Date: Sun, 18 Dec 1994 15:28:26 -0600 (CST) From: Gary Clark II <gclarkii@neon.gbdata.com> To: freebsd-hackers@freebsd.org Subject: tar man page Message-ID: <199412182128.PAA01632@neon.gbdata.com>
next in thread | raw e-mail | index | archive | help
Hi, Here is my first pass at a TAR man page written using the man-doc macros. It is neither compleate or ready for commiting yet. I'm just posting to get some feed back on it. Gary .\" Copyright (c) 1994 .\" FreeBSD Journal Publications All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 4. Neither the name of the Journal nor the names of its contributors .\" may be used to endorse or promote products derived from this document .\" without specific prior written permission. .\" .\" THIS DOCUMENT IS PROVIDED BY THE JOURNAL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE JOURNAL OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .Dd DEC 20, 1994 .Dt TAR 7 .Os FreeBSD 2.0 .Sh NAME .Nm Tar .Nd GNU Tape Archiver .Sh SYNOPSIS .Nm \&tar .Op Fl Acdrtux .Op Fl bGghiklmMoOpPRsSvwWZz .Op Fl \-atime-preserve .Op Fl C Ar DIR .Op Fl \-checkpoint .Op Fl f Ar Filename .Op Fl \-force\-local .Op Fl F Ar SCRIPT .Op Fl \-ignore-failed-read .Op Fl K Ar FILE .Op Fl L Ar LENGTH .Op Fl N Ar DATE .Op Fl T Ar FILE .Op Fl \-null .Op Fl \-totals .Op Fl V Ar LABEL .Op Fl \-version .Op Fl \-exclude Ar FILE .Op Fl X Ar FILE .Op Fl \-use\-compress\-program Ar PROG .Op Fl \-block\-compress .Op Ar [0-7][lmh] .Op Fl \-unlink .Ar directory .Sh DESCRIPTION .Nm is the .Sy GNU Tape Archiver. It is capable of creating and reading archives from many different sources including tape, floppy and file. .Pp .Em NOTE: All arguments to a command appear after the commands in the order that thier commands appear in the command line. .Pp .Em tar xvfML /dev/fd0a 1435 .Pp This command line will create a multi-part tar file that is outputed to the floppy drive and each tar segment is limited to 1435K to allow it to fit on the floppy. .Pp One and only one of the following options must be selected. .Pp .Bl -inset .It Em A Append tar files to an archive .It Em c Create a new archive .It Em d Find differences between tar archive and filesystem .It Em delete Delete from the archive. .Em Not to be used on mag tape!! .It Em r Append files to the end of the archive .It Em t List files in the archive. .It Em u Only append files that are newer than copy in archive .It Em x Extract files from the archive. .El .Pp The above options are modified using the options listed below .Pp .Bl -inset .It Em atime-preserve Don't change access times on dumped files .It Em b N Use block size of Nx512 bytes (Default N=20) .It Em B Reblock as we read (For reading 4.2BSD pipes) .It Em C DIR Change to directory DIR .It Em checkpoint Print directory names while reading the archive .It Em f F Use archive file F or device F (default /dev/rst0) .It Em F SCRIPT Run script SCRIPT at the end of each tape (Implies \-M) .It Em G Create/list/extract old GNU format incremental backup .It Em g Create/list/extract new GNU format incremental backup .It Em h Do not dump sym-links, dump the files they point to. .It Em i Ignore blocks of zeros in archive (normally mean EOF) .It Em ignore\-failed\-read Do not exit with non-zero status on unreadable files .It Em k Keep existing files, do not overwrite them from archive .It Em K FILE Begin at file FILE in the archive .It Em l Stay in local file system when creating archive .It Em L NUMBER Change tapes after writing NUMBER*1024 bytes .It Em m Do not extract file modified time .It Em M Create/list/extract multi-volume archives .It Em N DATE Only store files newer than DATE .It Em o Create a V7 format archive, rather than an ANSI format one .It Em O Extract files to STDOUT .It Em p Extract all permissions information .It Em P Do not strip leading /'s from file names .It Em R Show record number within archive with each message .It Em remove\-files Remove files after adding them to archive .It Em s List of names to extract is sorted to match archive .It Em same\-owner Create extracted files with same ownership .It Em S Handle sparse files efficiently .It Em T FILE Get file names to create or extract from file FILE .It Em null \-T reads null-terminated names, disable \-C .It Em totals Print total bytes written with "CREATE" .It Em v Verbosely list files processed .It Em V NAME Create archive with volume name of NAME .It Em version Print tar program version number .It Em w Interactive. Ask for conformation on every action. .It Em W Attempt to verify the archive after writing it .It Em exclude FILE Exclude file FILE .It Em X FILE Exclude files listed in FILE .It Em Z Filter the archive through compress .It Em z Filter the archive through gzip .It Em use\-compress\-program PROG Filter the archive through PROG (Which must accept the \-d option) .It Em block\-compress Block the output of compression program for tapes .It Em [0\-7][lmh] Specify drive and density .It Em unlink Unlink files before creating them .El .Sh ENVIROMENT The .Nm program uses the enviroment variable .Em TAPE if no file or device appears on the command line. It will use the command line argument to .Em f over the .Em TAPE variable. .Sh EXAMPLES .Pp .Pp .Pp .Sh SEE ALSO .Xr pax 1 .Xr cpio 1
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199412182128.PAA01632>