Status Mode (GNU tar 1.34)

Next: Exec Mode, Previous: Generate Mode, Up: Genfile [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 *

Next: Exec Mode, Previous: Generate Mode, Up: Genfile [Contents][Index]