93ce2b4ca5
Minimal changes required to integrate the SPL sources in to the
ZFS repository build infrastructure and packaging.
Build system and packaging:
* Renamed SPL_* autoconf m4 macros to ZFS_*.
* Removed redundant SPL_* autoconf m4 macros.
* Updated the RPM spec files to remove SPL package dependency.
* The zfs package obsoletes the spl package, and the zfs-kmod
package obsoletes the spl-kmod package.
* The zfs-kmod-devel* packages were updated to add compatibility
symlinks under /usr/src/spl-x.y.z until all dependent packages
can be updated. They will be removed in a future release.
* Updated copy-builtin script for in-kernel builds.
* Updated DKMS package to include the spl.ko.
* Updated stale AUTHORS file to include all contributors.
* Updated stale COPYRIGHT and included the SPL as an exception.
* Renamed README.markdown to README.md
* Renamed OPENSOLARIS.LICENSE to LICENSE.
* Renamed DISCLAIMER to NOTICE.
Required code changes:
* Removed redundant HAVE_SPL macro.
* Removed _BOOT from nvpairs since it doesn't apply for Linux.
* Initial header cleanup (removal of empty headers, refactoring).
* Remove SPL repository clone/build from zimport.sh.
* Use of DEFINE_RATELIMIT_STATE and DEFINE_SPINLOCK removed due
to build issues when forcing C99 compilation.
* Replaced legacy ACCESS_ONCE with READ_ONCE.
* Include needed headers for `current` and `EXPORT_SYMBOL`.
Reviewed-by: Tony Hutter <hutter2@llnl.gov>
Reviewed-by: Olaf Faaland <faaland1@llnl.gov>
Reviewed-by: Matthew Ahrens <mahrens@delphix.com>
Reviewed-by: Pavel Zakharov <pavel.zakharov@delphix.com>
Signed-off-by: Brian Behlendorf <behlendorf1@llnl.gov>
TEST_ZIMPORT_SKIP="yes"
Closes #7556
99 lines
2.9 KiB
Groff
99 lines
2.9 KiB
Groff
'\" 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 <dajhorn@vanadac.com>. All rights reserved.
|
|
.\"
|
|
.TH zhack 1 "2013 MAR 16" "ZFS on Linux" "User Commands"
|
|
|
|
.SH NAME
|
|
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 <dajhorn@vanadac.com>.
|
|
.SH SEE ALSO
|
|
.BR zfs (8),
|
|
.BR zpool-features (5),
|
|
.BR ztest (1)
|