Provided by: moosefs-master_3.0.117-1_amd64 bug

NAME

       mfsmetadump - dump MooseFS metadata info in human readable format

SYNOPSIS

       mfsmetadump [-d] [-s section_name] metadata_file

DESCRIPTION

       mfsmetadump  dumps  MooseFS  metadata  info  in human readable format.  Output consists of
       several sections with different types of information. Every section consist of header data
       - rows starting with hash (#) sign - and content data (may be empty).

OPTIONS

       -d  - replace all non-printable characters (codes < 32 and > 126) with '.' (it was default
       behaviour in version < 3.0.110).

       -s - dump only specified section of the file. Possible sections:
            HEAD - header info
            SESS - client sessions
            LABS - labels (not used)
            SCLA - storage classes
            NODE - tree nodes (i-nodes)
            EDGE - tree edges (file names)
            FREE - free nodes (deleted i-nodes)
            QUOT - quota definitions
            XATR - xattr data
            PACL - posix acl data
            OPEN - open files
            FLCK - flock data
            PLCK - posix locks (lockf,ioctl) data
            CSDB - active chunkservers
            CHNK - chunks

SECTION HEADER (precedes each section except HEAD)

       section header      section header (section type + version)

       length              length of section

       section type        name of section

       version             hexadecimal representation of section version

FILE HEADER (HEAD)

       header              MooseFS version

       version             metadata file version

       fileid              metadata file id

SESSIONS SECTION (SESS)

       nextsessionid       first free session id

       statscount          number of stats remembered in each session

       SESSION             line describing a single session
                           s         session id
                           e         exports checksum
                           p         IP address
                           r         root inode number
                           f         session flags
                           u         umask
                           g         min and max goal (redundancy level)
                           t         min and max trash retention
                           m         maproot uid,gid and mapall uid,gid
                           x         disabled operations
                           d         disconnection time (optional)
                           c         current hour stats data
                           l         last hour stats data
                           i         session name (usually local mount point)

STORAGE CLASS SECTION (SCLA), formerly LABELS SECTION (LABS)

       LABELDESC           line with label description (existed only in LABS)
                           l         label letter
                           n         label description

       SCLASS              (formerly LABELSET) line with storage class used in system
                           #         storage class id
                           x         admin only
                           m         mode
                           d         arch delay
                           c         create labels
                           k         keep labels
                           a         archive labels
                           n         name

NODES SECTION (NODE)

       maxinode            maximum inode number used by system

       hashelements        number of inodes in hash tabble

       NODE                line with node (inode) description
                           k         node type (-,D,S,F,B,C,L,T,R)
                                     -         file
                                     D         directory
                                     S         socket
                                     F         fifo
                                     B         block device
                                     C         character device
                                     L         symbolic link
                                     T         trash file
                                     R         sustained file (removed open file)
                           i         inode number
                           #         storage class id
                           e         flags (extra mfs attributes)
                           w         windows attributes
                           m         mode
                           u         uid
                           g         gid
                           a,m,c     atime, mtime, ctime
                           t         trash retention
                           d         rdevhi,rdevlo (only block and character devices)
                           p         path (only symbolic links)
                           l         file length (only files)
                           c         chunk list (only files)
                           r         sessions that have this file open (only files)

EDGES SECTION (EDGE)

       nextedgeid          next available edge id (descending)

       EDGE                line with edge description
                           p         parent inode number
                           c         child inode number
                           i         edge id
                           n         edge name

FREE NODES SECTION (FREE)

       free nodes          number of free (reusable) nodes

       FREEID              line with free inode description
                           i         inode number
                           f         deletion timestamp

QUOTA SECTION (QUOT)

       quota nodes         number of nodes with quota

       QUOTA               line with quota description
                           i         inode number
                           g         grace period
                           e         exceeded
                           f         flags
                           s         soft quota exceeded timestamp
                           si        soft inode quota
                           hi        hard inode quota
                           sl        soft length quota
                           hl        hard length quota
                           ss        soft size quota
                           hs        hard size quota
                           sr        soft real size quota
                           hr        hard real size quota

XATTR SECTION (XATR)

       XATTR               line with xattr description
                           i         inode number
                           n         xattr name
                           v         xattr value

POSIX ACL SECTION (PACL)

       POSIXACL            line with acl description
                           i         inode number
                           t         acl type
                           u         user (file owner) permissions
                           g         group permissions
                           o         other permissions
                           m         permission mask
                           n         named permissions - list of objects:
                           u(U):P    permissions P for user with uid U
                           g(G):P    permissions P for group with gid G

OPEN FILES SECTION (OPEN)

       OPENFILE            line with open file description
                           s         session id
                           i         inode number

FLOCK LOCK SECTION (FLCK)

       FLOCK               line with flock-lock description
                           i         inode number
                           s         session id
                           o         lock owner (FUSE lock owner)
                           t         lock type ('R' - shared lock, 'W' - exclusive lock)

POSIX LOCK SECTION (PLCK)

       POSIXLOCK           line with posix-lock description
                           i         inode number
                           s         session id
                           o         lock owner (FUSE lock owner)
                           p         local process id (owner pid)
                           r         lock range in format <START,END)
                           t         lock type ('R' - shared lock, 'W' - exclusive lock)

CHUNKSERVERS SECTION (CSDB)

       chunk servers       number of chunkservers

       CHUNCKSERVER        line with chunk server description
                           i         server ip
                           p         server port
                           #         server id
                           m         maintenance mode
                           t         maintenance timeout timestamp

CHUNKS SECTION (CHNK)

       nextchunkid         first available chunk number

       CHUNK               line with chunk description
                           i         chunk number
                           v         chunk version
                           t         "locked to" timestamp
                           a         archive flag

REPORTING BUGS

       Report bugs to <bugs@moosefs.com>.

COPYRIGHT

       Copyright (C) 2023 Jakub Kruszona-Zawadzki, Saglabs SA

       This file is part of MooseFS.

       MooseFS is free software; you can redistribute it and/or modify it under the terms of  the
       GNU General Public License as published by the Free Software Foundation, version 2 (only).

       MooseFS  is  distributed  in  the  hope  that it will be useful, but WITHOUT ANY WARRANTY;
       without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR  PURPOSE.
       See the GNU General Public License for more details.

       You  should  have received a copy of the GNU General Public License along with MooseFS; if
       not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,  MA
       02111-1301, USA or visit http://www.gnu.org/licenses/gpl-2.0.html

SEE ALSO

       mfsmaster(8)