dg_fsdb(1M) DG/UX R4.11 dg_fsdb(1M)
NAME
dgfsdb - file system debugger
SYNOPSIS
/etc/dgfsdb [ special | mount-point ]
where:
special The block special device containing the file system
mount-point
A directory for which there is an entry in the /etc/fstab
file, indicating the location where the file system device
is mounted
DESCRIPTION
Dgfsdb(1M) views information on a local file system. This
information includes inodes, directory entries, and any other file
system information.
To use dgfsdb(1M) effectively, you must be familiar with the
contents of inodes and directory entries and how these structures are
used.
Dgfsdb(1M) can display file system information in the following
formats:
inode
directory entry
long
short
byte
character
Dgfsdb(1M) supports decimal, hexadecimal, and octal numbers. A zero
followed by a lower-case x indicates a hexadecimal number and a zero
prefix indicates an octal number. Decimal is the default.
Additionally, numbers can have units by suffixing the value with the
following: B (blocks), I (node-number), K (kilobytes), M (megabytes),
or C (bytes and the default).
Command Language
Unlike fsdb(1M), dgfsdb(1M) provides a shell-like command language
to walk through the directory hierarchy to display file system
information.
The following commands are supported by dgfsdb(1M):
help [ command-name ]
With no arguments, the names of all available commands are
printed. If a command-name is given, a synopsis, syntax, and
description of the command are printed.
open [ special | mount-point ]
Opens a file system for manipulation. If a command line
argument is used to specify a file system, then a file system
will already be opened. File systems may be opened at any
time. Special is the block special device containing the file
system. Mount-point is a directory for which there is an entry
in the /etc/fstab file indicating the location the file system
device should be mounted.
cd [ node-number | path ]
When dgfsdb(1M) is started with a file system argument or a
file system has been opened, the current directory is set to
the root of the file system. cd provides the ability to
change this directory. If no arguments are given, the path
defaults to the root directory of the file system.
pwd
Prints the current working directory.
ls [ -ldc ] [ node-number | path ]
Prints a listing of the given directory specified by node-
number or path. If no arguments are given, information about
the current directory is printed.
The -l option specifies a long listing.
The -d option lists the directory's inode rather than its
contents.
The -c option gives a complete listing of the inode beyond
what is supplied by the -l option.
env
Prints statistics about the currently open file system.
da disk-address
Displays information about the given disk-address. A disk
address contains no spaces and is of the form:
[ path | value ] [ :sequence-number ] [+data-address ]
The first optional part provides the ability to specify an
inode or absolute displacement in the file system. An inode
can be specified with a path or an inode number value. Inode
number values are suffixed with an I. If the value does not
represent an inode, the value is assumed to be an absolute
displacement into the file system. If the first part is not
provided, the inode number of the current directory is used.
The second optional part allows the reference of a sequence
number. This should only be used when the first part of the
address refers to a directory. A sequence number of 0 refers
to the directory entry in the given inode's parent directory
(this provides an easy mechanism for looking at directory
entries for a given path). If no value is given, the address
will not resolve to a directory entry.
The third part provides the ability to access the data
associated with a given inode. The data-address is a
displacement within the file expressed by the given inode or
default.
dr disk-address [ count ] [ format ]
Disk read reads and displays the contents of the given disk
address. The count indicates the number of items to be
printed starting from the given disk-address. The item type
is specified with the format argument. The following formats
can be used:
long,l
short,s
byte,b
character,char,c
decimal,dec,d
longdec,ld,D
octal,oct,o
longoct,lo,O
hexadecimal,hex,h,x
longhex,lhex,lh,H,X
string,str
source path
Reads and executes commands from the given path. The commands
are executed on the current environment.
alias [ alias-name cmd-name arguments... ]
Replaces the old command with the new command and its
arguments. If no arguments are given, all of the current
aliases are printed.
exit
Exits dgfsdb(1M)
If a .fsdbrc file exists in the user's home directory, this file is
sourced before the program prompts the user for commands.
EXAMPLES
The following is an example session of dgfsdb(1M):
fsdb> open /dev/dsk/test
fsdb> env
File System: /dev/dsk/test1
Size: 3200 Blocks
1638400 Bytes
1.562500 Megabytes
0.001526 Gigabytes
Inodes: 4032
Current Directory: /
fsdb> ls
fooa(3) foob(4)
fsdb> ls -l
3 f---rw-rw-r-- 1 510 50 1376256 Apr 9 10:37 fooa
4 d---rwxrwxr-x 1 510 50 1376256 Apr 9 10:37 foob
fsdb> cd 4
fsdb> cd ../foob
fsdb> pwd
/foob(4)
fsdb> dr /foob+3B 0x1 c
/foob+0600> 0
fsdb> dr 4I+2K 010 H
3I+0800> 30313233 34353637 38394142 43444546 30313233
3I+0814> 34353637 38394142 43444546
fsdb> exit
SEE ALSO
fsck(1M), fsdb(1M), fs(4), inode(4).
Licensed material--property of copyright holder(s)