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