UnixPermissions

Permissions of file, folder, or symbolic link in UNIX

Since R2025a

Description

Use a UnixPermissions object to view and edit the permissions of a file, folder, or symbolic link located on a UNIX^® system.

Creation

Create a UnixPermissions object using the filePermissions function.

You can then view and edit individual permissions of the specified file, folder, or symbolic link by using the getPermissions and setPermissions functions, respectively.

Properties

AbsolutePath — Absolute path

Read-only: string scalar

This property is read-only.

Absolute path of the file, folder, or symbolic link, returned as a string scalar.

Type — Type

Read-only: File | Folder | Symbolic Link | None

This property is read-only.

Type, returned as File, Folder, Symbolic Link, or None. Type is None if MATLAB^® cannot resolve the path in AbsolutePath.

Readable — Readable permission

true or 1 | false or 0

Readable permission, specified as a numeric or logical 1 (true) or 0 (false). A value of 1 indicates that you can read the file, folder, or symbolic link.

Writable — Writable permission

true or 1 | false or 0

Writable permission, specified as a numeric or logical 1 (true) or 0 (false). A value of 1 indicates that you can write to the file, folder, or symbolic link.

UserExecute — User execute permission

true or 1 | false or 0

User execute permission, specified as a numeric or logical 1 (true) or 0 (false). For a file, a value of 1 indicates that you can execute the file. For a folder, a value of 1 indicates that you can access file contents and folder metadata.

GroupRead — Group read permission

true or 1 | false or 0

Group read permission, specified as a numeric or logical 1 (true) or 0 (false). A value of 1 indicates that your group can read the file, folder, or symbolic link.

GroupWrite — Group write permission

true or 1 | false or 0

Group write permission, specified as a numeric or logical 1 (true) or 0 (false). A value of 1 indicates that your group can write to the file, folder, or symbolic link.

GroupExecute — Group execute permission

true or 1 | false or 0

Group execute permission, specified as a numeric or logical 1 (true) or 0 (false). For a file, a value of 1 indicates that your group can execute the file. For a folder, a value of 1 indicates that your group can access file contents and folder metadata.

OtherRead — Others read permission

true or 1 | false or 0

Others read permission, specified as a numeric or logical 1 (true) or 0 (false). A value of 1 indicates that users other than you or your group can read the file, folder, or symbolic link.

OtherWrite — Others write permission

true or 1 | false or 0

Others write permission, specified as a numeric or logical 1 (true) or 0 (false). A value of 1 indicates that users other than you or your group can write to the file, folder, or symbolic link.

OtherExecute — Others execute permission

true or 1 | false or 0

Others execute permission, specified as a numeric or logical 1 (true) or 0 (false). For a file, a value of 1 indicates that users other than you or your group can execute the file. For a folder, a value of 1 indicates that users other than you or your group can access file contents and folder metadata.

Object Functions

getPermissions	Get individual permissions
setPermissions	Set individual permissions

Examples

File Permissions on UNIX

View the permissions of a file on a UNIX operating system.

perms = filePermissions("example.txt")

perms = 

        AbsolutePath         Type     Readable    Writable    UserExecute    GroupRead    GroupWrite    GroupExecute    OtherRead    OtherWrite    OtherExecute  
    ____________________     ____     ________    ________    ___________    _________    __________    ____________    _________    __________    ____________

    "/home/example.txt"      File       true        true         true          true          true           true          true          true           true

Version History

Introduced in R2025a