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

i
iofind(1M) iofind(1M)
If iofind is invoked with the -H
option, and no input file is specified using the -f option, iofind
builds
a list of legacy hardware path patterns by calling the
ioscan command.
The
-H and -n options can be used together to search both types of patterns.
If iofind is invoked with the -R
option, it replaces the matching patterns with their mapping in all
ASCII files identified, unless the
-p (preview) option is specified. Before modifying the files, iofind
saves a copy of the original ASCII files in the
/var/adm/iofind/logs/
mmddyy_hhmm/backup/
directory. iofind also asks for confirmation before each change, unless the
-F (force) option is used.
Options
iofind recognizes the following options:
-d directory Specify the directory which contains the files to be searched. If the
-d option is not
specified, then the current directory is used. All directories under the specified direc-
tory are searched recursively.
-F Turn off interactive mode (also known as the force option). This option must be used
with the
-R option. The user is not prompted to confirm the replacement of a pattern
before the pattern is replaced.
-f file Specify a list of patterns in the input file to search for. The format of the input file is
one device special file or hardware path, per line. When an input file is provided using
the -f option, the user must also specify the -n or -H option.
-H Search ASCII files on the system for legacy hardware path patterns. See "NOTE" in
DESCRIPTION about displaying output to a file. If the -f option is not specified,
iofind first calls ioscan -fnk to generate a list of hardware path patterns to be
searched for. Otherwise, if the -f option is specified, iofind searches the ASCII
files for the hardware path patterns defined in the file. Patterns are saved in the
pathHWlist.txt file.
Either the
-H or -n option must be specified. Also, both options can be specified
together.
-h Print the command usage. When iofind is invoked with no command line options,
or with the -h option, it prints a usage message.
-i filelist Provide a list of files under the specified directory, for which to search for legacy dev-
ice special files and hardware paths. The user may list as many files as needed on the
command line when using the -i option. Each file must be separated by a comma.
-n Search ASCII files on the system for legacy device special file patterns. See "NOTE"
in DESCRIPTION about displaying output to a file. If the -f option is not specified,
iofind first calls ioscan -fnk to generate a list of device special file patterns to
be searched for. Otherwise, if the -f option is specified, iofind searches the ASCII
files for the devices special file patterns defined in the file. Patterns are saved in the
pathDSFlist.txt file.
Either the
-H or -n option must be specified. Also, both options can be specified
together.
-p Preview, but do not replace, the selected patterns. This option is only supported in
combination with the -R option. When both the -p and -R options are specified,
iofind does not do the actual replacement of matching patterns (see the -R option),
but the replacement information will be created under this directory:
/var/adm/iofind/logs/mmddyy_hhmm/preview/
-R
Replace matching patterns with their mapping in the agile naming model. If the -R
option is used with the -p option, a preview of changes will be provided in the
/var/adm/iofind/logs/mmddyy_hhmm/preview/ directory. If the -R
option is used without the -F option, iofind asks the user for a confirmation before
executing each replacement in the file. If used with the -F option, the replacement is
executed without asking the user for confirmation.
You must be superuser to execute the -R option. You do not have to be superuser to
execute the other options.
All files modified by this command are first backed up in the
/var/adm/iofind/logs/mmddyy_hhmm/backup/ directory.
368 Hewlett-Packard Company − 3 − HP-UX 11i Version 3: February 2007