From nobody@FreeBSD.org  Fri Dec 23 20:17:10 2011
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id C0BB3106566B
	for <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <yaneurabeya@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: zfs(8) sync property not noted in the manpage
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>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:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Dec 23 20:20:17 UTC 2011
>Closed-Date:    Mon Jun 04 19:38:18 UTC 2012
>Last-Modified:  Sun Feb 03 22:29:54 UTC 2013
>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:
State-Changed-From-To: open->closed 
State-Changed-By: bcr 
State-Changed-When: Mon Jun 4 19:36:29 UTC 2012 
State-Changed-Why:  
The man page was updated in r228019 with the information regarding the sync property. 
PR closed. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=163576 
>Unformatted:
