aboutsummaryrefslogtreecommitdiff
path: root/man/man1/tar.1
diff options
context:
space:
mode:
authorrsc <devnull@localhost>2005-01-03 06:41:38 +0000
committerrsc <devnull@localhost>2005-01-03 06:41:38 +0000
commita19c44b83b96fefad131ef324c3eb2916e8c604c (patch)
tree9fee0b867751c0b9fe63a2763067c2e37403a866 /man/man1/tar.1
parent058b0118a52061ad57694c01fc8763b22b789c4d (diff)
downloadplan9port-a19c44b83b96fefad131ef324c3eb2916e8c604c.tar.gz
plan9port-a19c44b83b96fefad131ef324c3eb2916e8c604c.tar.bz2
plan9port-a19c44b83b96fefad131ef324c3eb2916e8c604c.zip
Add mkfile to keep indices up to date.
Remove man pages for things we don't provide.
Diffstat (limited to 'man/man1/tar.1')
-rw-r--r--man/man1/tar.1118
1 files changed, 0 insertions, 118 deletions
diff --git a/man/man1/tar.1 b/man/man1/tar.1
deleted file mode 100644
index 00ac0414..00000000
--- a/man/man1/tar.1
+++ /dev/null
@@ -1,118 +0,0 @@
-.TH TAR 1
-.SH NAME
-tar \- archiver
-.SH SYNOPSIS
-.B tar
-.I key
-[
-.I file ...
-]
-.SH DESCRIPTION
-.PP
-.I Tar
-saves and restores file trees.
-It is most often used to transport a tree of files from one
-system to another.
-The
-.I key
-is a string that contains
-at most one function letter plus optional modifiers.
-Other arguments to the command are names of
-files or directories to be dumped or restored.
-A directory name implies all the contained
-files and subdirectories (recursively).
-.PP
-The function is one of the following letters:
-.TP
-.B c
-Create a new archive with the given files as contents.
-.TP
-.B x
-Extract the named files from the archive.
-If a file is a directory, the directory is extracted recursively.
-Modes are restored if possible.
-If no file argument is given, extract the entire archive.
-If the archive contains multiple entries for a file,
-the latest one wins.
-.TP
-.B t
-List all occurrences of each
-.I file
-in the archive, or of all files if there are no
-.I file
-arguments.
-.TP
-.B r
-The named files
-are appended to the archive.
-.PP
-The modifiers are:
-.TP
-.B v
-(verbose)
-Print the name of each file treated
-preceded by the function letter.
-With
-.BR t ,
-give more details about the
-archive entries.
-.TP
-.B f
-Use the next argument as the name of the archive instead of
-the default standard input (for keys
-.B x
-and
-.BR t )
-or standard output (for keys
-.B c
-and
-.BR r ).
-.TP
-.B u
-Use the next (numeric) argument as the user id for files in
-the output archive. This is only useful when moving files to
-a non-Plan 9 system.
-.TP
-.B g
-Use the next (numeric) argument as the group id for files in
-the output archive.
-.TP
-.B p
-Create archive in POSIX ustar format,
-which raises the maximum pathname length from 100 to 256 bytes.
-Ustar archives are recognised automatically by
-.I tar
-when reading archives.
-.TP
-.B R
-When extracting, ignore leading slash on file names,
-i.e., extract all files relative to the current directory.
-.TP
-.B T
-Modifies the behavior of
-.B x
-to set the mode and modified time
-of each file to that specified in the archive.
-.SH EXAMPLES
-.I Tar
-can be used to copy hierarchies thus:
-.IP
-.EX
-@{cd fromdir && tar cp .} | @{cd todir && tar xT}
-.EE
-.SH SOURCE
-.B /usr/local/plan9/src/cmd/tar.c
-.SH SEE ALSO
-.IR ar (1),
-.IR bundle (1),
-.IR tapefs (1)
-.SH BUGS
-There is no way to ask for any but the last
-occurrence of a file.
-.br
-File path names are limited to
-100 characters
-(256 when using ustar format).
-.br
-The tar format allows specification of links and symbolic links,
-concepts foreign to Plan 9: they are ignored.