HP-UX Reference (11i v2 07/12) - 1 User Commands N-Z (vol 2)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

141

142

143

144

145

146

147

148

149

150

pax(1) pax(1)

The extracted ﬁles are created relative to the current ﬁle hierarchy. The

-r ﬂag can be speciﬁed with the

-c, -d, -f, -n,

-s, and -v ﬂags, and a pattern argument.

The access and modiﬁcation times of the extracted ﬁles are the same as the archived ﬁles. The access per-

missions of the extracted ﬁles remain as archived unless affected by the user’s default ﬁle creation mode.

The

S_ISUID and S_ISGID bits of the extracted ﬁles are cleared.

If intermediate directories are necessary to extract an archive member, the

pax command creates the

directories with access permissions set as the bitwise inclusive OR of the values of the

S_IRWXU,

S_IRWXG, and S_IRWXO options.

If the selected archive format supports the speciﬁcation of linked ﬁles (both the

tar and cpio formats

do), it is an error if these ﬁles cannot be linked when the archive is extracted.

pax informs you of the

error and continues processing.

Writing Archive Files

When the

-w ﬂag is speciﬁed and the

-r ﬂag is not, the pax command writes the contents of the ﬁles

speciﬁed by the ﬁle arguments to the standard output in an archive format. If no ﬁle arguments are

speciﬁed, a list of ﬁles to copy, one per line, is read from the standard input. When the ﬁle argument

speciﬁes a directory, all of the ﬁles contained in the directory are written. The

-w ﬂag can be speciﬁed with

the

-b, -d, -f, -i, -s, -t, -u, -v,

-x, and -X ﬂags and with ﬁle arguments.

-w is speciﬁed, but no ﬁles are speciﬁed, standard input is used. If neither

-f or -w are speciﬁed,

standard input must be an archive ﬁle.

Copying Files

When both the

-r and -w ﬂags are speciﬁed, the pax command copies the ﬁles speciﬁed by the ﬁle argu-

ments to the destination directory speciﬁed by the directory argument. If no ﬁle arguments are speciﬁed, a

list of ﬁles to copy, one per line, is read from the standard input. If a speciﬁed ﬁle is a directory, the ﬁle

hierarchy contained in the directory is also copied. The

-r and -w ﬂags can be speciﬁed with the

-d, -i,

-k, -l, -p, -n, -s, -t, -u, -v, and

-X ﬂags and with the ﬁle arguments. A directory argument must be

speciﬁed.

Copied ﬁles are the same as if they were written to an archive ﬁle and subsequently extracted, except that

there may be hard links between the original and the copied ﬁles.

RETURN VALUE

The

pax command returns a value of 0 (zero) if all ﬁles 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/rmt/0m .

To copy the olddir directory hierarchy to newdir enter:

mkdir newdir

cd olddir

pax -rw olddir newdir

To read the archive a.pax, with all ﬁles rooted in the directory /usr in the archive extracted relative to

the current directory, enter:

pax -r -s ’,//*usr//*,,’ -f a.pax

All of the preceding examples create archives in tar format.

The following pairs of commands demonstrate conversions from cpio and tar to pax. In all cases, the

examples show comparable command-line usage rather than identical output formats. The -x ﬂag can be

speciﬁed to the pax commands shown here, producing archives to select speciﬁc output formats:

ls * | cpio -ocv

pax -wdv *

find /mydir -type f -print | cpio -oc

find /mydir -type f -print | pax -w

cpio -icdum < archive

pax -r < archive

146 Hewlett-Packard Company − 4 − HP-UX 11i Version 2: December 2007 Update