iofind.1m (2010 09)

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_hhmmss
/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
directory 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
device 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. Pat-
terns 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_hhmmss
/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_hhmmss/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.
HP-UX 11i Version 3: September 2010 − 3 − Hewlett-Packard Company 3