docs/textdocs/README.DCEDFS

   1 =============================================================================
   2
   3         Basic DCE/DFS Support for SAMBA 1.9.13
   4
   5         Jim Doyle <doyle@oec.com> 06-02-95
   6
   7 =============================================================================
   8
   9 Functionality:
  10 --------------
  11
  12         Per-instance authentication for DCE/DFS.
  13
  14 Missing Functionality in this Implementation:
  15 ---------------------------------------------
  16
  17         * No automatic refresh of credentials
  18
  19           To do so would not be that hard.. One could simply
  20           stash the clear-text key in memory, spawn a key management
  21           thread to wake up right before credentials expire and
  22           refresh the login context.
  23
  24         * No UNIX Signals support (SIGCLD, SIGPIPE, SIGHUP, SIGBUS, SIGSEGV)
  25
  26
  27           There is no support for signal processing in Samba daemons
  28           that need to authenticate with DCE. The explanation for this
  29           is that the smbd is linked against thread-safe libraries in
  30           order to be able to use DCE authentication mechanisms.
  31           Because smbd uses signal() and fork(), it represents the
  32           worst case scenario for DCE portability. In order
  33           to properly support signals in a forked server environment,
  34           some rework of smbd is needed in order to properly
  35           construct, shutdown and reconstruct asynchronous signal
  36           handling threads and synchronous signal traps across the
  37           parent and child. I have not had contiguous time to work
  38           on it, I expect it to be a weeks worth of work to cleanly
  39           integrate thread-safe signal handing into the code and
  40           test it. Until I can get to this task, I will leave it up
  41           to someone adventurous enough to engineer it and negotiate
  42           with Andrew to integrate the changes into the mainline branch.
  43
  44           The lack of full signal support means that you cannot
  45           rely upon SIGHUP-ing the parent daemon to refresh
  46           the configuration data. Likewise, you cannot take advantage
  47           of the builtin SIGBUS/SIGSEGV traps to diagnose failures.
  48           You will have to halt Samba in order to make changes
  49           and then have them take effect.
  50
  51           The SMBD server as it stands is suitable to use if you
  52           already have experience with configuring and running
  53           SAMBA.
  54
  55 Tested Platforms:
  56 -----------------
  57
  58                 HP-UX 9.05 / HP-UX DCE 1.2.1
  59                 AIX 3.2.5  / AIX DCE/6000 1.3
  60                 DEC OSF-1 3.0 / DEC DCE 1.3
  61
  62 Building:
  63 ---------
  64
  65         - Uncomment the the appropriate block in the Makefile
  66           for the platform you wish to build on.
  67
  68         - Samples of Samba server configuration files for our
  69           DFS environment are included in samples.dcedfs/
  70
  71
  72
  73 Bugs, Suggestions, etc..
  74 --------------------------
  75
  76         Please post them to the mailing list.
  77         That way I will see them and they will become part of
  78         the archives so others can share the knowledge.
  79