From owner-freebsd-doc@FreeBSD.ORG Tue Nov 8 19:20:09 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 31B16106566B for ; Tue, 8 Nov 2011 19:20:09 +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 E9B308FC13 for ; Tue, 8 Nov 2011 19:20:08 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pA8JK865099437 for ; Tue, 8 Nov 2011 19:20:08 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pA8JK8m5099436; Tue, 8 Nov 2011 19:20:08 GMT (envelope-from gnats) Resent-Date: Tue, 8 Nov 2011 19:20:08 GMT Resent-Message-Id: <201111081920.pA8JK8m5099436@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 D986B1065670 for ; Tue, 8 Nov 2011 19:12:36 +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 C998B8FC15 for ; Tue, 8 Nov 2011 19:12:36 +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 pA8JCavD081125 for ; Tue, 8 Nov 2011 19:12:36 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id pA8JCajp081124; Tue, 8 Nov 2011 19:12:36 GMT (envelope-from nobody) Message-Id: <201111081912.pA8JCajp081124@red.freebsd.org> Date: Tue, 8 Nov 2011 19:12:36 GMT From: Garrett Cooper To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/162380: Documentation lacking for getfacl/setfacl 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: Tue, 08 Nov 2011 19:20:09 -0000 >Number: 162380 >Category: docs >Synopsis: Documentation lacking for getfacl/setfacl >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Nov 08 19:20:08 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Garrett Cooper >Release: 9.0-RC1 >Organization: n/a >Environment: FreeBSD bayonetta.local 9.0-RC1 FreeBSD 9.0-RC1 #0: Sat Nov 5 17:19:05 PDT 2011 root@bayonetta.local:/usr/obj/store/freebsd/stable/9/sys/BAYONETTA amd64 >Description: getfacl and setfacl are lacking documentation, s.t. it's hard to interpret ACL output from getfacl and it's hard to interpret what inputs need to be provided to setfacl in order to get the desired results in terms of permissions, etc. Basically, it would be nice if acl(3) said what the print outs meant, and getfacl(1) and setfacl(1) referenced acl(3) so that everything could be tied together appropriately and people could better understand what the utilities do. >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: