manual page distributed with 4.2BSD

SCCS-vsn: old/tar/tar.1 5.1

diff --git a/usr/src/old/tar/tar.1 b/usr/src/old/tar/tar.1
index 747e4d4..3ef60c4 100644 (file)
--- a/usr/src/old/tar/tar.1
+++ b/usr/src/old/tar/tar.1
@@ -1,6 +1,6 @@
-.\"    @(#)tar.1       4.1 (Berkeley) %G%
+.\"    @(#)tar.1       5.1 (Berkeley) %G%

 .\"
 .\"

-.TH TAR 1 4/1/81
+.TH TAR 1 "13 January 1983"

 .AT 3
 .SH NAME
 tar \- tape archiver
 .AT 3
 .SH NAME
 tar \- tape archiver


@@ -10,151 +10,155 @@ tar \- tape archiver
 .SH DESCRIPTION
 .PP
 .I Tar
 .SH DESCRIPTION
 .PP
 .I Tar

-saves and restores files
-on magtape.
-Its actions are controlled by the
+saves and restores multiple files on a single file (usually a magnetic
+tape, but it can be any file).  
+.IR Tar 's
+actions are controlled by the

 .I key
 .I key

-argument.
-The
+argument.  The

 .I key
 .I key

-is a string of characters containing
-at most one function letter and possibly
-one or more function modifiers.
-Other arguments to the command are file or directory
-names specifying which files are to be dumped or restored.
+is a string of characters containing at most one function letter and possibly
+one or more function modifiers.  Other arguments to 
+.I tar
+are file or directory names specifying which files to dump or restore.

 In all cases, appearance of a directory name refers to
 the files and (recursively) subdirectories of that directory.
 .PP
 In all cases, appearance of a directory name refers to
 the files and (recursively) subdirectories of that directory.
 .PP

-The function portion of
-the key is specified by one of the following letters:
+The function portion of the key is specified by one of the following letters:

 .TP 8
 .TP 8

-.B  r
-The named files
-are written
-on the end of the tape.
-The
+.B r
+The named files are written on the end of the tape.  The

 .B c
 function implies this.
 .TP 8
 .B c
 function implies this.
 .TP 8

-.B  x
-The named files are extracted from the tape.
-If the named file matches a directory whose contents 
-had been written onto the tape, this directory is (recursively) extracted.
-The owner, modification time, and mode are restored (if possible).
-If no file argument is given, the entire content of the
-tape is extracted.
-Note that if multiple entries specifying the same file
-are on the tape, the last one overwrites
-all earlier.
+.B x
+The named files are extracted from the tape.  If the named file
+matches a directory whose contents had been written onto the tape, this
+directory is (recursively) extracted.  The owner, modification time, and mode
+are restored (if possible).  If no file argument is given, the entire content
+of the tape is extracted.  Note that if multiple entries specifying the same
+file are on the tape, the last one overwrites all earlier.

 .TP 8
 .TP 8

-.B  t
-The names of the specified files are listed each time they occur
-on the tape.
-If no file argument is given,
-all of the names on the tape are listed.
+.B t
+The names of the specified files are listed each time they occur on
+the tape.  If no file argument is given, all of the names on the tape
+are listed.

 .TP 8
 .TP 8

-.B  u
-The named files are added to the tape if either they
-are not already there or have
-been modified since last put on the tape.
+.B u
+The named files are added to the tape if either they are not
+already there or have been modified since last put on the tape.

 .TP 8
 .TP 8

-.B  c
-Create a new tape; writing begins on the beginning
-of the tape instead of after the last file.
-This command implies
-.B  r.
+.B c
+Create a new tape; writing begins on the beginning of the tape
+instead of after the last file.  This command implies
+.BR r .

 .TP 8
 .TP 8

-.B  o
+.B o

 On output, tar normally places information specifying owner and modes
 On output, tar normally places information specifying owner and modes

-of directories in the archive.
-Former versions of tar, when encountering
+of directories in the archive.  Former versions of tar, when encountering

 this information will give error message of the form
 .br
        "<name>/: cannot create".
 .br
 This option will suppress the directory information.
 .TP 8
 this information will give error message of the form
 .br
        "<name>/: cannot create".
 .br
 This option will suppress the directory information.
 .TP 8

-.B  p
+.B p

 This option says to restore files to their original modes,
 This option says to restore files to their original modes,

-ignoring the present umask(2).  Setuid and sticky information
+ignoring the present
+.IR umask (2).
+Setuid and sticky information

 will also be restored to the super-user.
 .PP
 The following characters may be used in addition to the letter
 which selects the function desired.
 .TP 10
 will also be restored to the super-user.
 .PP
 The following characters may be used in addition to the letter
 which selects the function desired.
 .TP 10

-.B  0,...,7
-This
-modifier selects an alternate drive on which the tape is mounted.
-(The default is drive 0 at 1600 bpi, which is normally /dev/rmt8.)
+.B 0, ..., 9
+This modifier selects an alternate drive on which the tape is mounted.
+The default is drive 0 at 1600 bpi, which is normally /dev/rmt8.

 .TP 10
 .TP 10

