Интерактивная система просмотра системных руководств (man-ов)
gvinum (8)
>> gvinum (8) ( FreeBSD man: Команды системного администрирования )
BSD mandoc
NAME
gvinum
- Logical Volume Manager control program
SYNOPSIS
[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 current
configuration for editing.
help
Provides a synopsis of
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 provides recursive display, showing each object's subordinate objects in
proper relation.
The
-v
and
-V
flags provide progressively more detailed output.
move | mv -f drive subdisk [...
]
Move the subdisk(s) to the specified drive.
The
-f
flag is required, 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
when running in interactive mode.
Normally this would be done by entering the
EOF character.
Change the name of the specified object.
The
-r
flag will recursively rename subordinate objects.
Note that device nodes will not be renamed until
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 specified, 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
configuration.
rm [-r volume | plex | subdisk
]
Remove an object and, if
-r
is specified, its subordinate objects.
saveconfig
Save
configuration to disk after configuration failures.
Set state without influencing other objects, for diagnostic purposes
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
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,
maintains a command line history.
OPTIONS
The
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.
The
utility first appeared in
Fx 5.3 .
The
vinum
utility, on which
is based, was written by
An Greg Lehey .
The
utility
was written by
An Lukas Ertl .
The
move
and
rename
commands and
documentation were added by
An Chris Jones
through the 2005 Google Summer
of Code program.
