WHATSNEW.txt

   1                    ==============================
   2                    Release Notes for Samba 3.2.0
   3                             July 1, 2008
   4                    ==============================
   5
   6 This is the first stable release of Samba 3.2.0.
   7
   8 Please be aware that Samba is now distributed under the version 3
   9 of the new GNU General Public License.  You may refer to the COPYING
  10 file that accompanies these release notes for further licensing details.
  11
  12 Major enhancements in Samba 3.2.0 include:
  13
  14   File Serving:
  15   o Use of IDL generated parsing layer for several DCE/RPC
  16     interfaces.
  17   o Removal of the 1024 byte limit on pathnames and 256 byte limit on
  18     filename components to honor the MAX_PATH setting from the host OS.
  19   o Introduction of a registry based configuration system.
  20   o Improved CIFS Unix Extensions support.
  21   o Experimental support for file serving clusters.
  22   o Support for IPv6 in the server, and client tools and libraries.
  23   o Support for storing alternate data streams in xattrs.
  24   o Encrypted SMB transport in client tools and libraries, and server.
  25   o Support for Vista clients authenticating via Kerberos.
  26
  27   Winbind and Active Directory Integration:
  28   o Full support for Windows 2003 cross-forest, transitive trusts
  29     and one-way domain trusts.
  30   o Support for userPrincipalName logons via pam_winbind and NSS
  31     lookups.
  32   o Expansion of nested domain groups via NSS calls.
  33   o Support for Active Directory LDAP Signing policy.
  34   o New LGPL Winbind client library (libwbclient.so).
  35   o Support for establishing interdomain trust relationships with
  36     Windows 2008.
  37
  38   Joining:
  39   o New NetApi library for domain join related queries (libnetapi.so)
  40     and example GTK+ Domain join gui.
  41   o New client and server support for remotely joining and unjoining
  42     Domains.
  43   o Support for joining into Windows 2008 domains.
  44
  45   Users & Groups:
  46   o New ldb backend for local group mapping tables
  47   o Raised level of security defaults for authentication operations.
  48   o New NetApi library for user account related queries.
  49
  50
  51
  52 Now Licensed under the GNU GPLv3
  53 ================================
  54
  55 The Samba Team has adopted the Version 3 of the GNU General Public
  56 License for the 3.2 and later releases.   The GPLv3 is the updated
  57 version of the GPLv2 license under which Samba is currently
  58 distributed. It has been updated to improve compatibility with other
  59 licenses and to make it easier to adopt internationally, and is an
  60 improved version of the license to better suit the needs of Free
  61 Software in the 21st Century.
  62
  63 The original announcement is available on-line at
  64
  65     http://news.samba.org/announcements/samba_gplv3/
  66
  67
  68 New Security Defaults for Authentication
  69 ========================================
  70
  71 Support for LanMan passwords is now disabled in both client and server
  72 applications.  Additionally, clear text authentication requests are
  73 disabled by default in client utilities such as smbclient and all
  74 libsmbclient based applications.  This will affect connection both
  75 to and from hosts running DOS, Windows 9x/ME, and OS/2.  Please refer
  76 to the "Changes" section for details on the exact parameters that were
  77 updated.
  78
  79
  80 Registry Configuration Backend
  81 ==============================
  82
  83 Samba is now able to use a registry based configuration backed to
  84 supplement smb.conf settings.  This feature may be enabled by setting
  85 "config backend = registry" in the [global] section of smb.conf for a
  86 registry only configuration, or by specifying "include = registry" to
  87 include global options from registry for a mixed setup.
  88
  89 The new parameter "registry shares = yes" in the [global] section of
  90 smb.conf can be used to activate share definitions from registry.
  91 These shares are loaded on demand by the server. Registry shares are
  92 automatically activated by the global registry options above.
  93
  94 The configuration stored in registry can be conveniently managed using
  95 the "net conf" command.
  96
  97 More information may be obtained from the smb.conf(5) and net(8) man
  98 pages.
  99
 100
 101 Removed Features
 102 ================
 103
 104 Both the Python bindings and the libmsrpc shared library have been
 105 removed from the tree due to lack of an official maintainer.
 106
 107 As smbfs is no longer supported in current kernel versions, smbmount has
 108 been removed in this Samba version. Please use cifs (mount.cifs) instead.
 109 See examples/scripts/mount/mount.smbfs as an example for a wrapper which
 110 calls mount.cifs instead of smbmount/mount.smbfs.
 111
 112
 113 Modified API for libsmbclient
 114 ==============================================================================
 115
 116 Maintaining ABI compatibility for libsmbclient has become increasingly
 117 difficult to accomplish, while also keeping the code organization such that it
 118 is easily readable.  Towards the goal of maintaining ABI compatibility and
 119 also keeping the code easy to maintain and enhance, the API has been enhanced.
 120 In particular, the fields in the SMBCCTX context structure are no longer
 121 intended to be read/write by the user, and are marked as deprecated.  An
 122 application that previously accessed the members of the SMBCCTX context
 123 structure will now encounter warnings 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 to eliminate "deprecated" warnings:
 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     administrative share                New             No
 181     client lanman auth                  Changed Default No
 182     client ldap sasl wrapping           New             plain
 183     client plaintext auth               Changed Default No
 184     clustering                          New             No
 185     cluster addresses                   New             ""
 186     config backend                      New             file
 187     ctdbd socket                        New             ""
 188     debug class                         New             No
 189     lanman auth                         Changed Default No
 190     ldap connection timeout             New             2
 191     ldap debug level                    New             0
 192     ldap debug threshold                New             10
 193     mangled map                         Removed
 194     min receive file size               New             0
 195     open files database hashsize        Removed
 196     read bmpx                           Removed
 197     registry shares                     New             No
 198     smb encrypt                         New             Auto
 199     winbind expand groups               New             1
 200     winbind rpc only                    New             No
 201
 202     New special meaning of "include = registry".
 203
 204
 205 Changes since 3.2.0rc2:
 206 -----------------------
 207
 208
 209 o   Jeremy Allison <jra@samba.org>
 210     * BUG 5531: Fix conversion of ns units when converting
 211       from nttime to timespec.
 212     * BUG 5533: Fix handling of workgroup names containing a '.' in Winbindd.
 213     * BUG 5551: Fix group enumeration with 'wbinfo -g' on PDCs.
 214     * BUG 5555: Fix setting of the password last set field during domain joins.
 215     * BUG 5568: Fix net rpc trustdom add.
 216     * Fix gcc warnings at -O3.
 217
 218
 219 o   Michael Adam <obnox@samba.org>
 220     * BUG 5548: Fix segfaults in handle_include with %m macro expansion.
 221     * Add several tests to the testsuite.
 222
 223
 224 o   Steven Danneman <steven.danneman@isilon.com>
 225     * Make winbindd enum users and groups async.
 226
 227
 228 o   Günther Deschner <gd@samba.org>
 229     * BUG 5542: Fix empty passwords of samsync.
 230
 231
 232 o   Volker Lendecke <vl@samba.org>
 233     * BUG 5500: Add missing become_root to enable access to LDAP DB.
 234     * Fix coverity IDs 464, 474.
 235     * Fix an uninitialized variable found by the IBM checker.
 236     * Fix group parsing in libwbclient's copy_group_entry().
 237     * Fix max_fd calculation in event_loop_once.
 238     * Fix warnings on Fedory Core 9.
 239     * Fix several memleaks.
 240     * Fix a segfaults in wbcLookupRids.
 241     * Fix a segfault in clitar.
 242     * Fix the build on FreeBSD 4.6.2 and Darwin.
 243     * Fix a double-closedir() in form_junctions().
 244     * Fix a crash in _dfs_Enum.
 245     * Fix a segfault in rpcclient adddriver.
 246     * Fix valgrind errors in _spoolss_addprinterdriver.
 247     * Fix warnings on SuSE 9.0.
 248     * Fix a file descriptor leak in add_port_hook.
 249
 250
 251 o   William Jojo <jojowil@hvcc.edu>
 252     * Fix several AIX build issues.
 253     * Add -brtl to the AIX linker flags.
 254
 255
 256 o   Atte Peltomäki <atte.peltomaki@f-secure.com>
 257     * Fix winbindd group expansion.
 258
 259
 260 o   Andreas Schneider <anschneider@suse.de>
 261     * Add documentation for kerberos support in libsmbclient.
 262     * Add krb5 support for the testbrowse example.
 263
 264
 265 o   John H Terpstra <jht@samba.org>
 266     * Fix net help info.
 267     * Add documentation for TDB file.
 268
 269
 270 o   Bo Yang <boyang@novell.com>
 271     * Fix update of cached credentials during password change in pam_winbind.
 272
 273
 274 o   Christoph Zauner <christoph.zauner@sernet.de>
 275     * Fix several typos in the man pages and the Samba3 HowTo Collection.
 276
 277
 278
 279 ######################################################################
 280 Reporting bugs & Development Discussion
 281 #######################################
 282
 283 Please discuss this release on the samba-technical mailing list or by
 284 joining the #samba-technical IRC channel on irc.freenode.net.
 285
 286 If you do report problems then please try to send high quality
 287 feedback. If you don't provide vital information to help us track down
 288 the problem then you will probably be ignored.  All bug reports should
 289 be filed under the Samba 3.2 product in the project's Bugzilla
 290 database (https://bugzilla.samba.org/).
 291
 292
 293 ======================================================================
 294 == Our Code, Our Bugs, Our Responsibility.
 295 == The Samba Team
 296 ======================================================================
 297