| blob | 3721aec6f77f8ef0d18ac59cf27d80cf58b3644a |
1 =================================
2 Release Notes for Samba 3.2.0pre3
3 Mar 28, 2008
4 =================================
6 This is the third preview release of Samba 3.2.0. This is *not*
7 intended for production environments and is designed for testing
8 purposes only. Please report any defects via the Samba bug reporting
9 system at https://bugzilla.samba.org/.
11 Please be aware that Samba is now distributed under the version 3
12 of the new GNU General Public License. You may refer to the COPYING
13 file that accompanies these release notes for further licensing details.
15 Major enhancements in Samba 3.2.0 include:
17 File Serving:
18 o Use of IDL generated parsing layer for several DCE/RPC
19 interfaces.
20 o Removal of the 1024 byte limit on pathnames and 256 byte limit on
21 filename components to honor the MAX_PATH setting from the host OS.
22 o Introduction of a registry based configuration system.
23 o Improved CIFS Unix Extensions support.
24 o Experimental support for file serving clusters.
25 o Support for IPv6 in the server, and client tools and libraries.
26 o Support for storing alternate data streams in xattrs.
27 o Encrypted SMB transport in client tools and libraries, and server.
28 o Support for Vista clients authenticating via Kerberos.
30 Winbind and Active Directory Integration:
31 o Full support for Windows 2003 cross-forest, transitive trusts
32 and one-way domain trusts.
33 o Support for userPrincipalName logons via pam_winbind and NSS
34 lookups.
35 o Expansion of nested domain groups via NSS calls.
36 o Support for Active Directory LDAP Signing policy.
37 o New LGPL Winbind client library (libwbclient.so).
38 o Support for establishing interdomain trust relationships with
39 Windows 2008.
41 Joining:
42 o New NetApi library for domain join related queries (libnetapi.so)
43 and example GTK+ Domain join gui.
44 o New client and server support for remotely joining and unjoining
45 Domains.
46 o Support for joining into Windows 2008 domains.
48 Users & Groups:
49 o New ldb backend for local group mapping tables
50 o Raised level of security defaults for authentication operations.
51 o New NetApi library for user account related queries.
54 Documentation:
55 o Inclusion of an HTML version of the 3rd edition of "Using Samba"
56 from O'Reilly Publishing.
59 Now Licensed under the GNU GPLv3
60 ================================
62 The Samba Team has adopted the Version 3 of the GNU General Public
63 License for the 3.2 and later releases. The GPLv3 is the updated
64 version of the GPLv2 license under which Samba is currently
65 distributed. It has been updated to improve compatibility with other
66 licenses and to make it easier to adopt internationally, and is an
67 improved version of the license to better suit the needs of Free
68 Software in the 21st Century.
70 The original announcement is available on-line at
72 http://news.samba.org/announcements/samba_gplv3/
75 New Security Defaults for Authentication
76 ========================================
78 Support for LanMan passwords is now disabled in both client and server
79 applications. Additionally, clear text authentication requests are
80 disabled by default in client utilities such as smbclient and all
81 libsmbclient based applications. This will affect connection both
82 to and from hosts running DOS, Windows 9x/ME, and OS/2. Please refer
83 to the "Changes" section for details on the exact parameters that were
84 updated.
87 Registry Configuration Backend
88 ==============================
90 Samba is now able to use a registry based configuration backed to
91 supplement smb.conf setting. This feature may be enabled by setting
92 "config backend = registry" and "registry shares = yes" in the [global]
93 section of smb.conf and may be managed using the "net conf" command.
95 More information may be obtained from the smb.conf(5) and net(8) man
96 pages.
99 Removed Features
100 ================
102 Both the Python bindings and the libmsrpc shared library have been
103 removed from the tree due to lack of an official maintainer.
105 As smbfs is no longer supported in current kernel versions, smbmount has
106 been removed in this Samba version. Please use cifs (mount.cifs) instead.
107 See examples/scripts/mount/mount.smbfs as an example for a wrapper which
108 calls mount.cifs instead of smbmount/mount.smbfs.
111 Modified API for libsmbclient
112 ==============================================================================
114 Maintaining ABI compatibility for libsmbclient has become increasingly
115 difficult to accomplish, while also keeping the code organization such that it
116 is easily readable. Towards the goal of maintaining ABI compatibility and
117 also keeping the code easy to maintain and enhance, the API has been enhanced.
118 In particular, the fields in the SMBCCTX context structure are no longer
119 intended to be read/write by the user, and are marked as deprecated. An
120 application that previously accessed the members of the SMBCCTX context
121 structure will now encounter warnings if recompiled. This is intentional, to
122 encourage implementation of the small changes required for the new interface.
123 The number of changes is expected to be quite small for the vast majority of
124 applications, and no changes need be made for many applications. The changes
125 required for KDE (konqueror) to conform to the new interface, for example, are
126 only four lines in only one file.
128 Instead of the application manually changing or reading values in the context
129 structure, there are now setter and getter functions for each configurable
130 member in that structure. Similarly, the smbc_option_get() and
131 smbc_option_set() functions are deprecated in favor of the setter/getter
132 interface. The setters and getters are all documented in libsmbclient.h
133 under these comment blocks:
135 Getters and setters for CONFIGURATION
136 Getters and setters for OPTIONS
137 Getters and setters for FUNCTIONS
138 Callable functions for files
139 Callable functions for directories
140 Callable functions applicable to both files and directories
142 Example changes that may be required to eliminate "deprecated" warnings:
144 /* Set the debug level */
145 context->debug = 99;
146 changes to:
147 smbc_setDebug(context, 99);
149 /* Specify the authentication callback function */
150 context->callbacks.auth_fn = auth_smbc_get_data;
151 changes to:
152 smbc_setFunctionAuthData(context, auth_smbc_get_data);
154 /* Specify the new-style authentication callback with context parameter */
155 smbc_option_set("auth_function", auth_smbc_get_data_with_ctx);
156 changes to:
157 smbc_setFunctionAuthDataWithContext(context, auth_smbc_get_data_with_ctx);
159 /* Set kerberos flags */
160 context->flags = (SMB_CTX_FLAG_USE_KERBEROS |
161 SMB_CTX_FLAG_FALLBACK_AFTER_KERBEROS);
162 changes to:
163 smbc_setOptionUseKerberos(context, 1);
164 smbc_setOptionFallbackAfterKerberos(context, 1);
169 ######################################################################
170 Changes
171 #######
173 smb.conf changes
174 ----------------
176 Parameter Name Description Default
177 -------------- ----------- -------
178 client lanman auth Changed Default No
179 client ldap sasl wrapping New plain
180 client plaintext auth Changed Default No
181 clustering New No
182 cluster addresses New ""
183 config backend New file
184 ctdb socket New ""
185 debug class New No
186 administrative share New No
187 lanman auth Changed Default No
188 ldap debug level New 0
189 ldap debug threshold New 10
190 mangle map Removed
191 min receive file size New 0
192 open files database hashsize Removed
193 read bmpx Removed
194 registry shares New No
195 winbind expand groups New 1
196 winbind rpc only New No
199 Changes since 3.2.0pre2:
200 -----------------------
203 o Michael Adam <obnox@samba.org>
204 * Fix session setup with security = share.
205 * Fix segfault in testparm.
206 * Fix several Makefile issues.
207 * Fix build of bin/net on Solaris.
208 * Reformat the parm table of loadparm to use named initializers.
209 * Fix %I macro expansion for IPv4 mapped IPv6 addresses.
210 * Convert registry.tdb to use dbwrap and fix memleaks.
211 * Several make test fixes and improvements.
212 * Rename libnet_conf to libsmbconf and introduce backend abstraction layer.
213 * Add text backend to libsmbconf, based on params.c.
214 * Fix handling of includes in registry libsmbconf backend.
215 * Fix net conf import by reading from text backend.
216 * Add a "net registry" command to locally access the registry.
217 * Add testsuites for libsmbconf and "net registry".
218 * Fix Coverity IDs 517, 536, 545.
221 o Jeremy Allison <jra@samba.org>
222 * BUG 5311: Fix IPv6 issue with hosts allow/deny settings.
225 o Kai Blin <kai@samba.org>
226 * BUG 4235: Prevent ntlm_auth from sending BH responses without a message.
227 * Fix one BH message.
230 o Gerald (Jerry) Carter <jerry@samba.org>
231 * Fix libtdb some to move back towards allowing out of tree builds.
232 * Ignore port when pulling IP addr from struct sockaddr_storage..
235 o Guenther Deschner <gd@samba.org>
236 * Fix build of pam_smbpass.
237 * Fix lp_load with an empty registry and "config backend = registry".
238 * Fix build targets for bin/net.
239 * Fix _dssetup_DsRoleGetPrimaryDomainInformation().
240 * Fix the build of cifs.spnego.
241 * Migration of the SRVSVC client and server DCE/RPC code to IDL
242 based structures and autogenerated code
243 * Fix Kerberos session setup with Vista SP1 (ignore PAC type 12)
244 * Fix support for vampire of lockout policies and
245 for storing dialin/terminal server settings.
246 * Fix remote join/unjoin server implementation.
247 * BUG 5328: Fix netlogon credential chain with Windows 2008
248 (this also fixes joining Windows 2008 with rpc methods).
249 * Various fixes for establishing and validating interdomain trust
250 relationships with Windows 2008.
251 * Use IDL for storing domain controller information in dsgetdcname.
252 * Re-arranged internal structure of libnetapi.
253 * Add support for domain\dcname syntax in libnetjoin.
254 * Add support for browsing/joining OUs in netdomjoin-gui.
255 * Add various new calls to libnetapi.
258 o Volker Lendecke <vl@samba.org>
259 * Add support for async SMB requests.
260 * Add transactions to the dbwrap API.
261 * Add "net idmap aclmapset".
262 * Change default bufsize to 512k.
263 * Fix Coverity IDs 473, 481, 506, 507, 525, 526, 527, 528, 529, 530, 537,
264 538, 547, 548, 551, 552, 553, 554, 555, 557, 558, 559, 563, 564, 567.
265 * Fix some warnings in the tsmsm module.
266 * Fix warnings.
267 * BUG 4901: Fix "ldap passwd sync = only".
268 * BUG 5334: Fix download of empty files using smbclient.
269 * BUG 5307: Fix notify changes.
270 * BUG 5317: Fix debug output in domain_client_validate.
271 * BUG 5338: Fix format string issue in rpcclient.
274 o Derrell Lipman <derrell@samba.org>
275 * Check for NULL pointers before dereferencing them.
276 * Fix use of AuthDataWithContext capability.
279 o Stefan Metzmacher <metze@samba.org>
280 * Add dbwrap_tdb2 backend, useful for cluster setups.
281 * Add more functions to libwbclient:
282 - wbcGetGroups()
283 - wbcInterfaceDetails()
284 - wbcListUsers()
285 - wbcListGroups()
286 - wbcLookupUserSids()
287 - wbcSetUidMapping()
288 - wbcSetGidMapping()
289 - wbcSetUidHwm()
290 - wbcSetGidHwm()
291 * Let wbinfo use libwbclient where possible.
292 * Let net use only libwbclient to access winbindd.
293 * Make socket wrapper pcap support more portable.
294 * Some libreplace backports from v4-0-test.
295 * Store the write time in the locking.tdb,
296 so that smbd passes the BASE-DELAYWRITE test.
297 * Run RAW-SEARCH and BASE-DELAYWRITE by 'make test'.
300 o Karolin Seeger <kseeger@samba.org>
301 * Fix usage message for "net idmap dump".
304 o Andrew Tridgell <tridge@samba.org>
305 * Suppress superfluous message.
308 o Marc VanHeyningen <marc.vanheyningen@isilon.com>
309 * Coverity fixes.
312 Changes since 3.2.0pre1:
313 -----------------------
315 o Michael Adam <obnox@samba.org>
316 * Add library for access to the registry configuration data.
317 * BUG 5023: Separate NFS4 and POSIX ACL code in file access checks.
318 * BUG 4308: Fix Excel save operation ACL bug.
319 * Refactor and consolidate logic for retrieving the machine
320 trust password information.
321 * VFS API cleanup (remove redundant parameter).
322 * BUG 4801: Correctly implement LSA lookup levels for LookupNames.
323 * Add new option "debug class" to control printing of the debug class.
324 in debug headers.
325 * Enable building of the zfsacl and notify_fam vfs modules.
326 * BUG 5083: Fix memleak in solarisacl module.
327 * BUG 5063: Fix build on RHEL5.
328 * New smb.conf parameter "config backend = registry" to enable registry
329 only configuration.
330 * Move "net conf" functionality into a separate module libnet_conf.c
331 * Restructure registry code, eliminating the dynamic overlay.
332 Make use of reg_api instead of backend code in most places.
333 * Add support for intercepting LDAP libraries' debug output and print
334 it in Samba's debugging system.
335 * Libreplace fixes.
336 * Build fixes.
337 * Initial support for using subsystems as shared libraries.
338 Use talloc, tdb, and libnetapi as shared libraries internally.
341 o Jeremy Allison <jra@samba.org>
342 * Added support for IPv6 client and server connections.
343 * Add in the recvfile entry to the VFS layer.
344 * Removal of pstring data type.
345 * Remove unused utilities: smbctool and rpctorture.
346 * Fix service principal detection to match Windows Vista
347 (based on work from Andreas Schneider).
348 * Encrypted SMB transport in client tools and libraries, and server.
351 o Kai Blin <kai@samba.org>
352 * Added support for an SMB_CONF_PATH environment variable
353 containing the path to smb.conf.
354 * Various fixes to ntlm_auth.
355 * make test now supports more extensive SPOOLSS testing using vlp.
356 * Correctly handle mixed-case hostnames in NTLMv2 authentication.
359 o Gerald (Jerry) Carter <jerry@samba.org>
360 * Add Winbind client library.
361 * Decouple static linking between smbd and winbindd's client
362 interface.
365 o Guenther Deschner <gd@samba.org>
366 * Enhance client and server remote registry access.
367 * Add client calls for remotely joining a computer to a domain
368 (including calls from "net dom" command).
369 * Add libnetapi.so library for joining domains including
370 sample GTK+ app.
371 * Fixes for Vista SP1 Kerberos authdata handling to only pickup
372 the PAC.
373 * Various error code and error message fixes.
374 * Add initial draft of libnetconf to allow programmatic
375 configuration changes.
376 * Add libnet_join internal library for programmatically joining
377 and unjoining Domains.
378 * Add various fixes and new calls to libnetapi.so library.
379 * Various fixes for DsGetDcName and conversion to IDL based
380 structures.
381 * Fixes for pidl to correctly generate WERROR based client calls.
382 * Fixes for pidl to generate output that complies to coding
383 conventions.
384 * Various IDL fixes.
385 * Add ads_get_joinable_ous() to libads to get list of joinable ous.
386 * Add get_logon_hours_from_pdb() to comply with new IDL based
387 structures.
388 * Add debugging capabilities to dump AD connections to libads
389 (using ndr_print).
390 * Add "dump-domain-list" command for smbcontrol to retrieve better
391 debugging information out of winbindd.
392 * Migration of the entire client and server DCE/RPC code to IDL
393 based structures and autogenerated code for DSSETUP, LSA, SAMR
394 and NETLOGON.
395 * Started migration of client and server DCE/RPC code to IDL based
396 structures and autogenerated code for NTSSVC, SVCCTL and
397 EVENTLOG.
398 * Use IDL and autogenerated code for samlogoncache and Kerberos
399 PAC handling.
400 * Various fixes and cleanup of Kerberos PAC handling.
401 * Fix segfault in _srv_net_file_enum.
402 * Conversion of client join and unjoin code to libnet_join.
403 * Add remote join/unjoin server-side implementation.
404 * Removed a lot of code which has become obsolete.
407 o Steve Langasek <vorlon@debian.org>
408 * Integrate 2 out of 3 --with-fhs patches from Debian packaging
409 for better adherence to the FHS standard.
412 o Volker Lendecke <vl@samba.org>
413 * Add talloc_stackframe() and talloc_pool() features.
414 * Removal of pstring data type.
415 * Add generic a in-memory cache.
416 * Import the Linux red-black tree implementation.
417 * Remove large amount of global variables.
418 * Support for storing xattrs in tdb files.
419 * Support for storing alternate data streams in xattrs.
420 * Implement a generic in-memory cache based on rb-trees.
421 * Add implicit temporary talloc contexts via talloc_stack().
422 * Speed up the smbclient "get" command
423 * Add the aio_fork module
424 * Fix bug 4901
426 o Derrell Lipman <derrell@samba.org>
427 * Modified libsmbclient API for more easily maintaining ABI compatibility
428 while adding new features to libsmbclient.
430 o Stefan Metzmacher <metze@samba.org>
431 * Refactor Winbind internal parent-child interface tables
432 to achieve better unit testing support.
433 * Add nss_wrapper API for local Winbind unit tests.
434 * Networking fixes to the libreplace library.
435 * Pidl fixes.
436 * Remove unused Winbind pipe calls.
437 * Build fixes.
438 * Fix for a crash bug in pidl generated client code.
439 This could have happend with [in,out,unique] pointers
440 when the client sends a valid pointer, but the server
441 responds with a NULL pointer (as samba-3.0.26a does for some calls).
442 * Change NTSTATUS into enum ndr_err_code in librpc/ndr.
443 * Remove unused calls in the struct based winbindd protocol.
444 * Add --configfile option to wbinfo.
445 * Convert winbind_env_set(), winbind_on() and winbind_off() into macros.
446 * Return rids and other_sids arrays in WBFLAG_PAM_INFO3_TEXT mode.
447 * Implement wbcErrorString() and wbcAuthenticateUserEx().
448 * Convert auth_winbind to use wbcAuthenticateUserEx().
451 o James Peach <jpeach@samba.org>
452 * Add support for DNS Service Discovery. Based on work from
453 Rishi Srivatsavai <rishisv@gmail.com>.
456 o Andreas Schneider <anschneider@suse.de>
457 * Don't restart winbind if a corrupted tdb is found during
458 initialization.
459 * Fix Windows 2008 (Longhorn) join.
460 * Fix crashbug in winbindd.
461 * Add share parameter "administrative share".
464 o Karolin Seeger <ks@sernet.de>
465 * Improve error messages of net subcommands.
466 * Add 'net rap file user'.
467 * Change LDAP search filter to find machine accounts which
468 are not located in the user suffix.
469 * Remove smbmount.
472 o David Shaw <dshaw@jabberwocky.com>
473 * BUG 5073: Allow "delete readonly = yes" to correctly override
474 deletion of a file.
477 o Rishi Srivatsavai <rishisv@gmail.com>
478 * Register the smb service with mDNS if mDNS is supported.
479 * Add smbclient support for basic mDNS browsing.
482 o Andrew Tridgell <tridge@samba.org>
483 * Fix padding between Winbind 32bit/64bit client library in
484 the request/response structures.
485 * Added a syncops VFS module for file systems which do not
486 guarantee meta-data operations are immediately committed to
487 disk in stable form.
490 o Jelmer Vernooij <jelmer@samba.org>
491 * Additional portability support for building shared libraries.
494 o Corinna Vinschen <corinna@vinschen.de>
495 * Get Samba version or capability information from Windows user space.
498 Original 3.2.0pre1 commits:
499 ---------------------------
500 o Michael Adam <obnox@samba.org>
501 * Unified POSIX ACL detection including support for FreeBSD and
502 HP-UX.
503 * Performance improvements for Winbind's lookup functions (names,
504 SIDs, and group membership) when joined to an AD domain.
505 * Winbind cache validation support.
506 * Store domain trust passwords for Samba domain controller's in
507 the domain's passdb backend.
508 * Merged \winreg server code from the SAMBA_3_2 development branch.
509 * Fixes for libreplace.
510 * Implement new registry configuration backend.
513 o Jeremy Allison <jra@samba.org>
514 * Add support for file system objectIDs.
515 * Winbind cache validation support.
516 * Add in the UNIX capability for 24-bit readX.
517 * Improve Delete-on-Close semantics.
518 * Removal of static file and path name buffers in SMB file serving
519 code.
522 o Danilo Almeida <dalmeida@centeris.com>
523 * Move the machine account to the OU specified when running "net
524 ads join".
527 o Andrew Bartlett <abartlet@samba.org>
528 * Tighten authentication protocol defaults in client tools and
529 servers.
532 o Gerald (Jerry) Carter <jerry@samba.org>
533 * Implement support for one-way trusts and two-way cross-forest
534 transitive trust in winbindd.
535 * Fixes for Winbind's offline/disconnected logon support when
536 using remote idmap backends.
537 * Fix LookupNames and LookupSids to use the same resolution
538 heuristics as Windows XP.
539 * Fix lockups in Winbind when running nscd.
540 * UPN logon support in pam_winbind.
541 * Add support for GNU linker scripts when build shared libraries
542 (based on work by Julien Cristau <jcristau@debian.org> and James
543 Peach).
546 o Guenther Deschner <gd@samba.org>
547 * Additional support for decoding and downloading group policy
548 objects from Active Directory.
549 * Improvements to "net ads keytab" command.
550 * Fixes for linking against Heimdal Kerberos client libs.
551 * Support LDAP range retrieval searches.
552 * Fixes for failure to refresh user ticket caches in Winbind.
553 * UPN logon support in pam_winbind.
554 * Add KDC locator plugin for MIT kerberos 1.6 or later.
557 o Steve Langasek <vorlon@debian.org>
558 * Allow SIGTERM to cause nmbd to exit while awaiting a interface
559 to come up.
562 o Volker Lendecke <vl@samba.org>
563 * Merge experimental cluster support patches from the ctdb branch.
564 * Add tdb storage abstraction for ctdb.
565 * Use IDL for internal message passing system.
566 * Add client support for the SamLogonEx() authentication request.
567 * Implement RPC proxy stubs in the Samba server code to allow
568 replacing implementation functions one by one.
569 * Remove static incoming and outgoing buffers from core server SMB
570 packet processing code.
571 * Add "net sam rights" command.
574 o Steve French <sfrench@samba.org>
575 * Fixes for mount.cifs Linux utility.
578 o Stefan Metzmacher <metze@samba.org>
579 * Fixes for libreplace.
580 * Add support for LDAP digital signing policy.
581 * Experimental clustered file system support.
584 o Lars Mueller <lars@samba.org>
585 * Makefile and build fixes.
586 * Add pam_pwd_expire for pam_winbind (original patch from Andreas
587 Schneider).
590 o James Peach <jpeach@apple.com>
591 * Fixes for setgroups() and *BSD and Darwin.
592 * Support membership of >16 groups on Darwin.
595 o Jiri Sasek <Jiri.Sasek@Sun.COM>
596 * Added vfs_zfsacl module.
599 o Karolin Seeger <ks@sernet.de>
600 * Add deletelocalgroup and unmapunixgroup subcommand to "net sam".
601 * Cleanup internal passdb functions.
604 o Simo Sorce <idra@samba.org>
605 * Fixes for IDmap and Passdb backends.
608 o Andrew Tridgell <tridge@samba.org>
609 * Port ldb from the Samba 4 tree and add ldb group mapping plugin.
610 * Move several file serving related tdb files to use the dbwrap
611 API internally.
612 * Cleanup the GPFS VFS plugin.
613 * Experimental clustered file system support.
616 o Jelmer Vernooij <jelmer@samba.org>
617 * Implement NDR basic to support utilizing IDL files from Samba 4
618 tree for general DCE/RPC parsing stubs.
622 ######################################################################
623 Reporting bugs & Development Discussion
624 #######################################
626 Please discuss this release on the samba-technical mailing list or by
627 joining the #samba-technical IRC channel on irc.freenode.net.
629 If you do report problems then please try to send high quality
630 feedback. If you don't provide vital information to help us track down
631 the problem then you will probably be ignored. All bug reports should
632 be filed under the Samba 3.2 product in the project's Bugzilla
633 database (https://bugzilla.samba.org/).
636 ======================================================================
637 == Our Code, Our Bugs, Our Responsibility.
638 == The Samba Team
639 ======================================================================