aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org.ua>2019-09-06 10:59:20 +0300
committerSergey Poznyakoff <gray@gnu.org.ua>2019-09-06 10:59:20 +0300
commit61a90bb136035b1364c52b5bfed6a807dc7d75ca (patch)
tree28c2c79b7bd31f3de9502bc1bf1cf37f4260df63
parentea8c8114dfbf9c4eabd84168c39854fe2abf2ea7 (diff)
downloadassignments-61a90bb136035b1364c52b5bfed6a807dc7d75ca.tar.gz
assignments-61a90bb136035b1364c52b5bfed6a807dc7d75ca.tar.bz2
Document the gitacl schema
-rw-r--r--.gitignore3
-rw-r--r--Makefile4
-rw-r--r--gitacl.schema56
-rw-r--r--gray-assignments.texi34
4 files changed, 92 insertions, 5 deletions
diff --git a/.gitignore b/.gitignore
index c672b36..59631ac 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,3 +6,6 @@ MYSQL-STAT-MIB.txt
6TALLYMAN-MIB.txt 6TALLYMAN-MIB.txt
7*.html 7*.html
8gray-assignments 8gray-assignments
9.emacs.desktop
10.emacs.desktop.lock
11version.texi
diff --git a/Makefile b/Makefile
index f0581d4..554b8e5 100644
--- a/Makefile
+++ b/Makefile
@@ -1,8 +1,8 @@
1SCHEMES = gray.scheme umi.scheme 1SCHEMES = gray.schema gitacl.schema umi.schema
2MIBS = OWS-STATS.txt SESSION-STATS.txt 2MIBS = OWS-STATS.txt SESSION-STATS.txt
3REFMIBS = TALLYMAN-MIB.txt MYSQL-STAT-MIB.txt SENDMAIL-STATS.txt 3REFMIBS = TALLYMAN-MIB.txt MYSQL-STAT-MIB.txt SENDMAIL-STATS.txt
4 4
5TEXINFO_SOURCES = $(SCHEMES:.scheme=.inc) $(MIBS:.txt=.inc) $(REFMIBS:.txt=.inc) 5TEXINFO_SOURCES = $(SCHEMES:.schema=.inc) $(MIBS:.txt=.inc) $(REFMIBS:.txt=.inc)
6SOURCES = gray-assignments.texi version.texi $(TEXINFO_SOURCES) 6SOURCES = gray-assignments.texi version.texi $(TEXINFO_SOURCES)
7 7
8gray-assignments.info: $(SOURCES) 8gray-assignments.info: $(SOURCES)
diff --git a/gitacl.schema b/gitacl.schema
new file mode 100644
index 0000000..a9098d4
--- /dev/null
+++ b/gitacl.schema
@@ -0,0 +1,56 @@
1# Git LDAP schema items
2#
3# depends upon:
4# nis.schema
5
6attributetype ( 1.3.6.1.4.1.9163.2.3.1.0 NAME 'gitAclProject'
7 DESC 'Project for which the ACL entry is defined'
8 EQUALITY caseExactMatch
9 SUBSTR caseExactSubstringsMatch
10 SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256}
11 SINGLE-VALUE )
12
13attributetype ( 1.3.6.1.4.1.9163.2.3.1.1 NAME 'gitAclVerb'
14 DESC 'ACL verb'
15 EQUALITY caseExactMatch
16 SUBSTR caseExactSubstringsMatch
17 SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256}
18 SINGLE-VALUE )
19
20attributetype ( 1.3.6.1.4.1.9163.2.3.1.2 NAME 'gitAclOp'
21 DESC 'ACL opcode: any combination of C, D, U or R'
22 EQUALITY caseExactMatch
23 SUBSTR caseExactSubstringsMatch
24 SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
25
26attributetype ( 1.3.6.1.4.1.9163.2.3.1.3 NAME 'gitAclRef'
27 DESC 'Git ref'
28 EQUALITY caseExactMatch
29 SUBSTR caseExactSubstringsMatch
30 SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
31
32attributetype ( 1.3.6.1.4.1.9163.2.3.1.4 NAME 'gitAclOrder'
33 DESC 'an integer to order ACL entries'
34 EQUALITY integerMatch
35 SYNTAX 1.3.6.1.4.1.1466.115.121.1.27
36 SINGLE-VALUE )
37
38attributetype ( 1.3.6.1.4.1.9163.2.3.1.5 NAME 'gitAclUser'
39 DESC 'Git username'
40 EQUALITY caseExactMatch
41 SUBSTR caseExactSubstringsMatch
42 SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
43
44attributetype ( 1.3.6.1.4.1.9163.2.3.1.6 NAME 'gitAclTree'
45 DESC 'Git subtree'
46 EQUALITY caseExactMatch
47 SUBSTR caseExactSubstringsMatch
48 SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
49
50objectclass ( 1.3.6.1.4.1.9163.2.3.2.0 NAME 'gitACL'
51 DESC 'Git Access Control List Entry'
52 SUP top STRUCTURAL
53 MUST ( cn $ gitAclProject $ gitAclVerb )
54 MAY ( gitAclUser $ gitAclOp $ gitAclRef $ gitAclOrder $
55 gitAclTree $ description ) )
56
diff --git a/gray-assignments.texi b/gray-assignments.texi
index f6c8a7f..8ae72ad 100644
--- a/gray-assignments.texi
+++ b/gray-assignments.texi
@@ -47,6 +47,7 @@ Private Enterprise Number node.
47Apendices 47Apendices
48 48
49* gray.schema:: 49* gray.schema::
50* gitacl.schema::
50* SENDMAIL-STATS.txt:: 51* SENDMAIL-STATS.txt::
51* SESSION-STATS.txt:: 52* SESSION-STATS.txt::
52* MYSQL-STAT-MIB.txt:: 53* MYSQL-STAT-MIB.txt::
@@ -74,7 +75,7 @@ please contact @email{gray@@gnu.org, Sergey Poznyakoff}.
74@defvr {OID} 1.3.6.1.4.1.9163.2 75@defvr {OID} 1.3.6.1.4.1.9163.2
75Name: @samp{gray.schema} 76Name: @samp{gray.schema}
76@*Purpose: Various LDAP assignments. 77@*Purpose: Various LDAP assignments.
77@*References: @xref{gray.schema}. 78@*References: @xref{gray.schema}, @xref{gitacl.schema}.
78@end defvr 79@end defvr
79 80
80@defvr {OID} 1.3.6.1.4.1.9163.100 81@defvr {OID} 1.3.6.1.4.1.9163.100
@@ -124,7 +125,8 @@ Name: check_class_snmp
124 125
125@defvr {OID} 1.3.6.1.4.1.9163.864 126@defvr {OID} 1.3.6.1.4.1.9163.864
126Name: @samp{umi.schema} 127Name: @samp{umi.schema}
127@*Purpose: LDAP assignments for @command{UMI}. 128@*Purpose: LDAP assignments for @command{UMI}
129@*Author: Zeus Panchenko
128@*Project: @uref{https://github.com/z-eos/umi} 130@*Project: @uref{https://github.com/z-eos/umi}
129@*References: @xref{umi.schema}. 131@*References: @xref{umi.schema}.
130@end defvr 132@end defvr
@@ -135,12 +137,33 @@ Name: @samp{umi.schema}
135The LDAP schema below defines various accounting objects I use on my 137The LDAP schema below defines various accounting objects I use on my
136servers. 138servers.
137 139
138Base OID: 1.3.6.1.4.1.9163.2 140@noindent
141Base OID: 1.3.6.1.4.1.9163.2 (except for @samp{1.3.6.1.4.1.9163.2.3},
142which see in @pxref{gitacl.schema}).
139 143
140@example 144@example
141@include gray.inc 145@include gray.inc
142@end example 146@end example
143 147
148@node gitacl.schema
149@appendix gitacl.schema
150
151This is LDAP schema used by @command{gitaclhook}, a @command{git} hook
152implementing fine-grained access control for git repositories. For
153detailed information about the program including pointers to
154downloads, see @uref{https://puszcza.gnu.org.ua/projects/gitaclhook}.
155
156The most recent version of this MIB is available from
157@uref{http://git.gnu.org.ua/cgit/gitaclhook.git/tree/gitacl.schema}.
158
159
160@noindent
161Base OID: 1.3.6.1.4.1.9163.2.3
162
163@example
164@include gitacl.inc
165@end example
166
144@node SENDMAIL-STATS.txt 167@node SENDMAIL-STATS.txt
145@appendix SENDMAIL-STATS.txt 168@appendix SENDMAIL-STATS.txt
146 169
@@ -152,6 +175,7 @@ obtained by mailq and mailstats. It is used by the
152The most recent version of this MIB is available from 175The most recent version of this MIB is available from
153@uref{http://git.gnu.org.ua/cgit/netsnmp-sendmail.git/tree/SENDMAIL-STATS.txt}. 176@uref{http://git.gnu.org.ua/cgit/netsnmp-sendmail.git/tree/SENDMAIL-STATS.txt}.
154 177
178@noindent
155Base OID: 1.3.6.1.4.1.9163.100 179Base OID: 1.3.6.1.4.1.9163.100
156 180
157@example 181@example
@@ -169,6 +193,7 @@ Therefore I have never published it. Quite possibly the module would
169phase out some of these days, and the OID will be reused for some 193phase out some of these days, and the OID will be reused for some
170other purpose. 194other purpose.
171 195
196@noindent
172Base OID: 1.3.6.1.4.1.9163.101 197Base OID: 1.3.6.1.4.1.9163.101
173 198
174@example 199@example
@@ -186,6 +211,7 @@ module is available at @uref{https://puszcza.gnu.org.ua/projects/mysqlstat}.
186The most recent version of this MIB is available from 211The most recent version of this MIB is available from
187@uref{http://git.gnu.org.ua/cgit/mysqlstat.git/tree/src/MYSQL-STAT-MIB.txt} 212@uref{http://git.gnu.org.ua/cgit/mysqlstat.git/tree/src/MYSQL-STAT-MIB.txt}
188 213
214@noindent
189Base OID: 1.3.6.1.4.1.9163.102 215Base OID: 1.3.6.1.4.1.9163.102
190 216
191@example 217@example
@@ -202,6 +228,7 @@ avaialable from @uref{https://puszcza.gnu.org.ua/projects/tallyman}.
202The most recent version of this MIB is available from 228The most recent version of this MIB is available from
203@uref{http://git.gnu.org.ua/cgit/tallyman.git/tree/src/TALLYMAN-MIB.txt}. 229@uref{http://git.gnu.org.ua/cgit/tallyman.git/tree/src/TALLYMAN-MIB.txt}.
204 230
231@noindent
205Base OID: 1.3.6.1.4.1.9163.103 232Base OID: 1.3.6.1.4.1.9163.103
206 233
207@example 234@example
@@ -214,6 +241,7 @@ Base OID: 1.3.6.1.4.1.9163.103
214Yet another unpublished project: @command{NetSNMP::OWSProbe}. Will 241Yet another unpublished project: @command{NetSNMP::OWSProbe}. Will
215hopefully be withdrawn. 242hopefully be withdrawn.
216 243
244@noindent
217Base OID: 1.3.6.1.4.1.9163.110 245Base OID: 1.3.6.1.4.1.9163.110
218 246
219@example 247@example

Return to:

Send suggestions and report system problems to the System administrator.