1 .TH "cdrestore" "1" "0.6.3" "Stefan Hülswitt" "" |
1 .TH "cdrestore" "1" "0.6.4beta" "Stefan Hülswitt" "" |
2 .SH "NAME" |
2 .SH "NAME" |
3 .LP |
3 .LP |
4 cdrestore \- Streaming restore from CD\-R(W) |
4 cdrestore \- Streaming restore from CD\-R(W)/DVD\-R(W) |
5 .SH "SYNOPSIS" |
5 .SH "SYNOPSIS" |
6 .LP |
6 .LP |
7 cdrestore [\-qvDFRTV] [\-d \fIdevice\fP] [\-l \fIsize\fP] [\-t \fItrack\fP] |
7 cdrestore [\-qvDFRTV] [\-d \fIdevice\fP] [\-i \fIimage\fP] [\-l \fIsize\fP] |
8 [\-c \fIcommand\fP] |
8 [\-t \fItrack\fP] [\-c \fIcommand\fP] |
9 .SH "DESCRIPTION" |
9 .SH "DESCRIPTION" |
10 .LP |
10 .LP |
11 cdrestore is a utility to make streaming restores from CD\-R(W) disks. It's designed to work with any backup tool which is able to restore from stdin (like tar/cpio/afio). |
11 cdrestore is a utility to make streaming restores from CD\-R(W)/DVD\-R(W) disks. It's designed to work with any backup tool which is able to restore from stdin (like tar/cpio/afio). |
12 .SH "OPTIONS" |
12 .SH "OPTIONS" |
13 .LP |
13 .LP |
14 .TP |
14 .TP |
15 \fB\-d\fR \fIdevice\fP |
15 \fB\-d\fR \fIdevice\fP |
16 The device name which is used for reading the backup. |
16 The device name which is used for reading the backup. |
17 .br |
17 .br |
18 (default: /dev/cdrom) |
18 (default: /dev/cdrom) |
19 |
19 |
20 .TP |
20 .TP |
|
21 \fB\-i\fR \fIimage\fP |
|
22 Enables virtual image mode. The backup stream is read from the given image file. You have to use this option, if you are restoring from a dumped image too. |
|
23 .br |
|
24 (default: none) |
|
25 |
|
26 .TP |
21 \fB\-l\fR \fIsize\fP |
27 \fB\-l\fR \fIsize\fP |
22 The media size in megabytes. This value is used to calculate the free space on the media. |
28 Specifies the media size. This value is used to display the free space on the media only. |
23 .br |
29 .br |
24 (default: 650) |
30 By default the given value is taken as megabytes. You can append a single letter to the number to select: (k)ilobytes, (m)egabytes, (g)igabytes or (s)ectors (e.g. 170k, 4488m, 350000s). |
|
31 .br |
|
32 (default: 650m) |
25 |
33 |
26 .TP |
34 .TP |
27 \fB\-t\fR \fItrack\fP |
35 \fB\-t\fR \fItrack\fP |
28 The number of the data track on the media for reading the backup. |
36 The number of the data track on the media for reading the backup. |
29 .br |
37 .br |
30 (default: none) |
38 (default: none) |
31 |
39 |
32 .TP |
40 .TP |
33 \fB\-T\fR |
41 \fB\-T\fR |
34 Enables test mode. The complete restore process is done to test data integrity, but no data is output. |
42 Enables test mode. The complete restore process is done to test data integrity (includes CRC checksum test, if available), but no data is output. |
35 .br |
43 .br |
36 \fINOTE:\fR This only verifies that the data is readable by cdrestore at all. This doesn't quaranties that your backup software will be able to do a real restore with the data. |
44 \fINOTE:\fR This only verifies that the data is readable by cdrestore at all. This doesn't guarantee that your backup software will be able to do a real restore with the data. |
37 |
45 |
38 .TP |
46 .TP |
39 \fB\-F\fR |
47 \fB\-F\fR |
40 Forces cdrestore to begin the restore in the middle of a multi\-disk set. This may be usefull if you have lost a disk or a disk is badly damaged. |
48 Forces cdrestore to begin the restore in the middle of a multi\-disk set. This may be usefull if you have lost a disk or a disk is badly damaged. |
41 .br |
49 .br |
67 .TP |
75 .TP |
68 \fB\-V\fR |
76 \fB\-V\fR |
69 Prints out version information and exits. |
77 Prints out version information and exits. |
70 .SH "EXAMPLES" |
78 .SH "EXAMPLES" |
71 .LP |
79 .LP |
72 To query the 700 MB media on /dev/sr0: |
80 Query the 700 MB media on /dev/sr0: |
73 .IP |
81 .IP |
74 cdrestore \-d /dev/sr0 \-l 700 \-q |
82 cdrestore \-d /dev/sr0 \-l 700 \-q |
75 |
83 |
76 .LP |
84 .LP |
77 To restore a tar archive to the current directory from track 2 of a 702 MB media on /dev/scd0: |
85 Restore a tar archive to the current directory from track 2 of a 702 MB media on /dev/scd0: |
78 .IP |
86 .IP |
79 cdrestore \-d /dev/scd0 \-l 702 \-t 2 | tar xf \- |
87 cdrestore \-d /dev/scd0 \-l 702 \-t 2 | tar xf \- |
|
88 |
|
89 .LP |
|
90 Query the contents of a virtual image: |
|
91 .IP |
|
92 cdrestore \-i /tmp/vimage \-l 4488m \-q |
|
93 |
|
94 .LP |
|
95 Check data integrity of track 3 in a virtual image after dumping it to DVD media: |
|
96 .IP |
|
97 cdrestore \-i /dev/dvd \-t 3 \-T |
80 .SH "AUTHORS" |
98 .SH "AUTHORS" |
81 .LP |
99 .LP |
82 Stefan Hülswitt <huels@iname.com> |
100 Stefan Hülswitt <s.huelswitt@gmx.de> |
83 .SH "SEE ALSO" |
101 .SH "SEE ALSO" |
84 .LP |
102 .LP |
85 \fBcdbackup\fR(1) |
103 \fBcdbackup\fR(1) |
86 .SH "LICENSE" |
104 .SH "LICENSE" |
87 Copyright (c) 2000\-2002 Craig Condit, Stefan Hülswitt. |
105 Copyright (c) 2000\-2004 Craig Condit, Stefan Hülswitt. |
88 |
106 |
89 Redistribution and use in source and binary forms, with or without |
107 Redistribution and use in source and binary forms, with or without |
90 modification, are permitted provided that the following conditions are met: |
108 modification, are permitted provided that the following conditions are met: |
91 |
109 |
92 .TP |
110 .TP |