Man1 - lscp.1

Table of Contents

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).

Author: dt

Created: 2022-02-22 Tue 16:54