pax.1 (2010 09)

p
pax(1) pax(1)
consists of a dot, the file or archive member is processed with no modification to its name.
Otherwise, its name is replaced with the contents of the line. The
pax command
immediately exits with a nonzero exit status if an End-of-File is encountered when read-
ing a response or if it cannot read or write to the terminal.
-k Prevents the
pax command from writing over existing files.
-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
writing 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 port-
able filename as described in the Base Definitions volume of IEEE Std 1003.1-2001, Sec-
tion 3.276, Portable 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 ear-
lier shall be silently ignored. Also, if the value specified for a keyword is invalid,
pax
shall print a suitable 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 match-
ing 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 Matching a Single Character and Patterns Matching Multiple Charac-
ters . 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 multi-
ple
-o delete=pattern options are specified, the patterns shall be additive; all
keywords matching the specified string patterns shall be omitted from extended
header records that pax produces.
exclude=path
(Applicable only to the -x pax format.) path specifies a file or a directory to be
HP-UX 11i Version 3: September 2010 − 3 − Hewlett-Packard Company 3