Module posix.sys.stat

File Status Querying and Setting.

Functions

S_ISBLK (mode) Test for a block special file.
S_ISCHR (mode) Test for a character special file.
S_ISDIR (mode) Test for a directory.
S_ISFIFO (mode) Test for a fifo special file.
S_ISLNK (mode) Test for a symbolic link.
S_ISREG (mode) Test for a regular file.
S_ISSOCK (mode) Test for a socket.
chmod (path, mode) Change the mode of the path.
lstat (path) Information about an existing file path.
mkdir (path[, mode=511]) Make a directory.
mkfifo (path[, mode=511]) Make a FIFO pipe.
stat (path) Information about an existing file path.
umask ([mode]) Set file mode creation mask.

Tables

PosixStat File state record.

Constants

posix.sys.stat Stat constants.


Functions

S_ISBLK (mode)
Test for a block special file.

Parameters:

Returns:

    int non-zero if mode represents a block special file
S_ISCHR (mode)
Test for a character special file.

Parameters:

Returns:

    int non-zero if mode represents a character special file
S_ISDIR (mode)
Test for a directory.

Parameters:

Returns:

    int non-zero if mode represents a directory
S_ISFIFO (mode)
Test for a fifo special file.

Parameters:

Returns:

    int non-zero if mode represents a fifo special file
S_ISLNK (mode)
Test for a symbolic link.

Parameters:

Returns:

    int non-zero if mode represents a symbolic link
S_ISREG (mode)
Test for a regular file.

Parameters:

Returns:

    int non-zero if mode represents a regular file
S_ISSOCK (mode)
Test for a socket.

Parameters:

Returns:

    int non-zero if mode represents a socket
chmod (path, mode)
Change the mode of the path.

Parameters:

  • path string existing file path to act on
  • mode int access modes to set for path

Returns:

    int 0, if successful

Or

  1. nil
  2. string error message
  3. int errnum

See also:

Usage:

    P.chmod ('bin/dof', bit.bor (P.S_IRWXU, P.S_IRGRP))
lstat (path)
Information about an existing file path. If file is a symbolic link, return information about the link itself.

Parameters:

Returns:

    PosixStat information about path

See also:

Usage:

    for a, b in pairs (P.lstat "/etc/") do print (a, b) end
mkdir (path[, mode=511])
Make a directory.

Parameters:

  • path string location in file system to create directory
  • mode int access modes to set for path (default 511)

Returns:

    int 0, if successful

Or

  1. nil
  2. string error message
  3. int errnum

See also:

mkfifo (path[, mode=511])
Make a FIFO pipe.

Parameters:

  • path string location in file system to create fifo
  • mode int access modes to set for path (default 511)

Returns:

    int file descriptor for path, if successful

Or

  1. nil
  2. string error message
  3. int errnum

See also:

stat (path)
Information about an existing file path. If file is a symbolic link, return information about the file the link points to.

Parameters:

Returns:

    PosixStat information about path

See also:

Usage:

    for a, b in pairs (P.stat "/etc/") do print (a, b) end
umask ([mode])
Set file mode creation mask.

Parameters:

  • mode int new file creation mask (optional)

Returns:

    int previous umask

See also:

Tables

PosixStat
File state record.

Fields:

  • st_dev int device id
  • st_ino int inode number
  • st_mode int mode of file
  • st_nlink int number of hardlinks to file
  • st_uid int user id of file owner
  • st_gid int group id of file owner
  • st_rdev int additional device specific id for special files
  • st_size int file size in bytes
  • st_atime int time of last access
  • st_mtime int time of last data modification
  • st_ctime int time of last state change
  • st_blksize int preferred block size
  • st_blocks int number of blocks allocated

Constants

posix.sys.stat
Stat constants. Any constants not available in the underlying system will be nil valued.

Fields:

  • S_IFMT int file type mode bitmask
  • S_IFBLK int block special
  • S_IFCHR int character special
  • S_IFDIR int directory
  • S_IFIFO int fifo
  • S_IFLNK int symbolic link
  • S_IFREG int regular file
  • S_IFSOCK int socket
  • S_IRWXU int user read, write and execute
  • S_IRUSR int user read
  • S_IWUSR int user write
  • S_IXUSR int user execute
  • S_IRWXG int group read, write and execute
  • S_IRGRP int group read
  • S_IWGRP int group write
  • S_IXGRP int group execute
  • S_IRWXO int other read, write and execute
  • S_IROTH int other read
  • S_IWOTH int other write
  • S_IXOTH int other execute
  • S_ISGID int set group id on execution
  • S_ISUID int set user id on execution

Usage:

      -- Print stat constants supported on this host.
      for name, value in pairs (require "posix.sys.stat") do
        if type (value) == "number" then
          print (name, value)
         end
      end
generated by LDoc 1.4.3 Last updated 2015-03-01 09:06:02