WHATSNEW.txt

   1                    =============================
   2                    Release Notes for Samba 4.1.0
   3                          October 11, 2013
   4                    =============================
   5
   6
   7 This is is the first stable release of Samba 4.1.
   8
   9 Samba 4.1 will be the next version of the Samba suite and includes
  10 all the technology found in both the Samba4 series and the stable 3.x
  11 series. The primary additional features over Samba 3.6 are
  12 support for the Active Directory logon protocols used by Windows 2000
  13 and above.
  14
  15 Major enhancements in Samba 4.1.0 include:
  16
  17 Client tools support SMB2/3
  18 ===========================
  19
  20 Samba 4.1.0 contains the first release of our client tools
  21 and client library that work over the new protocols SMB2 or SMB3.
  22 Note that SMB3 only works either to a Samba server version 4.0.0
  23 or above, or to a Windows Server running Windows 2012 or Windows 8.
  24
  25 The default protocol for smbclient and smbcacls is still
  26 SMB1 (the NT1 protocol dialect). An SMB2 or SMB3 connection
  27 can be selected in one of two ways. The easiest way to test
  28 the new protocol connection is to add the -mMAX_PROTOCOL
  29 command line switch to either smbclient or smbcacls.
  30
  31 For example, to connect using SMB3 with smbclient a user
  32 would type:
  33
  34 smbclient //server/share -Uuser%password -mSMB3
  35
  36 Another example of connecting using SMB2 using smbcacls
  37 would be:
  38
  39 smbcacls //server/share -Uuser%password -mSMB2 filename
  40
  41 Note that when connecting using SMB2 or SMB3 protocols
  42 the UNIX extensions are no longer available inside the
  43 smbclient command set. This is due to UNIX extensions
  44 not yet being defined for the SMB2 or SMB3 protocols.
  45
  46 The second way to select SMB2 or SMB3 connections is to
  47 set the "client max protocol" parameter in the [global]
  48 section of your smb.conf.
  49
  50 Setting this parameter will cause all client connections
  51 from Samba and its client tools to offer the requested
  52 max protocol to a server on every connection request.
  53
  54 For example, to cause all client tools (including winbindd,
  55 rpcclient, and the libsmbclient library) to attempt use SMB3
  56 by default add the line:
  57
  58 client max protocol = SMB3
  59
  60 to the [global] section of your smb.conf. This has not
  61 been as widely tested as the -mPROTOCOL options, but
  62 is intended to work correctly in the final release of
  63 4.1.0.
  64
  65 Encrypted transport
  66 ===================
  67
  68 Although Samba servers have supported encrypted transport
  69 connections using the UNIX extensions for many years,
  70 selecting SMB3 transport allows encrypted transport
  71 connections to Windows servers that support SMB3, as
  72 well as Samba servers.
  73
  74 In order to enable this, add the "-e" option to the
  75 smbclient command line.
  76
  77 For example, to connect to a Windows 2012 server over
  78 SMB3 and select an encrypted transport you would use
  79 the following command line:
  80
  81 smbclient //Win2012Server/share -Uuser%password -mSMB3 -e
  82
  83
  84 Directory database replication (AD DC mode)
  85 ===========================================
  86
  87 Directory replication has been reworked in order to improve the
  88 correctness and efficiency.
  89 As a net effect of it, replication with other domain controllers with
  90 a heavily modified schema is now possible (ie. Windows 2012 DCs or
  91 other Windows DC with exchange installed) and replication didn't fail
  92 anymore in such environments.
  93
  94
  95 Server-Side Copy Support
  96 ========================
  97
  98 Samba 4.1.0 adds support for server-side copy operations via the SMB2
  99 FSCTL_SRV_COPYCHUNK request. Clients making use of server-side copy
 100 support, such as Windows Server 2012, should experience considerable
 101 performance improvements for file copy operations, as file data need not
 102 traverse the network.
 103 This feature is enabled by default on the smbd file server.
 104
 105
 106 Btrfs Filesystem Integration
 107 ============================
 108
 109 The Btrfs VFS module provided with Samba 4.1.0 further improves the
 110 performance of server-side copy operations on shares backed by a Btrfs
 111 filesystem. It does so by allowing multiple files to share the same
 112 on-disk extents, avoiding the unnecessary duplication of source and
 113 destination file data during a server-side copy operation.
 114
 115 This feature can be explicitly enabled on smbd shares backed by a Btrfs
 116 filesystem with the smb.conf parameter:
 117 vfs objects = btrfs
 118
 119
 120 REMOVED COMPONENTS
 121 ==================
 122
 123 The Samba Web Administration Tool (SWAT) has been removed.
 124 Details why SWAT has been removed can be found on the samba-technical mailing
 125 list:
 126
 127 https://lists.samba.org/archive/samba-technical/2013-February/090572.html
 128
 129
 130 ######################################################################
 131 Changes
 132 #######
 133
 134 smb.conf changes
 135 ----------------
 136
 137    Parameter Name                       Description     Default
 138    --------------                       -----------     -------
 139
 140    acl allow execute always             New             False
 141    password level                       Removed
 142    set directory                        Removed
 143    use ntdb                             New             No
 144
 145
 146 RUNNING Samba 4.1 as an AD DC
 147 =============================
 148
 149 A short guide to setting up Samba as an AD DC can be found on the wiki:
 150
 151   https://wiki.samba.org/index.php/Samba_AD_DC_HOWTO
 152
 153
 154 COMMIT HIGHLIGHTS
 155 =================
 156
 157 o   Jeremy Allison <jra@samba.org>
 158     * Add SMB2 and SMB3 support for client tools and client library.
 159     * Add support for SMB3 Encrypted transport.
 160
 161
 162 o   David Disseldorp <ddiss@samba.org>
 163     * Add vfs_btrfs module.
 164     * Add support for server-side copy operations via the
 165       SMB2 FSCTL_SRV_COPYCHUNK request.
 166
 167
 168 CHANGES SINCE 4.1.0rc4
 169 ======================
 170
 171 o   Stefan Metzmacher <metze@samba.org>
 172     * BUG 10178: Fix PAC parsing failure.
 173
 174
 175 o   Andreas Schneider <asn@samba.org>
 176     * BUG 10132: pam_winbindd: Support the KEYRING ccache type.
 177
 178
 179 CHANGES SINCE 4.1.0rc3
 180 ======================
 181
 182 o   Michael Adam <obnox@samba.org>
 183     * BUG 10134: Add "acl allow execute always" parameter.
 184
 185
 186 o   Jeremy Allison <jra@samba.org>
 187     * BUG 10139: Valid utf8 filenames cause "invalid conversion error"
 188       messages.
 189     * BUG 10145: Samba SMB2 client code reads the wrong short name length in a
 190       directory listing reply.
 191     * BUG 10149: cli_smb2_get_ea_list_path() failed to close file on exit.
 192     * BUG 10150: Not all OEM servers support the ALTNAME info level.
 193
 194
 195 o   Andrew Bartlett <abartlet@samba.org>
 196     * BUG 8077: dsdb: Convert the full string from UTF16 to UTF8, including
 197       embedded NULLs.
 198     * BUG 9461: python-samba-tool fsmo: Do not give an error on a successful
 199       role transfer.
 200     * BUG 10157: Regression causes replication failure with Windows 2008R2 and
 201       deletes Deleted Objects.
 202
 203
 204 o   Günther Deschner <gd@samba.org>
 205     * BUG 10147: Better document potential implications of a globally used
 206       "valid users".
 207
 208
 209 o   Korobkin <korobkin+samba@gmail.com>
 210     * BUG 10118: Raise the level of a debug when unable to open a printer.
 211
 212
 213 o   Volker Lendecke <vl@samba.org>
 214     * BUG 10008: dbwrap_ctdb: Treat empty records as non-existing.
 215     * BUG 10138: smbd: Always clean up share modes after hard crash.
 216
 217
 218 o   Daniel Liberman <danielvl@gmail.com>
 219     * BUG 10162: Fix POSIX ACL mapping when setting DENY ACE's from Windows.
 220
 221
 222 o   Stefan Metzmacher <metze@samba.org>
 223     * BUG 10144: libcli/smb: Use SMB1 MID=0 for the initial Negprot.
 224     * BUG 10146: libcli/smb: Only check the SMB2 session setup signature if
 225       required and valid.
 226
 227
 228 o   Matthieu Patou <mat@matws.net>
 229     * BUG 10158: Netbios related samba process consumes 100% CPU.
 230
 231
 232 o   Christof Schmitt <christof.schmitt@us.ibm.com>
 233     * BUG 10137: vfs_shadow_copy2: Display previous versions correctly over
 234       SMB2.
 235
 236
 237 CHANGES SINCE 4.1.0rc2
 238 ======================
 239
 240 o   Michael Adam <obnox@samba.org>
 241     * BUG 10107: Fix Winbind crashes on DC with trusted AD domains.
 242
 243
 244 o   Jeremy Allison <jra@samba.org>
 245     * BUG 5917: Fix working on site with Read Only Domain Controller.
 246     * BUG 9974: Add SMB2 and SMB3 support for smbclient.
 247     * BUG 10063: Fix memory leak in source3/lib/util.c:1493.
 248     * BUG 10121: Masks incorrectly applied to UNIX extension permission
 249       changes.
 250
 251
 252 o   Christian Ambach <ambi@samba.org>
 253     * BUG 9911: Build Samba 4.0.x on AIX with IBM XL C/C++.
 254
 255
 256 o   Andrew Bartlett <abartlet@samba.org>
 257     * BUG 9091: When replicating DNS for bind9_dlz we need to create the
 258       server-DNS account remotely.
 259
 260
 261 o   Günther Deschner <gd@samba.org>
 262     * BUG 9615: Winbind unable to retrieve user information from AD.
 263     * BUG 9899: winbind_lookup_names() fails because of
 264       NT_STATUS_CANT_ACCESS_DOMAIN_INFO.
 265     * BUG 10107: Fix Winbind crashes on DC with trusted AD domains.
 266
 267
 268 o   Volker Lendecke <vl@samba.org>
 269     * BUG 10086: smbd: Fix async echo handler forking.
 270     * BUG 10106: Honour output buffer length set by the client for SMB2 GetInfo
 271       requests.
 272     * BUG 10114: Handle Dropbox (write-only-directory) case correctly
 273       in pathname lookup.
 274
 275
 276 o   Stefan Metzmacher <metze@samba.org>
 277     * BUG 10030: ::1 added to nameserver on join.
 278
 279
 280 o   Rusty Russell <rusty@rustcorp.com.au>
 281     * BUG 10000: Add man pages for ntdb tools.
 282
 283
 284 o   Karolin Seeger <kseeger@samba.org>
 285     * BUG 7364: Add man page for vfs_syncops.
 286     * BUG 7490: Add man page for vfs_linux_xfs_sgid.
 287     * BUG 10001: Add man page for samba-regedit tool.
 288     * BUG 10076: Fix variable list in vfs_crossrename man page.
 289
 290
 291 o   Andreas Schneider <asn@samba.org>
 292     * BUG 10073: Fix segmentation fault in 'net ads join'.
 293     * BUG 10082: s3-winbind: Fix a segfault passing NULL to a fstring argument.
 294
 295
 296 o   Richard Sharpe <realrichardsharpe@gmail.com>
 297     * BUG 10097: MacOSX 10.9 will not follow path-based DFS referrals handed
 298       out by Samba.
 299
 300
 301 o   Ralph Wuerthner <ralph.wuerthner@de.ibm.com>
 302     * BUG 10106: Honour output buffer length set by the client for SMB2 GetInfo
 303       requests.
 304
 305
 306 CHANGES SINCE 4.1.0rc1
 307 ======================
 308
 309 o   Jeremy Allison <jra@samba.org>
 310     * BUG 9992: Windows error 0x800700FE when copying files with xattr names
 311       containing ":".
 312     * BUG 10010: Missing integer wrap protection in EA list reading can cause
 313       server to loop with DOS (CVE-2013-4124).
 314     * BUG 10064: Linux kernel oplock breaks can miss signals.
 315
 316
 317 o   Andrew Bartlett <abartlet@samba.org>
 318     * BUG 9029: Fix replication with --domain-crictical-only to fill in
 319       backlinks.
 320     * BUG 9820: Fix crash of winbind after "ls -l
 321       /usr/local/samba/var/locks/sysvol".
 322     * BUG 10056: dsdb improvements.
 323
 324
 325 o   Björn Baumbach <bb@sernet.de>
 326     * BUG 10003: Fix segfault while reading incomplete session info.
 327
 328
 329 o   Gregor Beck <gbeck@sernet.de>
 330     * BUG 9678: Windows 8 Roaming profiles fail.
 331
 332
 333 o   Günther Deschner <gd@samba.org>
 334     * BUG 10043: Allow to change the default location for Kerberos credential
 335       caches.
 336
 337
 338 o   Volker Lendecke <vl@samba.org>
 339     * BUG 10013: Fix a 100% loop at shutdown time (smbd).
 340
 341
 342 o   Stefan Metzmacher <metze@samba.org>
 343     * BUG 9820: Fix crash of winbind after "ls -l
 344       /usr/local/samba/var/locks/sysvol".
 345     * BUG 10015: Fix/improve debug options.
 346     * BUG 10042: Fix crashes in socket_get_local_addr().
 347     * BUG 10056: dsdb improvements.
 348
 349
 350 o   Andreas Schneider <asn@samba.org>
 351     * BUG 9994: Do not delete an existing valid credential cache (s3-winbind).
 352     * BUG 10040: Rename regedit to samba-regedit.
 353     * BUG 10041: Remove obsolete swat manpage and references.
 354     * BUG 10048: nsswitch: Add OPT_KRB5CCNAME to avoid an error message.
 355
 356
 357 o   Alexander Werth <alexander.werth@de.ibm.com>
 358     * BUG 10045: Remove a redundant inlined substitution of ACLs.
 359
 360
 361 o   Ralph Wuerthner <ralphw@de.ibm.com>
 362     * BUG 10064: Linux kernel oplock breaks can miss signals.
 363
 364
 365 #######################################
 366 Reporting bugs & Development Discussion
 367 #######################################
 368
 369 Please discuss this release on the samba-technical mailing list or by
 370 joining the #samba-technical IRC channel on irc.freenode.net.
 371
 372 If you do report problems then please try to send high quality
 373 feedback. If you don't provide vital information to help us track down
 374 the problem then you will probably be ignored.  All bug reports should
 375 be filed under the Samba 4.1 product in the project's Bugzilla
 376 database (https://bugzilla.samba.org/).
 377
 378
 379 ======================================================================
 380 == Our Code, Our Bugs, Our Responsibility.
 381 == The Samba Team
 382 ======================================================================
 383