lscp(1) - f33

1LSCP(1)                     General Commands Manual                    LSCP(1)
2
3
4

NAME

6       lscp - list NILFS2 checkpoints
7

SYNOPSIS

9       lscp [options] [device]
10

DESCRIPTION

12       lscp is a utility for displaying checkpoints or snapshots of the NILFS2
13       file system found in device.  When device is omitted,  /proc/mounts  is
14       examined to find a NILFS2 file system.
15
16       This  command  will fail if the device has no active mounts of a NILFS2
17       file system.
18

OPTIONS

20       -a, --all
21              Do not hide minor checkpoints.
22
23       -b, --show-block-count
24              Show number of used blocks instead of appended blocks.  This  is
25              the default mode.
26
27       -g, --show-increment
28              Show number of appended blocks instead of used blocks.
29
30       -r, --reverse
31              Reverse order.
32
33       -s, --snapshot
34              List only snapshots.
35
36       -i index, --index=index
37              Skip index checkpoints (or snapshots) at start of input.
38
39       -n lines, --lines=lines
40              List only lines input checkpoints (or snapshots).
41
42       -h, --help
43              Display help message and exit.
44
45       -V, --version
46              Display version and exit.
47

FIELD DESCRIPTION

49       Every line of the lscp output consists of the following seven fields:
50
51       CNO    Checkpoint number.
52
53       DATE   Creation date.
54
55       TIME   Creation time.
56
57       MODE   Mode  of the checkpoint; cp for a plain checkpoint, and ss for a
58              snapshot.
59
60       FLG    Flags on the checkpoint. At present, character ``i'' is  printed
61              in  the field if the checkpoint was created only by garbage col‐
62              lection, checkpoint mode change, or  other  change  of  internal
63              state.  Otherwise ``-'' is printed.
64
65       NBLKINC (optional)
66              Number of blocks appended by the checkpoint.  This field is dis‐
67              played instead of BLKCNT field when -g option is specified.
68
69       BLKCNT Number of blocks used by the checkpoint.
70
71       ICNT   Number of inodes included in the entire file system at the  time
72              specified by the checkpoint.
73

BUGS

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

AUTHOR

79       Koji Sato
80

AVAILABILITY

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