F.2 Status Mode

In status mode, genfile prints file system status for each file specified in the command line. This mode is toggled by ‘--stat’ (‘-S’) command line option. An optional argument to this option specifies output format: a comma-separated list of struct stat fields to be displayed. This list can contain following identifiers:

name

The file name.

dev

st_dev

Device number in decimal.

ino

st_ino

Inode number.

mode[.number]

st_mode[.number]

File mode in octal. Optional number specifies octal mask to be applied to the mode before outputting. For example, --stat mode.777 will preserve lower nine bits of it. Notice, that you can use any punctuation character in place of ‘.’.

nlink

st_nlink

Number of hard links.

uid

st_uid

User ID of owner.

gid

st_gid

Group ID of owner.

size

st_size

File size in decimal.

blksize

st_blksize

The size in bytes of each file block.

blocks

st_blocks

Number of blocks allocated.

atime

st_atime

Time of last access.

mtime

st_mtime

Time of last modification

ctime

st_ctime

Time of last status change

sparse

A boolean value indicating whether the file is ‘sparse’.

Modification times are displayed in UTC as UNIX timestamps, unless suffixed with ‘H’ (for “human-readable”), as in ‘ctimeH’, in which case usual tar tv output format is used.

The default output format is: ‘name,dev,ino,mode, nlink,uid,gid,size,blksize,blocks,atime,mtime,ctime’.

For example, the following command will display file names and corresponding times of last access for each file in the current working directory:

genfile --stat=name,atime *

By default, genfile follows symbolic links and returns information about files pointed to by them. To get information about the symlink files themselves, use the ‘--no-dereference’ (‘-h’) option.

This document was generated on August 23, 2023 using texi2html 5.0.