iofind(1M) iofind(1M)
NAME
iofind - find and convert ASCII files containing the legacy representation of device (special file name or hardware path)
SYNOPSIS
file] directory] filelist]
file] directory] filelist]
DESCRIPTION
The command helps users with the migration to the agile naming model (see intro(7)). First, identifies ASCII files on the system that con-
tain patterns representing legacy mass storage device special file names or hardware paths. Then replaces the matching patterns with their
mapping in the agile naming model inside the ASCII files.
NOTE: may take several minutes to execute depending on the number of files to be searched (see the 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, The increasing
size of this output file indicates that is making progress.
While executing, the command creates the following files in the and directories.
Files under the directory:
o contains the list of valid legacy device special file patterns to search for.
o contains the list of valid legacy hardware path patterns to search for.
o 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.
o 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.
o contains a list of files which match at least one of the device special file search patterns in
o contains a list of files which match at least one of the hardware path search patterns in
o contains the list of files to be searched.
o contains the command output summary, which is also displayed on the console during execution.
File under the directory:
o 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 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 file if you do not want iofind to skip any directories. By default, the following directories are repre-
sented 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/
/etc/opt/resmon/
/opt/ignite/boot/
/opt/hpsmh/
/opt/openssl/
/opt/ssh/
/opt/wbem/
/opt/atok/
/opt/X11/
/opt/java/
/opt/gnome
/opt/java
/opt/mozilla
/opt/wrkio
/opt/msscaf/
/opt/aCC/
/opt/sfmdb/
/usr/lib/
/usr/bin/
/usr/dt/
/usr/include/
/var/evm/
/var/stm/
/stand/
/tmp/
Files under the directory:
o These are backup copies of the original files, if any, before they get modified by the -R option. They are stored including their parent
directory. For instance, the file /usr/mydata will be saved under
Files under the directory:
o When option is used along with the original files are not actually modified, but a preview of the modified files, including their parent
directory, is made available under this preview directory.
If a user does not use the option to specify a file or files to search, the iofind command will search through directories, except those
indicated in the file, and it will skip files with the following file extensions:
.ttf
.gif
.jpg
.jar
.html
.img
.xml
.mof
.so.1
.so
.sdl
.png
.css
.tar
.gz
.zip
.1m
.pl
The option can be used to specify a list of patterns to be searched in ASCII files on the system. The patterns to be searched must be
entered in the input file, file, one per line. This input file must contain legacy device special files, legacy hardware paths, or a mix
of both. Device special file names must be fully qualified. For example, the full path must be used instead of
If is invoked with the option, and no input file is specified using the option, builds a list of legacy device special file patterns from
the data returned by the command.
If is invoked with the option, and no input file is specified using the option, builds a list of legacy hardware path patterns by calling
the command.
The and options can be used together to search both types of patterns.
If is invoked with the option, it replaces the matching patterns with their mapping in all ASCII files identified, unless the (preview)
option is specified. Before modifying the files, saves a copy of the original ASCII files in the directory. also asks for confirmation
before each change, unless the (force) option is used.
Options
recognizes the following options:
Specify the directory which contains the files to be searched.
If the option is not specified, then the current directory is used. All directories under the specified directory
are searched recursively.
Turn off interactive mode
(also known as the force option). This option must be used with the option. The user is not prompted to confirm the
replacement of a pattern before the pattern is replaced.
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 option, the user must also specify the or option.
Search ASCII files on the system for legacy hardware path patterns.
See "NOTE" in about displaying output to a file. If the option is not specified, first calls to generate a list of
hardware path patterns to be searched for. Otherwise, if the option is specified, searches the ASCII files for the
hardware path patterns defined in the file. Patterns are saved in the file.
Either the or option must be specified. Also, both options can be specified together.
Print the command usage.
When is invoked with no command line options, or with the option, it prints a usage message.
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 com-
mand line when using the option. Each file must be separated by a comma.
Search ASCII files on the system for legacy device special file patterns.
See "NOTE" in about displaying output to a file. If the option is not specified, first calls to generate a list of
device special file patterns to be searched for. Otherwise, if the option is specified, searches the ASCII files for
the devices special file patterns defined in the file. Patterns are saved in the file.
Either the or option must be specified. Also, both options can be specified together.
Preview, but do not replace, the selected patterns.
This option is only supported in combination with the option. When both the and options are specified, does not do
the actual replacement of matching patterns (see the option), but the replacement information will be created under
this directory:
Replace matching patterns with their mapping in the agile naming model.
If the option is used with the option, a preview of changes will be provided in the directory. If the option is used
without the option, asks the user for a confirmation before executing each replacement in the file. If used with the
option, the replacement is executed without asking the user for confirmation.
You must be superuser to execute the 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 directory.
RETURN VALUE
Exit values are:
Successful completion.
An error condition occurred.
EXAMPLES
Generate a list of searchable hardware paths on the system.
Generate a list of searchable hardware paths on the system. Redirect the output to a file and run as a background task.
Find all patterns matching the legacy hardware paths, 0/1/1/0.0.0 and 1/2/0/0.3.0, in the file. This file contains the strings,
0/1/1/0.0.0 and 1/2/0/0.3.0, one string per line.
Search all files under the current directory for matching hardware path patterns found in and preview the replacement of any matching pat-
terns without doing the actual replacement in the files.
Search all files under the current directory for matching device special file patterns found in and replace all matching patterns with
their mapping in the agile naming model. The format of the input file is one full path device special file, such as /dev/dsk/c1t3d0, per
line. Do not prompt the user for confirmation before each replacement.
Scan through all files under and its subdirectories to find all patterns matching the legacy hardware paths, 0/1/1/0.0.0 and 1/2/0/0.3.0,
in the file. This file contains the strings, 0/1/1/0.0.0 and 1/2/0/0.3.0, one string per line.
WARNINGS
The replace functionality needs appropriate permissions to make changes to the files to be modified.
SEE ALSO
ioscan(1M), intro(7).
iofind(1M)