*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> showfiles (1)              


showfiles(1M)							 showfiles(1M)

NAME    [Toc]    [Back]

     showfiles - show files belonging to installed products

SYNOPSIS    [Toc]    [Back]

     showfiles [ -BCFHLMSUabcilmostux ]	[ -r target ] [	-f distribution	]
	  [ product ...	] [ -- file ...	]

DESCRIPTION    [Toc]    [Back]

     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:

	  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

     -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
	  -  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
	  -  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    [Toc]    [Back]

     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

	       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    [Toc]    [Back]

     inst(1M), showprods(1M), swmgr(1M), versions(1M).

     IRIX Admin: Software Installation and Licensing

									PPPPaaaaggggeeee 4444
[ Back ]
 Similar pages
Name OS Title
showprods IRIX show products installed on system
kmknod Tru64 Creates device special files for static kernel layered products
swinstall HP-UX install and configure software products; software products for subsequent installation or distribution; respec
swcopy HP-UX install and configure software products; software products for subsequent installation or distribution; respec
acl_add_perm Tru64 Adds a permission to a set of permissions belonging to an ACL entry
swverify HP-UX verify software products
tt_ptype_exists HP-UX indicate whether a ptype is already installed
acl_delete_perm Tru64 Delete permissions from a set of permissions belonging to an ACL entry
swlist HP-UX display information about software products
swremove HP-UX unconfigure and remove software products
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service