showfiles(1M) showfiles(1M) NAME showfiles - show files belonging to installed products SYNOPSIS showfiles [ -BCFHLMSUabcilmostux ] [ -r target ] [ -f distribution ] [ product ... ] [ -- file ... ] DESCRIPTION showfiles 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. -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. -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): 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 ALSO inst(1M), showprods(1M), swmgr(1M), versions(1M). IRIX Admin: Software Installation and Licensing Page 4