WHATSNEW: Add some WHATSNEW improvements.
[samba.git] / WHATSNEW.txt
1                    =================================
2                    Release Notes for Samba 3.4.0pre1
3                             April 30, 2009
4                    =================================
5
6
7 This is the first preview release of Samba 3.4.  This is *not*
8 intended for production environments and is designed for testing
9 purposes only.  Please report any defects via the Samba bug reporting
10 system at https://bugzilla.samba.org/.
11
12
13 Major enhancements in Samba 3.4.0 include:
14 ------------------------------------------
15
16 General changes:
17 o Samba4 and Samba3 sources are included in the tarball
18
19 Authentication Changes:
20 o Changed the way smbd handles untrusted domain names given during user
21   authentication.
22
23 Printing Changes:
24 o Various fixes including printer change notificiation for Samba spoolss
25   print servers.
26
27 Internal changes:
28 o The remaining hand-marshalled DCE/RPC services (ntsvcs, svcctl, eventlog
29   and spoolss) were replaced by autogenerated code based on PIDL.
30 o Samba3 and Samba4 do now share a common tevent library.
31 o The code has been cleaned up and the major basic interfaces are shared with
32   Samba4 now.
33 o An asynchronous API has been added.
34
35
36 General Changes
37 ===============
38
39 On the way towards a standalone Samba AD domain controller, Samba3 and Samba4
40 branches can be built as "merged" build. That's why Samba3 and Samba4 sources
41 are included in the tarball. The merged build is possible in Samba 3.4.0, but
42 disabled by default. To learn more about the merged build,
43 please see http://wiki.samba.org/index.php/Franky.
44
45 According to this one, there is no "source" directory included in the tarball at
46 all. Samba3 sources are located in "source3", Samba4 sources are located in
47 "source4". The libraries have been moved to the toplevel directory.
48
49 To build plain Samba3, please change to "source3" and start the build as usual.
50 To build Samba4 as well, please use the "--enable-merged-build" configure
51 option.
52
53
54 Authentication Changes
55 ======================
56
57 Previously, when Samba was a domain member and a client was connecting using an
58 untrusted domain name, such as BOGUS\user smbd would remap the untrusted
59 domain to the primary domain smbd was a member of and attempt authentication
60 using that DOMAIN\user name.  This differed from how a Windows member server
61 would behave.  Now, smbd will replace the BOGUS name with it's SAM name.  In
62 the case where smbd is acting as a PDC this will be DOMAIN\user.  In the case
63 where smbd is acting as a domain member server this will be WORKSTATION\user.
64 Thus, smbd will never assume that an incoming user name which is not qualified
65 with the same primary domain, is part of smbd's primary domain.
66
67 While this behavior matches Windows, it may break some workflows which depended
68 on smbd to always pass through bogus names to the DC for verification.  A new
69 parameter "map untrusted to domain" can be enabled to revert to the legacy
70 behavior.
71
72
73 Printing Changes
74 ================
75
76 The spoolss subsystem was replaced by autogenerated code based on PIDL. That fixes
77 several printing issues including printer change notificiation on Samba print
78 servers and will stabilize the printing functionality generally.
79 The support for spoolss printing with Windows Vista has been improved.
80
81
82 Internal Changes
83 ================
84
85 The remaining hand-marshalled DCE/RPC services (ntsvcs, svcctl, eventlog and
86 spoolss) were replaced by autogenerated code based on PIDL.
87 So Günther Deschner finally corrected one of the biggest mistakes in the
88 development of Samba: Hand-marshalled RPC stubs.
89
90 Thanks a lot! :-)
91
92 Samba3 and Samba4 do now share a common tevent library for fd and timer events.
93
94 The code has been cleaned up and Samba3 and Samba4 do share the major basic
95 interfaces now. That is why the libraries were moved to the toplevel directory.
96 That is one of the first steps to share code and minimize the gap between
97 these two versions.
98
99 An asynchronous API has been added.
100
101
102 ######################################################################
103 Changes
104 #######
105
106 smb.conf changes
107 ----------------
108
109    Parameter Name                      Description     Default
110    --------------                      -----------     -------
111
112    access based share enum             New             No
113    dedicated keytab file               New             ""
114    kerberos method                     New             default
115    map untrusted to domain             New             No
116    max open files                      Changed Default auto detected
117    perfcount module                    New             ""
118    use kerberos keytab                 Removed
119
120
121 New [sub]commands
122 -----------------
123
124    net eventlog         Tool to import/dump/export native win32 eventlog files.
125
126
127 New configure options
128 ---------------------
129
130 --enable-external-libtalloc     Enable external talloc
131 --enable-merged-build           Build Samba 4 as well
132 --enable-gnutls                 Turn on gnutls support
133 --with-statedir=DIR             Where to put persistent state files
134 --with-cachedir=DIR             Where to put temporary cache files
135 --with-ncalprcdir=DIR           Where to put ncalrpc sockets
136 --with-selftest-shrdir=DIR      The share directory that make test will be run
137                                 against
138 --with-selftest-custom-conf=PATH
139                                 An optional custom smb.conf that is included in
140                                 the server smb.conf during make test
141 --with-wbclient                 Use external wbclient
142 --with-included-popt            Use bundled popt library, not from system
143 --with-libiconv=BASEDIR         Use libiconv in BASEDIR/lib and BASEDIR/include
144 --with-sqlite3                  SQLITE3 backend support
145 --with-pthreads                 Include pthreads
146 --with-setproctitle             Search for setproctitle support
147
148
149 Commit Highlights
150 =================
151
152
153 o   Steven Danneman <steven.danneman@isilon.com>
154     * Change the way smbd handles untrusted domain names given during user
155       authentication.
156
157
158 o   Guenther Deschner <gd@samba.org>
159     * Replace the hand-marshalled DCE/RPC services ntsvcs, svcctl, eventlog
160       and spoolss by autogenerated code based on PIDL.
161     * Fix several printing issues and improve support for printer change
162       notificiations.
163     * Add 'net eventlog'.
164
165
166 o   Volker Lendecke <vl@samba.org>
167     * Add asynchronous API.
168
169
170 o   Stefan Metzmacher <metze@samba.org>
171     * Make Samba3 and Samba4 share a tevent library.
172
173
174 o   Dan Sledz <dsledz@isilon.com>
175     * Add two new parameters to control how we verify kerberos tickets.
176
177
178 o   Jelmer Vernooij <jelmer@samba.org>
179     * Make merged build possible.
180     * Move common libraries to the shared lib/ directory.
181
182
183 ######################################################################
184 Reporting bugs & Development Discussion
185 #######################################
186
187 Please discuss this release on the samba-technical mailing list or by
188 joining the #samba-technical IRC channel on irc.freenode.net.
189
190 If you do report problems then please try to send high quality
191 feedback. If you don't provide vital information to help us track down
192 the problem then you will probably be ignored.  All bug reports should
193 be filed under the Samba 3.4 product in the project's Bugzilla
194 database (https://bugzilla.samba.org/).
195
196
197 ======================================================================
198 == Our Code, Our Bugs, Our Responsibility.
199 == The Samba Team
200 ======================================================================
201