source: gpfs_3.1_ker2.6.20/share/man/man8/mmdelsnapshot.8 @ 219

.TH mmdelsnapshot 02/16/06
mmdelsnapshot Command
.SH "Name"
.PP
\fBmmdelsnapshot\fR - Deletes a GPFS snapshot.
.SH "Synopsis"
.PP
\fBmmdelsnapshot\fR \fIDevice\fR \fIDirectory\fR
.SH "Description"
.PP
Use the \fBmmdelsnapshot\fR command to delete a GPFS snapshot.
.PP
Once the \fBmmdelsnapshot\fR command has been issued, the snapshot is
marked for deletion and cannot be recovered.
.PP
If the node from which the \fBmmdelsnapshot\fR command is issued fails,
you must reissue the command from another node in the cluster to complete the
deletion. Prior to reissuing a subsequent \fBmmdelsnapshot\fR
command, the file system may be recovered, mounted, and updates may continue
to be made and the
\fBmmcrsnapshot\fR command may be
issued. However, the
\fBmmrestorefs\fR and
\fBmmdelsnapshot\fR commands may not be issued on other snapshots until the
present snapshot is successfully deleted.
.PP
If the \fBmmdelsnapshot\fR command is issued while a conflicting command
is running, the \fBmmdelsnapshot\fR command waits for that command to
complete. Conflicting operations include: 
.RS +3
.HP 3
1. Other snapshot commands on the same snapshot
.HP 3
2. Adding, deleting, replacing disks in the file system
.HP 3
3. Rebalancing, repairing, reducing disk fragmentation in a file system
.RE
.PP
Any files open in the snapshot will be forcibly closed. The
user will receive an \fBerrno\fR of \fBESTALE\fR on the next file
access.
.SH "Parameters"
.PP
.RS +3
\fB\fIDevice\fR
\fR
.RE
.RS +9
The device name of the file system for which the snapshot is to be
deleted. File system names need not be fully-qualified.
\fBfs0\fR is just as acceptable as \fB/dev/fs0\fR.
.PP
This must be the first parameter.
.RE
.PP
.RS +3
\fB\fIDirectory\fR
\fR
.RE
.RS +9
The snapshot subdirectory to be deleted.
.RE
.SH "Options"
.PP
NONE
.SH "Exit status"
.PP
.PP
.RS +3
\fB0
\fR
.RE
.RS +9
Successful completion.
.RE
.PP
.RS +3
\fBnonzero
\fR
.RE
.RS +9
A failure has occurred.
.RE
.SH "Security"
.PP
You must have root authority to run the \fBmmdelsnapshot\fR
command.
.PP
You may issue the \fBmmdelsnapshot\fR command from any node in the GPFS
cluster.
.PP
When using the \fBrcp\fR and \fBrsh\fR commands for remote
communication, a properly configured \fB.rhosts\fR file must exist
in the root user's home directory on each node in the GPFS
cluster. If you have designated the use of a different remote
communication program on either the
\fBmmcrcluster\fR
or the
\fBmmchcluster\fR command, you must
ensure:
.RS +3
.HP 3
1. Proper authorization is granted to all nodes in the GPFS cluster.
.HP 3
2. The nodes in the GPFS cluster can communicate without the use of a
password, and without any extraneous messages.
.RE
.SH "Examples"
.PP
To delete the snapshot \fBsnap1\fR, for the file system \fBfs1\fR,
issue this command:
.sp
.nf
mmdelsnapshot fs1 snap1
.fi
.sp
.PP
The output is similar to this:
.sp
.nf
Deleting snapshot files...
Delete snapshot snap1 complete, err = 0
.fi
.sp
.PP
Before issuing the command, the directory structure would appear similar
to:
.sp
.nf
/fs1/file1
/fs1/userA/file2
/fs1/userA/file3
/fs1/.snapshots/snap1/file1
/fs1/.snapshots/snap1/userA/file2
/fs1/.snapshots/snap1/userA/file3
.fi
.sp
.PP
After the command has been issued, the directory structure would appear
similar to:
.sp
.nf
/fs1/file1
/fs1/userA/file2
/fs1/userA/file3
/fs1/.snapshots
.fi
.sp
.SH "See also"
.PP
mmcrsnapshot Command
.PP
mmlssnapshot Command
.PP
mmrestorefs Command
.PP
mmsnapdir Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR
.PP