nggh! damn select timeout, FD_ISSET... THING.
[Samba.git] / WHATSNEW.txt
blob94c6e6a663e9223bfbaeb63315c3766aa9ff3456
1           WHATS NEW IN Samba (The Next Generation) 2.2
2           ============================================
4 This is an ALPHA release of Samba TNG, the UNIX based SMB/CIFS file,
5 print and login server for Windows systems.
7 This release is to enlist the help of people who are unable to use
8 cvs (http://samba.org/cvs.html) in a major development project to
9 integrate Samba into a Windows NT (tm) Domain environment - the
10 NT Domains for Unix project.
12 If you are running Windows 9x and do not forsee the need for or
13 need to use any Windows NT Workstations on your network in the near
14 future, you will not need Samba TNG or any of its functionality,
15 and your assistance is not being solicited in the development of
16 this project.
18 [lkcl: There is, however, a large enough Windows 9x user-base
19 to warrant ensuring that Samba TNG remains compatible, it's just that
20 personally i will not touch it with a ten foot barge pole (I got
21 as far as setting up a vmware session called win98, and it's still
22 empty).  This is a personal view, not held by any other Samba
23 Team members who are cracking the whip in my direction, and I
24 keep getting into trouble over this.  I apologise sincerely and
25 wholeheartedly to all Windows 9x users for any offense and
26 inconvenience I may have caused to anyone using this stupid OS.]
29 Major changes in Samba TNG
30 --------------------------
32 There are many major changes in Samba TNG.  Here are some of them:
35 1). Windows NT (tm) Primary Domain Controller compatibility
36 -----------------------------------------------------------
38 Samba TNG can act as a Primary Domain Controller to Windows NT 3.5,
39 4.0 and 5.0 (in 4.0 backwards-compatible mode) Workstations.  Backup
40 Domain Controller and Inter-Domain Trust Relationships are at an
41 early, but functional and very hands-on, stage.
43 2). Support for Windows NT (tm) Administrative tools
44 ----------------------------------------------------
46 Significant in-roads have been made into providing support for at least
47 the following Windows NT (tm) tools and services:
49 - User Manager for Domains
50 - Server Manager for Domains
51 - Event Log
52 - Service Control Manager
53 - Registry Editor
54 - Command Scheduler
55 - NT-style Printing
57 A command-line tool named rpcclient, with a command-syntax similar to
58 smbclient, has over sixty five commands that provide equivalent
59 functionality for the same Windows NT (tm) Administrative tools,
60 including the ability to remotely shut down a Windows NT (tm) Server.
62 rpcclient has now been joined by net, samedit, regedit, ntspool,
63 eventlog, lsa, cmdat and svccontrol.  If anyone can think of better
64 names for these, suggestions are welcomed.
66 3). Portability
67 ---------------
69 Samba is now self-configuring using GNU autoconf and libtool, removing
70 the need for people installing Samba to have to hand-configured
71 Makefiles, as was needed in previous versions.
73 You now configure Samba by running "./configure" then "make".  See
74 docs/textdocs/UNIX_INSTALL.txt for details.
76 The use of libtool dramatically reduces the size of samba binaries.
77 As we are using libtool in a slightly different way from usual,
78 you may encounter run-time or compilation errors, so please report
79 them to us.
81 4). New SAM Database Daemons
82 ----------------------------
84 The SAM database daemon, samrd, is being considered "legacy", and
85 the aim is to replace it.  To this end, some new SAM database
86 daemons are being developed - samrtdbd and samrnt5ldapd.
87 They will need to be run with their counterparts, netlogontdbd or
88 netlogonnt5ldapd.  None of these are built as part of the standard
89 make, they have to be explicitly built because they are in
90 development: samrd and lsarpcd are compiled by default.
92 5). pam_ntdom and winbindd
93 --------------------------
95 The Windows Bind Daemon and the Plugin Authentication Module for NT
96 Domains are now part of the Samba TNG Development effort.  
98 winbindd presents, when installed using nsswitch, a unix-like view
99 of a Windows NT Domain environment, allowing Unix applications and
100 the Unix Operating system to enumerate NT users, groups and aliases
101 as Unix users and groups.
103 pam_ntdom, when installed as part of a PAM-enabled Unix Authentication
104 system, allows Unix users to be authenticated against a Windows NT
105 Domain environment.
107 @begin marketing-speak
108         " The powerful combination of winbindd and pam_ntdom allows Unix
109           to be integrated seamlessly into Windows NT Domain environments,
110           which moves us closer to the Holy Grail of 'Single Sign-on'. "
111 @end marketing-speak
114 =====================================================================
116 NOTE - Some important information
117 ---------------------------------
119 Samba TNG up to alpha-0.3 required that the samba server be joined.
120 to its own Domain.  This requirement has been removed.
122 It is important that you read the source/README file for
123 instructions, and it is recommended that you join samba-ntdom@samba.org
124 for update information and status reports.  For details, please see:
126 http://samba.org/listproc/samba-ntdom
128 =====================================================================
130 NOTE - Primary Domain Controller Functionality
131 ----------------------------------------------
133 This version of Samba contains code that correctly implements
134 the undocumented Primary Domain Controller authentication
135 protocols.  However, there is much more to being a Primary
136 Domain Controller than serving Windows NT logon requests.
138 A useful version of a Primary Domain Controller contains
139 many remote procedure calls to do things like enumerate users, 
140 groups, and security information, 98% of which Samba TNG currently
141 implements.  
143 This work is being done in the CVS (developer) versions of Samba,
144 development of which continues at a fast pace.  If you are
145 interested in participating in or helping with this development
146 please join the Samba-NTDOM mailing list.  Details on joining
147 are available at :
149 http://samba.org/listproc/
151 Details on obtaining CVS (developer) versions of Samba
152 are available at:
154 http://samba.org/cvs.html
156 For this version, use a tag of SAMBA_TNG
159 =====================================================================
161 NOTE - Known Bugs
162 -----------------
164 It is *not* recommended that this version of Samba be run in a
165 production environment, for at least the following reasons:
167 1) The new MSRPC architecture forks() one MSRPC daemon per incoming
168 service request.  The msrpc daemon stays around for as long as
169 the remote server maintains a connection to it.  An investigation
170 is underway to attempt to minimise the number of outstanding
171 connections, because a *single* NT user logon can result in up to
172 5 or 6 msrpc daemons waiting around, doing nothing but take up
173 process table space.
175 Connection reuse has now been added and debugged: the number of
176 incoming connections is reduced but still fairly large.
179 =====================================================================
181 If you have problems, or think you have found a bug please email 
182 a full, detailed report to:
184         samba-technical@samba.org
186 As always, all bugs are our responsibility.
188 Regards,
190         The Samba Team.