ddstar

DDSTAR(1)                   General Commands Manual                  DDSTAR(1)



NAME
       ddstar - A patched version of GNU tar with DDS features

SYNOPSIS
       ddstar [options]

       filename1 [ filename2, ... filenameN ]

       directory1 [ directory2, ...directoryN ]

DESCRIPTION
       This manual page documents briefly the ddstar, command.  This manual
       page was written for the Debian GNU/Linux distribution (but may be used
       by others), because the original program does not have a manual page.

       For a detailed description of what ddstar does, please have a look at
       /usr/doc/dds2tar/README.gz and the manual page of GNU tar.

FUNCTION LETTERS
       One of the following options must be used:

       -A, --catenate, --concatenate
              append tar files to an archive

       -c, --create
              create a new archive

       -d, --diff, --compare
              find differences between archive and file system

       --delete
              delete from the archive (not for use on mag tapes!)

       -r, --append
              append files to the end of an archive

       -t, --list
              list the contents of an archive

       -u, --update
              only append files that are newer than copy in archive

       -x, --extract, --get
              extract files from an archive

OTHER OPTIONS
       --atime-preserve
              don't change access times on dumped files

       -b, --block-size N
              block size of Nx512 bytes (default N=20)

       -B, --read-full-blocks
              reblock as we read (for reading 4.2BSD pipes)

       -C, --directory DIR
              change to directory DIR

       --checkpoint
              print directory names while reading the archive

       -f, --file [HOSTNAME:]F
              use archive file or device F (default /dev/rmt0)

       --force-local
              archive file is local even if has a colon

       -F, --info-script F --new-volume-script F
              run script at end of each tape (implies -M)

       -G, --incremental
              create/list/extract old GNU-format incremental backup

       -g, --listed-incremental F
              create/list/extract new GNU-format incremental backup

       -h, --dereference
              don't dump symlinks; dump the files they point to

       -i, --ignore-zeros
              ignore blocks of zeros in archive (normally mean EOF)

       --ignore-failed-read
              don't exit with non-zero status on unreadable files

       -k, --keep-old-files
              keep existing files; don't overwrite them from archive

       -K, --starting-file F
              begin at file F in the archive

       -l, --one-file-system
              stay in local file system when creating an archive

       -L, --tape-length N
              change tapes after writing N*1024 bytes

       -m, --modification-time
              don't extract file modified time

       -M, --multi-volume
              create/list/extract multi-volume archive

       -N, --after-date DATE, --newer DATE
              only store files newer than DATE

       -o, --old-archive, --portability
              write a V7 format archive, rather than ANSI format

       -O, --to-stdout
              extract files to standard output

       -p, --same-permissions, --preserve-permissions
              extract all protection information

       -P, --absolute-paths
              don't strip leading `/'s from file names

       --preserve
              like -p -s

       -R, --record-number
              show record number within archive with each message

       --record-file FILE
              print the record information to file, enables -R

       --remove-files
              remove files after adding them to the archive

       -s, --same-order, --preserve-order
              list of names to extract is sorted to match archive

       --same-owner
              create extracted files with the same ownership

       -S, --sparse
              handle sparse files efficiently

       -T, --files-from F
              get names to extract or create from file F

       --null
              -T reads null-terminated names, disable -C

       --totals
              print total bytes written with --create

       -v, --verbose
              verbosely list files processed

       -V, --label NAME
              create archive with volume name NAME

       --version
              print tar program version number

       -w, --interactive, --confirmation
              ask for confirmation for every action

       -W, --verify
              attempt to verify the archive after writing it

       --exclude FILE
              exclude file FILE

       -X, --exclude-from FILE
              exclude files listed in FILE

       -Z, --compress, --uncompress
              filter the archive through compress

       -z, --gzip, --ungzip
              filter the archive through gzip

       --use-compress-program PROG
              filter the archive through PROG (which must accept -d)

       --block-compress
              block the output of compression program for tapes

       -[0-7][lmh]
              specify drive and density

SEE ALSO
       The details of this program are described in the README of the dds2tar
       distribution, /usr/doc/dds2tar/README.gz, and in the manual page of GNU
       tar.

BUGS
       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.




                                 9 Januar 1997                       DDSTAR(1)