+++ /dev/null
---- tar-1.13.93.orig/debian/rmt.8
-+++ tar-1.13.93/debian/rmt.8
-@@ -0,0 +1,223 @@
-+.\" Copyright (c) 1983, 1991, 1993
-+.\" The Regents of the University of California. 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.
-+.\" 3. All advertising materials mentioning features or use of this software
-+.\" must display the following acknowledgement:
-+.\" This product includes software developed by the University of
-+.\" California, Berkeley and its contributors.
-+.\" 4. Neither the name of the University nor the names of its contributors
-+.\" may be used to endorse or promote products derived from this software
-+.\" without specific prior written permission.
-+.\"
-+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS 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 REGENTS 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.
-+.\"
-+.\" @(#)rmt.8 8.2 (Berkeley) 12/11/93
-+.\"
-+.Dd December 11, 1993
-+.Dt RMT 8
-+.Os BSD 4.2
-+.Sh NAME
-+.Nm rmt
-+.Nd remote magtape protocol module
-+.Sh SYNOPSIS
-+.Nm rmt
-+.Sh DESCRIPTION
-+.Nm Rmt
-+is a program used by tar, cpio, mt, and the remote dump and restore
-+programs in manipulating a magnetic tape drive through an interprocess
-+communication connection.
-+.Nm Rmt
-+is normally started up with an
-+.Xr rexec 3
-+or
-+.Xr rcmd 3
-+call or the
-+.Xr rsh 1
-+command.
-+.Pp
-+The
-+.Nm rmt
-+program accepts requests specific to the manipulation of
-+magnetic tapes, performs the commands, then responds with
-+a status indication. All responses are in
-+.Tn ASCII
-+and in
-+one of two forms.
-+Successful commands have responses of:
-+.Bd -filled -offset indent
-+.Sm off
-+.Sy A Ar number No \en
-+.Sm on
-+.Ed
-+.Pp
-+.Ar Number
-+is an
-+.Tn ASCII
-+representation of a decimal number.
-+Unsuccessful commands are responded to with:
-+.Bd -filled -offset indent
-+.Sm off
-+.Xo Sy E Ar error-number
-+.No \en Ar error-message
-+.No \en
-+.Xc
-+.Sm on
-+.Ed
-+.Pp
-+.Ar Error-number
-+is one of the possible error
-+numbers described in
-+.Xr intro 2
-+and
-+.Ar error-message
-+is the corresponding error string as printed
-+from a call to
-+.Xr perror 3 .
-+The protocol is comprised of the
-+following commands, which are sent as indicated - no spaces are supplied
-+between the command and its arguments, or between its arguments, and
-+.Ql \en
-+indicates that a newline should be supplied:
-+.Bl -tag -width Ds
-+.Sm off
-+.It Xo Sy \&O Ar device
-+.No \en Ar mode No \en
-+.Xc
-+Open the specified
-+.Ar device
-+using the indicated
-+.Ar mode .
-+.Ar Device
-+is a full pathname and
-+.Ar mode
-+is an
-+.Tn ASCII
-+representation of a decimal
-+number suitable for passing to
-+.Xr open 2 .
-+If a device had already been opened, it is
-+closed before a new open is performed.
-+.It Xo Sy C Ar device No \en
-+.Xc
-+Close the currently open device. The
-+.Ar device
-+specified is ignored.
-+.It Xo Sy L
-+.Ar offset No \en
-+.Ar whence No \en
-+.Xc
-+.Sm on
-+Perform an
-+.Xr lseek 2
-+operation using the specified parameters.
-+The response value is that returned from the
-+.Xr lseek
-+call.
-+.Sm off
-+.It Sy W Ar count No \en
-+.Sm on
-+Write data onto the open device.
-+.Nm Rmt
-+reads
-+.Ar count
-+bytes from the connection, aborting if
-+a premature end-of-file is encountered.
-+The response value is that returned from
-+the
-+.Xr write 2
-+call.
-+.Sm off
-+.It Sy R Ar count No \en
-+.Sm on
-+Read
-+.Ar count
-+bytes of data from the open device.
-+If
-+.Ar count
-+exceeds the size of the data buffer (10 kilobytes), it is
-+truncated to the data buffer size.
-+.Nm rmt
-+then performs the requested
-+.Xr read 2
-+and responds with
-+.Sm off
-+.Sy A Ar count-read No \en
-+.Sm on
-+if the read was
-+successful; otherwise an error in the
-+standard format is returned. If the read
-+was successful, the data read is then sent.
-+.Sm off
-+.It Xo Sy I Ar operation
-+.No \en Ar count No \en
-+.Xc
-+.Sm on
-+Perform a
-+.Dv MTIOCOP
-+.Xr ioctl 2
-+command using the specified parameters.
-+The parameters are interpreted as the
-+.Tn ASCII
-+representations of the decimal values
-+to place in the
-+.Ar mt_op
-+and
-+.Ar mt_count
-+fields of the structure used in the
-+.Xr ioctl
-+call. The return value is the
-+.Ar count
-+parameter when the operation is successful.
-+.It Sy S
-+Return the status of the open device, as
-+obtained with a
-+.Dv MTIOCGET
-+.Xr ioctl
-+call. If the operation was successful,
-+an ``ack'' is sent with the size of the
-+status buffer, then the status buffer is
-+sent (in binary).
-+.El
-+.Sm on
-+.Pp
-+Any other command causes
-+.Nm rmt
-+to exit.
-+.Sh DIAGNOSTICS
-+All responses are of the form described above.
-+.Sh SEE ALSO
-+.Xr tar 1 ,
-+.Xr cpio 1 ,
-+.Xr mt 1 ,
-+.Xr rsh 1 ,
-+.Xr rcmd 3 ,
-+.Xr rexec 3 ,
-+.Xr mtio 4 ,
-+.Xr rdump 8 ,
-+.Xr rrestore 8
-+.Sh BUGS
-+People should be discouraged from using this for a remote
-+file access protocol.
-+.Sh HISTORY
-+The
-+.Nm
-+command appeared in
-+.Bx 4.2 .
---- tar-1.13.93.orig/debian/tar.1
-+++ tar-1.13.93/debian/tar.1
-@@ -0,0 +1,313 @@
-+.\" @(#)tar.1 1.11.1 93/19/22 PJV;
-+.TH TAR 1 "22 September 1993"
-+.SH NAME
-+tar \- The GNU version of the tar archiving utility
-+.SH SYNOPSIS
-+.B tar
-+[
-+.B \-
-+]
-+.B A \-\-catenate \-\-concatenate \||\| c \-\-create \||\| d \-\-diff \-\-compare \||\| \-\-delete \||\| r \-\-append \||\| t \-\-list \||\| u \-\-update \||\| x \-\-extract \-\-get
-+.TP
-+.I [ options ]
-+.TP
-+.I filename1 [ filename2, ... filenameN ]
-+.TP
-+.I directory1 [ directory2, ...directoryN ]
-+.SH DESCRIPTION
-+.LP
-+This manual page documents the GNU version of
-+.B tar
-+, an archiving program designed to store and extract files from
-+an archive file known as a
-+.IR tarfile.
-+A
-+.IR tarfile
-+may be made on a tape drive, however, it is also common
-+to write a
-+.IR tarfile
-+to a normal file.
-+The first argument to
-+.B tar
-+must be one of the options:
-+.BR Acdrtux ,
-+followed by any optional functions.
-+The final arguments to
-+.B tar
-+are the names of the files or directories which should be archived. The use
-+of a directory name always implies that the subdirectories below should be
-+included in the archive.
-+.SH EXAMPLES
-+.TP
-+.B tar \-xvvf foo.tar
-+extract foo.tar
-+.TP
-+.B tar \-xvvzf foo.tar.gz
-+extract gzipped foo.tar.gz
-+.TP
-+.B tar \-cvvf foo.tar foo/
-+tar contents of folder foo in foo.tar
-+.SH "FUNCTION LETTERS"
-+.TP
-+.B One of the following options must be used:
-+.TP
-+.B \-A, \-\-catenate, \-\-concatenate
-+append tar files to an archive
-+.TP
-+.B \-c, \-\-create
-+create a new archive
-+.TP
-+.B \-d, \-\-diff, \-\-compare
-+find differences between archive and file system
-+.TP
-+.B \-\-delete
-+delete from the archive (not for use on mag tapes!)
-+.TP
-+.B \-r, \-\-append
-+append files to the end of an archive
-+.TP
-+.B \-t, \-\-list
-+list the contents of an archive
-+.TP
-+.B \-u, \-\-update
-+only append files that are newer than copy in archive
-+.TP
-+.B \-x, \-\-extract, \-\-get
-+extract files from an archive
-+.SH "OTHER OPTIONS"
-+.TP
-+.B \-\-anchored
-+force exclusion patterns to match initial subsequences
-+.TP
-+.B \-\-atime\-preserve
-+don't change access times on dumped files
-+.TP
-+.B \-b, \-\-blocking\-factor N
-+use record size of Nx512 bytes (default N=20)
-+.TP
-+.B \-B, \-\-read\-full\-records
-+reblock as we read (for reading 4.2BSD pipes)
-+.TP
-+.B \-\-backup [TYPE]
-+back up files instead of overwriting (TYPE=numbered, existing, simple)
-+.TP
-+.B \-C, \-\-directory DIR
-+change to directory DIR
-+.TP
-+.B \-\-checkpoint
-+print periodic checkpoints
-+.TP
-+.B \-\-exclude=PATTERN
-+exclude files matching PATTERN
-+.TP
-+.B \-f, \-\-file [HOSTNAME:]F
-+use archive file or device F (default "\-", meaning stdin/stdout)
-+.TP
-+.B \-F, \-\-info\-script F, \-\-new\-volume\-script F
-+run script at end of each tape (implies \-M)
-+.TP
-+.B \-\-force\-local
-+archive file is local even if it has a colon
-+.TP
-+.B \-G, \-\-incremental
-+create/list/extract old GNU-format incremental backup
-+.TP
-+.B \-g, \-\-listed\-incremental F
-+create/list/extract new GNU-format incremental backup
-+.TP
-+.B \-\-group G
-+set group to G while adding files
-+.TP
-+.B \-h, \-\-dereference
-+don't dump symlinks; dump the files they point to
-+.TP
-+.B \-\-help
-+print help message
-+.TP
-+.B \-i, \-\-ignore\-zeros
-+ignore blocks of zeros in archive (normally mean EOF)
-+.TP
-+.B \-\-ignore\-case
-+ignore case when excluding files
-+.TP
-+.B \-\-ignore\-failed\-read
-+don't exit with non-zero status on unreadable files
-+.TP
-+.B \-j, \-\-bzip2
-+filter archive through bzip2, use to decompress .bz2 files.
-+WARNING: some previous versions of tar used option \-I to
-+filter through bzip2. When writing scripts, use \-\-bzip2
-+instead of \-j so that both older and newer tar versions
-+will work.
-+.TP
-+.B \-k, \-\-keep\-old\-files
-+keep existing files; don't overwrite them from archive
-+.TP
-+.B \-K, \-\-starting\-file F
-+begin at file F in the archive
-+.TP
-+.B \-l, \-\-one\-file\-system
-+stay in local file system when creating an archive
-+.TP
-+.B \-L, \-\-tape\-length N
-+change tapes after writing N*1024 bytes
-+.TP
-+.B \-m, \-\-touch
-+don't extract file modified time
-+.TP
-+.B \-M, \-\-multi\-volume
-+create/list/extract multi-volume archive
-+.TP
-+.B \-\-mode M
-+set permissions to M while adding files
-+.TP
-+.B \-N, \-\-after\-date DATE, \-\-newer DATE
-+only store files newer than DATE
-+.TP
-+.B \-\-newer\-mtime DATE
-+only store files whose contents have changed after DATE
-+.TP
-+.B \-\-no\-anchored
-+allow exclusion patterns to match any substring (the default)
-+.TP
-+.B \-\-no\-ignore\-case
-+match patterns case sensitively (the default)
-+.TP
-+.B \-\-no\-recursion
-+do not recurse into subdirectories
-+.TP
-+.B \-\-no\-same\-owner
-+extract files with owner set to current user (the default for non-root
-+users)
-+.TP
-+.B \-\-no\-same\-permissions
-+apply umask to extracted files (the default for non-root users)
-+.TP
-+.B \-\-no\-wildcards
-+do not use wildcards when excluding files
-+.TP
-+.B \-\-no\-wildcards\-match\-slash
-+don't let wildcards match "/" when excluding files
-+.TP
-+.B \-\-null
-+for \-T, use "NUL" instead of newline as filename terminator
-+.TP
-+.B \-\-numeric\-owner
-+always use numbers for user/group names
-+.TP
-+.B \-o, \-\-old\-archive, \-\-portability
-+write a V7 format archive, rather than ANSI format
-+.TP
-+.B \-O, \-\-to\-stdout
-+extract files to standard output
-+.TP
-+.B \-p, \-\-same\-permissions, \-\-preserve\-permissions
-+ignore umask when extracting files (the default for root)
-+.TP
-+.B \-P, \-\-absolute\-names
-+don't strip leading `/'s from file names
-+.TP
-+.B \-\-posix
-+create POSIX compliant archive
-+.TP
-+.B \-\-preserve
-+like \-p \-s
-+.TP
-+.B \-R, \-\-block\-number
-+show block number within archive with each message
-+.TP
-+.B \-\-record\-size SIZE
-+use SIZE bytes per record
-+.TP
-+.B \-\-recursion
-+recurse into directories (the default)
-+.TP
-+.B \-\-recursive\-unlink
-+remove existing directories before extracting directories of the same
-+name
-+.TP
-+.B \-\-remove\-files
-+remove files after adding them to the archive
-+.TP
-+.B \-\-rsh\-command=CMD
-+Use remote COMMAND instead of `rsh'. This option exists so that
-+people who use something other than the standard `rsh' (e.g., a
-+Kerberized `rsh') can access a remote device.
-+.TP
-+.B \-S, \-\-sparse
-+handle sparse files efficiently
-+.TP
-+.B \-s, \-\-same\-order, \-\-preserve\-order
-+list of names to extract is sorted to match archive
-+.TP
-+.B \-\-same\-owner
-+extract files with owner as specified in archive (the default for
-+root)
-+.TP
-+.B \-\-show\-omitted\-dirs
-+mention directories that are being skipped over
-+.TP
-+.B \-\-suffix SUFFIX
-+append SUFFIX to make backup files (default ~)
-+.TP
-+.B \-T, \-\-files\-from F
-+get names to extract or archive from file F
-+.TP
-+.B \-\-totals
-+display total bytes written after creating an archive
-+.TP
-+.B \-\-totals
-+print total bytes written with \-\-create
-+.TP
-+.B \-U, \-\-unlink\-first
-+unlink & recreate files instead of overwriting
-+.TP
-+.B \-\-use\-compress\-program PROG
-+filter the archive through PROG (which must accept \-d)
-+.TP
-+.B \-v, \-\-verbose
-+verbosely list files processed
-+.TP
-+.B \-V, \-\-label NAME
-+create archive with volume name NAME
-+.TP
-+.B \-\-version
-+print tar program version number
-+.TP
-+.B \-\-volno\-file F
-+keep track of current volume (of a multi-volume archive) in F
-+.TP
-+.B \-w, \-\-interactive, \-\-confirmation
-+ask for confirmation for every action
-+.TP
-+.B \-W, \-\-verify
-+attempt to verify the archive after writing it
-+.TP
-+.B \-\-wildcards
-+use wildcards when excluding files (the default)
-+.TP
-+.B \-\-wildcards\-match\-slash
-+allow wildcards to match "/" (the default)
-+.TP
-+.B \-X, \-\-exclude\-from=FILE
-+exclude files matching patterns listed in FILE
-+.TP
-+.B \-Z, \-\-compress, \-\-uncompress
-+filter the archive through compress
-+.TP
-+.B \-z, \-\-gzip, \-\-gunzip, \-\-ungzip
-+filter the archive through gzip
-+.TP
-+.B \-[0\-7][lmh]
-+specify drive and density
-+.SH BUGS
-+.LP
-+The GNU folks, in general, abhor man pages, and create info documents instead.
-+The maintainer of tar falls into this category. This man page is neither
-+complete, nor current, and was included in the Debian Linux packaging of tar
-+entirely to reduce the frequency with which the lack of a man page gets
-+reported as a bug in our defect tracking system.
-+
-+If you really want to understand tar, then you should run info and read the
-+tar info pages, or use the info mode in emacs.
-+
projects / packages / tar.git / commitdiff