FreeBSD Manual Pages
GVINUM(8) BSD System Manager's Manual GVINUM(8) NAME gvinum -- Logical Volume Manager control program SYNOPSIS gvinum [command] [-options] COMMANDS checkparity [-f] plex Check the parity blocks of a RAID-5 plex. The parity check will start at the beginning of the plex if the -f flag is specified, or otherwise at the location of the parity check pointer, the first location at which plex's parity is incorrect. All subdisks in the plex must be up for a parity check. create [description-file] Create a volume as described in description-file. If no description-file provided, opens an editor and provides the cur- rent gvinum configuration for editing. help Provides a synopsis of gvinum commands and arguments. l | list [-rvV] [volume | plex | subdisk] ld [-rvV] [drive ...] ls [-rvV] [subdisk ...] lp [-rvV] [plex ...] lv [-rvV] [volume ...] List information about the relevant object(s). The -r flag pro- vides recursive display, showing each object's subordinate ob- jects in proper relation. The -v and -V flags provide progres- sively more detailed output. move | mv -f drive subdisk [...] Move the subdisk(s) to the specified drive. The -f flag is re- quired, as all data on the indicated subdisk(s) will be destroyed as part of the move. This can currently only be done when the subdisk is not being accessed. If the subdisk(s) form part of a RAID-5 plex, the disk(s) will need to be set to the "up" state and the plex will require a rebuildparity command; if the subdisk(s) form part of a plex that is mirrored with other plexes, the plex will require restarting and will sync once restarted. Moving more than one subdisk in a RAID-5 plex or subdisks from both sides of a mirrored plex volume will destroy data. Note that parity rebuilds and syncing must be started manually after a move. printconfig Write a copy of the current configuration to standard output. quit Exit gvinum when running in interactive mode. Normally this would be done by entering the EOF character. rename [-r] drive | subdisk | plex | volume newname Change the name of the specified object. The -r flag will recur- sively rename subordinate objects. Note that device nodes will not be renamed until gvinum is restarted. rebuildparity [-f] plex Rebuild the parity blocks of a RAID-5 plex. The parity rebuild will start at the beginning of the plex if the -f flag is speci- fied, or otherwise at the location of the parity check pointer. All subdisks in the plex must be up for a parity check. resetconfig Reset the complete gvinum configuration. rm [-r] volume | plex | subdisk Remove an object and, if -r is specified, its subordinate ob- jects. saveconfig Save gvinum configuration to disk after configuration failures. setstate [-f] state volume | plex | subdisk | drive Set state without influencing other objects, for diagnostic pur- poses only. The -f flag forces state changes regardless of whether they are legal. start Read configuration from all vinum drives. start [-S size] volume | plex | subdisk Allow the system to access the objects. The -S flag is currently ignored. DESCRIPTION The gvinum utility communicates with the kernel component of the GVinum logical volume manager. It is designed either for interactive use, when started without command line arguments, or to execute a single command if the command is supplied on the command line. In interactive mode, gvinum maintains a command line history. OPTIONS The gvinum commands may be followed by an option. -f The -f ("force") option overrides safety checks. It should be used with extreme caution. This option is required in order to use the move command. -r The -r ("recursive") option applies the command recursively to subordinate objects. For example, in conjunction with the lv command, the -r option will also show information about the plexes and subdisks belonging to the volume. It is also used by the rename command to indicate that subordinate objects such as subdisks should be renamed to match the object(s) specified and by the rm command to delete plexes belonging to a volume and so on. -v The -v ("verbose") option provides more detailed output. -V The -V ("very verbose") option provides even more detailed output than -v. ENVIRONMENT EDITOR The name of the editor to use for editing configuration files, by default vi(1) is invoked. FILES /dev/gvinum directory with device nodes for gvinum objects /dev/gvinum/plex directory containing device nodes for gvinum plexes /dev/gvinum/sd directory containing device nodes for gvinum subdisks SEE ALSO geom(4), geom(8) HISTORY The gvinum utility first appeared in FreeBSD 5.3. The vinum utility, on which gvinum is based, was written by Greg Lehey. The gvinum utility was written by Lukas Ertl. The move and rename com- mands and documentation were added by Chris Jones through the 2005 Google Summer of Code program. AUTHORS Lukas Ertl <le@FreeBSD.org> Chris Jones <soc-cjones@FreeBSD.org> BUGS Currently, gvinum does not rename devices in /dev/gvinum until reloaded. The -S initsize flag to start is ignored. The stop command does not work. Moving subdisks that are not part of a mirrored or RAID-5 volume will de- stroy data. It is perhaps a bug to permit this. Plexes in which subdisks have been moved do not automatically sync or re- build parity. This may leave data unprotected and is perhaps unwise. Currently, gvinum does not yet fully implement all of the functions found in vinum(4). Specifically, the following commands from vinum(4) are not supported: attach plex volume [rename] attach subdisk plex [offset] [rename] Attach a plex to a volume, or a subdisk to a plex. concat [-fv] [-n name] drives Create a concatenated volume from the specified drives. debug Cause the volume manager to enter the kernel debugger. debug flags Set debugging flags. detach [-f] [plex | subdisk] Detach a plex or subdisk from the volume or plex to which it is attached. dumpconfig [drive ...] List the configuration information stored on the specified drives, or all drives in the system if no drive names are speci- fied. info [-vV] List information about volume manager state. label volume Create a volume label. mirror [-fsv] [-n name] drives Create a mirrored volume from the specified drives. resetstats [-r] [volume | plex | subdisk] Reset statistics counters for the specified objects, or for all objects if none are specified. setdaemon [value] Set daemon configuration. stop [-f] [volume | plex | subdisk] Terminate access to the objects, or stop gvinum if no parameters are specified. stripe [-fv] [-n name] drives Create a striped volume from the specified drives. BSD March 23, 2006 BSD
NAME | SYNOPSIS | COMMANDS | DESCRIPTION | OPTIONS | ENVIRONMENT | FILES | SEE ALSO | HISTORY | AUTHORS | BUGS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gvinum&sektion=8&manpath=FreeBSD+7.0-RELEASE>