WHATSNEW.txt

   1                    =================================
   2                    Release Notes for Samba 3.2.0pre2
   3                                Feb 29, 2008
   4                    =================================
   5
   6 This is the second 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/.
  10
  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.
  14
  15 Major enhancements in Samba 3.2.0 include:
  16
  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.
  29
  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
  39   Joining:
  40   o New NetApi library for domain join related queries (libnetapi.so)
  41     and example GTK+ Domain join gui.
  42   o New client and server support for remotely joining and unjoining
  43     Domains.
  44   o Support for joining into Windows 2008 domains.
  45
  46   Users & Groups:
  47   o New ldb backend for local group mapping tables
  48   o Raised level of security defaults for authentication operations.
  49
  50
  51   Documentation:
  52   o Inclusion of an HTLM version of the 3rd edition of "Using Samba"
  53     from O'Reilly Publishing.
  54
  55
  56 Now Licensed under the GNU GPLv3
  57 ================================
  58
  59 The Samba Team has adopted the Version 3 of the GNU General Public
  60 License for the 3.2 and later releases.   The GPLv3 is the updated
  61 version of the GPLv2 license under which Samba is currently
  62 distributed. It has been updated to improve compatibility with other
  63 licenses and to make it easier to adopt internationally, and is an
  64 improved version of the license to better suit the needs of Free
  65 Software in the 21st Century.
  66
  67 The original announcement is available on-line at
  68
  69     http://news.samba.org/announcements/samba_gplv3/
  70
  71
  72 New Security Defaults for Authentication
  73 ========================================
  74
  75 Support for LanMan passwords is now disabled in both client and server
  76 applications.  Additionally, clear text authentication requests are
  77 disabled by default in client utilities such as smbclient and all
  78 libsmbclient based applications.  This will affect connection both
  79 to and from hosts running DOS, Windows 9x/ME, and OS/2.  Please refer
  80 to the "Changes" section for details on the exact parameters that were
  81 updated.
  82
  83
  84 Registry Configuration Backend
  85 ==============================
  86
  87 Samba is now able to use a registry based configuration backed to
  88 supplement smb.conf setting.  This feature may be enabled by setting
  89 "config backend = registry" and "registry shares = yes" in the [global]
  90 section of smb.conf and may be managed using the "net conf" command.
  91
  92 More information may be obtained from the smb.conf(5) and net(8) man
  93 pages.
  94
  95
  96 Removed Features
  97 ================
  98
  99 Both the Python bindings and the libmsrpc shared library have been
 100 removed from the tree due to lack of an official maintainer.
 101
 102 As smbfs is no longer supported in current kernel versions, smbmount has
 103 been removed in this Samba version. Please use cifs (mount.cifs) instead.
 104 See examples/scripts/mount/mount.smbfs as an example for a wrapper which
 105 calls mount.cifs instead of smbmount/mount.smbfs.
 106
 107
 108 Modified API for libsmbclient
 109 ==============================================================================
 110
 111 Maintaining ABI compatibility for libsmbclient has become increasingly
 112 difficult to accomplish, while also keeping the code organization such that it
 113 is easily readable.  Towards the goal of maintaining ABI compatibility and
 114 also keeping the code easy to maintain and enhance, the API has changed
 115 somewhat.  In particular, the fields in the SMBCCTX context structure are no
 116 longer intended to be read/write by the user.  The names of the fields have
 117 changed to encourage any recompilations to use the new interface, but for
 118 continued ABI compatibility, the fields are in the same locations in the
 119 context structure as they were previously so any previously-compiled
 120 applications should continue to work with this new version.
 121
 122 An application that previously accessed the members of the SMBCCTX context
 123 structure will encounter errors if recompiled.  This is intentional to
 124 encourage implementation of the small changes required for the new interface.
 125 The number of changes is expected to be quite small for the vast majority of
 126 applications, and no changes need be made for many applications.  The changes
 127 required for KDE (konqueror) to conform to the new interface, for example, are
 128 only four lines in only one file.
 129
 130 Instead of the application manually changing or reading values in the context
 131 structure, there are now setter and getter functions for each configurable
 132 member in that structure.  Similarly, the smbc_option_get() and
 133 smbc_option_set() functions are deprecated in favor of the setter/getter
 134 interface.  The setters and getters are all documented in libsmbclient.h
 135 under these comment blocks:
 136
 137   Getters and setters for CONFIGURATION
 138   Getters and setters for OPTIONS
 139   Getters and setters for FUNCTIONS
 140   Callable functions for files
 141   Callable functions for directories
 142   Callable functions applicable to both files and directories
 143
 144 Example changes that may be required:
 145
 146   /* Set the debug level */
 147   context->debug = 99;
 148 changes to:
 149   smbc_setDebug(context, 99);
 150
 151   /* Specify the authentication callback function */
 152   context->callbacks.auth_fn = auth_smbc_get_data;
 153 changes to:
 154   smbc_setFunctionAuthData(context, auth_smbc_get_data);
 155
 156   /* Specify the new-style authentication callback with context parameter */
 157   smbc_option_set("auth_function", auth_smbc_get_data_with_ctx);
 158 changes to:
 159   smbc_setFunctionAuthDataWithContext(context, auth_smbc_get_data_with_ctx);
 160
 161   /* Set kerberos flags */
 162   context->flags = (SMB_CTX_FLAG_USE_KERBEROS |
 163                     SMB_CTX_FLAG_FALLBACK_AFTER_KERBEROS);
 164 changes to:
 165   smbc_setOptionUseKerberos(context, 1);
 166   smbc_setOptionFallbackAfterKerberos(context, 1);
 167
 168
 169
 170
 171 ######################################################################
 172 Changes
 173 #######
 174
 175 smb.conf changes
 176 ----------------
 177
 178     Parameter Name                      Description     Default
 179     --------------                      -----------     -------
 180     client lanman auth                  Changed Default No
 181     client ldap sasl wrapping           New             plain
 182     client plaintext auth               Changed Default No
 183     clustering                          New             No
 184     cluster addresses                   New             ""
 185     config backend                      New             file
 186     ctdb socket                         New             ""
 187     debug class                         New             No
 188     administrative share                New             No
 189     lanman auth                         Changed Default No
 190     ldap debug level                    New             0
 191     ldap debug threshold                New             10
 192     mangle map                          Removed
 193     open files database hashsize        Removed
 194     read bmpx                           Removed
 195     registry shares                     New             No
 196     winbind expand groups               New             1
 197     winbind rpc only                    New             No
 198
 199
 200 Changes since 3.2.0pre1:
 201 -----------------------
 202
 203 o   Michael Adam <obnox@samba.org>
 204     * Add library for access to the registry configuration data.
 205     * BUG 5023: Separate NFS4 and POSIX ACL code in file access checks.
 206     * BUG 4308: Fix Excel save operation ACL bug.
 207     * Refactor and consolidate logic for retrieving the machine
 208       trust password information.
 209     * VFS API cleanup (remove redundant parameter).
 210     * BUG 4801: Correctly implement LSA lookup levels for LookupNames.
 211     * Add new option "debug class" to control printing of the debug class.
 212       in debug headers.
 213     * Enable building of the zfsacl and notify_fam vfs modules.
 214     * BUG 5083: Fix memleak in solarisacl module.
 215     * BUG 5063: Fix build on RHEL5.
 216     * New smb.conf parameter "config backend = registry" to enable registry
 217       only configuration.
 218     * Move "net conf" functionality into a separate module libnet_conf.c
 219     * Restructure registry code, eliminating the dynamic overlay.
 220       Make use of reg_api instead of backend code in most places.
 221     * Add support for intercepting LDAP libraries' debug output and print
 222       it in Samba's debugging system.
 223     * Libreplace fixes.
 224     * Build fixes.
 225     * Initial support for using subsystems as shared libraries.
 226       Use talloc, tdb, and libnetapi as shared libraries internally.
 227
 228
 229 o   Jeremy Allison <jra@samba.org>
 230     * Added support for IPv6 client and server connections.
 231     * Add in the recvfile entry to the VFS layer.
 232     * Removal of pstring data type.
 233     * Remove unused utilities: smbctool and rpctorture.
 234     * Fix service principal detection to match Windows Vista
 235       (based on work from Andreas Schneider).
 236     * Encrypted SMB transport in client tools and libraries, and server.
 237
 238
 239 o   Kai Blin <kai@samba.org>
 240     * Added support for an SMB_CONF_PATH environment variable
 241       containing the path to smb.conf.
 242     * Various fixes to ntlm_auth.
 243     * make test now supports more extensive SPOOLSS testing using vlp.
 244     * Correctly handle mixed-case hostnames in NTLMv2 authentication.
 245
 246
 247 o   Gerald (Jerry) Carter <jerry@samba.org>
 248     * Add Winbind client library.
 249     * Decouple static linking between smbd and winbindd's client
 250       interface.
 251
 252
 253 o   Guenther Deschner <gd@samba.org>
 254     * Enhance client and server remote registry access.
 255     * Add client calls for remotely joining a computer to a domain
 256       (including calls from "net dom" command).
 257     * Add libnetapi.so library for joining domains including
 258       sample GTK+ app.
 259     * Fixes for Vista SP1 Kerberos authdata handling to only pickup
 260       the PAC.
 261     * Various error code and error message fixes.
 262     * Add initial draft of libnetconf to allow programmatic
 263       configuration changes.
 264     * Add libnet_join internal library for programmatically joining
 265       and unjoining Domains.
 266     * Add various fixes and new calls to libnetapi.so library.
 267     * Various fixes for DsGetDcName and conversion to IDL based
 268       structures.
 269     * Fixes for pidl to correctly generate WERROR based client calls.
 270     * Fixes for pidl to generate output that complies to coding
 271       conventions.
 272     * Various IDL fixes.
 273     * Add ads_get_joinable_ous() to libads to get list of joinable ous.
 274     * Add get_logon_hours_from_pdb() to comply with new IDL based
 275       structures.
 276     * Add debugging capabilities to dump AD connections to libads
 277       (using ndr_print).
 278     * Add "dump-domain-list" command for smbcontrol to retrieve better
 279       debugging information out of winbindd.
 280     * Migration of the entire client and server DCE/RPC code to IDL
 281       based structures and autogenerated code for DSSETUP, LSA, SAMR
 282       and NETLOGON.
 283     * Started migration of client and server DCE/RPC code to IDL based
 284       structures and autogenerated code for NTSSVC, SVCCTL and
 285       EVENTLOG.
 286     * Use IDL and autogenerated code for samlogoncache and Kerberos
 287       PAC handling.
 288     * Various fixes and cleanup of Kerberos PAC handling.
 289     * Fix segfault in _srv_net_file_enum.
 290     * Conversion of client join and unjoin code to libnet_join.
 291     * Add remote join/unjoin server-side implementation.
 292     * Removed a lot of code which has become obsolete.
 293
 294
 295 o   Steve Langasek <vorlon@debian.org>
 296     * Integrate 2 out of 3 --with-fhs patches from Debian packaging
 297       for better adherence to the FHS standard.
 298
 299
 300 o  Volker Lendecke <vl@samba.org>
 301     * Add talloc_stackframe() and talloc_pool() features.
 302     * Removal of pstring data type.
 303     * Add generic a in-memory cache.
 304     * Import the Linux red-black tree implementation.
 305     * Remove large amount of global variables.
 306     * Support for storing xattrs in tdb files.
 307     * Support for storing alternate data streams in xattrs.
 308     * Implement a generic in-memory cache based on rb-trees.
 309     * Add implicit temporary talloc contexts via talloc_stack().
 310     * Speed up the smbclient "get" command
 311     * Add the aio_fork module
 312
 313 o   Derrell Lipman <derrell@samba.org>
 314     * Modified libsmbclient API for more easily maintaining ABI compatibility
 315       while adding new features to libsmbclient.
 316
 317 o   Stefan Metzmacher <metze@samba.org>
 318     * Fixes for libreplace.
 319     * Pidl fixes.
 320     * Build fixes.
 321     * Add nss_wrapper support.
 322     * Start and test winbindd by 'make test'.
 323     * Split up child_dispatch_table into domain, idmap and locator tables
 324       in winbindd.
 325     * Fix for a crash bug in pidl generated client code.
 326       This could have happend with [in,out,unique] pointers
 327       when the client sends a valid pointer, but the server
 328       responds with a NULL pointer (as samba-3.0.26a does for some calls).
 329     * Change NTSTATUS into enum ndr_err_code in librpc/ndr.
 330     * Remove unused calls in the struct based winbindd protocol.
 331     * Add --configfile option to wbinfo.
 332     * Convert winbind_env_set(), winbind_on() and winbind_off() into macros.
 333     * Return rids and other_sids arrays in WBFLAG_PAM_INFO3_TEXT mode.
 334     * Implement wbcErrorString() and wbcAuthenticateUserEx().
 335     * Convert auth_winbind to use wbcAuthenticateUserEx().
 336
 337
 338 o   James Peach <jpeach@samba.org>
 339     * Add support for DNS Service Discovery.  Based on work from
 340       Rishi Srivatsavai <rishisv@gmail.com>.
 341
 342
 343 o   Andreas Schneider <anschneider@suse.de>
 344     * Don't restart winbind if a corrupted tdb is found during
 345       initialization.
 346     * Fix Windows 2008 (Longhorn) join.
 347     * Fix crashbug in winbindd.
 348     * Add share parameter "administrative share".
 349
 350
 351 o   Karolin Seeger <ks@sernet.de>
 352     * Improve error messages of net subcommands.
 353     * Add 'net rap file user'.
 354     * Change LDAP search filter to find machine accounts which
 355       are not located in the user suffix.
 356     * Remove smbmount.
 357
 358
 359 o   David Shaw <dshaw@jabberwocky.com>
 360     * BUG 5073: Allow "delete readonly = yes" to correctly override
 361       deletion of a file.
 362
 363
 364 o   Rishi Srivatsavai <rishisv@gmail.com>
 365     * Register the smb service with mDNS if mDNS is supported.
 366     * Add smbclient support for basic mDNS browsing.
 367
 368
 369 o   Andrew Tridgell <tridge@samba.org>
 370     * Fix padding between Winbind 32bit/64bit client library in
 371       the request/response structures.
 372     * Added a syncops VFS module for file systems which do not
 373       guarantee meta-data operations are immediately committed to
 374       disk in stable form.
 375
 376
 377 o   Jelmer Vernooij <jelmer@samba.org>
 378     * Additional portability support for building shared libraries.
 379
 380
 381 o   Corinna Vinschen <corinna@vinschen.de>
 382     * Get Samba version or capability information from Windows user space.
 383
 384
 385 Original 3.2.0pre1 commits:
 386 ---------------------------
 387 o   Michael Adam <obnox@samba.org>
 388     * Unified POSIX ACL detection including support for FreeBSD and
 389       HP-UX.
 390     * Performance improvements for Winbind's lookup functions (names,
 391       SIDs, and group membership) when joined to an AD domain.
 392     * Winbind cache validation support.
 393     * Store domain trust passwords for Samba domain controller's in
 394       the domain's passdb backend.
 395     * Merged \winreg server code from the SAMBA_3_2 development branch.
 396     * Fixes for libreplace.
 397     * Implement new registry configuration backend.
 398
 399
 400 o   Jeremy Allison <jra@samba.org>
 401     * Add support for file system objectIDs.
 402     * Winbind cache validation support.
 403     * Add in the UNIX capability for 24-bit readX.
 404     * Improve Delete-on-Close semantics.
 405     * Removal of static file and path name buffers in SMB file serving
 406       code.
 407
 408
 409 o   Danilo Almeida <dalmeida@centeris.com>
 410     * Move the machine account to the OU specified when running "net
 411       ads join".
 412
 413
 414 o   Andrew Bartlett <abartlet@samba.org>
 415     * Tighten authentication protocol defaults in client tools and
 416       servers.
 417
 418
 419 o   Gerald (Jerry) Carter <jerry@samba.org>
 420     * Implement support for one-way trusts and two-way cross-forest
 421       transitive trust in winbindd.
 422     * Fixes for Winbind's offline/disconnected logon support when
 423       using remote idmap backends.
 424     * Fix LookupNames and LookupSids to use the same resolution
 425       heuristics as Windows XP.
 426     * Fix lockups in Winbind when running nscd.
 427     * UPN logon support in pam_winbind.
 428     * Add support for GNU linker scripts when build shared libraries
 429       (based on work by Julien Cristau <jcristau@debian.org> and James
 430       Peach).
 431
 432
 433 o   Guenther Deschner <gd@samba.org>
 434     * Additional support for decoding and downloading group policy
 435       objects from Active Directory.
 436     * Improvements to "net ads keytab" command.
 437     * Fixes for linking against Heimdal Kerberos client libs.
 438     * Support LDAP range retrieval searches.
 439     * Fixes for failure to refresh user ticket caches in Winbind.
 440     * UPN logon support in pam_winbind.
 441     * Add KDC locator plugin for MIT kerberos 1.6 or later.
 442
 443
 444 o   Steve Langasek <vorlon@debian.org>
 445     * Allow SIGTERM to cause nmbd to exit while awaiting a interface
 446       to come up.
 447
 448
 449 o   Volker Lendecke <vl@samba.org>
 450     * Merge experimental cluster support patches from the ctdb branch.
 451     * Add tdb storage abstraction for ctdb.
 452     * Use IDL for internal message passing system.
 453     * Add client support for the SamLogonEx() authentication request.
 454     * Implement RPC proxy stubs in the Samba server code to allow
 455       replacing implementation functions one by one.
 456     * Remove static incoming and outgoing buffers from core server SMB
 457       packet processing code.
 458     * Add "net sam rights" command.
 459
 460
 461 o   Steve French <sfrench@samba.org>
 462     * Fixes for mount.cifs Linux utility.
 463
 464
 465 o   Stefan Metzmacher <metze@samba.org>
 466     * Fixes for libreplace.
 467     * Add support for LDAP digital signing policy.
 468     * Experimental clustered file system support.
 469
 470
 471 o   Lars Mueller <lars@samba.org>
 472     * Makefile and build fixes.
 473     * Add pam_pwd_expire for pam_winbind (original patch from Andreas
 474       Schneider).
 475
 476
 477 o   James Peach <jpeach@apple.com>
 478     * Fixes for setgroups() and *BSD and Darwin.
 479     * Support membership of >16 groups on Darwin.
 480
 481
 482 o   Jiri Sasek <Jiri.Sasek@Sun.COM>
 483     * Added vfs_zfsacl module.
 484
 485
 486 o   Karolin Seeger <ks@sernet.de>
 487     * Add deletelocalgroup and unmapunixgroup subcommand to "net sam".
 488     * Cleanup internal passdb functions.
 489
 490
 491 o   Simo Sorce <idra@samba.org>
 492     * Fixes for IDmap and Passdb backends.
 493
 494
 495 o   Andrew Tridgell <tridge@samba.org>
 496     * Port ldb from the Samba 4 tree and add ldb group mapping plugin.
 497     * Move several file serving related tdb files to use the dbwrap
 498       API internally.
 499     * Cleanup the GPFS VFS plugin.
 500     * Experimental clustered file system support.
 501
 502
 503 o   Jelmer Vernooij <jelmer@samba.org>
 504     * Implement NDR basic to support utilizing IDL files from Samba 4
 505       tree for general DCE/RPC parsing stubs.
 506
 507
 508
 509 ######################################################################
 510 Reporting bugs & Development Discussion
 511 #######################################
 512
 513 Please discuss this release on the samba-technical mailing list or by
 514 joining the #samba-technical IRC channel on irc.freenode.net.
 515
 516 If you do report problems then please try to send high quality
 517 feedback. If you don't provide vital information to help us track down
 518 the problem then you will probably be ignored.  All bug reports should
 519 be filed under the Samba 3.2 product in the project's Bugzilla
 520 database (https://bugzilla.samba.org/).
 521
 522
 523 ======================================================================
 524 == Our Code, Our Bugs, Our Responsibility.
 525 == The Samba Team
 526 ======================================================================
 527