-.B  v
+.B v

 Normally
 .I tar
 Normally
 .I tar

-does its work silently.
-The
+does its work silently.  The

 .B v
 .B v

-(verbose)
-option causes it to type the name of each file it treats
-preceded by the function letter.
-With the
+(verbose) option make
+.I tar
+type the name of each file it treats preceded by the function
+letter.  With the

 .B t
 .B t

-function,
-.B v
-gives more information about the
-tape entries than just the name.
+function, the verbose option
+gives more information about the tape entries than just their names.

 .TP 10
 .TP 10

-.B  w
-causes
-.I tar
-to print the action to be taken followed by file name, then
+.B w
+.I Tar
+prints the action to be taken followed by file name, then

 wait for user confirmation. If a word beginning with `y'
 wait for user confirmation. If a word beginning with `y'

-is given, the action is performed. Any other input means
-don't do it.
+is given, the action is done. Any other input means don't do it.

 .TP 10
 .B f
 .TP 10
 .B f

-causes 
-.I tar
-to use the next argument as the name of the archive instead
-of /dev/rmt?. 
-If the name of the file is `\-', tar writes to
-standard output or reads from standard input, whichever is
-appropriate. Thus,
+.I Tar
+uses the next argument as the name of the archive instead of
+/dev/rmt?. If the name of the file is `\-', tar writes to standard output or
+reads from standard input, whichever is appropriate. Thus,

 .I tar
 .I tar

-can be used as the head or tail of a filter chain
+can be used as the head or tail of a filter chain.

 .I Tar
 can also be used to move hierarchies with the command
 .ce 1
 cd fromdir; tar cf - . | (cd todir; tar xf -)
 .TP 10
 .B b
 .I Tar
 can also be used to move hierarchies with the command
 .ce 1
 cd fromdir; tar cf - . | (cd todir; tar xf -)
 .TP 10
 .B b

-causes
-.I tar
-to use the next argument as the blocking factor for tape
-records. The default is 20 (the maximum). This option
-should only be used with raw magnetic tape archives (See
+.I Tar
+uses the next argument as the blocking factor for tape records. The
+default is 20 (the maximum). This option should only be used with raw magnetic
+tape archives (See 

 .B f
 .B f

-above).
-The block size is determined automatically when reading
-tapes (key letters `x' and `t').
+above).  The block size is determined automatically
+when reading tapes (key letters `x' and `t').

 .TP 10
 .B l
 .TP 10
 .B l

-tells
+tells 

 .I tar
 .I tar

-to complain if it cannot resolve all of the links
-to the files dumped. If this is not specified, no
-error messages are printed.
+to complain if it cannot resolve all of the links to the
+files dumped. If this is not specified, no error messages are printed.

 .TP 10
 .B m
 .TP 10
 .B m

-tells
+tells 

 .I tar
 .I tar

-to not restore the modification times.
-The mod time
+not to restore the modification times.  The modification time

 will be the time of extraction.
 will be the time of extraction.

+.TP 10
+.B h
+Force 
+.I tar
+to follow symbolic links as if they were normal files or
+directories.  Normally, 
+.I tar
+does not follow symbolic links.
+.TP 10
+.B B
+Forces input and output blocking to 20 blocks per record.  This option
+was added so that 
+.I tar
+can work across a communications channel where the blocking may not
+be maintained.
+.PP
+If a file name is preceded by 
+.BR \-C ,
+then 
+.I tar
+will perform a
+.IR chdir (2)
+to that file name.  This allows multiple directories not
+related by a close common parent to be archived using short
+relative path names.  For example, to archive files from /usr/include
+and from /etc, one might use
+.ti +0.5i
+tar c -C /usr include -C / etc

 .PP
 Previous restrictions dealing with
 .IR tar 's
 .PP
 Previous restrictions dealing with
 .IR tar 's

-inability to properly handle blocked archives
-have been lifted.
+inability to properly handle blocked archives have been lifted.

 .PP
 .SH FILES
 /dev/rmt?
 .PP
 .SH FILES
 /dev/rmt?


@@ -163,8 +167,7 @@ have been lifted.
 .SH DIAGNOSTICS
 Complaints about bad key characters and tape read/write errors.
 .br
 .SH DIAGNOSTICS
 Complaints about bad key characters and tape read/write errors.
 .br

-Complaints if enough memory is not available to hold
-the link tables.
+Complaints if enough memory is not available to hold the link tables.

 .SH BUGS
 There is no way to ask for the
 .IR n -th
 .SH BUGS
 There is no way to ask for the
 .IR n -th


@@ -172,9 +175,10 @@ occurrence of a file.
 .br
 Tape errors are handled ungracefully.
 .br
 .br
 Tape errors are handled ungracefully.
 .br

-The
+The 

 .B u
 option can be slow.
 .br
 .B u
 option can be slow.
 .br

-The current limit on file name length is
-100 characters.
+The current limit on file name length is 100 characters.
+.br
+There is no way to selectively follow symbolic links.