pax.1 (2011 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

pax(1) pax(1)

NAME

pax - extracts, writes, and lists archive ﬁles; copies ﬁles and directory hierarchies

SYNOPSIS

Listing Member Files of Archived Files

pax [-cdnv][-H|

-L][-A][-f archive ][-o options ]... [-s replstr ]... [pattern ]...

Extracting Archive Files

pax -r [-cdiknuvy][-H|

-L][-A][-f archive ][-o options ]... [-p string ]...

[

-s replstr ]... [pattern ]...

Writing Archive Files

pax -w [-adituvXy][-H

|-L][-A][-b blocking ][-f archive ][-o options ]... [

-s replstr ]...

[

-x format ][ﬁle ]...

Copying Files

pax -r -w [-diklntuvXy][-H

|-L][-A][-o options ]... [-p string ]... [-s replstr ]...

[ﬁle]... directory

DESCRIPTION

The

pax command extracts and writes member ﬁles of archive ﬁles; writes lists of the member ﬁles of

archives; and copies directory hierarchies. The -r and -w ﬂags specify the archive operation performed

by the pax command.

The pattern argument speciﬁes a pattern that matches one or more paths of archive members. A

(backslash) character is not recognized in the pattern argument and it prevents the subsequent character

from having any special meaning. If no pattern argument is speciﬁed, all members are selected in the

archive.

If a pattern argument is speciﬁed, but no archive members are found that match the pattern speciﬁed, the

pax command detects the error, exits with a nonzero exit status, and writes a diagnostic message.

The

pax command can read both tar and cpio archives. In the case of cpio, this means that

pax

can read ASCII archives (which are created with cpio -c) and binary archives (which are created

without the -c ﬂag).

pax can also write archives that tar and cpio can read; by default, pax writes archives in the

ustar

extended tar interchange format. pax also writes ASCII cpio archives; use the -x cpio ﬂag to

specify this extended cpio output format.

pax also reads and writes archives in the pax interchange format, IEEE Std 1003.1, 2003 Edition. Use

the -x pax ﬂag to specify this format. Refer to the description of the -x format

option for more

details.

The supported archive formats are automatically detected on input. All three formats are explained in

greater detail under EXTENDED DESCRIPTION.

The four combinations of

-r and -w are referred to as the four modes of operation: list, read, write,

and copy modes, corresponding respectively to the four forms shown in the SYNOPSIS section.

list In list mode (when neither -r nor -w are speciﬁed), pax shall write the names of the

members of the archive ﬁle read from the standard input, with pathnames matching the

speciﬁed patterns, to standard output. If a named ﬁle is of type directory, the ﬁle hierarchy

rooted at that ﬁle shall be listed as well.

read In read mode (when -r is speciﬁed, but -w is not), pax shall extract the members of the

archive ﬁle read from the standard input, with pathnames matching the speciﬁed patterns. If an

extracted ﬁle is of type directory, the ﬁle hierarchy rooted at that ﬁle shall be extracted as well.

The extracted ﬁles shall be created performing pathname resolution with the directory in which

pax was invoked as the current working directory.

If an attempt is made to extract a directory when the directory already exists, this shall not be

considered an error. If an attempt is made to extract a FIFO when the FIFO already exists, this

shall not be considered an error.

write In write mode (when -w is speciﬁed, but -r is not), pax shall write the contents of the ﬁle

operands to the standard output in an archive format. If no ﬁle operands are speciﬁed, a list of

ﬁles to copy, one per line, shall be read from the standard input. A ﬁle of type directory shall

HP-UX 11i Version 3: September 2011 − 1 − Hewlett-Packard Company 1

Summary of content (14 pages)

PAGE 1
pax(1) pax(1) NAME pax - extracts, writes, and lists archive files; copies files and directory hierarchies SYNOPSIS Listing Member Files of Archived Files pax [-cdnv] [-H|-L] [-A] [-f archive ] [-o options ]... [-s replstr ]... [pattern ]... Extracting Archive Files pax -r [-cdiknuvy] [-H|-L] [-A] [-f archive ] [-o options ]... [-p string ]... [-s replstr ]... [pattern ]... Writing Archive Files pax -w [-adituvXy] [-H|-L] [-A] [-b blocking ] [-f archive ] [-o options ]... [-s replstr ]...
PAGE 2
pax(1) pax(1) include all of the files in the file hierarchy rooted at the file. copy In copy mode (when both -r and -w are specified), pax shall copy the file operands to the destination directory. If no file operands are specified, a list of files to copy, one per line, shall be read from the standard input. A file of type directory shall include all of the files in the file hierarchy rooted at the file.
PAGE 3
pax(1) pax(1) 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 reading 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 established between the source and destination file hierarchies whenever possible.
PAGE 4
pax(1) pax(1) part of the tree. Otherwise, the specified path will be ignored. The PAX-ENH product must be installed to enable this option. 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 .
PAGE 5
pax(1) pax(1) rename In read or copy mode, pax shall act as if the -i option were in effect for each file with invalid filename or link name values, allowing the user to provide a replacement name interactively. write In read or copy mode, pax shall write the file, translating the name regardless of whether this may overwrite an existing file with a valid name. This action argument is not supported for files having invalid link names.
PAGE 6
pax(1) pax(1) m Does not retain file-modification times. o Retains the user ID and the group ID. p Retains the access permission. Note that "retain" means that an attribute stored in the archive is given to the extracted file, subject to the permissions of the invoking process; otherwise, the attribute is determined as part of the normal file creation action.
PAGE 7
pax(1) pax(1) characters, pathname longer than 256 characters or link name longer than 100 characters. Archives of this format are reported as "USTAR format archive extended" in the read and list mode when the -v (verbose) flag is specified in the command line. ustar Extended tar interchange format. This is the default output archive format. The default blocking value for this format for character special archive files is 10240. Blocking values from 512 to 32,256 in increments of 512 are supported.
PAGE 8
pax(1) pax(1) Copying Files The -r and -w flags can be specified with the -H or -L, -d, -i, -k, -l, -o, -p, -n, -s, -t, -u, -v, and -X flags and with the file arguments. A directory argument must be specified. List Mode Format Specifications In list mode with the -o listopt= format option, the format argument shall be applied for each selected file. The pax utility shall append a newline to the listopt output for each selected file.
PAGE 9
pax(1) pax(1) c_mode Contains the file type and access permissions. c_uid Contains the user ID of the owner of the file. c_gid Contains the group ID of the group owner of the file. c_nlink Contains the number links of the file. c_rdev Contains information for character or block special files. c_mtime Contains the latest time of modification of the file at the time the archive was created. c_namesize Contains the length of the pathname, including the terminating NULL character.
PAGE 10
pax(1) pax(1) linkname The linkname is the pathname of the target of a symbolic or hard link. It is limited to 100 characters. If the name does not fit in the space provided, pax shall notify the user of the error, and shall not attempt to store the link on the medium. devmajor,devminor When the typeflag field contains ’3’ or ’4’ the devmajor and devminor fields shall contain the major and minor numbers of the device respectively.
PAGE 11
pax(1) pax(1) An extended header shall consist of one or more records, each constructed as follows: %d %s=%s\n,length,keyword,value The keyword field shall be one of the entries from the following list. A keyword shall not include an equals sign. In the following list, the notations "file(s)" or "block(s)" are used to acknowledge that a keyword affects the following single file after a typeflag x extended header, but possibly multiple files after typeflag g.
PAGE 12
pax(1) pax(1) specified while creating the archive, the HFS file has optional ACL entries and the ACL entries are good. security.aclv Indicates that the optional ACL entry for the file has been backed up for JFS files and its value will be equal to 1. This record is written to the extended header if -A option is specified while creating the archive, the JFS file has optional ACL entries and the ACL entries are good. security.
PAGE 13
pax(1) pax(1) RETURN VALUE The pax command returns a value of 0 (zero) if all files were successfully processed; otherwise, pax returns a value greater than 0 (zero). EXAMPLES To copy the contents of the current directory to the tape drive, enter: pax -w -f /dev/rtape/tape4QIC150 . To copy the olddir directory hierarchy to newdir enter: mkdir newdir pax -rw olddir newdir To read the archive a.
PAGE 14
(Notes) A (Notes) pA 14 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2011