source/scripting/python/samba/__init__.py

   1 #!/usr/bin/python
   2
   3 # Unix SMB/CIFS implementation.
   4 # Copyright (C) Andrew Tridgell <tridge@samba.org> 2005
   5 # Copyright (C) Jelmer Vernooij <jelmer@samba.org> 2007
   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 os
  22 from misc import ldb_set_credentials
  23
  24 def _in_source_tree():
  25     print os.path.exists("%s/../../../samba4-skip" % os.path.dirname(__file__))
  26
  27 # When running, in-tree, make sure bin/python is in the PYTHONPATH
  28 if _in_source_tree():
  29     import sys
  30     dir = os.path.dirname(__file__)
  31     sys.path.append("%s/../../../bin/python" % os.path.dirname(__file__))
  32
  33 def Ldb(url, session_info=None, credentials=None, modules_dir=None):
  34     """Open a Samba Ldb file.
  35
  36     This is different from a regular Ldb file in that the Samba-specific
  37     modules-dir is used by default and that credentials and session_info
  38     can be passed through (required by some modules).
  39     """
  40     import ldb
  41     ret = ldb.Ldb()
  42     if modules_dir is None:
  43         modules_dir = os.path.join(os.getcwd(), "bin", "modules", "ldb")
  44     ret.set_modules_dir(modules_dir)
  45     def samba_debug(level,text):
  46         print "%d %s" % (level, text)
  47     ldb_set_opaque("credentials", credentials)
  48     ret.set_opaque("sessionInfo", session_info)
  49     #ret.set_debug(samba_debug)
  50     ret.connect(url)
  51     return ret
  52
  53
  54 def substitute_var(text, values):
  55     """substitute strings of the form ${NAME} in str, replacing
  56     with substitutions from subobj.
  57
  58     :param text: Text in which to subsitute.
  59     :param values: Dictionary with keys and values.
  60     """
  61
  62     for (name, value) in values.items():
  63         text = text.replace("${%s}" % name, value)
  64
  65     return text
  66
  67
  68 def valid_netbios_name(name):
  69     """Check whether a name is valid as a NetBIOS name. """
  70     # FIXME: There are probably more constraints here.
  71     # crh has a paragraph on this in his book (1.4.1.1)
  72     if len(name) > 13:
  73         return False
  74     return True
  75