Open System Services Shell and Utilities Reference Manual (G06.27+, H06.04+)
pinstall(1) OSS Shell and Utilities Reference Manual
Multiple -p flags are allowed in one command. If an option in string duplicates or
conflicts with another option in string, the option given last takes precedence.
If neither the e nor the o option is specified in string, or if the user ID and group ID are
not retained, the S_ISUID and S_ISGID bits of the access permission are not set for
the extracted archive members. If the retention of any of these items fails, pinstall
writes a diagnostic message to the standard error file. Failure to retain any of the items
affects the exit value but does not cause the extracted file to be deleted.
File mode bits cannot be preserved if the target is a Guardian file. The user’s default
Guardian file permissions or the existing Guardian file permissions are used instead.
-r Reads an archive file. -r is required if the archive members are to be restored to the
OSS file system.
-s replstr Modifies archive-member names specified by the pattern operand according to the sub-
stitution expression replstr and using the syntax of the ed command. The substitution
expression has the following format:
-s /old/new/ [gp]
where (as in the ed command) old is a basic regular expression and new is the replace-
ment string to be inserted in place of strings that match the regular expression. The
string new can contain an & (ampersand), \n (where n is a digit), back references, or
subexpression matching. A g following new/ replaces all matches. A p following new/
causes successful substitutions to be written to the standard error file.
Multiple -s flags can be specified in one command. Multiple expressions are applied in
the specified order, terminating with the first successful substitution. Archive-member
names that are replaced by an empty string are ignored.
-u Ignores files that are older (that have a less recent file modification time) than archive
members with the same names. An archive member with the same name as a file in the
file system is extracted if the archive member is newer than the file.
-v In list mode, produces a table of contents (see Standard Outputunder DESCRIP-
TION). Otherwise, -v writes the archive member pathnames to the standard error file
(see Standard Error under DESCRIPTION).
-W clobber
Allows the matching files from an archive to be restored to a Guardian target and to
overwrite any existing Guardian target file with the same name. The files are restored
as unstructured files, and Guardian file attributes are not preserved. Be sure you under-
stand the problems this flag can create (refer to the subsection Guardian Filename
Transformation in the pax(1) reference page) before using this flag.
-W norewind
Specifies that the tape be left on the tape drive without being rewound and unloaded
after pinstall has finished reading from it. The tape drive is closed. The default action
is for the tape to be rewound. The -W nounload flag is assumed when the -W
norewind flag is specified. The -W unload and -W norewind flags cannot be
specified together.
-W [unload | nounload]
Specifies whether the tape is to be unloaded or left on the tape drive after it has been
rewound. The default action is -W unload.
7−24 Hewlett-Packard Company 527188-004