Test user permissions for a file specified atpath andmode callingcallback with anError if one errors.

access("/home") { err->if (null!= err) {println("Something went wrong checking access to /home")  }}

The possible values for themode argument to test file accesspermissions can be seen below.

• F_OK - Test for the existence of a file
• R_OK - Test for read permissions on a file
• W_OK - Test for write permissions on a file
• X_OK - Test for execution permissions on a file

Change user permissions of a file specified atpath andmode callingcallback with anError if one occurs.

// make read, write, execute permissions for everyoneval mode= (S_IRUSRorS_IWUSRorS_IXUSRorS_IRGRPorS_IWGRPorS_IXGRPorS_IROTHorS_IWOTHorS_IXOTH)// modify program permissionschmod("/home/program", mode) { err->if (null!= err) {println("Something went wrong changing program permissions:${err.message}")  }}

The possible values for themode argument can be seen below. They canbe grouped into a bit mask by the logical OR (or) operator.

• S_IRWXU - Read, write, and execute by owner (700)
• S_IRUSR - Read by owner (400)
• S_IWUSR - Write by owner (200)
• S_IXUSR - Execute by owner (100)
• S_IRWXG - Read, write, and Execute by group (070)
• S_IRGRP - Read by group (040)
• S_IWGRP - Write by group (020)
• S_IXGRP - Execute by group (010)
• S_IRWXO - Read, write, and execute by others (007)
• S_IROTH - Read by others (004)
• S_IWOTH - Write by others (002)
• S_IXOTH - Execute by others (001)

Change user and group ownership of a file specified atpath for useriduid, and group idgid callingcallback with anError, if oneoccurs.

chown("/home/file",1000,10) { err->if (null!= err) {println("Something went wrong changing file ownership:${err.message}")  }}

Change user and group ownership of a symbolic link specified atpath foruser iduid, and group idgid callingcallback with anError, if oneoccurs.

symlink("/home/file","/home/link") { err->  lchown("/home/link",1000,10) { err->if (null!= err) {println("Something went wrong changing link ownership:${err.message}")    }  }}

Create a new hard link atpath for a file specified atsourcecallingcallback with anError, if one occurs.

link("/home/file","/home/link") { err->if (null!= err) {println("Something went creating hard link:${err.message}")  }}

Query the stats of a file specified atpath, if it exists, callingcallback with anError, if one occurs, otherwise an instance ofStats as the second argument.

stat("/home/file") { err, stats->if (null!= err) {println(err.message)  }else {println(stats)  }}

Query the stats of a file specified atpath, if it is a link or file, callingcallback with anError, if one occurs, otherwise an instance ofStats as the second argument.

lstat("/home/file") { err, stats->if (null!= err) {println(err.message)  }else {println(stats)  }}

Make a directory specified atpath with withmode callingcallingwith anError, if one occurs. Themode defaults toDEFAULT_MKDIR_MODE (see below) if not specified.

mkdir("/path/to/directory") { err->if (null!= err) {println(err.message)  }}

Read a directory specified atpath for files entries callingcallback with anError, if one occurs, otherwise anArray<String>with file names.

readdir("/home") { err, entries,->for (entryin entries) {println(entry)  }}

Open a file specified atpath with optional flags and mode callingcallback with anError, if one occurs, otherwise with a valid filedescriptor.

open("/path/to/file") { err, fd->if (null!= err) {println(err.message)  }else {// do something with fd  }}

By default, all files will be opened inDEFAULT_OPEN_MODE where:

// equivalent to (0666)valDEFAULT_OPEN_MODE= (S_IRUSRorS_IWUSRorS_IRGRPorS_IWGRPorS_IROTHorS_IWOTH)

• "r" - Open file for reading. An error occurs if the file does not exist.
• "r+" - Open file for reading and writing. An error occurs if the file does not exist.
• "w" - Open file for writing. The file is created if it does notexist, otherwise it is truncated.
• "w+" - Open file for reading and writing. The file is created if it does notexist, otherwise it is truncated.
• "a" - Open file for appending. Writes start at the end of the file.The file is created if it does not exist, otherwise it is truncated.

Check if a given mode is present in the stat's mode bit field.

if (stat.hasMode(S_IFREG)) {// stat points to a regular file}

Check if the stat points to a directory. Equivalent tostat.hasMode(S_IFDIR).

if (stat.isDirectory()) {// stat points to a directory}

Check if the stat points to a socket. Equivalent tostat.hasMode(S_IFSOCK).

if (stat.isSocket()) {// stat points to a socket}

Check if the stat points to a regular file.Equivalent tostat.hasMode(S_IFREG).

if (stat.isFile()) {// stat points to a file}