[Evms-cvs-commits] evms2/engine/tests evms_deactivate.8,NONE,1.1

[<kc...@us...>]

Update of /cvsroot/evms/evms2/engine/tests
In directory sc8-pr-cvs1:/tmp/cvs-serv3001/tests

Added Files:
	evms_deactivate.8 
Log Message:
Moving evms_deactivate.8 from doc/man/ to tests/, since evms_deactivate is
no longer an official utility.


--- NEW FILE: evms_deactivate.8 ---
.\" Copyright (C) 2003 IBM
.\" This file is distributed according to the GNU General Public License.
.\" See the file COPYING in the top level source directory for details.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
..
.de Sp 
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "EVMS_DEACTIVATE" 8 "2003-05-30" "Linux 2.5" "Linux System Administration"
.SH NAME
evms_deactivate \- Deactivate EVMS volumes
.SH "SYNOPSIS"
.ad l
.hy 0

evms_deactivate [no options]
.sp
.ad
.hy

.SH "DESCRIPTION"

.PP
The \fBevms_deactivate\fR command tells the Device-Mapper driver to deactivate all active devices. \fBevms_deactivate\fR can be run at system shutdown or reboot time to cleanly deactivate EVMS volumes. Running the command is not a strict requirement for EVMS to operate properly; \fBevms_deactivate\fR is simply a convenient complement to the \fBevms_activate\fR command. \fBevms_deactivate\fR is also a useful tool that can be used during development and testing of EVMS.

.SH "NOTES"

.PP
When a Device-Mapper device is deactivated, the kernel does not actually remove it from memory unless the device has no active users. Thus, if a device is mounted when \fBevms_deactivate\fR is run, the device will not actually be deactivated until it is unmounted (even though \fBevms_deactivate\fR will complete successfully). This behavior is analogous to how files are deleted from a file system, where the storage space for the file is not freed until the usage count for the file goes to zero.

.PP
The \fBevms_deactivate\fR only deactivates Device-Mapper devices. Software-RAID devices are handled by the MD driver and will be automatically deactivated a reboot time by the kernel. Thus, running this command on a running system that has a combination of Device-Mapper and Software-RAID devices may produce unexpected results.

.SH "SEE ALSO"

.PP
\fBevms\fR(8), \fBevms_activate\fR(8), \fBevms_gather_info\fR(8), http://evms.sourceforge.net/

.SH AUTHOR
Kevin Corry