dgfsdb(1M) DG/UX 4.30 dgfsdb(1M)
NAME
dg_fsdb - DG/UX file system debugger
SYNOPSIS
/etc/dgfsdb [ special | mount-point ]
DESCRIPTION
Dgfsdb(1M) views information on a local file system. This
information includes inodes, directory entries, and any
other file system information. 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 where the file system device
is mounted.
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
Licensed material--property of copyright holder(s) Page 1
dgfsdb(1M) DG/UX 4.30 dgfsdb(1M)
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
Licensed material--property of copyright holder(s) Page 2
dgfsdb(1M) DG/UX 4.30 dgfsdb(1M)
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
Licensed material--property of copyright holder(s) Page 3
dgfsdb(1M) DG/UX 4.30 dgfsdb(1M)
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) Page 4