LSCP(1)

📦
version 2.3.1 · 2 versions
, in alpine 3.24, arch rolling, nixpkgs unstable

✨ LSCP(1) ✨

okay bestie, welcome to lscp from the General Commands Manual — the NILFS2 checkpoint lister that literally eats 💅

🌸 NAME 🌸

lscp — list NILFS2 checkpoints

🎀 SYNOPSIS 🎀

lscp [options] [device|node]

🦋 DESCRIPTION 🦋

so lscp is that utility that shows you the checkpoints or snapshots of the NILFS2 file system living inside device. and when we say device, we mean it can be a block device or a filesystem node — like a file or a directory — on the filesystem. either one, she's flexible like that 💖

and if you just... don't pass a device at all? no stress, bestie. lscp goes and peeks at /proc/mounts to find itself a NILFS2 file system. iconic behavior honestly.

🚨 but heads up — this command will fail if the device has no active mounts of a NILFS2 file system. like, no mounts, no vibes, no output. periodt.

💅 OPTIONS 💅

  • -a, --all — do not hide minor checkpoints. show me everything, we're nosy 🫶
  • -b, --show-block-count — show the number of used blocks instead of appended blocks. this is the default mode, so if you do nothing, this is what you get ✨
  • -g, --show-increment — show the number of appended blocks instead of used blocks. the swap-in sister of -b
  • -r, --reverse — reverse the order. flip it, turn it, reverse it 🔄
  • -s, --snapshot — list only snapshots. snapshots only, no plain checkpoints allowed
  • -i index, --index=index — skip index checkpoints (or snapshots) at the start of the input. like scrolling past the first few, but in flag form
  • -n lines, --lines=lines — list only lines checkpoints (or snapshots) from the input. a lil limit, a lil snack 🍓
  • -h, --help — display the help message and exit. your little "what does this do again" button
  • -V, --version — display the version and exit. show me the numbers 👑

🌈 FIELD DESCRIPTION 🌈

every single line of lscp output is made of seven fields, bestie. seven. here's the tea on each one:

  • 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, the character i'' gets printed in this field if the checkpoint was created **only** by garbage collection, checkpoint mode change, or other change of internal state. otherwise -'' gets printed. so it's giving i or it's giving -, no in between 💀
  • NBLKINC (optional) — number of blocks appended by the checkpoint. this field is displayed instead of the BLKCNT field when the -g option is specified. so it's an either/or situation, she doesn't do both.
  • 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. so on old kernels that field is just... not it. 😭

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

and that's the whole page, bestie 🎀 this was nilfs-utils version 2.3, dated Jan 2026, signing off with main character energy — go list some checkpoints, you absolute icon ✨💅🦋

📦 where this page comes from