dumpseg(8)

1DUMPSEG(8)                  System Manager's Manual                 DUMPSEG(8)
2
3
4

NAME

6       dumpseg - print segment information of NILFS2
7

SYNOPSIS

9       dumpseg [device] segment-number ...
10
11       dumpseg -h
12

DESCRIPTION

14       The  dumpseg  program  is an analysis tool for on-disk logs of a NILFS2
15       file system found in device.  It displays the  configuration  of  every
16       log  stored  in  the segments specified by one or more segment-numbers.
17       The term segment here means a contiguous lump of disk blocks giving  an
18       allocation unit of NILFS2 disk space.  When device is omitted, it tries
19       to find an active NILFS2 file system from /proc/mounts.
20
21       dumpseg is a tool for debugging rather than administration.  To list  a
22       summary of segments, lssu(1) is available instead.
23

OPTIONS

25       -h     Display help message and exit.
26

FIELD DESCRIPTION

28       dumpseg  shows the configuration of each log with the following fields,
29       where each field is printed in the style of ``field-name = value''.
30
31       creation time
32              Creation date and time of the log.
33
34       nfinfo Number of file information summaries.
35
36       finfo  File information summary. This information starts with the  fol‐
37              lowing fields:
38
39              ino    Inode number of the file.
40
41              cno    Number  of the checkpoint that the blocks included in the
42                     file belong to.  For normal writings, this  is  equal  to
43                     the  latest checkpoint number.  For the writings involved
44                     in garbage collection, this indicates a  past  checkpoint
45                     number.
46
47              nblocks
48                     Number  of  blocks  of the file written in the log.  This
49                     number is a sum of the number of data blocks  and  B-tree
50                     node  blocks.   The  contents of these blocks are written
51                     serially in the payload part of the log.   Only  modified
52                     or newly created blocks are written to each log.
53
54              ndatblk
55                     Number of data blocks of the file written in the log.
56
57              Then,  for each update block in the file, the following informa‐
58              tion will follow these headings.
59
60              vblocknr
61                     Virtual block number.  Not printed for data blocks of the
62                     Disk Address Translation file (DAT file).
63
64              blkoff Block  offset number.  Not printed for B-tree node blocks
65                     except for the DAT file.
66
67              level  Level of B-tree node block.  Printed  only  for  the  DAT
68                     file.
69
70              blocknr
71                     Block address on the device.  This is not an actual field
72                     in the summary but is calculated from the disk address of
73                     each log.
74

AUTHOR

76       Koji Sato <koji@osrg.net>
77

AVAILABILITY

79       dumpseg  is  part  of  the  nilfs-utils  package  and is available from
80       http://www.nilfs.org.
81