NAME

       lscp - list NILFS2 checkpoints

SYNOPSIS

       lscp [options] [device]

DESCRIPTION

       lscp  is a utility for displaying checkpoints or snapshots of the NILFS2 file system found
       in device.  When device is omitted, /proc/mounts is examined to find a NILFS2 file system.

       This command will fail if the device has no active mounts of a NILFS2 file system.

OPTIONS

       -a, --all
              Do not hide minor checkpoints.

       -b, --show-block-count
              Show number of used blocks instead of appended blocks.  This is the default mode.

       -g, --show-increment
              Show number of appended blocks instead of used blocks.

       -r, --reverse
              Reverse order.

       -s, --snapshot
              List only snapshots.

       -i index, --index=index
              Skip index checkpoints (or snapshots) at start of input.

       -n lines, --lines=lines
              List only lines input checkpoints (or snapshots).

       -h, --help
              Display help message and exit.

       -V, --version
              Display version and exit.

FIELD DESCRIPTION

       Every line of the lscp output consists of the following seven fields:

       CNO    Checkpoint number.

       DATE   Creation date.

       TIME   Creation time.

       MODE   Mode of the checkpoint; cp for a plain checkpoint, and ss for a snapshot.

       FLG    Flags on the checkpoint. At present, character ``i'' is printed in the field if the
              checkpoint was created only by garbage collection, checkpoint mode change, or other
              change of internal state.  Otherwise ``-'' is printed.

       NBLKINC (optional)
              Number of blocks appended by the checkpoint.  This field is  displayed  instead  of
              BLKCNT field when -g option is specified.

       BLKCNT Number of blocks used by the checkpoint.

       ICNT   Number  of  inodes  included in the entire file system at the time specified by the
              checkpoint.

BUGS

       NILFS2 in Linux kernel version 2.6.38  and  earlier  does  not  support  the  block  count
       (BLKCNT) information.

AUTHOR

       Koji Sato

AVAILABILITY

       lscp    is    part    of    the    nilfs-utils    package    and    is    available   from
       https://nilfs.sourceforge.io.

SEE ALSO

       nilfs(8), mkcp(8), chcp(8), rmcp(8), nilfs-tune(8).