Open System Services Shell and Utilities Reference Manual (G06.28+, H06.05+)
User Commands (p - r) pinstall(1)
-W [wait | nowait]
Specifies which of the following the pinstall command is to do if a tape is not mounted
on the tape drive or the tape drive goes off line:
• Issue a prompt and wait for a tape to be mounted
• Exit immediately, without waiting
The default action is -W wait.
DESCRIPTION
The pinstall command invokes a Guardian process that copies archived files such as OSS utili-
ties to the OSS file system. The pinstall command reads ustar data interchange format files,
such as archive files that are created by the pax utility. pinstall can only read from an archive; it
cannot create an archive.
The name of the archive is specified by the archive argument of the -f flag. If the archive argu-
ment is a tape device, pinstall reads from the archive tapes that are mounted on the tape device.
If the -r flag is not specified, the names of all members of the archive file are listed to the output
file or to the process’s controlling terminal; no files are extracted.
The root directory must exist and be mounted when pinstall is invoked.
The -s flag defines where extracted files are to be stored in the OSS file system. Without the -s
flag, the files could be stored to the current file system, which could be the Guardian file system.
pinstall also issues tape mount messages and checks the tape drive to make sure that the correct
tapes are mounted before proceeding. (See the pax(1) reference page for mount messages and
possible diagnostic messages.)
Operands
pattern Specifies the pathnames for one or more archive members to be copied or listed. If no
pattern is specified, the default action is to select all archive members.
Standard Input
The standard input file is specified by the archive argument of the -f flag.
Input Files
The input file is specified by the archive argument of the -f flag. If the input file maps to a disk
file, then it must be written in ustar archive format. If the input file maps to a tape device, then
the tape mounted on the tape device must be written in ustar archive format.
Standard Output
The table of contents of the archive members is written to the standard output file as:
%s,pathname
If the -v flag is also specified, the output has the following format:
%s,-ls_-l_listing
where ls_-l_listing is the format used by the ls command with the -l flag specified.
Output Files
Extracted files are copied to the OSS file system.
527188-007 Hewlett-Packard Company 7−25