fsdb(1M)                                                           fsdb(1M)




 NAME    [Toc]    [Back]
      fsdb - file system debugger (generic)

 SYNOPSIS    [Toc]    [Back]
      /usr/sbin/fsdb [-F FStype] [-o specific_options] [-V] special

    Remarks    [Toc]    [Back]
      Always execute the fsck command (see fsck(1M)) after running fsdb.

 DESCRIPTION    [Toc]    [Back]
      The fsdb command can be used to patch up a damaged file system after a
      crash.  It is intended for experienced users only.  The file system
      type to be debugged is specified as FStype.  Each file system type has
      a unique structure requiring different debugging capabilities.  The
      manual entries for the file-system-specific fsdb should be consulted
      before attempting any debugging or modifications.

    Options and Arguments    [Toc]    [Back]
      fsdb recognizes the following options and arguments:

           special        The file name of the special file containing the
                          file system.

           -F FStype      Specify the file system type on which to operate
                          (see fstyp(1M) and fs_wrapper(5)).  If this option
                          is not included on the command line, then the file
                          system type is determined from the file /etc/fstab
                          by matching special with an entry in that file.
                          If there is no entry in /etc/fstab, then the file
                          system type is determined from the file
                          /etc/default/fs.

           -o specific_options
                          Specify suboptions specific to each file system
                          type.  specific_options is a comma-separated list
                          of suboptions and/or keyword/attribute pairs
                          supported by the specific FStype.

           -V             Echo the completed command line, but perform no
                          other action.  The command line is generated by
                          incorporating the user-specified options and other
                          information derived from the /etc/fstab file.
                          This option allows the user to verify the command
                          line.

 EXAMPLES    [Toc]    [Back]
      Invoke the file system debugger on HFS file system /dev/dsk/c1d2s0:

           fsdb -F hfs /dev/dsk/c1d2s0





 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 fsdb(1M)                                                           fsdb(1M)




      Display a completed command line without executing the debugger:

           fsdb -V /dev/dsk/c1d2s0

      The previous command might display:

           fsdb -F hfs /dev/dsk/c1d2s0

 WARNINGS    [Toc]    [Back]
      Only experienced users should use fsdb.  The failure to fully
      understand the usage of fsdb and the file system's internal
      organization can lead to complete destruction of the file system and
      total loss of data.

 AUTHORS    [Toc]    [Back]
      fsdb was developed by HP and AT&T.

 FILES    [Toc]    [Back]
      /etc/default/fs          Specifies the default file system type
      /etc/fstab               Static information about the file systems

 SEE ALSO    [Toc]    [Back]
      fsck(1M), fsdb_hfs(1M), fsdb_vxfs(1M), fstyp(1M), stat(2),
      fs_wrapper(5).

 STANDARDS CONFORMANCE    [Toc]    [Back]
      fsdb: SVID3


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003