Module rustix::fs

Filesystem operations.

Re-exports

• pub use crate::io::FdFlags;
• pub use crate::io::fcntl_dupfd_cloexec;
• pub use crate::io::fcntl_getfd;
• pub use crate::io::fcntl_setfd;

Structs

• Access
  *_OK constants for use with accessat.
• AtFlags
  AT_* constants for use with openat, statat, and other *at functions.
• CloneFlags
  CLONE_* constants for use with fclonefileat.
• CopyfileFlags
  COPYFILE_* constants for use with fcopyfile.
• Dir
  DIR*
• DirEntry
  struct dirent
• FallocateFlags
  FALLOC_FL_* constants for use with fallocate.
• Gid
  gid_t—A Unix group ID.
• Mode
  S_I* constants for use with openat, chmodat, and fchmod.
• OFlags
  O_* constants for use with openat.
• StatVfs
  struct statvfs for use with statvfs and fstatvfs.
• StatVfsMountFlags
  ST_* constants for use with StatVfs.
• Timestamps
  Timestamps used by utimensat and futimens.
• Uid
  uid_t—A Unix user ID.
• XattrFlags
  XATTR_* constants for use with setxattr, and other *setxattr functions.
• copyfile_state_t
  copyfile_state_t—State for use with fcopyfile.

Enums

• FileType
  S_IF* constants for use with mknodat and Stat’s st_mode field.
• FlockOperation
  LOCK_* constants for use with flock and fcntl_lock.
• SeekFrom
  Enumeration of possible methods to seek within an I/O object.

Constants

• CWD
  AT_FDCWD—A handle representing the current working directory.
• UTIME_NOW
  UTIME_NOW for use with utimensat.
• UTIME_OMIT
  UTIME_OMIT for use with utimensat.

Traits

• DirEntryExt
  Re-export types common to POSIX-ish platforms. Unix-specific extension methods for fs::DirEntry.
• FileExt
  Re-export types common to POSIX-ish platforms. Unix-specific extensions to fs::File.
• FileTypeExt
  Re-export types common to POSIX-ish platforms. Unix-specific extensions for fs::FileType.
• MetadataExt
  Re-export types common to POSIX-ish platforms. Unix-specific extensions to fs::Metadata.
• OpenOptionsExt
  Re-export types common to POSIX-ish platforms. Unix-specific extensions to fs::OpenOptions.

Functions

• access
  access(path, access)—Tests permissions for a file or directory.
• accessat
  faccessat(dirfd, path, access, flags)—Tests permissions for a file or directory.
• chmod
  chmod(path, mode)—Sets file or directory permissions.
• chmodat
  fchmodat(dirfd, path, mode, flags)—Sets file or directory permissions.
• chown
  chown(path, owner, group)—Sets open file or directory ownership.
• chownat
  fchownat(dirfd, path, owner, group, flags)—Sets file or directory ownership.
• copyfile_state_alloc
  copyfile_state_alloc()
• copyfile_state_free^⚠
  copyfile_state_free(state)
• copyfile_state_get^⚠
  copyfile_state_get(state, flags, dst)
• copyfile_state_get_copied^⚠
  copyfile_state_get(state, COPYFILE_STATE_COPIED)
• cwdDeprecated
  Return the value of CWD.
• fallocate
  fallocate(fd, mode, offset, len)—Adjusts file allocation.
• fchmod
  fchmod(fd, mode)—Sets open file or directory permissions.
• fchown
  fchown(fd, owner, group)—Sets open file or directory ownership.
• fclonefileat
  fclonefileat(src, dst_dir, dst, flags)—Efficiently copies between files.
• fcntl_fullfsync
  fcntl(fd, F_FULLFSYNC)
• fcntl_getfl
  fcntl(fd, F_GETFL)—Returns a file descriptor’s access mode and status.
• fcntl_global_nocache
  fcntl(fd, F_GLOBAL_NOCACHE, value)—Turn data caching off or on for all file descriptors.
• fcntl_lock
  fcntl(fd, F_SETLK)—Acquire or release an fcntl-style lock.
• fcntl_nocache
  fcntl(fd, F_NOCACHE, value)—Turn data caching off or on for a file descriptor.
• fcntl_rdadvise
  fcntl(fd, F_RDADVISE, radvisory { offset, len })
• fcntl_setfl
  fcntl(fd, F_SETFL, flags)—Sets a file descriptor’s status.
• fcopyfile^⚠
  fcopyfile(from, to, state, flags)
• fgetxattr
  fgetxattr(fd, name, value.as_ptr(), value.len())—Get extended filesystem attributes on an open file descriptor.
