From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from relay.sgi.com (relay1.corp.sgi.com [137.38.102.111]) by oss.sgi.com (Postfix) with ESMTP id 525A97CA2 for ; Sun, 7 Feb 2016 10:30:56 -0600 (CST) Received: from cuda.sgi.com (cuda2.sgi.com [192.48.176.25]) by relay1.corp.sgi.com (Postfix) with ESMTP id 426BC8F8033 for ; Sun, 7 Feb 2016 08:30:56 -0800 (PST) Received: from mail-wm0-f41.google.com (mail-wm0-f41.google.com [74.125.82.41]) by cuda.sgi.com with ESMTP id O5Or5MFLYwk4rLcy (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128 verify=NO) for ; Sun, 07 Feb 2016 08:30:53 -0800 (PST) Received: by mail-wm0-f41.google.com with SMTP id g62so105381795wme.0 for ; Sun, 07 Feb 2016 08:30:53 -0800 (PST) Subject: getrichacl(1) man page review comments References: <56B770B6.7040803@gmail.com> From: "Michael Kerrisk (man-pages)" Message-ID: <56B77139.4080209@gmail.com> Date: Sun, 7 Feb 2016 17:30:49 +0100 MIME-Version: 1.0 In-Reply-To: <56B770B6.7040803@gmail.com> List-Id: XFS Filesystem from SGI List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Errors-To: xfs-bounces@oss.sgi.com Sender: xfs-bounces@oss.sgi.com To: Andreas Gruenbacher Cc: Andreas Dilger , linux-cifs@vger.kernel.org, linux-nfs@vger.kernel.org, Christoph Hellwig , Linux API , Trond Myklebust , lkml , xfs@oss.sgi.com, "J. Bruce Fields" , mtk.manpages@gmail.com, linux-fsdevel@vger.kernel.org, Jeff Layton , linux-ext4@vger.kernel.org, Anna Schumaker SGVsbG8gQW5kcmVhcywKCkhlcmUsIHNvbWUgY29tbWVudHMgb24gdGhlIGdldHJpY2hhY2woMSkg cGFnZS4KCj4gLlwiCj4gLlwiIFJpY2hhY2wgTWFudWFsIFBhZ2VzCj4gLlwiCj4gLlwiIENvcHly aWdodCAoQykgMjAxNSAgUmVkIEhhdCwgSW5jLgo+IC5cIiBXcml0dGVuIGJ5IEFuZHJlYXMgR3J1 ZW5iYWNoZXIgPGFncnVlbmJhQHJlZGhhdC5jb20+Cj4gLlwiIFRoaXMgaXMgZnJlZSBkb2N1bWVu dGF0aW9uOyB5b3UgY2FuIHJlZGlzdHJpYnV0ZSBpdCBhbmQvb3IKPiAuXCIgbW9kaWZ5IGl0IHVu ZGVyIHRoZSB0ZXJtcyBvZiB0aGUgR05VIEdlbmVyYWwgUHVibGljIExpY2Vuc2UgYXMKPiAuXCIg cHVibGlzaGVkIGJ5IHRoZSBGcmVlIFNvZnR3YXJlIEZvdW5kYXRpb247IGVpdGhlciB2ZXJzaW9u IDIgb2YKPiAuXCIgdGhlIExpY2Vuc2UsIG9yIChhdCB5b3VyIG9wdGlvbikgYW55IGxhdGVyIHZl cnNpb24uCj4gLlwiCj4gLlwiIFRoZSBHTlUgR2VuZXJhbCBQdWJsaWMgTGljZW5zZSdzIHJlZmVy ZW5jZXMgdG8gIm9iamVjdCBjb2RlIgo+IC5cIiBhbmQgImV4ZWN1dGFibGVzIiBhcmUgdG8gYmUg aW50ZXJwcmV0ZWQgYXMgdGhlIG91dHB1dCBvZiBhbnkKPiAuXCIgZG9jdW1lbnQgZm9ybWF0dGlu ZyBvciB0eXBlc2V0dGluZyBzeXN0ZW0sIGluY2x1ZGluZwo+IC5cIiBpbnRlcm1lZGlhdGUgYW5k IHByaW50ZWQgb3V0cHV0Lgo+IC5cIgo+IC5cIiBUaGlzIG1hbnVhbCBpcyBkaXN0cmlidXRlZCBp biB0aGUgaG9wZSB0aGF0IGl0IHdpbGwgYmUgdXNlZnVsLAo+IC5cIiBidXQgV0lUSE9VVCBBTlkg V0FSUkFOVFk7IHdpdGhvdXQgZXZlbiB0aGUgaW1wbGllZCB3YXJyYW50eSBvZgo+IC5cIiBNRVJD SEFOVEFCSUxJVFkgb3IgRklUTkVTUyBGT1IgQSBQQVJUSUNVTEFSIFBVUlBPU0UuICBTZWUgdGhl Cj4gLlwiIEdOVSBHZW5lcmFsIFB1YmxpYyBMaWNlbnNlIGZvciBtb3JlIGRldGFpbHMuCj4gLlwi Cj4gLlwiIFlvdSBzaG91bGQgaGF2ZSByZWNlaXZlZCBhIGNvcHkgb2YgdGhlIEdOVSBHZW5lcmFs IFB1YmxpYwo+IC5cIiBMaWNlbnNlIGFsb25nIHdpdGggdGhpcyBtYW51YWwuICBJZiBub3QsIHNl ZQo+IC5cIiA8aHR0cDovL3d3dy5nbnUub3JnL2xpY2Vuc2VzLz4uCj4gLlwiCj4gLlRIIEdFVFJJ Q0hBQ0wgNyAyMDE1LTA5LTAxICJMaW51eCIgIlJpY2ggQWNjZXNzIENvbnRyb2wgTGlzdHMiCj4g Cj4gLlNIIE5BTUUKPiBnZXRyaWNoYWNsIFwtIEdldCBSaWNoIEFjY2VzcyBDb250cm9sIExpc3Rz Cj4gCj4gLlNIIFNZTk9QU0lTCj4gLkIgZ2V0cmljaGFjbAo+IC5SSSBbIE9QVElPTiAiXS4uLiBb IiBGSUxFIF0uLi4KCkluIG1hbi1wYWdlcywgYXQgbGVhc3QsIHRoZSBjb252ZW50aW9uIGlzIHRv IHVzZSBsb3dlciBjYXNlIGZvciB0aGVzZQpwaWVjZXMgKGFuZCB0aHVzIHRocm91Z2ggdGhlIHJl bWFpbmRlciBvZiB0aGUgcGFnZSksIHNvOgoKPiAuUkkgWyBvcHRpb24gIl0uLi4gWyIgZmlsZSBd Li4uCgo+IC5TSCBERVNDUklQVElPTgo+IEZvciBlYWNoIGZpbGUsIGdldHJpY2hhY2wgZGlzcGxh eXMgdGhlIGZpbGUgbmFtZSBhbmQgUmljaCBBY2Nlc3MgQ29udHJvbCBMaXN0CgpGb3IgbWFuLXBh Z2VzLCBhdCBsZWFzdCwgdGhlIGNvbnZlbnRpb24gaXMgdGhhdCB0aGUgcmVmZXJlbmNlcyB0byB0 aGUKZnVuY3Rpb24vY29tbWFuZCBuYW1lIGV4cGxhaW5lZCBpbiB0aGUgcGFnZSBhcmUgYm9sZCwg ZG86CgouQlIgZ2V0cmljaGFjbAoKPiAocmljaGFjbCkuCgpGb3Igd2hhdCBpdCdzIHdvcnRoLCBJ IHRoaW5rIGl0IHdvdWxkIGJlIHdvcnRod2hpbGUgdG8gc3RhcnQgd2l0aAphIGNvbnNpc3RlbnQg YWJicmV2aWF0aW9uIGNvbW1lbnQgaGVyZSAoYW5kIHVzZSBpdCB0aHJvdWdob3V0IGFsbCBvZiB0 aGUKbWFuIHBhZ2VzKTogIlJpY2hBQ0wiIChvciAicmljaEFDTCIpLCByYXRoZXIgdGhhbiAicmlj aGFjbCI7IHRoYXQgc2VlbXMKbW9yZSBjb25zaXN0ZW50IHdpdGggdGhlIHRyYWRpdGlvbmFsIGFi YnJldmlhdGlvbiAiQUNMIi4KCj4gCj4gQnkgZGVmYXVsdCwgZ2V0cmljaGFjbCBkaXNwbGF5cyB0 aGUgZWZmZWN0aXZlIHBlcm1pc3Npb25zIHJlbWFpbmluZyBhZnRlcgoKLkJSIGdldHJpY2hhY2wK Cj4gYXBwbHlpbmcgdGhlIGZpbGUgbWFza3MgdG8gdGhlIEFDTC4gIFRoZSBmaWxlIG1hc2tzIGFu ZCB1bmRlcmx5aW5nIE5GU3Y0IEFDTAo+IGNhbiBiZSBkaXNwbGF5ZWQgd2l0aCB0aGUgXC1cLXJh dyBvcHRpb24uCgpVc2UKLkJSIFwtXC1yYXcKCj4gCj4gVGhlIG91dHB1dCBmb3JtYXQgb2YgZ2V0 cmljaGFjbCBpcyBhcyBmb2xsb3dzOgoKLkJSIGdldHJpY2hhY2wKCj4gLmZhbSBDCj4gLlJTCj4g Lm5mCj4gIDE6ICBmaWxlOgo+ICAyOiAgICAgIGZsYWdzOmEKPiAgMzogICAgICBvd25lcjpyd3At LS0tLS0tLS0tLS0tOjptYXNrCj4gIDQ6ICAgICAgZ3JvdXA6ci1wLS0tLS0tLS0tLS0tLTo6bWFz awo+ICA1OiAgICAgIG90aGVyOnItLS0tLS0tLS0tLS0tLS06Om1hc2sKPiAgNjogICAgIG93bmVy QDpyd3AtLS0tLS0tLS0tLS0tOjphbGxvdwo+ICA3OiAgIHVzZXI6Zm9vOnItcC0tLS0tLS0tLS0t LS06OmFsbG93Cj4gIDg6ICAgICBncm91cEA6ci1wLS0tLS0tLS0tLS0tLTo6YWxsb3cKPiAgOTog IGdyb3VwOmJhcjpyLXAtLS0tLS0tLS0tLS0tOjphbGxvdwo+IDEwOiAgZXZlcnlvbmVAOnItLS0t LS0tLS0tLS0tLS06OmFsbG93Cj4gMTE6Cj4gLmZpCj4gLlJFCj4gLmZhbSBUCj4gCj4gTGluZSAx IGNvbnRhaW5zIHRoZSBmaWxlIG5hbWUsIGZvbGxvd2VkIGJ5IGEgY29sb24uCj4gCj4gTGluZSAy IGNvbnRhaW5zIHRoZSBBQ0wgZmxhZ3MuIFRoaXMgbGluZSBpcyBvbWl0dGVkIGlmIG5vIGZsYWdz IGFyZSBzZXQuCj4gCj4gTGluZXMgMy0tNSBpbmRpY2F0ZSB0aGUgb3duZXIsIGdyb3VwLCBhbmQg b3RoZXIgZmlsZSBtYXNrcywgd2hpY2ggYXJlIG9ubHkKPiBzaG93biBpZiB0aGUgXC1cLXJhdyBv cHRpb24gaXMgc3BlY2lmaWVkLgo+IAo+IExpbmVzIDYtLTEwIGluZGljYXRlIGRpZmZlcmVudCBB Q0wgZW50cmllcyBmb3IgdGhlIGZpbGUgb3duZXIKPiAuUkIgKCBvd25lckAgKSwKPiB1c2VyIGZv bywgdGhlIG93bmluZyBncm91cAo+IC5SQiAoIGdyb3VwQCApLAo+IGdyb3VwIGJhciwgYW5kIGZv ciBldmVyeW9uZQoKLklSIGJhciAsCgo+IC5SQiAoIGV2ZXJ5b25lQCApLgo+IAo+IEEgYmxhbmsg bGluZSBmb2xsb3dzIGF0IHRoZSBlbmQuCj4gCj4gQnkgZGVmYXVsdCwgZ2V0cmljaGFjbCBkaXNw bGF5cyB0aGUgdGhlIHNpbmdsZS1sZXR0ZXIgZm9ybXMgb2YgZmxhZ3MgYW5kCgouQlIgZ2V0cmlj aGFjbAoKcy90aGUgdGhlL3RoZS8KCj4gcGVybWlzc2lvbnMsIHRoZSBpZGVudGlmaWVycyBvZiBB Q0wgZW50cnlpZXMgYXJlIHJpZ2h0IGp1c3RpZmllZCwgdGhlCgpzL2VudHJ5aWVzL2VudHJpZXMv Cgo+IHBlcm1pc3Npb25zIGFyZSB2ZXJ0aWNhbGx5IGFsaWduZWQsIGFuZCBwZXJtaXNzaW9ucyB3 aGljaCBhcmUgYWx3YXlzCj4gZ3JhbnRlZAo+IC5SQiAoIHJlYWRfYXR0cmlidXRlcyAiLCAiIHJl YWRfYWNsICIsICIgc3luY2hyb25pemUgKQo+IGFyZSBvbWl0dGVkLiBTZWUgdGhlIHJpY2hhY2wo NykgbWFudWFsIHBhZ2UgZm9yIHRoZSBkZWZpbmVkIGZsYWdzIGFuZAoKVXNlCi5CUiByaWNoYWNo bCAoNykKZm9yIHBhZ2UgY3Jvc3MgcmVmZXJlbmNlcy4KCj4gcGVybWlzc2lvbnMuCj4gCj4gV2hl biBnZXRyaWNoYWNsIGlzIHVzZWQgb24gYSBmaWxlIHRoYXQgZG9lcyBub3QgaGF2ZSBhIHJpY2hh Y2wgb3Igb24gYQoKLkJSIGdldHJpY2hhY2wKCj4gZmlsZXN5c3RlbSB0aGF0IGRvZXMgbm90IHN1 cHBvcnQgcmljaGFjbHMsIGdldHJpY2hhY2wgZGlzcGxheXMgdGhlIGFjY2VzcwoKLkJSIGdldHJp Y2hhY2wKCj4gcGVybWlzc2lvbnMgZGVmaW5lZCBieSB0aGUgdHJhZGl0aW9uYWwgZmlsZSBwZXJt aXNzaW9uIGJpdHMgYXMgYSByaWNoYWNsLiBXaGVuCj4gZ2V0cmljaGFjbCBpcyB1c2VkIG9uIGEg ZmlsZSB0aGF0IGhhcyBhIFBPU0lYIEFDTCwgaXQgcHJpbnRzIGFuIGVycm9yIG1lc3NhZ2UuCgou QlIgZ2V0cmljaGFjbAoKQW5kIHRoZW46CgpbLi4uXSBoYXMgYSBQT1NJWCBBQ0wgKHNlZQouQlIg YWNsICg3KSksIGl0IHByaW50cyBbLi4uXQo+IAo+IC5TSCBPUFRJT05TCj4gLlRQCj4gXGZCXC1c LWxvbmdcZlIsIFxmQlwtbFxmUgo+IERpc3BsYXkgYWNjZXNzIG1hc2tzIGFuZCBmbGFncyBpbiB0 aGVpciBsb25nIGZvcm0uCj4gLlRQCj4gXGZCXC1cLWZ1bGxcZlIKPiBBbHNvIHNob3cgcGVybWlz c2lvbnMgd2hpY2ggYXJlIGFsd2F5cyBpbXBsaWNpdGx5IGFsbG93ZWQuCj4gLlRQCj4gXGZCXC1c LXJhd1xmUgo+IFNob3cgYWNscyBhcyBzdG9yZWQgb24gdGhlIGZpbGUgc3lzdGVtIGluY2x1ZGlu ZyB0aGUgZmlsZSBtYXNrcy4gSW1wbGllcwoKcy9heGxzL0FDTHMvCgo+IFxmQlwtXC1mdWxsXGZS Lgo+IC5UUAo+IFxmQlwtXC11bmFsaWduZWRcZlIKPiBEbyBub3QgYWxpZ24gQUNMIGVudHJpZXMg b3IgcGFkIG1pc3NpbmcgcGVybWlzc2lvbnMgd2l0aCAnLScuCj4gLlRQCj4gXGZCXC1cLW51bWVy aWMtaWRzXGZSCj4gRGlzcGxheSBudW1lcmljIHVzZXIgYW5kIGdyb3VwIElEcyBpbnN0ZWFkIG9m IG5hbWVzLgo+IC5UUAo+IFxmQlwtXC1hY2Nlc3NcZlIgWz1cZkl1c2VyXGZSWzpcZklncm91cFxm UjouLi5dfSwgXGZCXC1hXGZSW1xmSXVzZXJcZlJbOlxmSWdyb3VwXGZSOi4uLl19Cj4gSW5zdGVh ZCBvZiB0aGUgQUNMLCBzaG93IHdoaWNoIHBlcm1pc3Npb25zIHRoZSBjYWxsZXIgb3IgYSBzcGVj aWZpZWQgdXNlciBoYXMKCiJjYWxsZXIiPyAidGhlIHVzZXIgcnVubmluZyB0aGUgY29tbWFuZCwg IgoKPiBmb3IgZmlsZShzKS4gIFdoZW4gYSBsaXN0IG9mIGdyb3VwcyBpcyBnaXZlbiwgdGhpcyBv dmVycmlkZXMgdGhlIGdyb3VwcyB0aGUKCnMvZmlsZShzKS9zcGVjaWZpZWQgZmlsZShzKS8KCj4g dXNlciBpcyBpbi4KClRoZSBwcmVjZWRpbmcgdGV4dCBpcyBub3QgdmVyeSBjbGVhci4KCj4gLlRQ Cj4gXGZCXC1cLXZlcnNpb25cZlIsIFxmQlwtdlxmUgo+IERpc3BsYXkgdGhlIHZlcnNpb24gb2Yg Z2V0cmljaGFjbCBhbmQgZXhpdC4KCi5CUiBnZXRyaWNoYWNsCgo+IC5UUAo+IFxmQlwtXC1oZWxw XGZSLCBcZkJcLWhcZlIKPiBEaXNwbGF5IGNvbW1hbmQtbGluZSB1c2FnZSBoZWxwIHRleHQuCj4g Cj4gLlNIIEFVVEhPUgo+IFdyaXR0ZW4gYnkgQW5kcmVhcyBHcsO8bmJhY2hlciA8YWdydWVuYmFA cmVkaGF0LmNvbT4uCj4gCj4gUGxlYXNlIHNlbmQgeW91ciBidWcgcmVwb3J0cywgc3VnZ2VzdGVk IGZlYXR1cmVzIGFuZCBjb21tZW50cyB0byB0aGUgYWJvdmUgYWRkcmVzcy4KPiAKPiAuU0ggQ09O Rk9STUlORyBUTwo+IFJpY2ggQWNjZXNzIENvbnRyb2wgTGlzdHMgYXJlIExpbnV4LXNwZWNpZmlj Lgo+IAo+IC5TSCBTRUUgQUxTTwo+IC5CUiBzZXRyaWNoYWNsICgxKSwKPiAuQlIgcmljaGFjbCAo NykKCkNoZWVycywKCk1pY2hhZWwKCgotLSAKTWljaGFlbCBLZXJyaXNrCkxpbnV4IG1hbi1wYWdl cyBtYWludGFpbmVyOyBodHRwOi8vd3d3Lmtlcm5lbC5vcmcvZG9jL21hbi1wYWdlcy8KTGludXgv VU5JWCBTeXN0ZW0gUHJvZ3JhbW1pbmcgVHJhaW5pbmc6IGh0dHA6Ly9tYW43Lm9yZy90cmFpbmlu Zy8KCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCnhmcyBt YWlsaW5nIGxpc3QKeGZzQG9zcy5zZ2kuY29tCmh0dHA6Ly9vc3Muc2dpLmNvbS9tYWlsbWFuL2xp c3RpbmZvL3hmcwo=