add a config file git-buildpackage
[debian/dds2tar] / dds-dd.man
1 .TH dds-dd 1 2.4 \" -*- nroff -*-
2 .\"----------
3 .SH NAME
4 .\"----------
5 dds-dd \- tool to read a dds device.
6 .\"----------
7 .SH SYNOPSIS
8 .\"----------
9 .B dds-dd
10 [
11 .B -f device
12 ]
13 .PD 1
14 .\"----------
15 .SH DESCRIPTION
16 .\"----------
17 .B dds-dd
18 reads a dds tape devices (DAT). Every block is read and written to
19 stdout. A tape with unknown block size or blocks of different size
20 can be read.
21 .PP
22 The default device is
23 .IR /dev/rmt0 ,
24 which may be overridden with the environment variable
25 .BR TAPE ,
26 which in turn may be overridden with the
27 .BI -f \ device
28 option. The device must be a character special file.
29 .\"----------
30 .SH OPTIONS
31 .\"----------
32 .TP
33 .BI -f\  device
34 Device of the tape archive (default is /dev/rmt0).
35 Must be a character special file connected to a dds tape device.
36 .TP
37 .BR -V , --version
38 Print the version number of
39 .B mt-dds
40 to stderr and exit immediately.
41 .TP
42 .B --help
43 print some screens of online help with examples through a pager
44 and exit immediately.
45 .\"----------
46 .SH EXAMPLES
47 .\"----------
48 .B Example: 
49 Read the tape and make a listing:
50 .RS 10
51 dds-dd | tar ft -
52 .RE
53 .PP
54 .B Example: 
55 Read the tape and make a listing:
56 .RS 10
57 dds-dd | cpio -it 
58 .RE
59 .PP
60 .PD 1
61 .\"----------
62 .SH ENVIRONMENT
63 .\"----------
64 The environment variable
65 .B TAPE
66 overrides the default tape device /dev/rmt0.
67 .TP
68 .\"----------
69 .SH "SEE ALSO"
70 .\"----------
71 dds2tar(1), dds2index(1), mt(1), tar(1)
72 .\"----------
73 .SH HISTORY
74 .\"----------
75 This program was created to use it in conjunction with dds2tar.
76 .\"----------
77 .SH AUTHOR
78 .\"----------
79 J"org Weule (weule@cs.uni-duesseldorf.de), Phone +49 211 751409.
80 This software is available at
81 ftp.uni-duesseldorf.de:/pub/unix/apollo
82