summaryrefslogtreecommitdiffstats
path: root/sbin/dump
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2003-02-23 01:50:07 +0000
committerru <ru@FreeBSD.org>2003-02-23 01:50:07 +0000
commit8a2a9091301e63f3908b341bcc984162e59a845d (patch)
treef358c6eb2249574e755e6d64c4b7ce42f92a6fb8 /sbin/dump
parent5ecd4995a53ef83a3ed6cc0e466632e66719f8c0 (diff)
downloadFreeBSD-src-8a2a9091301e63f3908b341bcc984162e59a845d.zip
FreeBSD-src-8a2a9091301e63f3908b341bcc984162e59a845d.tar.gz
Sort options.
Diffstat (limited to 'sbin/dump')
-rw-r--r--sbin/dump/dump.859
-rw-r--r--sbin/dump/main.c34
2 files changed, 53 insertions, 40 deletions
diff --git a/sbin/dump/dump.8 b/sbin/dump/dump.8
index 424e4b3..350792d 100644
--- a/sbin/dump/dump.8
+++ b/sbin/dump/dump.8
@@ -45,8 +45,8 @@
.Op Fl 0123456789ackLnSu
.Op Fl B Ar records
.Op Fl b Ar blocksize
-.Op Fl D Ar dumpdates
.Op Fl C Ar cachesize
+.Op Fl D Ar dumpdates
.Op Fl d Ar density
.Op Fl f Ar file
.Op Fl h Ar level
@@ -80,7 +80,8 @@ option below for doing remote backups).
A dump that is larger than the output medium is broken into
multiple volumes.
On most media the size is determined by writing until an
-end-of-media indication is returned. This can be enforced
+end-of-media indication is returned.
+This can be enforced
by using the
.Fl a
option.
@@ -103,7 +104,7 @@ as either its device-special file or its mount point
The following options are supported by
.Nm :
.Bl -tag -width Ds
-.It Fl 0\-9
+.It Fl 0-9
Dump levels.
A level 0, full backup,
guarantees the entire file system is copied
@@ -119,8 +120,9 @@ The default level is 0.
.It Fl a
.Dq auto-size .
Bypass all tape length considerations, and enforce writing
-until an end-of-media indication is returned. This fits best
-for most modern tape drives. Use of this option is particularly
+until an end-of-media indication is returned.
+This fits best for most modern tape drives.
+Use of this option is particularly
recommended when appending to an existing tape, or using a tape
drive with hardware compression (where you can never be sure about
the compression ratio).
@@ -132,8 +134,24 @@ This option overrides the calculation of tape size
based on length and density.
.It Fl b Ar blocksize
The number of kilobytes per output block, except that if it is
-larger than 64, the command uses 64. (See the BUGS section.)
+larger than 64, the command uses 64.
+(See the
+.Sx BUGS
+section.)
The default block size is 10.
+.It Fl C Ar cachesize
+Specify the cache size in megabytes.
+This will greatly improve performance
+at the cost of
+.Nm
+possibly not noticing changes in the file system between passes.
+It is
+recommended that you always use this option when dumping a snapshot.
+Beware that
+.Nm
+forks, and the actual memory use may be larger than the specified cache
+size.
+The recommended cache size is between 8 and 32 (megabytes).
.It Fl c
Change the defaults for use with a cartridge tape drive, with a density
of 8000 bpi, and a length of 1700 feet.
@@ -143,16 +161,6 @@ Specify an alternate path to the
file.
The default is
.Pa /etc/dumpdates .
-.It Fl C Ar cachesize
-Specify the cache size in megabytes. This will greatly improve performance
-at the cost of
-.Nm
-possibly not noticing changes in the filesystem between passes. It is
-recommended that you always use this option when dumping a snapshot.
-Beware that
-.Nm
-forks, and the actual memory use may be larger then the specified cache
-size. The recommended cache size is between 8 and 32 (megabytes).
.It Fl d Ar density
Set tape density to
.Ar density .
@@ -201,7 +209,8 @@ The default honor level is 1,
so that incremental backups omit such files
but full backups retain them.
.It Fl k
-Use Kerberos authentication to talk to remote tape servers. (Only
+Use Kerberos authentication to talk to remote tape servers.
+(Only
available if this option was enabled when
.Nm
was compiled.)
@@ -222,6 +231,9 @@ notify all operators in the group
.Dq operator
by means similar to a
.Xr wall 1 .
+.It Fl S
+Display an estimate of the backup size and the number of
+tapes required, and exit without actually performing the dump.
.It Fl s Ar feet
Attempt to calculate the amount of tape needed
at a particular density.
@@ -230,9 +242,6 @@ If this amount is exceeded,
prompts for a new tape.
It is recommended to be a bit conservative on this option.
The default tape length is 2300 feet.
-.It Fl S
-Display an estimate of the backup size and the number of
-tapes required, and exit without actually performing the dump.
.It Fl T Ar date
Use the specified date as the starting time for the dump
instead of the time determined from looking in
@@ -299,7 +308,9 @@ option is set, all other options are ignored, and
.Nm
exits immediately.
.It Fl w
-Is like W, but prints only those file systems which need to be dumped.
+Is like
+.Fl W ,
+but prints only those file systems which need to be dumped.
.El
.Pp
Directories and regular files which have their
@@ -442,7 +453,8 @@ is written.
.Pp
Currently,
.Xr physio 9
-slices all requests into chunks of 64 KB. Therefore, it is
+slices all requests into chunks of 64 KB.
+Therefore, it is
impossible to use a larger output block size, so
.Nm
will prevent this from happening.
@@ -472,7 +484,8 @@ for the operator running
The
.Nm
utility cannot do remote backups without being run as root, due to its
-security history. This will be fixed in a later version of
+security history.
+This will be fixed in a later version of
.Fx .
Presently, it works if you set it setuid (like it used to be), but this
might constitute a security risk.
diff --git a/sbin/dump/main.c b/sbin/dump/main.c
index 6784b55..b540383 100644
--- a/sbin/dump/main.c
+++ b/sbin/dump/main.c
@@ -128,9 +128,9 @@ main(int argc, char *argv[])
obsolete(&argc, &argv);
#ifdef KERBEROS
-#define optstring "0123456789aB:b:cd:f:h:kLns:ST:uWwD:C:"
+#define optstring "0123456789aB:b:C:cD:d:f:h:kLnSs:T:uWw"
#else
-#define optstring "0123456789aB:b:cd:f:h:Lns:ST:uWwD:C:"
+#define optstring "0123456789aB:b:C:cD:d:f:h:LnSs:T:uWw"
#endif
while ((ch = getopt(argc, argv, optstring)) != -1)
#undef optstring
@@ -155,10 +155,18 @@ main(int argc, char *argv[])
1L, 1000L);
break;
+ case 'C':
+ cachesize = numarg("cachesize", 0, 0) * 1024 * 1024;
+ break;
+
case 'c': /* Tape is cart. not 9-track */
cartridge = 1;
break;
+ case 'D':
+ dumpdates = optarg;
+ break;
+
case 'd': /* density, in bits per inch */
density = numarg("density", 10L, 327670L) / 10;
if (density >= 625 && !bflag)
@@ -169,14 +177,6 @@ main(int argc, char *argv[])
tape = optarg;
break;
- case 'D':
- dumpdates = optarg;
- break;
-
- case 'C':
- cachesize = numarg("cachesize", 0, 0) * 1024 * 1024;
- break;
-
case 'h':
honorlevel = numarg("honor level", 0L, 10L);
break;
@@ -195,14 +195,14 @@ main(int argc, char *argv[])
notify = 1;
break;
- case 's': /* tape size, feet */
- tsize = numarg("tape size", 1L, 0L) * 12 * 10;
- break;
-
case 'S': /* exit after estimating # of tapes */
just_estimate = 1;
break;
+ case 's': /* tape size, feet */
+ tsize = numarg("tape size", 1L, 0L) * 12 * 10;
+ break;
+
case 'T': /* time of last dump */
spcl.c_ddate = unctime(optarg);
if (spcl.c_ddate < 0) {
@@ -576,9 +576,9 @@ usage(void)
#ifdef KERBEROS
"k"
#endif
- "nSu] [-B records] [-b blocksize] [-D dumpdates]\n"
- " [-d density] [-f file] [-h level] [-s feet]\n"
- " [-T date] [-C cachesizeMB] filesystem\n"
+ "LnSu] [-B records] [-b blocksize] [-C cachesize]\n"
+ " [-D dumpdates] [-d density] [-f file] [-h level] [-s feet]\n"
+ " [-T date] filesystem\n"
" dump -W | -w\n");
exit(X_STARTUP);
}
OpenPOWER on IntegriCloud