Manual Reference Pages - VOS_DUMP (1)
vos_dump - Converts a volume into ASCII format and writes it to a file
vos dump -id <volume name or ID>
[-time <dump from time>]
[-file <dump file>] [-server <server>]
[-partition <partition>] [-clone] [-omitdirs]
[-cell <cell name>] [-noauth] [-localauth]
[-verbose] [-encrypt] [-noresolve] [-help]
vos du -i <volume name or ID>
[-t <dump from time>]
[-f <dump file>] [-s <server>]
[-cl] [-o] [-ce <cell name>] [-noa] [-l]
[-v] [-e] [-nor] [-h]
The vos dump command converts the contents of the indicated volume,
which can be read/write, read-only or backup, into ASCII format. The
Volume Server writes the converted contents to the file named by the
-file argument, or to the standard output stream. In the latter case,
the output can be directed to a named pipe, which enables interoperation
with third-party backup utilities.
To dump the complete contents of a volume (create a full dump), omit
the -time argument or specify the value 0 (zero) for it. To create
an incremental dump, which includes only the files and directories in
the volume that have modification timestamps later than a certain time,
specify a date and time as the value for the -time argument.
By default, the vos command interpreter consults the Volume Location
Database (VLDB) to learn the volumes location, so the -server and
-partition arguments are not required. If the -id argument
identifies a read-only volume that resides at multiple sites, the command
dumps the version from just one of them (normally, the one listed first in
the volumes VLDB entry as reported by the vos examine or vos
listvldb command). To dump the read-only volume from a particular site,
use the -server and -partition arguments to specify the site. To
bypass the VLDB lookup entirely, provide a volume ID number (rather than a
volume name) as the value for the -id argument, together with the
-server and -partition arguments. This makes it possible to dump a
volume for which there is no VLDB entry.
During the dump operation, the volume is inaccessible both to Cache
Managers and to other volume operations. Dumping a volume does not
otherwise affect its status on the partition or its VLDB entry.
To restore a dumped volume back into AFS, use the vos restore command.
Support for incremental dumps is provided to facilitate interoperation
with third-party backup utilities. The vos dump command does not
provide any of the administrative facilities of an actual backup system,
so the administrator must keep manual records of dump times and the
relationship between full and incremental dumps of a volume. For a
volumes contents to be consistent after restoration of incremental dumps,
there must be no gap between the time at which a prior dump of the volume
was created and the value of the -time argument to the vos dump
command that creates the incremental dump. More specifically, for a
read/write volume, the -time argument must specify the time that the
prior dump was performed, and for a read-only or backup volume it must
specify the time that the volume was last released (using the vos
release command) or cloned (using the vos backup or vos backupsys
command) prior to dumping it. The parent dump can be either a full dump or
another incremental dump.
-id <volume name or ID>
Specifies either the complete name or volume ID number of the read/write,
read-only, or backup volume to dump.
-time <dump from time>
Specifies whether the dump is full or incremental. Omit this argument to
create a full dump, or provide one of three acceptable values:
The value 0 (zero) to create a full dump.
A date in the format mm/dd/yyyy (month, day and year) to
create an incremental dump that includes only files and directories with
modification timestamps later than midnight (12:00 a.m.) on the indicated
date. Valid values for the year range from 1970 to 2037; higher
values are not valid because the latest possible date in the standard UNIX
representation is in 2038. The command interpreter automatically reduces
later dates to the maximum value. An example is 01/13/1999.
A date and time in the format "mm/dd/yyyy
hh:MM" to create an incremental dump that includes only files
and directories with modification timestamps later than the specified date
and time. The date format is the same as for a date alone. Express the
time as hours and minutes (hh:MM) in 24-hour format (for example,
20:30 is 8:30 p.m.). Surround the entire expression with double quotes
("") because it contains a space. An example is "01/13/1999 22:30".
-file <dump file>
Specifies the pathname of the file to which to write the dump. The file
can be in AFS, but not in the volume being dumped. A partial pathname is
interpreted relative to the current working directory. If this argument is
omitted, the dump is directed to the standard output stream.
-server <server name>
Specifies the file server machine on which the volume resides. Provide
the -partition argument along with this one.
-partition <partition name>
Specifies the partition on which the volume resides. Provide the
-server argument along with this one.
Normally, vos dump locks the volume and dumps it, which blocks writes
to the volume while the dump is in progress. If this flag is given, vos
dump will instead clone the volume first (similar to what vos move
would do) and then dumps the clone. This can significantly decrease the
amount of time the volume is kept locked for dumps of large volumes.
By default, vos dump includes all directory objects in an incremental
dump whether theyve been changed or not. If this option is given,
unchanged directories will be omitted. This will reduce the size of the
dump and not cause problems if the incremental is restored, as expected,
on top of a volume containing the correct directory structure (such as one
created by restoring previous full and incremental dumps).
-cell <cell name
Names the cell in which to run the command. Do not combine this argument
with the -localauth flag. For more details, see vos(1).
Assigns the unprivileged identity anonymous to the issuer. Do not combine
this flag with the -localauth flag. For more details, see vos(1).
Constructs a server ticket using a key from the local
/usr/local/etc/openafs/server/KeyFile file. The vos command interpreter presents it
to the Volume Server and Volume Location Server during mutual
authentication. Do not combine this flag with the -cell argument or
-noauth flag. For more details, see vos(1).
Produces on the standard error stream a detailed trace of the commands
execution. If this argument is omitted, only warnings and error messages
Encrypts the command so that the operations results are not transmitted
across the network in clear text. This option is available in OpenAFS
versions 1.4.11 or later and 1.5.60 or later.
Shows all servers as IP addresses instead of the DNS name. This is very
useful when the server address is registered as 127.0.0.1 or when dealing
with multi-homed servers. This option is available in OpenAFS
versions 1.4.8 or later and 1.5.35 or later.
Prints the online help for this command. All other valid options are
The following command writes a full dump of the volume user.terry to
the file /afs/abc.com/common/dumps/terry.dump.
% vos dump -id user.terry -time 0 -file /afs/abc.com/common/dumps/terry.dump
The following command writes an incremental dump of the volume
user.smith to the file smith.990131.dump in the current working
directory. Only those files in the volume with modification time stamps
later than 6:00 p.m. on 31 January 1999 are included in the dump.
% vos dump -id user.smith -time "01/31/1999 18:00" -file smith.990131.dump
The issuer must be listed in the /usr/local/etc/openafs/server/UserList file on the
machine specified with the -server argument and on each database server
machine. If the -localauth flag is included, the issuer must instead be
logged on to a server machine as the local superuser root.
If the -file argument is included, the issuer must also have permission
to insert and write in the directory that houses the file.
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
This documentation is covered by the IBM Public License Version 1.0. It was
converted from HTML to POD by software written by Chas Williams and Russ
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
|OpenAFS ||VOS_DUMP (1) ||2015-10-28 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.