• flistxattr
  flistxattr(fd, list.as_ptr(), list.len())—List extended filesystem attributes on an open file descriptor.
• flock
  flock(fd, operation)—Acquire or release an advisory lock on an open file.
• fremovexattr
  fremovexattr(fd, name)—Remove an extended filesystem attribute on an open file descriptor.
• fsetxattr
  fsetxattr(fd, name, value.as_ptr(), value.len(), flags)—Set extended filesystem attributes on an open file descriptor.
• fstat
  fstat(fd)—Queries metadata for an open file or directory.
• fstatfs
  fstatfs(fd)—Queries filesystem statistics for an open file or directory.
• fstatvfs
  fstatvfs(fd)—Queries filesystem statistics for an open file or directory, POSIX version.
• fsync
  fsync(fd)—Ensures that file data and metadata is written to the underlying storage device.
• ftruncate
  ftruncate(fd, length)—Sets the length of a file.
• futimens
  futimens(fd, times)—Sets timestamps for an open file or directory.
• getpath
  fcntl(fd, F_GETPATH)
• getxattr
  getxattr(path, name, value.as_ptr(), value.len())—Get extended filesystem attributes.
• is_file_read_write
  fcntl(fd, F_GETFL) & O_ACCMODE
• lgetxattr
  lgetxattr(path, name, value.as_ptr(), value.len())—Get extended filesystem attributes, without following symlinks in the last path component.
• link
  link(old_path, new_path)—Creates a hard link.
• linkat
  linkat(old_dirfd, old_path, new_dirfd, new_path, flags)—Creates a hard link.
• listxattr
  listxattr(path, list.as_ptr(), list.len())—List extended filesystem attributes.
• llistxattr
  llistxattr(path, list.as_ptr(), list.len())—List extended filesystem attributes, without following symlinks in the last path component.
• lremovexattr
  lremovexattr(path, name)—Remove an extended filesystem attribute, without following symlinks in the last path component.
• lsetxattr
  setxattr(path, name, value.as_ptr(), value.len(), flags)—Set extended filesystem attributes, without following symlinks in the last path component.
• lstat
  lstat(path)—Queries metadata for a file or directory, without following symlinks.
• major
  major(dev)
• makedev
  makedev(maj, min)
• minor
  minor(dev)
• mkdir
  mkdir(path, mode)—Creates a directory.
• mkdirat
  mkdirat(fd, path, mode)—Creates a directory.
• open
  open(path, oflags, mode)—Opens a file.
• openat
  openat(dirfd, path, oflags, mode)—Opens a file.
• readlink
  readlink(path)—Reads the contents of a symlink.
• readlinkat
  readlinkat(fd, path)—Reads the contents of a symlink.
• readlinkat_raw
  readlinkat(fd, path)—Reads the contents of a symlink, without allocating.
• removexattr
  removexattr(path, name)—Remove an extended filesystem attribute.
• rename
  rename(old_path, new_path)—Renames a file or directory.
• renameat
  renameat(old_dirfd, old_path, new_dirfd, new_path)—Renames a file or directory.
• rmdir
  rmdir(path)—Removes a directory.
• seek
  lseek(fd, offset, whence)—Repositions a file descriptor within a file.
• setxattr
  setxattr(path, name, value.as_ptr(), value.len(), flags)—Set extended filesystem attributes.
• stat
  stat(path)—Queries metadata for a file or directory.
• statat
  fstatat(dirfd, path, flags)—Queries metadata for a file or directory.
• statfs
  statfs—Queries filesystem metadata.
• statvfs
  statvfs—Queries filesystem metadata, POSIX version.
• symlink
  symlink(old_path, new_path)—Creates a symlink.
• symlinkat
  symlinkat(old_path, new_dirfd, new_path)—Creates a symlink.
• sync
  sync—Flush cached filesystem data for all filesystems.
• tell
  lseek(fd, 0, SEEK_CUR)—Returns the current position within a file.
• unlink
  unlink(path)—Unlinks a file.
• unlinkat
  unlinkat(fd, path, flags)—Unlinks a file or remove a directory.
• utimensat
  utimensat(dirfd, path, times, flags)—Sets file or directory timestamps.

Type Aliases

• Dev
  dev_t
• Nsecs
  A type for the tv_nsec field of Timespec.
• RawMode
  mode_t
• Secs
  A type for the tv_sec field of Timespec.
• Stat
  struct stat for use with statat and fstat.
• StatFs
  struct statfs for use with statfs and fstatfs.
• Timespec
  struct timespec