NAME

ofind − optical file system search

SYNOPSIS

ofind [−rs] [−b size] [−f size] [−l length] [−q quota] od [filename ...]

DESCRIPTION

ofind examines an optical file system to locate missing files and inspect earlier generations of files.  The file system od is a character-special device node referencing the od device driver or an ordinary file containing an optical file system. 

If any filenames are specified, ofind traverses the entire optical file system tree, inspecting previous generations of any directories encountered, and presents on its standard output all the file index numbers found associated with each filename. If no filename is specified, ofind interactively accepts a file index number (and optional generation level and depth) from its standard input and presents information about the corresponding file on its standard output.  If file index number zero is entered, the generation level and depth are assumed to represent an absolute block number and block count, and the corresponding blocks are presented in both hexadecimal and text format. 

OPTIONS

−b The following value is the logical block size in bytes.  This number must be a power of two not less than 256.  The true block size is sensed automatically whenever an optical volume is accessed, so this option is used only for testing.  The default block size is 512 bytes. 

−f Emulate an optical file system in an ordinary file.  The following value specifies the size of the file in megabytes.  od selects the file to be used, which must already exist.  The default file size is 1 megabyte. 

−l The following value is the file buffer length in blocks.  To optimize access latency, physical data transfers from the optical storage media are accumulated and performed several blocks at a time.  This parameter may be varied to take optimal advantage of the characteristics of various optical disk drives.  The default buffer length is 96 kilobytes. 

−q The following value is the maximum number of contiguous errors accepted without producing a fatal I/O fault.  If this value is zero, no error quota is imposed.  The default error quota is 24. 

−r Raw — Do not read the volume index map.  If this option is specified, ofind will be unable to navigate the file structure on the volume, so its only practical use is in direct interactive inspection by physical block number. 

−s Slow — Examine every file index record while accessing a file system.  The normal fast sequence locates file index records using an index map.  If any record cannot be read, the corresponding file cannot be accessed.  Using the slow option allows an earlier version of such an index record to be identified. 

EXAMPLES

To inspect an optical file system: ofind /dev/od0

To locate a missing optical file: ofind /dev/od0 file

FILES

/ofs/#<volume> optical disk volume index map. 

/ofs/$<volume> optical disk volume index cache. 

SEE ALSO

ofs(4), ofsd(8)

  —  30 June 1992