---
name: "lscp"
section: "1"
platform: "linux"
package: "nilfs-utils"
version: "2.3.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/lscp"
---

# lscp(1)

list NILFS2 checkpoints

## NAME

lscp - list NILFS2 checkpoints

## SYNOPSIS

**lscp** \[*options*\] \[*device*\|*node*\]

## DESCRIPTION

**lscp** is a utility for displaying checkpoints or snapshots of the NILFS2 file system found in *device*. *device* may be a block device or a filesystem node (file or directory) on the filesystem. 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)](/nilfs/8.md), [**mkcp**(8)](/mkcp/8.md), [**chcp**(8)](/chcp/8.md), [**rmcp**(8)](/rmcp/8.md), [**nilfs-tune**(8)](/nilfs-tune/8.md).