WHATSNEW.txt

   1                    =================================
   2                    Release Notes for Samba 3.3.0pre2
   3                           September 30, 2008
   4                    =================================
   5
   6 This is the second preview release of Samba 3.3.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 Major enhancements in Samba 3.3.0 include:
  12
  13  Configuration/installation:
  14  o Splitting of library directory into library directory and separate
  15    modules directory.
  16
  17  File Serving:
  18  o Extended Cluster support.
  19
  20  Winbind:
  21  o Simplified idmap configuration.
  22  o New idmap backends "adex" and "hash".
  23  o Added new parameter "winbind reconnect delay".
  24  o Added support for user and group aliasing.
  25
  26  Administrative tools:
  27  o The destination "all" of smbcontrol does now affect all running
  28    daemons including nmbd and winbindd.
  29  o New 'net rpc vampire keytab' and 'net rpc vampire ldif' commands.
  30  o The 'net' utility can now use kerberos for joining and authentication.
  31
  32  Libraries:
  33  o NetApi library implements various new calls for User- and Group
  34    Account Management.
  35
  36
  37 Configure changes
  38 =================
  39
  40 The configure option "--with-libdir" has been removed. The library
  41 directory can still be specified by using the existing "--libdir" option.
  42 A new option "--with-modulesdir" has been added to allow the specification
  43 of a separate directory for the shared modules.
  44
  45
  46 Winbind idmap backend changes
  47 =============================
  48
  49 The idmap configuration has changed with version 3.3 to something that
  50 allows a smoother upgrade path from pre-3.0.25 configurations that use
  51 "idmap backend". The reason for this change is that to many, also to Samba
  52 developers, the 3.0.25 style configuration with "idmap config" turned out
  53 to be very complex. Version 3.3 no longer deprecates the "idmap backend"
  54 parameter, instead with "idmap backend" the default idmap backend is
  55 specified.
  56
  57 Accordingly, the "idmap config <domain> : default = yes" setting is no
  58 longer being looked at.
  59
  60 The alloc backend defaults to the default backend, which should be able to
  61 allocate IDs. In the default distribution the tdb and ldap backends can
  62 allocate, the ad and rid backends can not. The idmap alloc range is now
  63 being set with the "old" parameters "idmap uid" and "idmap gid".
  64
  65 The "idmap domains" parameter has been removed.
  66
  67
  68 winbind reconnect delay
  69 =======================
  70
  71 This is a new parameter which specifies the number of seconds the Winbind
  72 daemon will wait between attempts to contact a Domain controller for a domain
  73 that is determined to be down or not contactable.
  74
  75
  76 Winbind's Name Aliasing
  77 =======================
  78
  79 Name aliasing in Winbind is a feature that allows an administrator to
  80 map a fully qualified user or group name from a Windows domain to a
  81 convenient short name for Unix access.  This is similar to the username
  82 map functionality supported by smbd but is primary intended for
  83 clients and servers making use of Winbind's PAM and NSS libraries.
  84
  85 For example, the user "DOMAIN\fred" has been mapped to the Unix name
  86 "freddie".
  87
  88    $ getent passwd "DOMAIN\fred"
  89    freddie:x:1000:1001:Fred Jones:/home/freddie:/bin/bash
  90
  91    $ getent passwd freddie
  92    freddie:x:1000:1001:Fred Jones:/home/freddie:/bin/bash
  93
  94 The name aliasing support is provided by individual nss_info plugins.
  95 For example, the new "adex" plugin reads the uid attribute from Active
  96 Directory to make a short login name to the fully qualified name.
  97 While the new "hash" module utilizes a local file to map "short_name
  98 = QUALIFIED\name".  Both user and group name mapping is supported.
  99 Please refer to the "winbind nss info" option in smb.conf(5) and
 100 to individual plugin man pages for further details.
 101
 102
 103 idmap_hash
 104 ==========
 105
 106 The idmap_hash plugin provides similar support as the idmap_rid
 107 module.  However, uids and gids are generated from the full domain
 108 SID using a hashing algorithm that maps the lower 19 bits from the user
 109 or group RID to bits 0 - 19 in the Unix id and hashes 96 bits from
 110 the domain SID to bits 20 - 30 in the Unix id.  The result is a 31 bit
 111 uid or gid that is consistent across machines and provides support for
 112 trusted domains.
 113
 114 Please refer to the idmap_hash(8) man page for more details.
 115
 116 idmap_adex
 117 ==========
 118
 119 The adex idmap/nss_info plugin is an adaptation of the Likewise
 120 Enterprise plugin with support for OU based cells removed
 121 (since the Windows pieces to manage the cells are not available).
 122
 123 This plugin supports
 124
 125       * The RFC2307 schema for users and groups.
 126       * Connections to trusted domains
 127       * Global catalog searches
 128       * Cross forest trusts
 129       * User and group aliases
 130
 131 Prerequisite: Add the following attributes to the Partial Attribute
 132 Set in global catalog:
 133
 134       * uidNumber
 135       * uid
 136       * gidNumber
 137
 138 A basic config using the current trunk code would look like:
 139
 140 [global]
 141         idmap backend = adex
 142         idmap uid = 10000 - 29999
 143         idmap gid = 10000 - 29999
 144         winbind nss info = adex
 145
 146         winbind normalize names = yes
 147         winbind refresh tickets = yes
 148         template homedir = /home/%D/%U
 149         template shell = /bin/bash
 150
 151 Please refer to the idmap_adex(8) man page for more details.
 152
 153
 154 ######################################################################
 155 Changes
 156 #######
 157
 158 smb.conf changes
 159 ----------------
 160
 161     Parameter Name                      Description     Default
 162     --------------                      -----------     -------
 163     cups connection timeout             New             30
 164     idmap domains                       Removed
 165     init logon delayed hosts            New             ""
 166     init logon delay                    New             100
 167     winbind reconnect delay             New             30
 168
 169
 170 Changes since 3.3.0pre1:
 171 ------------------------
 172
 173
 174 o   Michael Adam <obnox@samba.org>
 175
 176     * BUG 5492: Fix RHEL SPEC file by removing libmsrpc stuff.
 177     * BUG 5507: Fix several issues in the RHEL SPEC file.
 178
 179 o   Jeremy Allison <jra@samba.org>
 180     * BUG 5729: Explicitly allow "-valid".
 181     * BUG 5737: Fix winbindd crash in an unusual failure mode.
 182     * BUG 5751: Fix showing of ACLs on DFS in (lib)smbclient.
 183     * BUG 5762: Fix opening of mangled directory name (resulted
 184       'is a stream name').
 185     * BUG 5783: Fix FindFirst where search pattern == mangled filename.
 186     * BUG 5790: Fix returning of STATUS_OBJECT_NAME_NOT_FOUND on set file
 187       disposition.
 188     * Fix crashes when looking up a non-existant uid.
 189     * Fix getting/setting of NT ACLs on a file.
 190     * Add st_birthtime and friends for accurate create times on *BSD
 191       and MacOSX).
 192     * Fix the wcache_invalidate_samlogon calls.
 193     * Clarify usage of "force create mode".
 194     * Get smbd to look (read-only) into the winbindd cache for uid/gid <--> sid
 195       mappings.
 196     * Write times code update.
 197     * Add experimental version of VFS module acl_xattr.
 198
 199
 200 o   Gerald W. Carter <jerry@samba.org>
 201     * Fix segfault when calling nss_get_info() with a NULL ads structure.
 202     * Add support for name aliasing in Winbind.
 203     * Add the idmap/nss-info provider from Likewise Open.
 204     * Allow an admin to define the "uid" attribute for a RFC2307
 205       user object in AD to be the username alias.
 206     * Add new idmap backend "adex" to support RFC2307 enabled AD forests.
 207
 208
 209 o   Steven Danneman <steven.danneman@isilon.com>
 210     * Fix build warnings.
 211     * Cleanup of DC enumeration in get_dcs().
 212
 213
 214 o   Günther Deschner <gd@samba.org>
 215     * BUG 5710: Fix changing of machine account passwords.
 216     * BUG 5784: Fix pam_winbind build issue on Solaris.
 217     * Fix invalid sid copy (hit when enumerating sibling domains) in Winbind.
 218     * Fix double installation of cifs.upcall.
 219
 220
 221 o   James Ding <ding_cc@hotmail.com>
 222     * BUG 5736: Fix Winbind crash bug with trusted domains.
 223
 224
 225 o   Ephi Dror <Ephi.Dror@datadomain.com>
 226     * Correct the netsamlogon_clear_cached_user function.
 227
 228
 229 o   Jeff Layton <jlayton@redhat.com>
 230     * Fix build warnings in cifs.upcall.
 231
 232
 233 o   Volker Lendecke <vl@sernet.de>
 234     * BUG 5707: Do proper error handling if the socket is closed.
 235     * BUG 5778: Don't define 'strlcat' and 'strlcpy' if it's already defined.
 236     * Fix Coverity IDs 587 and 589.
 237     * Increase the default positive idmap cache time to a week.
 238     * Fix calculation of useable_space for trans2 and nttrans replies.
 239     * Add mapping of generic bits when setting an NFSv4 ACL.
 240
 241
 242 o   Stefan Metzmacher <metze@samba.org>
 243     * Some write time fixes.
 244
 245
 246 o   Karolin Seeger <kseeger@samba.org>
 247     * Add new parameter "cups connection timeout".
 248
 249
 250 o   Simo Sorce <idra@samba.org>
 251     * Fix enumeration of nested group memberships in Winbind.
 252       This affected only setups using "security = ads".
 253
 254
 255 o   Timur <timur@FreeBSD.org>
 256     * Fix cut and paste error in quota code.
 257     * Fix display of POSIX ACLs.
 258     * Fix aio on FreeBSD.
 259
 260
 261 o   Andrew Tridgell <tridge@samba.org>
 262     * Fix permissions of group_mapping.ldb (CVE-2008-3789).
 263     * Avoid a race condition in glibc between AIO and setresuid().
 264     * Add missing become root for AIO operations.
 265     * Fix an errno handling bug that could lead to an infinite loop.
 266     * Fix logic of tsmsm_sendfile().
 267     * Fix handling of arbitrary new PAC types.
 268
 269
 270 o   Qiao Yang <geoyang@ironport.com>
 271     * Fix a memleak.
 272
 273
 274 Commit Highlights:
 275 ------------------
 276
 277 o   Michael Adam <obnox@samba.org>
 278     * BUG 5609: Remove configure option "--with-libdir" and add
 279       "--with-modulesdir".
 280     * Extend "net rpc vampire keytab" to support differential replication
 281       and storing of kerberos keys.
 282     * Rework internal logic of registry tdb code.
 283     * Freeze autogenerated prototype headers (good bye "make proto").
 284
 285
 286 o   Jeremy Allison <jra@samba.org>
 287     * Add new "winbind reconnect delay" parameter.
 288     * Make the change to smbcontrol for "all" to mean broadcast,
 289       and "smbd" to mean the main smb daemon.
 290
 291
 292 o   Gerald W. Carter <jerry@samba.org>
 293     * Add support for name aliasing in Winbind.
 294     * Add the idmap/nss-info provider from Likewise Open.
 295     * Allow an admin to define the "uid" attribute for a RFC2307
 296       user object in AD to be the username alias.
 297     * Add new idmap backend "adex" to support RFC2307 enabled AD forests.
 298
 299
 300 o   Guenther Deschner <gd@samba.org>
 301     * BUG 5710: Fix changing of machine account passwords.
 302     * Add "net rpc vampire keytab" and "net rpc vampire ldif".
 303
 304
 305 o   Volker Lendecke <vl@samba.org>
 306     * Rework of the Winbind idmap backend.
 307     * Fix calculation of useable_space for trans2 and nttrans replies.
 308     * Add mapping of generic bits when setting an NFSv4 ACL.
 309
 310
 311 ######################################################################
 312 Reporting bugs & Development Discussion
 313 #######################################
 314
 315 Please discuss this release on the samba-technical mailing list or by
 316 joining the #samba-technical IRC channel on irc.freenode.net.
 317
 318 If you do report problems then please try to send high quality
 319 feedback. If you don't provide vital information to help us track down
 320 the problem then you will probably be ignored.  All bug reports should
 321 be filed under the Samba 3.3 product in the project's Bugzilla
 322 database (https://bugzilla.samba.org/).
 323
 324
 325 ======================================================================
 326 == Our Code, Our Bugs, Our Responsibility.
 327 == The Samba Team
 328 ======================================================================
 329