~ubuntu-branches/ubuntu/vivid/nfs4-acl-tools/vivid-proposed

« back to all changes in this revision

Viewing changes to man/man1/nfs4_getfacl.1

  • Committer: Bazaar Package Importer
  • Author(s): Timo Aaltonen
  • Date: 2009-05-12 13:53:04 UTC
  • Revision ID: james.westby@ubuntu.com-20090512135304-b4hyk0en3a0v8r3p
Tags: upstream-0.3.3
ImportĀ upstreamĀ versionĀ 0.3.3

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" NFSv4 Access Control Lists manual pages
 
2
.\" format with: groff -man -Tascii foo.1
 
3
.\" 
 
4
.\" http://www.delorie.com/gnu/docs/groff/groff_37.html
 
5
.\" http://www.schweikhardt.net/man_page_howto.html
 
6
.\" 
 
7
.TH NFS4_GETFACL 1 "version 0.3.3, August 2008" "Linux" "NFSv4 Access Control Lists"
 
8
.SH NAME
 
9
nfs4_getfacl \- get NFSv4 file/directory access control lists
 
10
.SH SYNOPSIS
 
11
.B nfs4_getfacl [-H]
 
12
.I file
 
13
.SH DESCRIPTION
 
14
.B nfs4_getfacl 
 
15
will display the NFSv4 Access Control List (ACL) for 
 
16
.I file 
 
17
(a file or directory), provided 
 
18
.I file 
 
19
is on a mounted NFSv4 filesystem which supports ACLs.
 
20
 
 
21
If the 
 
22
.BR -H / --more-help
 
23
flag is specified, 
 
24
.B nfs4_getfacl
 
25
will print some information about NFSv4 ACLs and the fields used in ACEs.  
 
26
 
 
27
The output format for an NFSv4 file ACL, e.g., is:
 
28
.RS
 
29
.nf
 
30
 
 
31
A::OWNER@:rwatTnNcCy
 
32
A::alice@nfsdomain.org:rxtncy
 
33
A::bob@nfsdomain.org:rwadtTnNcCy
 
34
A:g:GROUP@:rtncy
 
35
D:g:GROUP@:waxTC
 
36
A::EVERYONE@:rtncy
 
37
D::EVERYONE@:waxTC
 
38
.fi
 
39
.RE
 
40
 
 
41
In the example output above, the user `alice@nfsdomain.org' has the equivalent
 
42
of "read" and "execute" permissions, `bob@nfsdomain.org' has "read" and 
 
43
"write", and both `GROUP@' and `EVERYONE@' have "read".
 
44
 
 
45
Refer to the 
 
46
.BR nfs4_acl (5)
 
47
manpage for detailed information about NFSv4 ACL terminology and syntax. 
 
48
.SH AUTHORS
 
49
.B nfs4_getfacl
 
50
was written by people at CITI, the Center for Information Technology Integration
 
51
.RI ( http://www.citi.umich.edu ).
 
52
This manpage was written by David Richter.
 
53
.SH CONTACT
 
54
Please send bug reports, feature requests, and comments to
 
55
.RI < nfsv4@linux-nfs.org >.
 
56
.SH SEE ALSO
 
57
.BR nfs4_setfacl "(1), " nfs4_acl (5),
 
58
.IR RFC3530 " (NFSv4.0), NFSv4.1 Minor Version Draft."