GNU tar 1.34: F.2 Status Mode

[ << ]

[ < ]

[ Up ]

[ > ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

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 *