diff options
author | Sergey Poznyakoff <gray@gnu.org.ua> | 2019-09-06 10:59:20 +0300 |
---|---|---|
committer | Sergey Poznyakoff <gray@gnu.org.ua> | 2019-09-06 10:59:20 +0300 |
commit | 61a90bb136035b1364c52b5bfed6a807dc7d75ca (patch) | |
tree | 28c2c79b7bd31f3de9502bc1bf1cf37f4260df63 | |
parent | ea8c8114dfbf9c4eabd84168c39854fe2abf2ea7 (diff) | |
download | assignments-61a90bb136035b1364c52b5bfed6a807dc7d75ca.tar.gz assignments-61a90bb136035b1364c52b5bfed6a807dc7d75ca.tar.bz2 |
Document the gitacl schema
-rw-r--r-- | .gitignore | 3 | ||||
-rw-r--r-- | Makefile | 4 | ||||
-rw-r--r-- | gitacl.schema | 56 | ||||
-rw-r--r-- | gray-assignments.texi | 34 |
4 files changed, 92 insertions, 5 deletions
@@ -6,3 +6,6 @@ MYSQL-STAT-MIB.txt | |||
6 | TALLYMAN-MIB.txt | 6 | TALLYMAN-MIB.txt |
7 | *.html | 7 | *.html |
8 | gray-assignments | 8 | gray-assignments |
9 | .emacs.desktop | ||
10 | .emacs.desktop.lock | ||
11 | version.texi | ||
@@ -1,8 +1,8 @@ | |||
1 | SCHEMES = gray.scheme umi.scheme | 1 | SCHEMES = gray.schema gitacl.schema umi.schema |
2 | MIBS = OWS-STATS.txt SESSION-STATS.txt | 2 | MIBS = OWS-STATS.txt SESSION-STATS.txt |
3 | REFMIBS = TALLYMAN-MIB.txt MYSQL-STAT-MIB.txt SENDMAIL-STATS.txt | 3 | REFMIBS = TALLYMAN-MIB.txt MYSQL-STAT-MIB.txt SENDMAIL-STATS.txt |
4 | 4 | ||
5 | TEXINFO_SOURCES = $(SCHEMES:.scheme=.inc) $(MIBS:.txt=.inc) $(REFMIBS:.txt=.inc) | 5 | TEXINFO_SOURCES = $(SCHEMES:.schema=.inc) $(MIBS:.txt=.inc) $(REFMIBS:.txt=.inc) |
6 | SOURCES = gray-assignments.texi version.texi $(TEXINFO_SOURCES) | 6 | SOURCES = gray-assignments.texi version.texi $(TEXINFO_SOURCES) |
7 | 7 | ||
8 | gray-assignments.info: $(SOURCES) | 8 | gray-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 | |||
6 | attributetype ( 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 | |||
13 | attributetype ( 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 | |||
20 | attributetype ( 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 | |||
26 | attributetype ( 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 | |||
32 | attributetype ( 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 | |||
38 | attributetype ( 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 | |||
44 | attributetype ( 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 | |||
50 | objectclass ( 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. | |||
47 | Apendices | 47 | Apendices |
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 |
75 | Name: @samp{gray.schema} | 76 | Name: @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 |
126 | Name: @samp{umi.schema} | 127 | Name: @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} | |||
135 | The LDAP schema below defines various accounting objects I use on my | 137 | The LDAP schema below defines various accounting objects I use on my |
136 | servers. | 138 | servers. |
137 | 139 | ||
138 | Base OID: 1.3.6.1.4.1.9163.2 | 140 | @noindent |
141 | Base OID: 1.3.6.1.4.1.9163.2 (except for @samp{1.3.6.1.4.1.9163.2.3}, | ||
142 | which 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 | |||
151 | This is LDAP schema used by @command{gitaclhook}, a @command{git} hook | ||
152 | implementing fine-grained access control for git repositories. For | ||
153 | detailed information about the program including pointers to | ||
154 | downloads, see @uref{https://puszcza.gnu.org.ua/projects/gitaclhook}. | ||
155 | |||
156 | The 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 | ||
161 | Base 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 | |||
152 | The most recent version of this MIB is available from | 175 | The 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 | ||
155 | Base OID: 1.3.6.1.4.1.9163.100 | 179 | Base 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 | |||
169 | phase out some of these days, and the OID will be reused for some | 193 | phase out some of these days, and the OID will be reused for some |
170 | other purpose. | 194 | other purpose. |
171 | 195 | ||
196 | @noindent | ||
172 | Base OID: 1.3.6.1.4.1.9163.101 | 197 | Base 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}. | |||
186 | The most recent version of this MIB is available from | 211 | The 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 | ||
189 | Base OID: 1.3.6.1.4.1.9163.102 | 215 | Base 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}. | |||
202 | The most recent version of this MIB is available from | 228 | The 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 | ||
205 | Base OID: 1.3.6.1.4.1.9163.103 | 232 | Base 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 | |||
214 | Yet another unpublished project: @command{NetSNMP::OWSProbe}. Will | 241 | Yet another unpublished project: @command{NetSNMP::OWSProbe}. Will |
215 | hopefully be withdrawn. | 242 | hopefully be withdrawn. |
216 | 243 | ||
244 | @noindent | ||
217 | Base OID: 1.3.6.1.4.1.9163.110 | 245 | Base OID: 1.3.6.1.4.1.9163.110 |
218 | 246 | ||
219 | @example | 247 | @example |