.\"  Copyright (C) 2007-2012 Nippon Telegraph and Telephone Corporation.
.\"  Written by Ryusuke Konishi <konishi.ryusuke@lab.ntt.co.jp>
.\"
.TH LSSU 1 "May 2011" "nilfs-utils version 2.1"
.SH NAME
lssu \- list usage state of NILFS2 segments
.SH SYNOPSIS
.B lssu
[\fIoptions\fP] [\fIdevice\fP]
.SH DESCRIPTION
.B lssu
is a utility for displaying usage state of NILFS2 segments in
\fIdevice\fP, where a segment is contiguous lump of disk blocks and
an allocation unit of NILFS2 disk space.  When \fIdevice\fP is
omitted, \fI/proc/mounts\fP is examined to find a NILFS2 file system.
.PP
This command will fail if the \fIdevice\fP has no active mounts of a
NILFS2 file system.
.SH OPTIONS
.TP
\fB\-a\fR, \fB\-\-all\fR
Do not hide clean segments.
.TP
\fB\-h\fR, \fB\-\-help\fR
Display help message and exit.
.TP
\fB\-i \fIindex\fR, \fB\-\-index\fR=\fIindex\fR
Skip \fIindex\fP segments at start of input.
.TP
\fB\-n \fIlines\fR, \fB\-\-lines\fR=\fIlines\fR
List only \fIlines\fP input segments.
.TP
\fB\-V\fR, \fB\-\-version\fR
Display version and exit.
.SH "FIELD DESCRIPTION"
Every line of the \fBlssu\fP output consists of the following fields:
.TP
.B SEGNUM
Segment number.
.TP
.B DATE
Creation date.
.TP
.B TIME
Creation time.
.TP
.B STAT
State of the segment.  It consists of three flags whose meaning is
shown below:
.RS
.TP
.B a
The segment is active, meaning that it is recently created and cannot
be reclaimed by the garbage collector.
.TP
.B d
The segment is dirty, meaning that it is in use.
.TP
.B e
The segment is erroneous, meaning that it has once caused an I/O
error.  NILFS2 avoids allocating the segments with this flag.
.RE
.TP
.B NBLOCKS
Number of in-use blocks of the segment.
.SH AUTHOR
Koji Sato
.SH AVAILABILITY
.B lssu
is part of the nilfs-utils package and is available from
http://www.nilfs.org.
.SH SEE ALSO
.BR nilfs (8),
.BR dumpseg (8).