From e34f6ef1b85e8de5a6fed59dcc6a963fb349b00e Mon Sep 17 00:00:00 2001 From: Kirk McKusick Date: Tue, 30 Apr 1985 03:15:12 -0800 Subject: [PATCH] manual page distributed with 4.2BSD SCCS-vsn: old/tar/tar.1 5.1 --- usr/src/old/tar/tar.1 | 202 +++++++++++++++++++++--------------------- 1 file changed, 103 insertions(+), 99 deletions(-) diff --git a/usr/src/old/tar/tar.1 b/usr/src/old/tar/tar.1 index 747e4d48fc..3ef60c4d98 100644 --- 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 @@ -10,151 +10,155 @@ tar \- tape archiver .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 -argument. -The +argument. The .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 -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 -.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 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 -.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 -.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 -.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 -.B o +.B o 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 "/: 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, -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 -.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 -.B v +.B v Normally .I tar -does its work silently. -The +does its work silently. The .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 -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 -.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' -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 -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 -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 -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 -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 -tells +tells .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 -tells +tells .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. +.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 -inability to properly handle blocked archives -have been lifted. +inability to properly handle blocked archives have been lifted. .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 -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 @@ -172,9 +175,10 @@ occurrence of a file. .br Tape errors are handled ungracefully. .br -The +The .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. -- 2.20.1