python/samba/netcmd/drs.py

   1 # implement samba_tool drs commands
   2 #
   3 # Copyright Andrew Tridgell 2010
   4 #
   5 # based on C implementation by Kamen Mazdrashki <kamen.mazdrashki@postpath.com>
   6 #
   7 # This program is free software; you can redistribute it and/or modify
   8 # it under the terms of the GNU General Public License as published by
   9 # the Free Software Foundation; either version 3 of the License, or
  10 # (at your option) any later version.
  11 #
  12 # This program is distributed in the hope that it will be useful,
  13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 # GNU General Public License for more details.
  16 #
  17 # You should have received a copy of the GNU General Public License
  18 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19 #
  20
  21 import samba.getopt as options
  22 import ldb
  23
  24 from samba.auth import system_session
  25 from samba.netcmd import (
  26     Command,
  27     CommandError,
  28     Option,
  29     SuperCommand,
  30     )
  31 from samba.samdb import SamDB
  32 from samba import drs_utils, nttime2string, dsdb
  33 from samba.dcerpc import drsuapi, misc
  34 import common
  35
  36 def drsuapi_connect(ctx):
  37     '''make a DRSUAPI connection to the server'''
  38     try:
  39         (ctx.drsuapi, ctx.drsuapi_handle, ctx.bind_supported_extensions) = drs_utils.drsuapi_connect(ctx.server, ctx.lp, ctx.creds)
  40     except Exception, e:
  41         raise CommandError("DRS connection to %s failed" % ctx.server, e)
  42
  43 def samdb_connect(ctx):
  44     '''make a ldap connection to the server'''
  45     try:
  46         ctx.samdb = SamDB(url="ldap://%s" % ctx.server,
  47                           session_info=system_session(),
  48                           credentials=ctx.creds, lp=ctx.lp)
  49     except Exception, e:
  50         raise CommandError("LDAP connection to %s failed" % ctx.server, e)
  51
  52 def drs_errmsg(werr):
  53     '''return "was successful" or an error string'''
  54     (ecode, estring) = werr
  55     if ecode == 0:
  56         return "was successful"
  57     return "failed, result %u (%s)" % (ecode, estring)
  58
  59
  60
  61 def attr_default(msg, attrname, default):
  62     '''get an attribute from a ldap msg with a default'''
  63     if attrname in msg:
  64         return msg[attrname][0]
  65     return default
  66
  67
  68
  69 def drs_parse_ntds_dn(ntds_dn):
  70     '''parse a NTDS DN returning a site and server'''
  71     a = ntds_dn.split(',')
  72     if a[0] != "CN=NTDS Settings" or a[2] != "CN=Servers" or a[4] != 'CN=Sites':
  73         raise RuntimeError("bad NTDS DN %s" % ntds_dn)
  74     server = a[1].split('=')[1]
  75     site   = a[3].split('=')[1]
  76     return (site, server)
  77
  78
  79
  80
  81
  82 class cmd_drs_showrepl(Command):
  83     """Show replication status."""
  84
  85     synopsis = "%prog [<DC>] [options]"
  86
  87     takes_optiongroups = {
  88         "sambaopts": options.SambaOptions,
  89         "versionopts": options.VersionOptions,
  90         "credopts": options.CredentialsOptions,
  91     }
  92
  93     takes_args = ["DC?"]
  94
  95     def print_neighbour(self, n):
  96         '''print one set of neighbour information'''
  97         self.message("%s" % n.naming_context_dn)
  98         try:
  99             (site, server) = drs_parse_ntds_dn(n.source_dsa_obj_dn)
 100             self.message("\t%s\%s via RPC" % (site, server))
 101         except RuntimeError:
 102             self.message("\tNTDS DN: %s" % n.source_dsa_obj_dn)
 103         self.message("\t\tDSA object GUID: %s" % n.source_dsa_obj_guid)
 104         self.message("\t\tLast attempt @ %s %s" % (nttime2string(n.last_attempt),
 105                                                    drs_errmsg(n.result_last_attempt)))
 106         self.message("\t\t%u consecutive failure(s)." % n.consecutive_sync_failures)
 107         self.message("\t\tLast success @ %s" % nttime2string(n.last_success))
 108         self.message("")
 109
 110     def drsuapi_ReplicaInfo(ctx, info_type):
 111         '''call a DsReplicaInfo'''
 112
 113         req1 = drsuapi.DsReplicaGetInfoRequest1()
 114         req1.info_type = info_type
 115         try:
 116             (info_type, info) = ctx.drsuapi.DsReplicaGetInfo(ctx.drsuapi_handle, 1, req1)
 117         except Exception, e:
 118             raise CommandError("DsReplicaGetInfo of type %u failed" % info_type, e)
 119         return (info_type, info)
 120
 121     def run(self, DC=None, sambaopts=None,
 122             credopts=None, versionopts=None, server=None):
 123
 124         self.lp = sambaopts.get_loadparm()
 125         if DC is None:
 126             DC = common.netcmd_dnsname(self.lp)
 127         self.server = DC
 128         self.creds = credopts.get_credentials(self.lp, fallback_machine=True)
 129
 130         drsuapi_connect(self)
 131         samdb_connect(self)
 132
 133         # show domain information
 134         ntds_dn = self.samdb.get_dsServiceName()
 135         server_dns = self.samdb.search(base="", scope=ldb.SCOPE_BASE, attrs=["dnsHostName"])[0]['dnsHostName'][0]
 136
 137         (site, server) = drs_parse_ntds_dn(ntds_dn)
 138         try:
 139             ntds = self.samdb.search(base=ntds_dn, scope=ldb.SCOPE_BASE, attrs=['options', 'objectGUID', 'invocationId'])
 140         except Exception, e:
 141             raise CommandError("Failed to search NTDS DN %s" % ntds_dn)
 142         conn = self.samdb.search(base=ntds_dn, expression="(objectClass=nTDSConnection)")
 143
 144         self.message("%s\\%s" % (site, server))
 145         self.message("DSA Options: 0x%08x" % int(attr_default(ntds[0], "options", 0)))
 146         self.message("DSA object GUID: %s" % self.samdb.schema_format_value("objectGUID", ntds[0]["objectGUID"][0]))
 147         self.message("DSA invocationId: %s\n" % self.samdb.schema_format_value("objectGUID", ntds[0]["invocationId"][0]))
 148
 149         self.message("==== INBOUND NEIGHBORS ====\n")
 150         (info_type, info) = self.drsuapi_ReplicaInfo(drsuapi.DRSUAPI_DS_REPLICA_INFO_NEIGHBORS)
 151         for n in info.array:
 152             self.print_neighbour(n)
 153
 154
 155         self.message("==== OUTBOUND NEIGHBORS ====\n")
 156         (info_type, info) = self.drsuapi_ReplicaInfo(drsuapi.DRSUAPI_DS_REPLICA_INFO_REPSTO)
 157         for n in info.array:
 158             self.print_neighbour(n)
 159
 160         reasons = ['NTDSCONN_KCC_GC_TOPOLOGY',
 161                    'NTDSCONN_KCC_RING_TOPOLOGY',
 162                    'NTDSCONN_KCC_MINIMIZE_HOPS_TOPOLOGY',
 163                    'NTDSCONN_KCC_STALE_SERVERS_TOPOLOGY',
 164                    'NTDSCONN_KCC_OSCILLATING_CONNECTION_TOPOLOGY',
 165                    'NTDSCONN_KCC_INTERSITE_GC_TOPOLOGY',
 166                    'NTDSCONN_KCC_INTERSITE_TOPOLOGY',
 167                    'NTDSCONN_KCC_SERVER_FAILOVER_TOPOLOGY',
 168                    'NTDSCONN_KCC_SITE_FAILOVER_TOPOLOGY',
 169                    'NTDSCONN_KCC_REDUNDANT_SERVER_TOPOLOGY']
 170
 171         self.message("==== KCC CONNECTION OBJECTS ====\n")
 172         for c in conn:
 173             self.message("Connection --")
 174
 175             c_rdn, sep, c_server_dn = c['fromServer'][0].partition(',')
 176             try:
 177                 c_server_res = self.samdb.search(base=c_server_dn, scope=ldb.SCOPE_BASE, attrs=["dnsHostName"])
 178                 c_server_dns = c_server_res[0]["dnsHostName"][0]
 179             except ldb.LdbError, (errno, _):
 180                 if errno == ldb.ERR_NO_SUCH_OBJECT:
 181                     self.message("\tWARNING: Connection to DELETED server!")
 182                 c_server_dns = ""
 183             except KeyError:
 184                 c_server_dns = ""
 185
 186             self.message("\tConnection name: %s" % c['name'][0])
 187             self.message("\tEnabled        : %s" % attr_default(c, 'enabledConnection', 'TRUE'))
 188             self.message("\tServer DNS name : %s" % c_server_dns)
 189             self.message("\tServer DN name  : %s" % c['fromServer'][0])
 190             self.message("\t\tTransportType: RPC")
 191             self.message("\t\toptions: 0x%08X" % int(attr_default(c, 'options', 0)))
 192             if not 'mS-DS-ReplicatesNCReason' in c:
 193                 self.message("Warning: No NC replicated for Connection!")
 194                 continue
 195             for r in c['mS-DS-ReplicatesNCReason']:
 196                 a = str(r).split(':')
 197                 self.message("\t\tReplicatesNC: %s" % a[3])
 198                 self.message("\t\tReason: 0x%08x" % int(a[2]))
 199                 for s in reasons:
 200                     if getattr(dsdb, s, 0) & int(a[2]):
 201                         self.message("\t\t\t%s" % s)
 202
 203
 204
 205 class cmd_drs_kcc(Command):
 206     """Trigger knowledge consistency center run."""
 207
 208     synopsis = "%prog [<DC>] [options]"
 209
 210     takes_optiongroups = {
 211         "sambaopts": options.SambaOptions,
 212         "versionopts": options.VersionOptions,
 213         "credopts": options.CredentialsOptions,
 214     }
 215
 216     takes_args = ["DC?"]
 217
 218     def run(self, DC=None, sambaopts=None,
 219             credopts=None, versionopts=None, server=None):
 220
 221         self.lp = sambaopts.get_loadparm()
 222         if DC is None:
 223             DC = common.netcmd_dnsname(self.lp)
 224         self.server = DC
 225
 226         self.creds = credopts.get_credentials(self.lp, fallback_machine=True)
 227
 228         drsuapi_connect(self)
 229
 230         req1 = drsuapi.DsExecuteKCC1()
 231         try:
 232             self.drsuapi.DsExecuteKCC(self.drsuapi_handle, 1, req1)
 233         except Exception, e:
 234             raise CommandError("DsExecuteKCC failed", e)
 235         self.message("Consistency check on %s successful." % DC)
 236
 237
 238
 239 def drs_local_replicate(self, SOURCE_DC, NC):
 240     '''replicate from a source DC to the local SAM'''
 241
 242     self.server = SOURCE_DC
 243     drsuapi_connect(self)
 244
 245     self.local_samdb = SamDB(session_info=system_session(), url=None,
 246                              credentials=self.creds, lp=self.lp)
 247
 248     self.samdb = SamDB(url="ldap://%s" % self.server,
 249                        session_info=system_session(),
 250                        credentials=self.creds, lp=self.lp)
 251
 252     # work out the source and destination GUIDs
 253     res = self.local_samdb.search(base="", scope=ldb.SCOPE_BASE, attrs=["dsServiceName"])
 254     self.ntds_dn = res[0]["dsServiceName"][0]
 255
 256     res = self.local_samdb.search(base=self.ntds_dn, scope=ldb.SCOPE_BASE, attrs=["objectGUID"])
 257     self.ntds_guid = misc.GUID(self.samdb.schema_format_value("objectGUID", res[0]["objectGUID"][0]))
 258
 259
 260     source_dsa_invocation_id = misc.GUID(self.samdb.get_invocation_id())
 261     destination_dsa_guid = self.ntds_guid
 262
 263     self.samdb.transaction_start()
 264     repl = drs_utils.drs_Replicate("ncacn_ip_tcp:%s[seal]" % self.server, self.lp,
 265                                    self.creds, self.local_samdb)
 266     try:
 267         repl.replicate(NC, source_dsa_invocation_id, destination_dsa_guid)
 268     except Exception, e:
 269         raise CommandError("Error replicating DN %s" % NC, e)
 270     self.samdb.transaction_commit()
 271
 272
 273
 274 class cmd_drs_replicate(Command):
 275     """Replicate a naming context between two DCs."""
 276
 277     synopsis = "%prog <destinationDC> <sourceDC> <NC> [options]"
 278
 279     takes_optiongroups = {
 280         "sambaopts": options.SambaOptions,
 281         "versionopts": options.VersionOptions,
 282         "credopts": options.CredentialsOptions,
 283     }
 284
 285     takes_args = ["DEST_DC", "SOURCE_DC", "NC"]
 286
 287     takes_options = [
 288         Option("--add-ref", help="use ADD_REF to add to repsTo on source", action="store_true"),
 289         Option("--sync-forced", help="use SYNC_FORCED to force inbound replication", action="store_true"),
 290         Option("--sync-all", help="use SYNC_ALL to replicate from all DCs", action="store_true"),
 291         Option("--full-sync", help="resync all objects", action="store_true"),
 292         Option("--local", help="pull changes directly into the local database (destination DC is ignored)", action="store_true"),
 293         ]
 294
 295     def run(self, DEST_DC, SOURCE_DC, NC,
 296             add_ref=False, sync_forced=False, sync_all=False, full_sync=False,
 297             local=False, sambaopts=None, credopts=None, versionopts=None, server=None):
 298
 299         self.server = DEST_DC
 300         self.lp = sambaopts.get_loadparm()
 301
 302         self.creds = credopts.get_credentials(self.lp, fallback_machine=True)
 303
 304         if local:
 305             drs_local_replicate(self, SOURCE_DC, NC)
 306             return
 307
 308         drsuapi_connect(self)
 309         samdb_connect(self)
 310
 311         # we need to find the NTDS GUID of the source DC
 312         msg = self.samdb.search(base=self.samdb.get_config_basedn(),
 313                                 expression="(&(objectCategory=server)(|(name=%s)(dNSHostName=%s)))" % (
 314             ldb.binary_encode(SOURCE_DC),
 315             ldb.binary_encode(SOURCE_DC)),
 316                                 attrs=[])
 317         if len(msg) == 0:
 318             raise CommandError("Failed to find source DC %s" % SOURCE_DC)
 319         server_dn = msg[0]['dn']
 320
 321         msg = self.samdb.search(base=server_dn, scope=ldb.SCOPE_ONELEVEL,
 322                                 expression="(|(objectCategory=nTDSDSA)(objectCategory=nTDSDSARO))",
 323                                 attrs=['objectGUID', 'options'])
 324         if len(msg) == 0:
 325             raise CommandError("Failed to find source NTDS DN %s" % SOURCE_DC)
 326         source_dsa_guid = msg[0]['objectGUID'][0]
 327         dsa_options = int(attr_default(msg, 'options', 0))
 328
 329
 330         req_options = 0
 331         if not (dsa_options & dsdb.DS_NTDSDSA_OPT_DISABLE_OUTBOUND_REPL):
 332             req_options |= drsuapi.DRSUAPI_DRS_WRIT_REP
 333         if add_ref:
 334             req_options |= drsuapi.DRSUAPI_DRS_ADD_REF
 335         if sync_forced:
 336             req_options |= drsuapi.DRSUAPI_DRS_SYNC_FORCED
 337         if sync_all:
 338             req_options |= drsuapi.DRSUAPI_DRS_SYNC_ALL
 339         if full_sync:
 340             req_options |= drsuapi.DRSUAPI_DRS_FULL_SYNC_NOW
 341
 342         try:
 343             drs_utils.sendDsReplicaSync(self.drsuapi, self.drsuapi_handle, source_dsa_guid, NC, req_options)
 344         except drs_utils.drsException, estr:
 345             raise CommandError("DsReplicaSync failed", estr)
 346         self.message("Replicate from %s to %s was successful." % (SOURCE_DC, DEST_DC))
 347
 348
 349
 350 class cmd_drs_bind(Command):
 351     """Show DRS capabilities of a server."""
 352
 353     synopsis = "%prog [<DC>] [options]"
 354
 355     takes_optiongroups = {
 356         "sambaopts": options.SambaOptions,
 357         "versionopts": options.VersionOptions,
 358         "credopts": options.CredentialsOptions,
 359     }
 360
 361     takes_args = ["DC?"]
 362
 363     def run(self, DC=None, sambaopts=None,
 364             credopts=None, versionopts=None, server=None):
 365
 366         self.lp = sambaopts.get_loadparm()
 367         if DC is None:
 368             DC = common.netcmd_dnsname(self.lp)
 369         self.server = DC
 370         self.creds = credopts.get_credentials(self.lp, fallback_machine=True)
 371
 372         drsuapi_connect(self)
 373
 374         bind_info = drsuapi.DsBindInfoCtr()
 375         bind_info.length = 28
 376         bind_info.info = drsuapi.DsBindInfo28()
 377         (info, handle) = self.drsuapi.DsBind(misc.GUID(drsuapi.DRSUAPI_DS_BIND_GUID), bind_info)
 378
 379         optmap = [
 380             ("DRSUAPI_SUPPORTED_EXTENSION_BASE",     "DRS_EXT_BASE"),
 381             ("DRSUAPI_SUPPORTED_EXTENSION_ASYNC_REPLICATION",   "DRS_EXT_ASYNCREPL"),
 382             ("DRSUAPI_SUPPORTED_EXTENSION_REMOVEAPI",    "DRS_EXT_REMOVEAPI"),
 383             ("DRSUAPI_SUPPORTED_EXTENSION_MOVEREQ_V2",   "DRS_EXT_MOVEREQ_V2"),
 384             ("DRSUAPI_SUPPORTED_EXTENSION_GETCHG_COMPRESS",   "DRS_EXT_GETCHG_DEFLATE"),
 385             ("DRSUAPI_SUPPORTED_EXTENSION_DCINFO_V1",    "DRS_EXT_DCINFO_V1"),
 386             ("DRSUAPI_SUPPORTED_EXTENSION_RESTORE_USN_OPTIMIZATION",   "DRS_EXT_RESTORE_USN_OPTIMIZATION"),
 387             ("DRSUAPI_SUPPORTED_EXTENSION_ADDENTRY",    "DRS_EXT_ADDENTRY"),
 388             ("DRSUAPI_SUPPORTED_EXTENSION_KCC_EXECUTE",   "DRS_EXT_KCC_EXECUTE"),
 389             ("DRSUAPI_SUPPORTED_EXTENSION_ADDENTRY_V2",   "DRS_EXT_ADDENTRY_V2"),
 390             ("DRSUAPI_SUPPORTED_EXTENSION_LINKED_VALUE_REPLICATION",   "DRS_EXT_LINKED_VALUE_REPLICATION"),
 391             ("DRSUAPI_SUPPORTED_EXTENSION_DCINFO_V2",    "DRS_EXT_DCINFO_V2"),
 392             ("DRSUAPI_SUPPORTED_EXTENSION_INSTANCE_TYPE_NOT_REQ_ON_MOD","DRS_EXT_INSTANCE_TYPE_NOT_REQ_ON_MOD"),
 393             ("DRSUAPI_SUPPORTED_EXTENSION_CRYPTO_BIND",   "DRS_EXT_CRYPTO_BIND"),
 394             ("DRSUAPI_SUPPORTED_EXTENSION_GET_REPL_INFO",   "DRS_EXT_GET_REPL_INFO"),
 395             ("DRSUAPI_SUPPORTED_EXTENSION_STRONG_ENCRYPTION",   "DRS_EXT_STRONG_ENCRYPTION"),
 396             ("DRSUAPI_SUPPORTED_EXTENSION_DCINFO_V01",   "DRS_EXT_DCINFO_VFFFFFFFF"),
 397             ("DRSUAPI_SUPPORTED_EXTENSION_TRANSITIVE_MEMBERSHIP",  "DRS_EXT_TRANSITIVE_MEMBERSHIP"),
 398             ("DRSUAPI_SUPPORTED_EXTENSION_ADD_SID_HISTORY",   "DRS_EXT_ADD_SID_HISTORY"),
 399             ("DRSUAPI_SUPPORTED_EXTENSION_POST_BETA3",   "DRS_EXT_POST_BETA3"),
 400             ("DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V5",   "DRS_EXT_GETCHGREQ_V5"),
 401             ("DRSUAPI_SUPPORTED_EXTENSION_GET_MEMBERSHIPS2",   "DRS_EXT_GETMEMBERSHIPS2"),
 402             ("DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V6",   "DRS_EXT_GETCHGREQ_V6"),
 403             ("DRSUAPI_SUPPORTED_EXTENSION_NONDOMAIN_NCS",   "DRS_EXT_NONDOMAIN_NCS"),
 404             ("DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V8",   "DRS_EXT_GETCHGREQ_V8"),
 405             ("DRSUAPI_SUPPORTED_EXTENSION_GETCHGREPLY_V5",   "DRS_EXT_GETCHGREPLY_V5"),
 406             ("DRSUAPI_SUPPORTED_EXTENSION_GETCHGREPLY_V6",   "DRS_EXT_GETCHGREPLY_V6"),
 407             ("DRSUAPI_SUPPORTED_EXTENSION_ADDENTRYREPLY_V3",   "DRS_EXT_WHISTLER_BETA3"),
 408             ("DRSUAPI_SUPPORTED_EXTENSION_GETCHGREPLY_V7",   "DRS_EXT_WHISTLER_BETA3"),
 409             ("DRSUAPI_SUPPORTED_EXTENSION_VERIFY_OBJECT",   "DRS_EXT_WHISTLER_BETA3"),
 410             ("DRSUAPI_SUPPORTED_EXTENSION_XPRESS_COMPRESS",   "DRS_EXT_W2K3_DEFLATE"),
 411             ("DRSUAPI_SUPPORTED_EXTENSION_GETCHGREQ_V10",   "DRS_EXT_GETCHGREQ_V10"),
 412             ("DRSUAPI_SUPPORTED_EXTENSION_RESERVED_PART2",   "DRS_EXT_RESERVED_FOR_WIN2K_OR_DOTNET_PART2"),
 413             ("DRSUAPI_SUPPORTED_EXTENSION_RESERVED_PART3", "DRS_EXT_RESERVED_FOR_WIN2K_OR_DOTNET_PART3")
 414             ]
 415
 416         optmap_ext = [
 417             ("DRSUAPI_SUPPORTED_EXTENSION_ADAM", "DRS_EXT_ADAM"),
 418             ("DRSUAPI_SUPPORTED_EXTENSION_LH_BETA2", "DRS_EXT_LH_BETA2"),
 419             ("DRSUAPI_SUPPORTED_EXTENSION_RECYCLE_BIN", "DRS_EXT_RECYCLE_BIN")]
 420
 421         self.message("Bind to %s succeeded." % DC)
 422         self.message("Extensions supported:")
 423         for (opt, str) in optmap:
 424             optval = getattr(drsuapi, opt, 0)
 425             if info.info.supported_extensions & optval:
 426                 yesno = "Yes"
 427             else:
 428                 yesno = "No "
 429             self.message("  %-60s: %s (%s)" % (opt, yesno, str))
 430
 431         if isinstance(info.info, drsuapi.DsBindInfo48):
 432             self.message("\nExtended Extensions supported:")
 433             for (opt, str) in optmap_ext:
 434                 optval = getattr(drsuapi, opt, 0)
 435                 if info.info.supported_extensions_ext & optval:
 436                     yesno = "Yes"
 437                 else:
 438                     yesno = "No "
 439                 self.message("  %-60s: %s (%s)" % (opt, yesno, str))
 440
 441         self.message("\nSite GUID: %s" % info.info.site_guid)
 442         self.message("Repl epoch: %u" % info.info.repl_epoch)
 443         if isinstance(info.info, drsuapi.DsBindInfo48):
 444             self.message("Forest GUID: %s" % info.info.config_dn_guid)
 445
 446
 447
 448 class cmd_drs_options(Command):
 449     """Query or change 'options' for NTDS Settings object of a Domain Controller."""
 450
 451     synopsis = "%prog [<DC>] [options]"
 452
 453     takes_optiongroups = {
 454         "sambaopts": options.SambaOptions,
 455         "versionopts": options.VersionOptions,
 456         "credopts": options.CredentialsOptions,
 457     }
 458
 459     takes_args = ["DC?"]
 460
 461     takes_options = [
 462         Option("--dsa-option", help="DSA option to enable/disable", type="str",
 463                metavar="{+|-}IS_GC | {+|-}DISABLE_INBOUND_REPL | {+|-}DISABLE_OUTBOUND_REPL | {+|-}DISABLE_NTDSCONN_XLATE" ),
 464         ]
 465
 466     option_map = {"IS_GC": 0x00000001,
 467                   "DISABLE_INBOUND_REPL": 0x00000002,
 468                   "DISABLE_OUTBOUND_REPL": 0x00000004,
 469                   "DISABLE_NTDSCONN_XLATE": 0x00000008}
 470
 471     def run(self, DC=None, dsa_option=None,
 472             sambaopts=None, credopts=None, versionopts=None):
 473
 474         self.lp = sambaopts.get_loadparm()
 475         if DC is None:
 476             DC = common.netcmd_dnsname(self.lp)
 477         self.server = DC
 478         self.creds = credopts.get_credentials(self.lp, fallback_machine=True)
 479
 480         samdb_connect(self)
 481
 482         ntds_dn = self.samdb.get_dsServiceName()
 483         res = self.samdb.search(base=ntds_dn, scope=ldb.SCOPE_BASE, attrs=["options"])
 484         dsa_opts = int(res[0]["options"][0])
 485
 486         # print out current DSA options
 487         cur_opts = [x for x in self.option_map if self.option_map[x] & dsa_opts]
 488         self.message("Current DSA options: " + ", ".join(cur_opts))
 489
 490         # modify options
 491         if dsa_option:
 492             if dsa_option[:1] not in ("+", "-"):
 493                 raise CommandError("Unknown option %s" % dsa_option)
 494             flag = dsa_option[1:]
 495             if flag not in self.option_map.keys():
 496                 raise CommandError("Unknown option %s" % dsa_option)
 497             if dsa_option[:1] == "+":
 498                 dsa_opts |= self.option_map[flag]
 499             else:
 500                 dsa_opts &= ~self.option_map[flag]
 501             #save new options
 502             m = ldb.Message()
 503             m.dn = ldb.Dn(self.samdb, ntds_dn)
 504             m["options"]= ldb.MessageElement(str(dsa_opts), ldb.FLAG_MOD_REPLACE, "options")
 505             self.samdb.modify(m)
 506             # print out new DSA options
 507             cur_opts = [x for x in self.option_map if self.option_map[x] & dsa_opts]
 508             self.message("New DSA options: " + ", ".join(cur_opts))
 509
 510
 511 class cmd_drs(SuperCommand):
 512     """Directory Replication Services (DRS) management."""
 513
 514     subcommands = {}
 515     subcommands["bind"] = cmd_drs_bind()
 516     subcommands["kcc"] = cmd_drs_kcc()
 517     subcommands["replicate"] = cmd_drs_replicate()
 518     subcommands["showrepl"] = cmd_drs_showrepl()
 519     subcommands["options"] = cmd_drs_options()