DomainKey-Signature: a=rsa-sha1; c=nofws; d=sourceware.org; h=list-id
	:list-unsubscribe:list-subscribe:list-archive:list-post
	:list-help:sender:date:from:to:subject:message-id:reply-to
	:references:mime-version:content-type:in-reply-to; q=dns; s=
	default; b=TgsyJ42J1b5q8xgT1n5hNVFbazvuujUE4YsVNZftBudvFEpJgbJgV
	B5bAXR5Ytgu4No1KisKYMmg+C6+mH7HHJTG7X0nRYsqhVQVjmC5SZIPVNbGoWe1Y
	jJKBkwjvAOuSH9pZ1mx2zeXeTjn+ntSjy4os0c3NFtSll0zD4WoLM8=
Mailing-List: contact cygwin-help@cygwin.com; run by ezmlm
Sender: cygwin-owner@cygwin.com
Mail-Followup-To: cygwin@cygwin.com
Date: Sat, 28 Feb 2015 14:16:49 +0100
From: Corinna Vinschen <corinna-cygwin@cygwin.com>
To: cygwin@cygwin.com
Subject: Re: unclear wording on getfacl manpage (--all != ALL)
Message-ID: <20150228131649.GV11124@calimero.vinschen.de>
Reply-To: cygwin@cygwin.com
Mail-Followup-To: cygwin@cygwin.com
References: <54F104B7.6050307@tlinx.org>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;	protocol="application/pgp-signature"; boundary="YvpO9wCO44Ze8QQC"
Content-Disposition: inline
In-Reply-To: <54F104B7.6050307@tlinx.org>
User-Agent: Mutt/1.5.23 (2014-03-12)

--YvpO9wCO44Ze8QQC
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Feb 27 15:58, Linda Walsh wrote:
> on the CYGWIN getfacl manpage, it has
>=20
>   -a, --all
>       display  the  filename, the owner, the group, and the ACL of the
>       file
>=20
> --
> But in the linux version it says:
>=20
>=20
>    -a, --access
>        Display the file access control list.
>=20
> --
>=20
> The "--all" in the cygwin cygwin version sounds like it
> should display all ACL-related entries, but it really only
> displays the inode-specific acl on directories.
>=20
> To display "all ACL-related entries", one uses no parameter.
>=20
> The usage of "--all" to indicate the option "limits" output
> to only the "inode-specific" part is confusing and unclear.

The original getfacl was based on the Solaris getfacl (just as Cygwin's
ACL handling is based on the Solaris one).  It only had -a.  I guess the
--all was a thinko when adding the long options, as was --dir.

I changed that to --access and --default as on Linux.  I kept the --all
and --dir in for backward compatibility.  They are just undocumented now.


HTH,
Corinna

--=20
Corinna Vinschen                  Please, send mails regarding Cygwin to
Cygwin Maintainer                 cygwin AT cygwin DOT com
Red Hat

--YvpO9wCO44Ze8QQC
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2

iQIcBAEBAgAGBQJU8b/BAAoJEPU2Bp2uRE+g5RIP/1K/5VKeN6gyOx1DcJhLUCcL
U+HQGvy/r/DcI1jo32rjoLn6ey7C+YTJCLbB0ljvO/FGpRYdpuqcQAYdH97tDhAD
xPJeOgyoYhsYJVj5CzEd1B+QQ+hz8VaRz5UIED/N75THVFckqOaIxjFvRqMeGywN
24YFDhLZlEpRTeRttEDhyi7UwhhGuWf/jMroVYIECXKg6M2jwnpOiWjQl2B6Zhh2
pSStQeguOHCCEuFt0Q4SLZGaMUmCX1ynY1WXRJMbkxgdA1FlNZT96vOzQ3OO9kET
d+xWLDjsmYYj9QnXopp28Y1my5qb9kePRm+TLBUVZmwL1/8g5EckxSaHfgnIInNA
rVMZtRSto5pS0TLx4In4+Ygbiv7r3W1Y1VFp/uf2hAUy9c0zOJCdIc4AEHEYVmUn
Q3MldJSMiJLzYkDi27VYOHPT2oB06T9zxPYJftzPWkcWYm/TFuj2tCgjEt0FcqfL
i25tsEQ7ch/pF7ae1FPg1RhKIan9PN+Hzowi6NcZ6ysH8jDch/LelxssVKrJAGGQ
RKyibxu48jXNZkNJZAqzyIkkd/QE0dHLQJJGMgFuG0xAg/BiUTibB7sKpiTUyxAq
INUitYoVuribgD61Wj1JFzXCXIQTwlhZkbQiRXOESHnsDLsOPqiNg62LldQwqLnY
4/ctaWXzPoKLoiOXtxn6
=6um9
-----END PGP SIGNATURE-----

--YvpO9wCO44Ze8QQC--