Mac OS X Panther in a Nutshell, 2nd Edition

Name

tar

Synopsis

tar [options] [tarfile] [other_files]

Copies files to or restores files from an archive medium. If any files are directories, tar acts on the entire subtree. Options need not be preceded by a dash (-, although they may be). Note that until native drivers for tape drives exist for Mac OS X, tar can’t write to tape. Note also that tar doesn’t preserve resource forks or metadata when copying files that contain them.

Function options

You must use exactly one of these, and it must come before any other options:

-c

Create a new archive.

-r, u

Append other_files to the end of an existing archive.

-t

Print the names of other_files if they are stored on the archive (if other_files aren’t specified, print names of all files).

x

Extract other_files from an archive (if other_files aren’t specified, extract all files).

Options

-b

Set block size to 512 bytes.

-e

If there is an error, stop.

-f arch

Store files in or extract files from archive arch. The default is /dev/rst0. Because Mac OS X has no native tape drive support, tar produces an error unless the -f option is used.

-h

Dereference symbolic links.

-m

Don’t restore file modification times; update them to the time of extraction.

-O

Create non-POSIX archives.

-o

Don’t create archives with directory information that v7 tar can’t decode.

-p

Keep ownership of extracted files the same as that of original permissions.

-s regex

Using ed-style regular expressions, change filenames in the archive.

-v

Verbose; print filenames as ...