Annotation of src/usr.bin/cvs/cvsacl.5, Revision 1.1
1.1 ! jfb 1: .\" $OpenBSD: pflogd.8,v 1.24 2004/01/16 10:45:49 jmc Exp $
! 2: .\"
! 3: .\" Copyright (c) 2004 Jean-Francois Brousseau <jfb@openbsd.org>
! 4: .\"
! 5: .\" Redistribution and use in source and binary forms, with or without
! 6: .\" modification, are permitted provided that the following conditions
! 7: .\" are met:
! 8: .\" 1. Redistributions of source code must retain the above copyright
! 9: .\" notice, this list of conditions and the following disclaimer.
! 10: .\" 2. Redistributions in binary form must reproduce the above copyright
! 11: .\" notice, this list of conditions and the following disclaimer in the
! 12: .\" documentation and/or other materials provided with the distribution.
! 13: .\" 3. The name of the author may not be used to endorse or promote products
! 14: .\" derived from this software without specific prior written permission.
! 15: .\"
! 16: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
! 17: .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
! 18: .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
! 19: .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
! 20: .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
! 21: .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
! 22: .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
! 23: .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
! 24: .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
! 25: .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
! 26: .\"
! 27: .Dd June 22, 2004
! 28: .Dt CVSACL 5
! 29: .Os
! 30: .Sh NAME
! 31: .Nm cvsacl
! 32: .Nd CVS Access Control Lists format
! 33: .Sh DESCRIPTION
! 34: The
! 35: .Nm
! 36: file format is the format understood by the
! 37: .Xr cvsd 8
! 38: daemon for performing access control on files within the CVS repository.
! 39: It is composed of access rules, each on a single line, which either allow
! 40: or deny certain operations on files or entire directories.
! 41: .Sh GRAMMAR
! 42: The
! 43: .Nm
! 44: grammar is expressed in BNF (Backus-Naur Form) notation.
! 45: Terminals are displayed as normal text.
! 46: Nonterminals are in bold.
! 47: Anything enclosed between angle brackets
! 48: .Po
! 49: .Ql [
! 50: and
! 51: .Ql \&]
! 52: .Pc
! 53: is optional.
! 54: The pipe character
! 55: .Pq Ql \&|
! 56: is used to separate multiple choices.
! 57: .Pp
! 58: Here is the BNF syntax for
! 59: .Nm
! 60: rules:
! 61: .Bl -tag -width "this is a test"
! 62: .It Ic line
! 63: ::=
! 64: .It Ic rule
! 65: ::=
! 66: .Ic action
! 67: .Bo
! 68: .Ic optlist
! 69: .Bc
! 70: .Ic op
! 71: [ branch
! 72: .Ic branch
! 73: ]
! 74: .Pp
! 75: [ from
! 76: .Ic userlist
! 77: ]
! 78: .It Ic action
! 79: ::= allow | deny
! 80: .It Ic option
! 81: ::= quick | log
! 82: .It Ic optlist
! 83: ::=
! 84: .Ic option
! 85: |
! 86: .Ic optlist ,
! 87: .Ic option
! 88: .It Ic op
! 89: ::= add | commit | tag | update
! 90: .It Ic userlist
! 91: ::=
! 92: .El
! 93: .Pp
! 94: .Sh EXAMPLES
! 95: The following rule denies all operations:
! 96: .Bd -literal
! 97: deny quick
! 98: .Ed
! 99: .Sh SEE ALSO
! 100: .Xr cvs 1 ,
! 101: .Xr cvsd 8
! 102: .Sh HISTORY
! 103: The
! 104: .Nm
! 105: file format appeared with the OpenCVS project.
! 106: .Sh AUTHORS
! 107: .An Jean-Francois Brousseau