showfiles(1M)showfiles(1M)NAMEshowfiles - show files belonging to installed products
SYNOPSISshowfiles [ -BCFHLMSUabcilmostux ] [ -r target ] [ -f distribution ]
[ product ... ] [ -- file ... ]
DESCRIPTIONshowfiles is a tool used to list files belonging to installed software
products. The -f option can be used to list files in a software
distribution packaged in the inst(1M) archive format.
Current command-line options are:
product
List only files belonging to the given product(s).
-- file
List only files matching the specified file expression(s), which
must follow the -- argument. Filename expressions are those
described in regexp(5), with special treatment of the asterisk * and
period . characters. Unless preceded by a backslash \, an asterisk
matches any sequence of zero or more characters, and a period
matches only a period.
-A Print absolute pathnames, including the effective root directory.
-B Show only "bad" files (files on disk are missing or unreadable).
(This is normally only useful when run as root, since files with
inadequate read permission show up as unreadable.)
-C Show in simplified "config file" format, which includes modification
information as well as the filename.
-D Downgrade the history file to the earliest patch compatible history
file format.
-E Enables the inst_terse_mode preference, but has no effect on
showfiles. Provided only for compatibility with inst(1M) and
showprods(1M).
-F Filter mode -- rather than checking all files in the history,
instead, check filenames read off of standard input. This is
intended for use in commands of the type find | showfiles-F
[option-list]. This option is slow because it requires building a
table of information about all installed files on the system. When
using this option in conjunction with the -r option, all input file
pathnames passed via standard input must be prefixed with the path
passed to the -r option.
Page 1
showfiles(1M)showfiles(1M)-H Show only installed files that have an associated .O or .N .
-M Don't use the built-in pager.
-U Upgrade the history file to the latest known format.
-V preference:value
Set an inst/swmgr preference to a given value.
-a AND operator -- -option1 -a option2 searches for files that satisfy
both conditions. This is the default (-option1 -option2 is the same
as saying -option1 -a option2).
-b Display sizes in blocks instead of the default bytes.
-c Show only config files.
-f distribution
Show files on a distribution. Currently this prints out files only
in idb format:
- File type (see long format below).
- Mode (see chmod(1)).
- Owner.
- Group.
- Pathname of the installed file.
- Source pathname (this field should usually be ignored by the
user).
- Subsystem that owns the file.
- Miscellaneous file attributes: checksum, size, compressed size,
associated pre, post and exitops, etc.
-i Show only installed files (the default), as opposed to user files
(files that weren't created by inst/swmgr).
-k Do checksums for user files.
-l List in long format (the default). Long format includes the
following fields, in order:
- File type: file, link, directory, block special, character
special, Fifo, or ? (unknown).
- Checksum.
- Size in blocks.
- Name of subsystem owning this file.
- Whether the file is a configuration file or a machine-dependent
file.
- Pathname of file.
Page 2
showfiles(1M)showfiles(1M)-m Show only modified files (files that differ in size or checksum from
the file that was installed). This requires checksumming each file,
so listing the -m late in the list of arguments is preferable from a
performance standpoint.
-n Show only files that were installed from an overlay product and did
not have a counterpart file in the base product. These are new
files introduced in the overlay.
-o OR operator -- -option1 -o -option2 shows files that match either
option1 or option2.
-r target
Set the effective root directory from which the installation
database will be read. By default, this is /.
-s View in short mode -- show only filenames, no other information.
-t Test configuration mode -- exit with status 0 as soon as a file is
found that matches the given conditions, otherwise exit with status
1. The file $rbase/var/inst/.config_changed is used to accelerate
this in the case of showfiles-t -c -H (equivalent to versions -t
changed): the presence of this file (created by inst or swmgr)
indicates that there may be changed configuration files present on
the system. If this file is absent, it means that a previous run of
showfiles-tcH determined that there were no changed configuration
files present, and removed .config_changed.
-u Show only unmodified files.
-w Show only files that were installed from an overlay product.
-x Extract files from the distribution into the target. This option
can be useful in conjunction with -- file to extract particular
files. A distribution must also be specified using the -f option.
Files are extracted into the current working directory, unless the
-r target option is also specified, in which case files are written
into their normal location relative to the root directory of the
target. Normally inst(1M) or swmgr(1M) should be used to install
software components, since showfiles-x does not update the
installation history database, execute auxiliary installation
commands such as exitops, install symbolic links, preserve modified
configuration files, or perform rqs(1) processing.
! Negate the option that follows, for example, showfiles ! -m is the
same as showfiles-u.
EXAMPLES
1. To find all files that are changed config files (files with .N or
.O) and print them in "config mode" (same as versions changed):
Page 3
showfiles(1M)showfiles(1M)showfiles-c -C -H
2. To find all files that are changed config files (files with .N or
.O) OR files (config or otherwise) that have been modified since
installation:
showfiles-c -H -o -m
3. To find out which product on the current system or on a specified
distribution owns the file called filename:
showfiles-l [ -f distribution ] | grep filename
The output consists of zero or more "long format" lines containing
the information that is known about the file; see the description of
-l (long format) above.
SEE ALSOinst(1M), showprods(1M), swmgr(1M), versions(1M).
IRIX Admin: Software Installation and Licensing
Page 4
