Open System Services Shell and Utilities Reference Manual (G06.29+, H06.08+, J06.03+)

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.
For the H06.23 or J06.12 RVUs, or systems that have installed SPR T8626H03_ADE, pinstall
assigns a permission of 0755 to the intermediate directories it creates. For the H06.24 or later
H-series RVUs, or J06.13 or later J-series RVUs, or systems that have installed SPR
T8626H03_ADF or later, pinstall creates intermediate directories with access permissions set as
the bitwise inclusive OR of the values of S_IRWXU, S_IRWXG, and S_IRWXO. The access
permissions are set using the Guardian DEFINE =OSSˆUMASK.IfDEFINE =OSSˆUMASK is
not set or invalid, pinstall assumes the default value of 022.
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,pat hname
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.
527188-021 Hewlett-Packard Company 7−25