genvol - Generates an Auristor volume dump from a file hierarchy
genvol [-verbose] [-norecurse] [-noxdev] [-setacl <ptsid ACLrights>+] [-skipnode <skippath>] [-name <volume name>] [-id <volume id>] [-time <dumptime>] -file <dumpfile> [-mountpoint <mountpount>+ ] -items <[files]>+
The genvol command emits a Auristor volume dump file that can be restored with vos_restore(1). genvol takes a list of files or directories and builds a dump. Optional parameters allow adding Auristor-specific features to volume dump in addition to the files.
Be verbose. Print out information about each file.
Don't recurse into directories. Just include files from the specified directory.
Don't cross mount points. Only include files from the device with the directory specified for inclusion.
Specifies the volume ID number of the read/write, read-only, or backup volume to claim in the dump.
Specifies the volume name of the read/write, read-only, or backup volume to claim in the dump.
Specifies whether the dump is full or incremental. Omit this argument to create a full dump, or provide one of three acceptable values:
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 begin with
An example is
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
Specifies the pathname of the file to which to write the dump. The file can be in /afs. 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.
Specifies the files and directories to be included in the dump. Unless norecurse is specified, directories will be traversed and children included.
Creates a mountpoint in the dump.
The format of each mountpoint is
relative path:[% or #][cellname:]volumename,
The relative path specifies where the mount point will be inserted, potentially replacing an object which otherwise would have been included as a child of a directory specified in -items.
A number sign (
#) precedes the <volume name> string for a regular mount point.
A percent sign (
%) precedes the <volume name> string for a read/write mount point.
A cell name and colon (
:) follow the number or percent sign and precede the <volume name> string for a cellular mount point.
Describes an access list which is applied recursively to all directories in the dump.
The list is formatted as pairs of numeric pts ids and access control bits as described in fs_setacl.
-101 rl -A -204 rlidwka would set an ACL with system:anyuser read and system:administrators all.
A list of files and directories to be omitted from the emitted dump.
The following command creates a dump of a volume named
user.bill with volume number
100 in a file named bill.dump,
with an access control list allowing AUN
102 full access,
and members of group
system:anyuser read access to all files,
including all files in the directory home as well as the file named readme.txt,
omitting the file home/private.txt,
and including a mountpoint at home/www for a volume named user.bill.www.
% /usr/sbin/genvol -setacl 102 rlidwka -101 rl \ -items home readme.txt -skipnode home/private.txt \ -mountpoint home/www:#user.bill.www -name user.bill \ -id 100
The issuer must be logged in as a user who can read all specified files.
fs_setacl(1), vos_dump(1), vos_restore(1)
Copyright AuriStor, Inc. 2014-2020. https://www.auristor.com/ All Rights Reserved.
"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)
"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)
The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).
"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).
"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.