System.Posix.Files.ByteString

setFileMode path mode changes permission of the file given by path to mode. This operation may fail with throwErrnoPathIfMinus1_ if path doesn't exist or if the effective user ID of the current process is not that of the file's owner.

Note: calls chmod.

setFdMode fd mode acts like setFileMode but uses a file descriptor fd instead of a FilePath.

Note: calls fchmod.

setFileCreationMask mode sets the file mode creation mask to mode. Modes set by this operation are subtracted from files and directories upon creation. The previous file creation mask is returned.

Note: calls umask.

fileAccess name read write exec checks if the file (or other file system object) name can be accessed for reading, writing and/or executing. To check a permission set the corresponding argument to True.

Note: calls access.

Checks for the existence of the file.

Note: calls access.

getFileStatus path calls gets the FileStatus information (user ID, size, access times, etc.) for the file path.

Note: calls stat.

getFdStatus fd acts as getFileStatus but uses a file descriptor fd.

Note: calls fstat.

Acts as getFileStatus except when the RawFilePath refers to a symbolic link. In that case the FileStatus information of the symbolic link itself is returned instead of that of the file it points to.

Note: calls lstat.

ID of the device on which this file resides.

inode number

File mode (such as permissions).

Number of hard links to this file.

ID of owner.

ID of group.

Describes the device that this file represents.

Size of the file in bytes. If this file is a symbolic link the size is the length of the pathname it contains.

Time of last access.

Time of last modification.

Time of last status change (i.e. owner, group, link count, mode, etc.).

Time of last access in sub-second resolution. Depends on the timestamp resolution of the underlying filesystem.

Time of last modification in sub-second resolution. Depends on the timestamp resolution of the underlying filesystem.

Time of last status change (i.e. owner, group, link count, mode, etc.) in sub-second resolution. Depends on the timestamp resolution of the underlying filesystem.

Checks if this file is a block device.

Checks if this file is a character device.

Checks if this file is a named pipe device.

Checks if this file is a regular file device.

Checks if this file is a directory device.

Checks if this file is a symbolic link device.

Checks if this file is a socket device.

Gives the preferred block size for efficient filesystem I/O in bytes. Returns Nothing if st_blocksize is not supported on this platform.

Number of blocks allocated for this file, in units of 512-bytes. Returns Nothing if st_blocks is not supported on this platform.

Gets extended file status information.

The target file to open is identified in one of the following ways:

• If pathname begins with a slash, then it is an absolute pathname that identifies the target file. In this case, dirfd is ignored

• If pathname is a string that begins with a character other than a slash and dirfd is a file descriptor that refers to a directory, then pathname is a relative pathname that is interpreted relative to the directory referred to by dirfd. (See openat(2) for an explanation of why this is useful.)

• If pathname is an empty string and the EmptyPath flag is specified in flags (see below), then the target file is the one referred to by the file descriptor dirfd.

Note: calls statx.

Statx flags.

See the pattern synonyms for possible flags. These are combined via (<>). Flags can be tested via (.&.).

The following flags influence pathname-based lookup:

• EmptyPath

• NoAutoMount

• SymlinkNoFollow

The following flags can be used to control what sort of synchronization the kernel will do when querying a file on a remote filesystem:

• SyncAsStat

• ForceSync

• DontSync

If pathname to getExtendedFileStatus is an empty string, operate on the file referred to by the 'Maybe Fd' argument.

In this case, it can refer to any type of file, not just a directory.

Don't automount the terminal ("basename") component of pathname if it is a directory that is an automount point. This allows the caller to gather attributes of an automount point (rather than the location it would mount). This flag can be used in tools that scan directories to prevent mass-automounting of a directory of automount points. This flag has no effect if the mount point has already been mounted over.

If pathname is a symbolic link, do not dereference it: instead return information about the link itself, like lstat(2).

Do whatever stat(2) does. This is the default and is very much filesystem-specific.

Force the attributes to be synchronized with the server. This may require that a network filesystem perform a data writeback to get the timestamps correct.

Don't synchronize anything, but rather just take whatever the system has cached if possible. This may mean that the information returned is approximate, but, on a network filesystem, it may not involve a round trip to the server - even if no lease is held.

Mask argument to statx. It's used to tell the kernel which fields the caller is interested in.

See the pattern synonyms for possible masks. These are combined via (<>). Masks can be tested via (.&.).

Want stx_mode & S_IFMT.

Want stx_mode & ~S_IFMT.

Want stx_nlink.

Want stx_uid.

Want stx_gid.

Want stx_atime.

Want stx_mtime.

Want stx_ctime.

Want stx_ino.

Want stx_size.

Want stx_blocks.

Want all of the above.

Want stx_btime.

Want stx_mnt_id.

Want all currently available fields.

The "preferred" block size for efficient filesystem I/O. (Writing to a file in smaller chunks may cause an inefficient read-modify-rewrite.)

The number of hard links on a file.

Te user ID of the owner of the file.

The ID of the group owner of the file.

The file type and mode. See inode(7) for details.

The inode number of the file.

The size of the file (if it is a regular file or a symbolic link) in bytes. The size of a symbolic link is the length of the pathname it contains, without a terminating null byte.

The number of blocks allocated to the file on the medium, in 512-byte units. (This may be smaller than stx_size/512 when the file has holes.)

The file's last access timestamp.

The file's creation timestamp.

The file's last status change timestamp.

The file's last modification timestamp.

ID of the device on which this file resides.

Describes the device that this file represents.

The mount ID of the mount containing the file. This is the same number reported by name_to_handle_at(2) and corresponds to the number in the first field in one of the records in procself/mountinfo.

The file is compressed by the filesystem and may take extra resources to access. This is an extended attribute.

The file cannot be modified: it cannot be deleted or renamed, no hard links can be created to this file and no data can be written to it. See chattr(1). This is an extended attribute.

The file can only be opened in append mode for writing. Random access writing is not permitted. See chattr(1). This is an extended attribute.

File is not a candidate for backup when a backup program such as dump(8) is run. See chattr(1). This is an extended attribute.

A key is required for the file to be encrypted by the filesystem. This is an extended attribute.

The file has fs-verity enabled. It cannot be written to, and all reads from it will be verified against a cryptographic hash that covers the entire file (e.g., via a Merkle tree). This is an extended attribute. Since Linux 5.5.

The file is in the DAX (cpu direct access) state. This is an extended attribute. Since Linux 5.8.

Checks if this file is a block device.

Checks if this file is a character device.

Checks if this file is a named pipe device.

Checks if this file is a regular file device.

Checks if this file is a directory device.

Checks if this file is a symbolic link device.

Checks if this file is a socket device.