HP-UX Reference (11i v3 07/02) - 1 User Commands N-Z (vol 2)
p
pax(1) pax(1)
-l Links files when copying files. When both
-r and -w are specified, hard links are esta-
blished between the source and destination file hierarchies whenever possible.
-L If a symbolic link referencing a file of type directory is specified on the command line or
encountered during the traversal of a file hierarchy,
pax shall archive the file hierarchy
rooted in the file referenced by the link, using the name of the link as the root of the file
hierarchy. Otherwise, if a symbolic link referencing a file of any other file type which
pax
can normally archive is specified on the command line or encountered during the traversal
of a file hierarchy,
pax shall archive the file referenced by the link, using the name of the
link. The default behavior shall be to archive the symbolic link itself.
-n Selects the first archive member that matches each pattern argument. No more than one
archive member is matched for each pattern (although members of type directory will still
match the file hierarchy rooted at that file).
-o options Provides information to the implementation to modify the algorithm for extracting or writ-
ing files. The value of options shall consist of one or more comma-separated keywords of the
form:
keyword[[:]=value][,keyword[[:]=value,]...]
Some keywords apply only to certain file formats, as indicated with each description. Use of
keywords that are inapplicable to the file format being processed causes
pax to print an
error message and ignore the keyword. However pax will continue processing the archive.
Keywords in the options argument shall be a string that would be a valid portable filename
as described in the Base Definitions volume of IEEE Std 1003.1-2001, Section 3.276, Port-
able Filename Character Set.
Note: Keywords are not expected to be filenames, merely to follow the same character
composition rules as portable filenames.
The value field shall consist of zero or more characters; within value, the application shall
precede any literal comma with a backslash, which shall be ignored, but preserves the
comma as part of value. A comma as the final character, or a comma followed solely by
white space as the final characters, in options shall be ignored. Multiple -o options can be
specified; if keywords given to these multiple -o options conflict, the keywords and values
appearing later in command line sequence shall take precedence and the earlier shall be
silently ignored. Also, if the value specified for a keyword is invalid, pax shall print a suit-
able error message and behave as if the keyword were not specified in the command line.
The following keyword values of options shall be supported for the file formats as indicated:
delete=pattern
(Applicable only to the -x pax format.) When used in write or copy mode, pax
shall omit from extended header records that it produces any keywords matching the
string pattern. When used in read or list mode, pax shall ignore any keywords
matching the string pattern in the extended header records. In both cases, matching
shall be performed using the pattern matching notation described in Patterns Match-
ing a Single Character and Patterns Matching Multiple Characters. For example, the
following pattern:
-o delete=[ug]name
would suppress user and group name keywords in the extended header.
See pax Extended Header for extended header record keyword usage. When multiple
-o delete=pattern options are specified, the patterns shall be additive; all key-
words matching the specified string patterns shall be omitted from extended header
records that pax produces.
exthdr.name= string
(Applicable only to the -x pax format.) This keyword allows user control over the
name that is written into the ustar header blocks for the extended header produced
under the circumstances described in pax Header Block. The name shall be the con-
tents of string, after the following character substitutions have been made:
%d The directory name of the file, equivalent to the result of the dirname utility on
the translated pathname.
HP-UX 11i Version 3: February 2007 − 3 − Hewlett-Packard Company 107