Mercurial > illumos > illumos-gate
changeset 13545:b35304501ec3
1888 zfs(1M) should mention zfs recv -e
Reviewed by: Garrett D'Amore <garrett@damore.org>
Reviewed by: Eric Schrock <eric.schrock@delphix.com>
Reviewed by: Gordon Ross <gordon.w.ross@gmail.com>
Approved by: Richard Lowe <richlowe@richlowe.net>
author | Joshua M. Clulow <josh@sysmgr.org> |
---|---|
date | Fri, 16 Dec 2011 15:38:30 +1100 |
parents | 4fd590021359 |
children | 6d7e5def82fb |
files | usr/src/man/man1m/zfs.1m |
diffstat | 1 files changed, 31 insertions(+), 9 deletions(-) [+] |
line wrap: on
line diff
--- a/usr/src/man/man1m/zfs.1m Thu Dec 15 09:58:29 2011 +0300 +++ b/usr/src/man/man1m/zfs.1m Fri Dec 16 15:38:30 2011 +1100 @@ -6,6 +6,7 @@ .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] .\" Copyright 2011 Nexenta Systems, Inc. All rights reserved. .\" Copyright 2011 by Delphix. All rights reserved. +.\" Copyright 2011 Joshua M. Clulow <josh@sysmgr.org> .TH ZFS 1M "28 Jul 2011" .SH NAME zfs \- configures ZFS file systems @@ -153,7 +154,7 @@ .LP .nf -\fBzfs\fR \fBreceive\fR [\fB-vnFu\fR] \fB-d\fR \fIfilesystem\fR +\fBzfs\fR \fBreceive\fR [\fB-vnFu\fR] [\fB-d\fR|\fB-e\fR] \fIfilesystem\fR .fi .LP @@ -2850,7 +2851,7 @@ .ad .br .na -\fB\fBzfs receive\fR [\fB-vnFu\fR] \fB-d\fR \fIfilesystem\fR\fR +\fB\fBzfs receive\fR [\fB-vnFu\fR] [\fB-d\fR|\fB-e\fR] \fIfilesystem\fR\fR .ad .sp .6 .RS 4n @@ -2872,15 +2873,23 @@ command. .sp The name of the snapshot (and file system, if a full stream is received) that -this subcommand creates depends on the argument type and the \fB-d\fR option. +this subcommand creates depends on the argument type and the use of the +\fB-d\fR or \fB-e\fR options. .sp If the argument is a snapshot name, the specified \fIsnapshot\fR is created. If the argument is a file system or volume name, a snapshot with the same name as the sent snapshot is created within the specified \fIfilesystem\fR or -\fIvolume\fR. If the \fB-d\fR option is specified, the snapshot name is -determined by appending the sent snapshot's name to the specified -\fIfilesystem\fR. If the \fB-d\fR option is specified, any required file -systems within the specified one are created. +\fIvolume\fR. If neither of the \fB-d\fR or \fB-e\fR options are specified, +the provided target snapshot name is used exactly as provided. +.sp +The \fB-d\fR and \fB-e\fR options cause the file system name of the target +snapshot to be determined by appending a portion of the sent snapshot's name to +the specified target \fIfilesystem\fR. If the \fB-d\fR option is specified, all +but the first element of the sent snapshot's file system path (usually the +pool name) is used and any required intermediate file systems within the +specified one are created. If the \fB-e\fR option is specified, then only the +last element of the sent snapshot's file system name (i.e. the name of the +source file system itself) is used as the target file system name. .sp .ne 2 .na @@ -2888,8 +2897,21 @@ .ad .sp .6 .RS 4n -Use the name of the sent snapshot to determine the name of the new snapshot as -described in the paragraph above. +Discard the first element of the sent snapshot's file system name, using +the remaining elements to determine the name of the target file system for +the new snapshot as described in the paragraph above. +.RE + +.sp +.ne 2 +.na +\fB\fB-e\fR\fR +.ad +.sp .6 +.RS 4n +Discard all but the last element of the sent snapshot's file system name, +using that element to determine the name of the target file system for +the new snapshot as described in the paragraph above. .RE .sp