iofind(1M)iofind(1M)NAMEiofind - find and convert ASCII files containing the legacy representa‐
tion 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:
· contains the list of valid legacy device special file patterns to
search for.
· contains the list of valid legacy hardware path patterns to search
for.
· 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 sec‐
ond field is the legacy name.
· 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.
· contains a list of files which match at least one of the device spe‐
cial file search patterns in
· contains a list of files which match at least one of the hardware
path search patterns in
· contains the list of files to be searched.
· contains the command output summary, which is also displayed on the
console during execution.
File under the directory:
· 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:
· These are backup copies of the original files, if any, before they
get modified by the -R option. They are stored including their par‐
ent directory. For instance, the file /usr/mydata will be saved
under
Files under the directory:
· When option is used along with the original files are not actually
modified, but a preview of the modified files, including their par‐
ent 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 indi‐
cated 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 spe‐
cial 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 pat‐
terns.
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 speci‐
fied, 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 command 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 speci‐
fied, 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 ask‐
ing 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 patterns
without doing the actual replacement in the files.
Search all files under the current directory for matching device spe‐
cial 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 pat‐
terns 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 ALSOioscan(1M), intro(7).
iofind(1M)