libsmbconf: Document smbconf_delete_parameter().
[Samba.git] / WHATSNEW.txt
blob7046e8d63da3e64044a8046a9bba45c11cf2d20e
1                    =================================
2                    Release Notes for Samba 3.6.0pre3
3                             April 26, 2011
4                    =================================
7 This is the third preview release of Samba 3.6.0.  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/.
13 Major enhancements in Samba 3.6.0 include:
16 Changed security defaults
17 -------------------------
19 Samba 3.6 has adopted a number of improved security defaults that will
20 impact on existing users of Samba.
22  client ntlmv2 auth = yes
23  client use spnego principal = no
24  send spnego principal = no
26 The impact of 'client ntlmv2 auth = yes' is that by default we will not
27 use NTLM authentication as a client.  This applies to the Samba client
28 tools such as smbclient and winbind, but does not change the separately
29 released in-kernel CIFS client.  To re-enable the poorer NTLM encryption
30 set '--option=clientusentlmv2auth=no' on your smbclient command line, or
31 set 'client ntlmv2 auth = no' in your smb.conf
33 The impact of 'client use spnego principal = no' is that we may be able
34 to use Kerberos to communicate with a server less often in smbclient,
35 winbind and other Samba client tools.  We may fall back to NTLMSSP in
36 more situations where we would previously rely on the insecure
37 indication from the 'NegProt' CIFS packet.  This mostly occursed when
38 connecting to a name alias not recorded as a servicePrincipalName for
39 the server.  This indication is not available from Windows 2008 or later
40 in any case, and is not used by modern Windows clients, so this makes
41 Samba's behaviour consistent with other clients and against all servers.
43 The impact of 'send spnego principal = no' is to match Windows 2008 and
44 not to send this principal, making existing clients give more consistent
45 behaviour (more likely to fall back to NTLMSSP) between Samba and
46 Windows 2008, and between Windows versions that did and no longer use
47 this insecure hint.
50 SMB2 support
51 ------------
53 SMB2 support in 3.6.0 is fully functional (with one omission),
54 and can be enabled by setting:
56 max protocol = SMB2
58 in the [global] section of your smb.conf and re-starting
59 Samba. All features should work over SMB2 except the modification
60 of user quotas using the Windows quota management tools.
62 As this is the first release containing what we consider
63 to be a fully featured SMB2 protocol, we are not enabling
64 this by default, but encourage users to enable SMB2 and
65 test it. Once we have enough confirmation from Samba
66 users and OEMs that SMB2 support is stable in wide user
67 testing we will enable SMB2 by default in a future Samba
68 release.
71 Internal Winbind passdb changes
72 -------------------------------
74 Winbind has been changed to use the internal samr and lsa rpc pipe to get
75 local user and group information instead of calling passdb functions. The
76 reason is to use more of our infrastructure and test this infrastructure by
77 using it. With this approach more code in Winbind is shared.
80 New Spoolss code
81 ----------------
83 The spoolss and the old RAP printing code have been completely
84 overhauled and refactored.
86 All calls from lanman/printing code has been changed to go through the
87 spoolss RPC interfaces, this allows us to keep all checks in one place
88 and avoid special cases in the main printing code.
89 Printing code has been therefore confined within the spoolss code.
91 All the printing code, including the spoolss RPC interfaces has been
92 changed to use the winreg RPC interfaces to store all data.
93 All data has been migrated from custom, arbitrary TDB files to the
94 registry interface. This transition allow us to present correct data to
95 windows client accessing the server registry through the winreg RPC
96 interfaces to query for printer data. Data is served out from a real
97 registry implementation and therefore arguably 100% forward compatible.
99 Migration code from the previous TDB files formats is provided. This
100 code is automatically invoked the first time the new code is run on the
101 server. Although manual migration is also available using the 'net
102 printer migrate' command.
104 These changes not only make all the spoolss code much more closer to
105 "the spec", it also greatly improves our internal testing of both
106 spoolss and winreg interfaces, and reduces overall code duplication.
108 As part of this work, new tests have been also added to increase
109 coverage.
111 This code will also allow, in future, an easy transition to split out
112 the spooling functions into a separate daemon for those OEMs that do not
113 need printing functionality in their appliances, reducing the code
114 footprint.
117 ID Mapping Changes
118 ------------------
120 The id mapping configuration has been a source of much grief in the past.
121 For this release, id mapping has been rewritten yet again with the goal
122 of making the configuration more simple and more coherent while keeping
123 the needed flexibility and even adding to the flexibility in some respects.
125 The major change that implies the configuration simplifications is at
126 the heart of the id mapping system: The separation of the "idmap alloc
127 system" that is responsible for the unix id counters in the tdb, tdb2
128 and ldap idmap backends from the id mapping code itself has been removed.
129 The sids_to_unixids operation is now atomic and encapsulates (if needed)
130 the action of allocating a unix id for a mapping that is to be created.
131 Consequently all idmap alloc configuration parameters have vanished and
132 it is hence now also not possible any more to specify an idmap alloc
133 backend different from the idmap backend. Each idmap backend uses its
134 own idmap unixid creation mechanism transparently.
136 As a consequence of the id mapping changes, the methods that are used
137 for storing and deleting id mappings have been removed from the winbindd
138 API. The "net idmap dump/restore" commands have been rewritten to
139 not speak through winbindd any more but directly act on the databases.
140 This is currently available for the tdb and tdb2 backends, the implementation
141 for ldap still missing.
143 The allocate_id functionality is preserved for the unix id creator of the
144 default idmap configuration is also used as the source of unix ids
145 for the group mapping database and for the posix attributes in a
146 ldapsam:editposix setup.
148 As part of the changes, the default idmap configuration has been
149 changed to be more coherent with the per-domain configuration.
150 The parameters "idmap uid", "idmap gid" and "idmap range" are now
151 deprecated in favour of the systematic "idmap config * : range"
152 and "idmap config * : backend" parameters. The reason for this change
153 is that the old options only provided an incomplete and hence deceiving
154 backwards compatibility, which was a source of many problems with
155 upgrades. By introducing this change in configuration, it should be
156 brought to the conciousness of the users that even the simple
157 id mapping is not working exactly as in Samba 3.0 versions any more.
160 Endpoint Mapper
161 ---------------
163 As Microsoft is more and more relying on endpoint mapper and we didn't have a
164 complete implementation we decided to create an instance for Samba. The
165 endpoint mapper is like a DNS server but for ports. If you want to talk to a
166 certain RPC service over TCP/IP, you just ask the endpoint mapper on which
167 port it is running. Then you can connect to the service and make sure that it
168 is running.
169 The code is deactivated by default, because it needs more testing and it
170 doesn't scale yet. We will work on these limitations and hopefully release it
171 with pre3. If you want to enable and test the endpoint mapper you can set
172 "rpc_server:epmapper = daemon" in the smb.conf file.
175 Internal restructuring
176 ----------------------
178 Ongoing internal restructuring for better separation of internal subsystem to
179 achieve a faster build, smaller binaries and cleaner dependencies for the samba3
180 waf build.
183 SMB Traffic Analyzer
184 --------------------
186 Added the new SMB Traffic Analyzer (SMBTA) VFS module protocol 2
187 featuring encryption, multiple arguments, and easier parseability. A new
188 tool 'smbta-util' has been created to control the encryption behaviour
189 of SMBTA. For compatibility, SMBTA by default operates on version 1.
190 There are programs consuming the data that the module sends.
192 More information can be found on
193 http://holger123.wordpress.com/smb-traffic-analyzer/
196 NFS quota backend on Linux
197 --------------------------
199 A new nfs quota backend for Linux has been added that is based
200 on the existing Solaris/FreeBSD implementation. This allows samba
201 to communicate correct diskfree information for nfs imports that
202 are re-exported as samba shares.
205 ######################################################################
206 Changes
207 #######
209 smb.conf changes
210 ----------------
212    Parameter Name                      Description     Default
213    --------------                      -----------     -------
215    async smb echo handler              New             No
216    client ntlmv2 auth                  Changed Default Yes
217    client use spnego principal         New             No
218    ctdb locktime warn threshold        New             0
219    idmap alloc backend                 Removed
220    log writeable files on exit         New             No
221    multicast dns register              New             Yes
222    ncalrpc dir                         New
223    send spnego principal               New             No
224    smb2 max credits                    New             128
225    smb2 max read                       New             1048576
226    smb2 max trans                      New             1048576
227    smb2 max write                      New             1048576
228    username map cache time             New             0
229    winbind max clients                 New             200
231    The variable substitutions for %i and %I no longer
232    use IPv4 addresses mapped to IPv6, e.g. '::ffff:192.168.0.1',
233    if the host has IPv6 enabled. Now %i and %I contain just
234    '192.168.0.1'.
236 Commit Highlights
237 -----------------
239 o   Michael Adam <obnox@samba.org>
240     * ID Mapping changes.
243 o   Jeremy Allison <jra@samba.org>
244     * Implement SMB2 support.
247 o   Stefan Metzmacher <metze@samba.org>
248     * Implement SMB2 support.
251 o   Andreas Schneider <asn@samba.org>
252     * Add an Endpoint Mapper daemon.
255 Changes since 3.6.0pre2
256 -----------------------
258 o   Michael Adam <obnox@samba.org>
259     * Fix build of tdb2.
262 o   Jeremy Allison <jra@samba.org>
263     * BUG 8083: "inherit owner = yes" doesn't interact correctly with
264       vfs_acl_xattr or vfs_acl_tdb module.
265     * BUG 8088: rpccli_samr_chng_pswd_auth_crap segfaults if any input blobs
266       are null.
267     * Correctly detect and deny symlinks anywhere in a path (not just the last
268       component) if "follow symlinks = no".
271 o   Günther Deschner <gd@samba.org>
272     * BUG 8106: Fix the build of 'smbget' on HP NonStop.
273     * Fix timeout in rpc_pipe_open_tcp_port().
274     * Fix the build of "--with-profiling-data".
275     * Fix the AIX 5.3 build.
278 o   Sergey Korsak <skif@1plus1.net>
279     * BUG #8099: setpwent() actually does endpwent() and vice versa on FreeBSD.
282 o   Volker Lendecke <vl@samba.org>
283     * BUG 8066: Fix wrong output in 'smbget'.
284     * Fix Coverity IDs 986, 1340, 2047, 2299, 2307, 2325, 2335, 2336, 2470,
285       2471, 2478.
286     * nsswitch: Add 'wbinfo --lookup-sids'.
287     * nsswitch: Add 'wbinfo --sids-to-unix-ids'.
288     * Fix smbd with the async echo responder.
289     * Fix the build of vfs_gpfs.c.
290     * Add a 10-second timeout for the 445 or netbios connection to a DC.
291     * Many pthreadpool fixes.
294 o   Stefan Metzmacher <metze@samba.org>
295     * BUG 7383: Listen on IPv6 addresses with IPV6_ONLY.
298 o   Rusty Russell <rusty@rustcorp.com.au>
299     * Fix transaction recovery area for converted tdbs.
303 Changes since 3.6.0pre1
304 -----------------------
306 o   Michael Adam <obnox@samba.org>
307     * ID Mapping changes.
308     * Add "--option" to 'testparm'.
311 o   Jeremy Allison <jra@samba.org>
312     * BUG 7080: Quota only shown when logged as root.
313     * BUG 7863: Unlink may unlink wrong file when hardlinks are involved.
314     * BUG 7996: Sgid bit lost on folder rename.
315     * BUG 8040: Fix smbclient segfault with Cyrillic netbios names.
316     * Fix crash bug on smbd shutdown when using FOPENDIR().
317     * Ensure we don't return an incorrect access mask.
318     * Fix bug against the new Mac client.
319     * Fix leak in error path.
320     * Fix error where Windows client spoolss returns WERR_INVALID_DATA.
323 o   Christian Ambach <christian.ambach@de.ibm.com>
324     * Fix a segfault in the krb5 locator plugin.
325     * Enable sharesec for registry shares.
328 o   Andrew Bartlett <abartlet@samba.org>
329     * Fix memory leak in "security=share" and "force user".
332 o   Björn Baumbach <bb@sernet.de>
333     * BUG 7875: Fix 'nmbd --port'.
334     * BUG 7880: cmd_spoolss_deletedriver() returned without checking all
335       architectures.
338 o   Gregor Beck <gbeck@sernet.de>
339     * Add new 'net idmap check' command.
340     * Add new 'net idmap delete' command.
341     * Fix segfault on missing input file in 'net idmap restore'.
344 o   Olly Betts <olly@survex.com>
345     * Fix 'net usersidlist' not to skip every other user.
348 o   Gregor Beck <gbeck@sernet.de>
349     * Add "net idmap check", a check and repair tool for the
350       id mapping database.
352 o   Günther Deschner <gd@samba.org>
353     * BUG 7690: Retry DNS updates when connection to one nameserver has failed.
354     * BUG 7945: Let winbind try to use samlogon validation level 6.
355     * Fix Coverity ID 2041.
356     * Fix potential crash bug in spoolss_PrinterEnumValues push path.
357     * Internal restructuring.
358     * Don't wipe out all printer drivers when only one should be deleted.
359     * Fix winbindd_dual_pam_auth_samlogon() for NT4 domains.
362 o   David Disseldorp <ddiss@suse.de>
363     * BUG 7915: Fix cups pcap reload with no printers.
364     * BUG 8040: Fix smbclient segfault with Cyrillic netbios names.
365     * Fix memory leak in print_cups.c.
366     * Remove duplicate cups response processing code.
367     * Follow force user/group for driver IO.
368     * Initiate pcap reload from parent smbd.
369     * Reload shares after pcap cache fill.
372 o   Björn Jacke <bj@sernet.de>
373     * BUG 8033: Add explicit configure option whether or not to enable dmapi
374       support.
377 o   Volker Lendecke <vl@samba.org>
378     * BUG 7917: Fix bug in chain_reply.
379     * BUG 7940: Fall back for utimes calls.
380     * BUG 8009: Fix getting username in 'net rap session'.
381     * BUG 8010: Use jenkins hash for str_checksum.
382     * BUG 8042: Fix file creation on OS/X.
383     * Fix numerous Coverity IDs.
384     * Fix a memory leak in check_sam_security_info3.
385     * Fix a segfault in the nss wrapper when libnss_winbind.so is not loadable.
386     * Make "net sam list [users|workstations]" list only the right things.
387     * Fix a potential memleak in secrets_fetch_trusted_domain_password.
388     * Use the right credentials in check_netlogond_security.
389     * Add support for AF_NETLINK addr notifications.
390     * Fork multiple Winbind children per domain.
391     * Fix a deadlock between smbd and ctdbd.
392     * Add 'wbinfo --dc-info'.
393     * Make "nmbd socket dir" configurable.
394     * Fix a valgrind error.
395     * Fix a memleak in receive_getdc_response.
398 o   Nikolay Martynov <mar.kolya@gmail.com>
399     * BUG 8010: Fix inode generation so nautilus can count total dir size
400       correctly.
403 o   Stefan Metzmacher <metze@samba.org>
404     * BUG 7567: Fix printing from Windows 7.
405     * BUG 7899: Don't return "-1" on success in 'net rpc vampire keytab'.
406     * BUG 7944: Catch lookup_names/sids schannel errors over ncacn_ip_tcp.
407     * Don't grant SEC_STD_DELETE always to the owner of a file.
408     * Fix segfaults on addrchange errors in Winbind.
409     * Allow machine accounts as members in groupdb.
412 o   Jonathan Nieder <jrnieder@gmail.com>
413     * BUG 6837: Make "rlimit_max below minimum Windows limit" notification less
414       scary.
417 o   Andreas Schneider <asn@samba.org>
418     * Add an Endpoint Mapper daemon.
419     * Add IPv6 support for the endpoint mapper.
420     * Free unused memory in the rpc server.
421     * Fix possible segfaults in svcctl server.
422     * Fix possible segfault with client_id in rpc server.
423     * Add a 'svcctl shutdown' function to rpc server.
424     * Fix a resource leak in net_afs.
425     * Fix a resource leak in smbta-util.
426     * Fix possible resource leak in net_usershare.
427     * Fix possible resource leak in 'smbget'.
428     * Fix possible resource leak in 'smbfilter'.
429     * Fix a possible null pointer dereference in smbd.
432 o   Pavel Shilovsky <piastry@etersoft.ru>
433     * BUG 7928: Fix problems with "kernel oplocks" option set to "no".
434     * Ensure we send the direct levelII oplock break to the correct fid.
437 o   Simo Sorce <idra@samba.org>
438     * Fix private libdir and codepages paths.
441 o   Andrew Tridgell <tridge@samba.org>
442     * Fix a valgrind error.
445 ######################################################################
446 Reporting bugs & Development Discussion
447 #######################################
449 Please discuss this release on the samba-technical mailing list or by
450 joining the #samba-technical IRC channel on irc.freenode.net.
452 If you do report problems then please try to send high quality
453 feedback. If you don't provide vital information to help us track down
454 the problem then you will probably be ignored.  All bug reports should
455 be filed under the Samba 3.6 product in the project's Bugzilla
456 database (https://bugzilla.samba.org/).
459 ======================================================================
460 == Our Code, Our Bugs, Our Responsibility.
461 == The Samba Team
462 ======================================================================