Return to tar.1 CVS log

Up to [MW Coherent from dump] / coherent / g / usr / bin / pax / doc

Annotation of coherent/g/usr/bin/pax/doc/tar.1, revision 1.1

1.1     ! root        1: .\" $Id: tar.1,v 1.1 88/12/23 18:02:37 mark Rel $
        !             2: .TH TAR 1 "USENIX Association" ""
        !             3: .SH NAME
        !             4: tar \- process tape archives
        !             5: .SH SYNOPSIS
        !             6: .B tar
        !             7: .BR \-c [ bfvw ]
        !             8: .I device
        !             9: .I block
        !            10: .I filename...
        !            11: .br
        !            12: .B tar
        !            13: .BR \-r [ bvw ]
        !            14: .I device
        !            15: .I block
        !            16: .RI [ filename... ]
        !            17: .br
        !            18: .B tar
        !            19: .BR \-t [ fv ]
        !            20: .I device
        !            21: .br
        !            22: .B tar
        !            23: .BR \-u [ bvw ]
        !            24: .I device
        !            25: .I block
        !            26: .br
        !            27: .B tar
        !            28: .BR \-x [ flmovw ]
        !            29: .I device
        !            30: .RI [ filename... ]
        !            31: .SH DESCRIPTION
        !            32: .I Tar
        !            33: reads and writes archive files which conform to the
        !            34: .B "Archive/Interchange File Format"
        !            35: specified in
        !            36: .IR "IEEE Std. 1003.1-1988" .
        !            37: .SS Options
        !            38: The following options are available:
        !            39: .TP 1i
        !            40: .B \-c
        !            41: Creates a new archive; writing begins at the beginning of the archive,
        !            42: instead of after the last file.
        !            43: .TP 1i
        !            44: .B \-r
        !            45: Writes names files to the end of the archive.
        !            46: .TP 1i
        !            47: .B \-t
        !            48: Lists the names of all of the files in the archive.
        !            49: .TP 1i
        !            50: .B \-u
        !            51: Causes named files to be
        !            52: added to the archive if they are not already there, or have been
        !            53: modified since last written into the archive.
        !            54: This implies the
        !            55: .B \-r
        !            56: option.
        !            57: .TP 1i
        !            58: .B \-x
        !            59: Extracts named files
        !            60: from the archive.
        !            61: If a named file matches a directory whose contents had been written onto
        !            62: the archive, that directory is recursively extracted.
        !            63: If a named file in the archive does not exist on the system, the file is
        !            64: create with the same mode as the one in the archive, except that the
        !            65: set-user-id and get-group-id modes are not set unless the user has
        !            66: appropriate privileges.
        !            67: .PP
        !            68: If the files exist, their modes are not changed except as described above.
        !            69: The owner, group and modification time are restored if possible.
        !            70: If no
        !            71: .I filename
        !            72: argument is given, the entire contents of the archive is extracted.
        !            73: Note that if several files with the same name are in the archive,
        !            74: the last one will overwrite all earlier ones.
        !            75: .TP 1i
        !            76: .B \-b
        !            77: Causes
        !            78: .I tar
        !            79: to use the next argument on the command line as the blocking factor for
        !            80: tape records.
        !            81: The default is 1; the maximum is 20.
        !            82: This option should only be used with raw magnetic tape archives.
        !            83: Normally, the block size is determined automatically when reading tapes.
        !            84: .TP 1i
        !            85: .B \-f
        !            86: Causes
        !            87: .I tar
        !            88: to use the next argument on the command line as the name of the archive
        !            89: instead of the default, which is usually a tape drive.
        !            90: If
        !            91: .B -
        !            92: is specified as a filename
        !            93: .I tar
        !            94: writes to the standard output or reads from the standard input, whichever
        !            95: is appropriate for the options given.
        !            96: Thus,
        !            97: .I tar
        !            98: can be used as the head or tail of a pipeline.
        !            99: .TP 1i
        !           100: .B \-l
        !           101: Tells
        !           102: .I tar
        !           103: to report if it cannot resolve all of the links to the files being
        !           104: archived.
        !           105: If
        !           106: .B \-l
        !           107: is not specified, no error messages are written to the standard output.
        !           108: This modifier is only valid with the
        !           109: .BR \-c ,
        !           110: .B \-r
        !           111: and
        !           112: .BR \-u
        !           113: options.
        !           114: .TP 1i
        !           115: .B \-m
        !           116: Tells
        !           117: .I tar
        !           118: not to restore the modification times.
        !           119: The modification time of the file will be the time of extraction.
        !           120: This modifier is invalid with th
        !           121: .B \-t
        !           122: option.
        !           123: .TP 1i
        !           124: .B \-o
        !           125: Causes extracted files to take on the user and group identifier of the user
        !           126: running the program rather than those on the archive.
        !           127: This modifier is only valid with the
        !           128: .B \-x
        !           129: option.
        !           130: .TP 1i
        !           131: .B \-v
        !           132: Causes
        !           133: .I tar
        !           134: to operate verbosely.  Usually,
        !           135: .I tar
        !           136: does its work silently, but
        !           137: the
        !           138: .B v
        !           139: modifier causes it to print the name of each file it processes,
        !           140: preceded by the option letter.
        !           141: With the
        !           142: .B \-t
        !           143: option,
        !           144: .B v
        !           145: gives more information about the archive entries than just the name.
        !           146: .TP 1i
        !           147: .B \-w
        !           148: Causes
        !           149: .I tar
        !           150: to print the action to be taken, followed by the name of the file, and then
        !           151: wait for the user's confirmation.
        !           152: If a word beginning with
        !           153: .B y
        !           154: is given, the action is performed.
        !           155: Any other input means "no".
        !           156: This modifier is invalid with the
        !           157: .B \-t
        !           158: option.
        !           159: .SH FILES
        !           160: .TP 1i
        !           161: /dev/tty
        !           162: used to prompt the user for information when the
        !           163: .BR \-i " or " \-y
        !           164: options are specified.
        !           165: .SH "SEE ALSO"
        !           166: cpio(1), dd(1), find(1), pax(1), cpio(5), tar(5)
        !           167: .SH COPYRIGHT
        !           168: Copyright (c) 1989 Mark H. Colburn.  
        !           169: .br
        !           170: All rights reserved.
        !           171: .PP
        !           172: Redistribution and use in source and binary forms are permitted
        !           173: provided that the above copyright notice is duplicated in all such 
        !           174: forms and that any documentation, advertising materials, and other 
        !           175: materials related to such distribution and use acknowledge that the 
        !           176: software was developed by Mark H. Colburn and sponsored by The 
        !           177: USENIX Association. 
        !           178: .PP
        !           179: THE SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
        !           180: IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
        !           181: WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !           182: .SH AUTHOR
        !           183: Mark H. Colburn
        !           184: .br
        !           185: NAPS International
        !           186: .br
        !           187: 117 Mackubin Street, Suite 1
        !           188: .br
        !           189: St. Paul, MN 55102
        !           190: .br
        !           191: [email protected]
        !           192: .sp 2
        !           193: Sponsored by
        !           194: .B "The USENIX Association"
        !           195: for public distribution.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.