DEBUGVMFS(8)
NAME
debugvmfs - VMFS file system debugger
SYNOPSIS
debugvmfs VOLUME... COMMAND [ OPTIONS ]
DESCRIPTION
The debugvmfs program allows to display various informations about VMFS
file systems, and to access data within the file systems.
The VOLUME to be opened can be either a block device or an image file.
When the VMFS spreads accross several extents, all extents must be
given.
Please note that most commands are still likely to change in future
versions.
COMMANDS
- cat file [ ... ]
- Outputs the content of the given files from the VMFS.
- ls [ -l ] path
- Lists files contained at the given location within the VMFS.
- With -l, gives some more information, much like the output from ls(1) when given the -l option.
- truncate path length
- Truncate the file to the specified length. R/W support must be
enabled. - df
- Outputs information about file system size.
- show_file_blocks file
- Outputs block_ids for the given file's content blocks.
- get_file_block file position
- Get file block corresponding to position in the specified file.
- check_file_blocks file
- Check that all blocks used by a file are correctly allocated.
- check_vol_bitmaps
- Checks volume bitmaps consistency.
- show_heartbeats
- Outputs active heartbeats on the file system.
- read_block block_id [ ... ]
- Outputs content within the specified block_id in binary
- dump_block block_id [ ... ]
- Outputs content within the specified block_id in hex
- get_block_status block_id
- Get status (allocated or free) of the specified block_id.
- alloc_block_fixed block_id
- Allocate the specified block_id. R/W support must be enabled.
- alloc_block block_type
- Allocate a block of the specified type. R/W support must be
enabled. - Allowed block types are: 1 (File Block), 2 (Sub-Block), 3 (Pointer Block) and 4 (File Descriptor / Inode).
- free_block block_id
- Free the specified block_id. R/W support must be enabled.
- Warning: can cause damage since no heartbeat is used at this time
and a block used by a file can be freed. - show_bitmap_item block_id
- Outputs raw content for the bitmap item corresponding to the given block_id.
- show
- Display value(s) of the given variable. See the VARIABLES section for more details.
- shell
- Starts an interactive session. All of the above commands can be
executed from within the interactive session. - The current working directory can be changed with the cd command, followed by a path.
- The following output redirections are supported within the shell:
- o cmd > output
Puts the output of cmd in the output file. - o cmd >> output
Appends the output of cmd to the output file. - o cmd | external command
Sends the output of cmd to the input of external command. The external command itself can contain output redirection.Examples:o read_block 0x00000681 | lesso cat /.fdc.sf | hexdump -Co cat /.fdc.sf | hexdump -C > /tmp/fdc.hexo cat /.fdc.sf | hexdump -C | less
VARIABLES
Variables in debugvmfs represent structures on the filesystem. The
currently supported top-level variables are the following:
o fbb
o fdc
o pbc
o sbc
o fs
o lvm
o blkid[blk]
o dirent[path]
o inode[path]
The fbb, fdc, pbc and sbc variables are bitmaps. Running them through
the show command will display all the bitmaps header fields. Each of
these fields can also be displayed individually:
o bitmap.items_per_bitmap_entry
o bitmap.bmp_entries_per_area
o bitmap.hdr_size
o bitmap.data_size
o bitmap.area_size
o bitmap.area_count
o bitmap.total_items
o bitmap.used_items
o bitmap.free_items
o bitmap.entry[n]
e.g. to display the data size of the fdc bitmap, type show
fdc.data_size.
Each bitmap.entry[n] (where 0 <= n < bitmap.bmp_entries_per_area *
bitmap.area_count) contains information about each entry in the bitmap.
The available fields are:
o bitmap.entry[n].id
o bitmap.entry[n].total
o bitmap.entry[n].free
o bitmap.entry[n].ffree
o bitmap.entry[n].mdh
o bitmap.entry[n].item[m]
The bitmap.entry[n].mdh is a metadata header. See further below for
more details about metadata headers.
Each bitmap.entry[n].item[m] (where 0 <= m <
bitmap.items_per_bitmap_entry) contains information about a given item
in the given entry. The available fields are:
o bitmap.entry[n].item[m].used
The fs variable contains low-level information about the filesystem.
The available fields are:
o fs.vol_version
o fs.version
o fs.label
o fs.mode
o fs.uuid
o fs.ctime
o fs.block_size
o fs.subblock_size
o fs.fdc_header_size
o fs.fdc_bitmap_count
The lvm variable contains low-level information about the physical and
logical volumes. The available fields are:
o lvm.uuid
o lvm.size
o lvm.blocks
o lvm.num_extents
o lvm.extent[n]
Each lvm.extent[n] (where 0 <= n < lvm.num_extents) contains low-level
information about the physical volumes. The available fields are:
o lvm.extent[n].device
o lvm.extent[n].uuid
o lvm.extent[n].lun
o lvm.extent[n].version
o lvm.extent[n].name
o lvm.extent[n].size
o lvm.extent[n].num_segments
o lvm.extent[n].first_segment
o lvm.extent[n].last_segment
Each blkid[blk] (where blk is a block id) contains information on the
given block id. The available fields are:
o blkid[blk].item
o blkid[blk].flags
Each dirent[path] (where path is a path relative to the current
directory in the shell or / outside the shell) contains information on
the directory entry corresponding to the given path. The available
fields are:
o dirent[path].type
o dirent[path].block_id
o dirent[path].record_id
o dirent[path].name
Each inode[path] (where path is a path relative to the current
directory in the shell or / outside the shell) contains information on
the inode corresponding to the given path. The available fields are:
o inode[path].id
o inode[path].id2
o inode[path].nlink
o inode[path].type
o inode[path].flags
o inode[path].size
o inode[path].blk_size
o inode[path].blk_count
o inode[path].uid
o inode[path].gid
o inode[path].mode
o inode[path].zla
o inode[path].tbz
o inode[path].cow
o inode[path].atime
o inode[path].mtime
o inode[path].ctime
o inode[path].rdm_id
o inode[path].mdh
Metadata headers are being used in several places, such as
bitmap.entry[n].mdh and inode[path].mdh. They mostly contain
information about clustered accesses to metadata on the filesystem. The
available fields are:
o mdh.magic
o mdh.pos
o mdh.hb_pos
o mdh.hb_lock
o mdh.hb_uuid
o mdh.hb_seq
o mdh.obj_seq
o mdh.mtime
AUTHORS
Christophe Fillot <cf@utc.fr[1]>, Mike Hommey <mh@glandium.org[2]>
SEE ALSO
NOTES
- 1. cf@utc.fr
- mailto:cf@utc.fr
- 2. mh@glandium.org
mailto:mh@glandium.org