aboutsummaryrefslogtreecommitdiffstats
path: root/man/man1
diff options
context:
space:
mode:
authorDarik Horn <[email protected]>2013-03-16 15:54:32 -0500
committerBrian Behlendorf <[email protected]>2013-03-19 13:29:13 -0700
commitac826e16682114ee7a41b7a4ca3d8fdde59d29dc (patch)
treef3dd2d0aff76246a62948fe6f69ba943eb3fcd61 /man/man1
parent5dc6af0eec29b119b731c793037fd77214fc9438 (diff)
Create fsck.zfs and zhack man pages.
The automake templates have been updated to install them, and the existing packaging will automatically include them. Signed-off-by: Brian Behlendorf <[email protected]> Supplements #518
Diffstat (limited to 'man/man1')
-rw-r--r--man/man1/Makefile.am2
-rw-r--r--man/man1/zhack.199
-rw-r--r--man/man1/ztest.12
3 files changed, 101 insertions, 2 deletions
diff --git a/man/man1/Makefile.am b/man/man1/Makefile.am
index 54ff9e54f..9d4439817 100644
--- a/man/man1/Makefile.am
+++ b/man/man1/Makefile.am
@@ -1,4 +1,4 @@
-man_MANS = zpios.1 ztest.1
+man_MANS = zhack.1 zpios.1 ztest.1
EXTRA_DIST = $(man_MANS)
install-data-local:
diff --git a/man/man1/zhack.1 b/man/man1/zhack.1
new file mode 100644
index 000000000..26a46f177
--- /dev/null
+++ b/man/man1/zhack.1
@@ -0,0 +1,99 @@
+'\" t
+.\"
+.\" CDDL HEADER START
+.\"
+.\" The contents of this file are subject to the terms of the
+.\" Common Development and Distribution License (the "License").
+.\" You may not use this file except in compliance with the License.
+.\"
+.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+.\" or http://www.opensolaris.org/os/licensing.
+.\" See the License for the specific language governing permissions
+.\" and limitations under the License.
+.\"
+.\" When distributing Covered Code, include this CDDL HEADER in each
+.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+.\" If applicable, add the following below this CDDL HEADER, with the
+.\" fields enclosed by brackets "[]" replaced with your own identifying
+.\" information: Portions Copyright [yyyy] [name of copyright owner]
+.\"
+.\" CDDL HEADER END
+.\"
+.\"
+.\" Copyright 2013 Darik Horn <[email protected]>. All rights reserved.
+.\"
+.TH zhack 1 "2013 MAR 16" "ZFS on Linux" "User Commands"
+.SH NAME
+.BR zhack " \- libzpool debugging tool"
+.SH DESCRIPTION
+This utility pokes configuration changes directly into a ZFS pool,
+which is dangerous and can cause data corruption.
+.SH SYNOPSIS
+.LP
+.BI "zhack [\-c " "cachefile" "] [\-d " "dir" "] <" "subcommand" "> [" "arguments" "]"
+.SH OPTIONS
+.HP
+.BI "\-c" " cachefile"
+.IP
+Read the \fIpool\fR configuration from the \fIcachefile\fR, which is
+/etc/zfs/zpool.cache by default.
+.HP
+.BI "\-d" " dir"
+.IP
+Search for \fIpool\fR members in the \fIdir\fR path. Can be specified
+more than once.
+.SH SUBCOMMANDS
+.LP
+.BI "feature stat " "pool"
+.IP
+List feature flags.
+.LP
+.BI "feature enable [\-d " "description" "] [\-r] " "pool guid"
+.IP
+Add a new feature to \fIpool\fR that is uniquely identified by
+\fIguid\fR, which is specified in the same form as a zfs(8) user
+property.
+.IP
+The \fIdescription\fR is a short human readable explanation of the new
+feature.
+.IP
+The \fB\-r\fR switch indicates that \fIpool\fR can be safely opened
+in read-only mode by a system that does not have the \fIguid\fR
+feature.
+.LP
+.BI "feature ref [\-d|\-m] " "pool guid"
+.IP
+Increment the reference count of the \fIguid\fR feature in \fIpool\fR.
+.IP
+The \fB\-d\fR switch decrements the reference count of the \fIguid\fR
+feature in \fIpool\fR.
+.IP
+The \fB\-m\fR switch indicates that the \fIguid\fR feature is now
+required to read the pool MOS.
+.SH EXAMPLES
+.LP
+.nf
+# zhack feature stat tank
+
+for_read_obj:
+ org.illumos:lz4_compress = 0
+for_write_obj:
+ com.delphix:async_destroy = 0
+ com.delphix:empty_bpobj = 0
+descriptions_obj:
+ com.delphix:async_destroy = Destroy filesystems asynchronously.
+ com.delphix:empty_bpobj = Snapshots use less space.
+ org.illumos:lz4_compress = LZ4 compression algorithm support.
+.LP
+# zhack feature enable -d 'Predict future disk failures.' \\
+ tank com.example:clairvoyance
+.LP
+# zhack feature ref tank com.example:clairvoyance
+.SH AUTHORS
+This man page was written by Darik Horn <[email protected]>.
+.SH SEE ALSO
+.BR splat (1),
+.BR zfs (8),
+.BR zpios (1),
+.BR zpool-features (5),
+.BR ztest (1)
diff --git a/man/man1/ztest.1 b/man/man1/ztest.1
index b698f4256..961a5b0de 100644
--- a/man/man1/ztest.1
+++ b/man/man1/ztest.1
@@ -24,7 +24,7 @@
.\" Copyright (c) 2009 Michael Gebetsroither <[email protected]>. All rights
.\" reserved.
.\"
-.TH zpios 1 "2009 NOV 01" "ZFS on Linux" "User Commands"
+.TH ztest 1 "2009 NOV 01" "ZFS on Linux" "User Commands"
.SH NAME
\fBztest\fR \- was written by the ZFS Developers as a ZFS unit test.