Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
GVINUM(8)		  BSD System Manager's Manual		     GVINUM(8)

     gvinum -- Logical Volume Manager control program

     gvinum [command] [-options]

     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.

	     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

     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.

	     Reset the complete	gvinum configuration.

     rm	[-r] volume | plex | subdisk
	     Remove an object and, if -r is specified, its subordinate ob-

	     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

     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.

     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

     -v	     The -v ("verbose")	option provides	more detailed output.

     -V	     The -V ("very verbose") option provides even more detailed	output
	     than -v.

     EDITOR  The name of the editor to use for editing configuration files, by
	     default vi(1) is invoked.

     /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

     geom(4), geom(8)

     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.

     Lukas Ertl	<>
     Chris Jones <>

     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

     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

     dumpconfig	[drive ...]
	     List the configuration information	stored on the specified
	     drives, or	all drives in the system if no drive names are speci-

     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


Want to link to this manual page? Use this URL:

home | help