From owner-freebsd-doc@FreeBSD.ORG Fri Dec 23 20:20:19 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E62A610656F9 for ; Fri, 23 Dec 2011 20:20:19 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 34B448FC20 for ; Fri, 23 Dec 2011 20:20:18 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id pBNKKIFF035150 for ; Fri, 23 Dec 2011 20:20:18 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id pBNKKIug035149; Fri, 23 Dec 2011 20:20:18 GMT (envelope-from gnats) Resent-Date: Fri, 23 Dec 2011 20:20:18 GMT Resent-Message-Id: <201112232020.pBNKKIug035149@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Garrett Cooper Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C0BB3106566B for ; Fri, 23 Dec 2011 20:17:10 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id AF8B18FC08 for ; Fri, 23 Dec 2011 20:17:10 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id pBNKHAdd058042 for ; Fri, 23 Dec 2011 20:17:10 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id pBNKHAgS058041; Fri, 23 Dec 2011 20:17:10 GMT (envelope-from nobody) Message-Id: <201112232017.pBNKHAgS058041@red.freebsd.org> Date: Fri, 23 Dec 2011 20:17:10 GMT From: Garrett Cooper To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/163576: zfs(8) sync property not noted in the manpage X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Dec 2011 20:20:20 -0000 >Number: 163576 >Category: docs >Synopsis: zfs(8) sync property not noted in the manpage >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Fri Dec 23 20:20:17 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Garrett Cooper >Release: 10-CURRENT >Organization: n/a >Environment: FreeBSD streetfighter.ixsystems.com 10.0-CURRENT FreeBSD 10.0-CURRENT #0 r227801: Mon Nov 21 14:04:39 PST 2011 root@streetfighter.ixsystems.com:/usr/obj/usr/src/sys/STREETFIGHTER amd64 >Description: The sync property isn't discussed in the zfs(8) manpage. The sync property allows administrators to turn off write synchronization at the "filesystem" level (in reality the ZIL level according to /sys/cddl/contrib/opensolaris/uts/common/fs/zfs/dmu_objset.c), which might improve performance in some scenarios. Just like setting checksum=off though, it should be highly discouraged option to tweak because with standard setups and with some disk technologies (*ATA and some big HDD vendors, I'm looking at you ;)..), this could result in catastrophic data loss in the event where enough drives become unavailable, there's a system (software/hardware) failure, or power outage. >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: