HP-UX Reference (11i v3 07/02) - 1M System Administration Commands A-M (vol 3)

i
iofind(1M) iofind(1M)
NAME
iofind - find and convert ASCII files containing the legacy representation of device (special file name or
hardware path)
SYNOPSIS
/usr/sbin/iofind
-h
/usr/sbin/iofind
-H [-n][-f file ][
-d directory ][-i filelist ][-R [-p][-F]]
/usr/sbin/iofind
-n [-H][-f file ][
-d directory ][-i filelist ][-R [-p][-F]]
DESCRIPTION
The
iofind command helps users with the migration to the agile naming model (see intro(7)). First,
iofind identifies ASCII files on the system that contain patterns representing legacy mass storage device
special file names or hardware paths. Then
iofind replaces the matching patterns with their mapping in
the agile naming model inside the ASCII files.
NOTE:
iofind may take several minutes to execute depending on the number of files to be searched (see
the -d,-n,
-H options). If there are many files, the search will take a long time. An alternative is to
redirect the output to a file and run in background mode (for example,
iofind -H > outputfile
&
). The increasing size of this output file indicates that iofind is making progress.
While executing, the iofind command creates the following files in the
/var/adm/iofind/logs/
mmddyy_hhmm/, /var/adm/iofind/cfg/,
/var/adm/iofind/logs/
mmddyy_hhmm/backup/, and
/var/adm/iofind/logs/
mmddyy_hhmm/preview/ directories.
Files under the
/var/adm/iofind/logs/
mmddyy_hhmm/ directory:
•
pathDSFlist.txt contains the list of valid legacy device special file patterns to search for.
•
pathHWlist.txt contains the list of valid legacy hardware path patterns to search for.
•
DSFmapping.txt contains a colon separated list of all legacy device special files mapped to their
corresponding persistent device special files. The first field is the persistent device special file name and
the second field is the legacy name.
•
HWmapping.txt contains a colon separated list of all legacy hardware paths mapped to their
corresponding lun and lunpath hardware paths in the agile naming model. The first and second fields
are the lun and lunpath hardware paths, respectively, in the agile naming model. The third field is the
legacy path.
•
dsf_match_files.txt
contains a list of files which match at least one of the device special file
search patterns in
pathDSFlist.txt
.
•
hwpath_match_files.txt
contains a list of files which match at least one of the hardware path
search patterns in
pathHWlist.txt
.
•
search_file_list.txt
contains the list of files to be searched.
•
summary.txt contains the command output summary, which is also displayed on the console during
execution.
File under the /var/adm/iofind/cfg/ directory:
• iofind_exclude.cfg contains a list of directories to be excluded from the search. The purpose of
this file is to speed up the search by not searching directories indicated in this file. Running the iofind
command will create this file if it does not already exist. If a user provides the -i option, this file is not
used to exclude directories. A user can edit this file to add or delete any directories from the search.
Delete all the entries in the iofind_exclude.cfg file if you do not want iofind to skip any direc-
tories. By default, the following directories are represented in this file:
/var/adm/msgbuf/
/var/adm/iofind/
/var/adm/syslog/
/var/adm/crash/
/var/adm/userdb/
/var/opt/ignite/
/usr/share/lib/
/usr/share/man/
/var/spool/
366 Hewlett-Packard Company − 1 − HP-UX 11i Version 3: February 2007