1 # create schema.ldif (as a string) from WSPP documentation
3 # based on minschema.py and minschema_wspp
5 # This program is free software; you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; either version 3 of the License, or
8 # (at your option) any later version.
10 # This program is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 # GNU General Public License for more details.
15 # You should have received a copy of the GNU General Public License
16 # along with this program. If not, see <http://www.gnu.org/licenses/>.
18 """Generate LDIF from WSPP documentation."""
27 # bit positions as labeled in the docs
28 bitFields["searchflags"] = {
30 'fPDNTATTINDEX': 30, # PI
32 'fPRESERVEONDELETE': 28, # PR
34 'fTUPLEINDEX': 26, # TP
35 'fSUBTREEATTINDEX': 25, # ST
36 'fCONFIDENTIAL': 24, # CF
37 'fNEVERVALUEAUDIT': 23, # NV
38 'fRODCAttribute': 22, # RO
41 # missing in ADTS but required by LDIF
42 'fRODCFilteredAttribute': 22, # RO ?
43 'fCONFIDENTAIL': 24, # typo
44 'fRODCFILTEREDATTRIBUTE': 22 # case
48 bitFields["systemflags"] = {
49 'FLAG_ATTR_NOT_REPLICATED': 31, 'FLAG_CR_NTDS_NC': 31, # NR
50 'FLAG_ATTR_REQ_PARTIAL_SET_MEMBER': 30, 'FLAG_CR_NTDS_DOMAIN': 30, # PS
51 'FLAG_ATTR_IS_CONSTRUCTED': 29, 'FLAG_CR_NTDS_NOT_GC_REPLICATED': 29, # CS
52 'FLAG_ATTR_IS_OPERATIONAL': 28, # OP
53 'FLAG_SCHEMA_BASE_OBJECT': 27, # BS
54 'FLAG_ATTR_IS_RDN': 26, # RD
55 'FLAG_DISALLOW_MOVE_ON_DELETE': 6, # DE
56 'FLAG_DOMAIN_DISALLOW_MOVE': 5, # DM
57 'FLAG_DOMAIN_DISALLOW_RENAME': 4, # DR
58 'FLAG_CONFIG_ALLOW_LIMITED_MOVE': 3, # AL
59 'FLAG_CONFIG_ALLOW_MOVE': 2, # AM
60 'FLAG_CONFIG_ALLOW_RENAME': 1, # AR
61 'FLAG_DISALLOW_DELETE': 0 # DD
65 bitFields["schemaflagsex"] = {
66 'FLAG_ATTR_IS_CRITICAL': 31
71 '1.3.12.2.1011.28.0.702' : base64.b64encode('\x2B\x0C\x02\x87\x73\x1C\x00\x85\x3E'),
72 '1.2.840.113556.1.1.1.12': base64.b64encode('\x2A\x86\x48\x86\xF7\x14\x01\x01\x01\x0C'),
73 '2.6.6.1.2.5.11.29' : base64.b64encode('\x56\x06\x01\x02\x05\x0B\x1D'),
74 '1.2.840.113556.1.1.1.11': base64.b64encode('\x2A\x86\x48\x86\xF7\x14\x01\x01\x01\x0B'),
75 '1.3.12.2.1011.28.0.714' : base64.b64encode('\x2B\x0C\x02\x87\x73\x1C\x00\x85\x4A'),
76 '1.3.12.2.1011.28.0.732' : base64.b64encode('\x2B\x0C\x02\x87\x73\x1C\x00\x85\x5C'),
77 '1.2.840.113556.1.1.1.6' : base64.b64encode('\x2A\x86\x48\x86\xF7\x14\x01\x01\x01\x06')
80 # separated by commas in docs, and must be broken up
81 multivalued_attrs = set(["auxiliaryclass","maycontain","mustcontain","posssuperiors",
82 "systemauxiliaryclass","systemmaycontain","systemmustcontain",
83 "systemposssuperiors"])
85 def __read_folded_line(f, buffer):
86 """ reads a line from an LDIF file, unfolding it"""
95 # cannot fold an empty line
96 assert(line != "" and line != "\n")
106 # eof, definitely won't be folded
109 # marks end of a folded line
110 # line contains the now unfolded line
111 # buffer contains the start of the next possibly folded line
115 return (line, buffer)
118 def __read_raw_entries(f):
119 """reads an LDIF entry, only unfolding lines"""
121 # will not match options after the attribute type
122 attr_type_re = re.compile("^([A-Za-z]+[A-Za-z0-9-]*):")
130 (l, buffer) = __read_folded_line(f, buffer)
135 if l == "\n" or l == "":
138 m = attr_type_re.match(l)
146 print >>sys.stderr, "Invalid line: %s" % l,
157 """fix a string DN to use ${SCHEMADN}"""
160 if dn.find("<RootDomainDN>") != -1:
161 dn = dn.replace("\n ", "")
162 dn = dn.replace(" ", "")
163 return dn.replace("CN=Schema,CN=Configuration,<RootDomainDN>", "${SCHEMADN}")
167 def __convert_bitfield(key, value):
168 """Evaluate the OR expression in 'value'"""
169 assert(isinstance(value, str))
171 value = value.replace("\n ", "")
172 value = value.replace(" ", "")
175 # some attributes already have numeric values
179 flags = value.split("|")
181 bitpos = bitFields[key][f]
182 o = o | (1 << (31 - bitpos))
186 def __write_ldif_one(entry):
187 """Write out entry as LDIF"""
191 if isinstance(l[1], str):
196 if l[0].lower() == 'omobjectclass':
197 out.append("%s:: %s" % (l[0], l[1]))
201 out.append("%s: %s" % (l[0], v))
204 return "\n".join(out)
206 def __transform_entry(entry, objectClass):
207 """Perform transformations required to convert the LDIF-like schema
208 file entries to LDIF, including Samba-specific stuff."""
210 entry = [l.split(":", 1) for l in entry]
219 if not cn and key == "cn":
222 if key in multivalued_attrs:
223 # unlike LDIF, these are comma-separated
224 l[1] = l[1].replace("\n ", "")
225 l[1] = l[1].replace(" ", "")
227 l[1] = l[1].split(",")
230 l[1] = __convert_bitfield(key, l[1])
232 if key == "omobjectclass":
233 l[1] = oMObjectClassBER[l[1].strip()]
235 if isinstance(l[1], str):
240 entry.insert(0, ["dn", "CN=%s,${SCHEMADN}" % cn])
241 entry.insert(1, ["objectClass", ["top", objectClass]])
242 entry.insert(2, ["cn", cn])
243 entry.insert(2, ["objectGUID", str(uuid.uuid4())])
244 entry.insert(2, ["adminDescription", cn])
245 entry.insert(2, ["adminDisplayName", cn])
255 def __parse_schema_file(filename, objectClass):
256 """Load and transform a schema file."""
260 f = open(filename, "rU")
261 for entry in __read_raw_entries(f):
262 out.append(__write_ldif_one(__transform_entry(entry, objectClass)))
264 return "\n\n".join(out)
267 def read_ms_schema(attr_file, classes_file, dump_attributes = True, dump_classes = True, debug = False):
268 """Read WSPP documentation-derived schema files."""
274 attr_ldif = __parse_schema_file(attr_file, "attributeSchema")
276 classes_ldif = __parse_schema_file(classes_file, "classSchema")
278 return attr_ldif + "\n\n" + classes_ldif + "\n\n"
280 if __name__ == '__main__':
284 attr_file = sys.argv[1]
285 classes_file = sys.argv[2]
287 print >>sys.stderr, "Usage: %s attr-file.txt classes-file.txt" % (sys.argv[0])
290 print read_ms_schema(attr_file, classes_file)