1.\" 2.\" CDDL HEADER START 3.\" 4.\" The contents of this file are subject to the terms of the 5.\" Common Development and Distribution License (the "License"). 6.\" You may not use this file except in compliance with the License. 7.\" 8.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9.\" or http://www.opensolaris.org/os/licensing. 10.\" See the License for the specific language governing permissions 11.\" and limitations under the License. 12.\" 13.\" When distributing Covered Code, include this CDDL HEADER in each 14.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15.\" If applicable, add the following below this CDDL HEADER, with the 16.\" fields enclosed by brackets "[]" replaced with your own identifying 17.\" information: Portions Copyright [yyyy] [name of copyright owner] 18.\" 19.\" CDDL HEADER END 20.\" 21.\" Copyright (c) 2020 by Delphix. All rights reserved. 22.\" 23.Dd May 8, 2021 24.Dt ZSTREAM 8 25.Os 26. 27.Sh NAME 28.Nm zstream 29.Nd manipulate ZFS send streams 30.Sh SYNOPSIS 31.Nm 32.Cm dump 33.Op Fl Cvd 34.Op Ar file 35.Nm 36.Cm redup 37.Op Fl v 38.Ar file 39.Nm 40.Cm token 41.Ar resume_token 42. 43.Sh DESCRIPTION 44The 45.Sy zstream 46utility manipulates ZFS send streams output by the 47.Sy zfs send 48command. 49.Bl -tag -width "" 50.It Xo 51.Nm 52.Cm dump 53.Op Fl Cvd 54.Op Ar file 55.Xc 56Print information about the specified send stream, including headers and 57record counts. 58The send stream may either be in the specified 59.Ar file , 60or provided on standard input. 61.Bl -tag -width "-D" 62.It Fl C 63Suppress the validation of checksums. 64.It Fl v 65Verbose. 66Print metadata for each record. 67.It Fl d 68Dump data contained in each record. 69Implies verbose. 70.El 71.Pp 72The 73.Nm zstreamdump 74alias is provided for compatibility and is equivalent to running 75.Nm 76.Cm dump . 77.It Xo 78.Nm 79.Cm token 80.Ar resume_token 81.Xc 82Dumps zfs resume token information 83.It Xo 84.Nm 85.Cm redup 86.Op Fl v 87.Ar file 88.Xc 89Deduplicated send streams can be generated by using the 90.Nm zfs Cm send Fl D 91command. 92The ability to send deduplicated send streams is deprecated. 93In the future, the ability to receive a deduplicated send stream with 94.Nm zfs Cm receive 95will be removed. 96However, deduplicated send streams can still be received by utilizing 97.Nm zstream Cm redup . 98.Pp 99The 100.Nm zstream Cm redup 101command is provided a 102.Ar file 103containing a deduplicated send stream, and outputs an equivalent 104non-deduplicated send stream on standard output. 105Therefore, a deduplicated send stream can be received by running: 106.Dl # Nm zstream Cm redup Pa DEDUP_STREAM_FILE | Nm zfs Cm receive No … 107.Bl -tag -width "-D" 108.It Fl v 109Verbose. 110Print summary of converted records. 111.El 112.El 113. 114.Sh SEE ALSO 115.Xr zfs 8 , 116.Xr zfs-receive 8 , 117.Xr zfs-send 8 118