VERSION: Disable git snapshot for the 4.3.1 release.
[Samba.git] / WHATSNEW.txt
blob5fee3721daa4a08d082b6187beea6da01af95df7
1                    =============================
2                    Release Notes for Samba 4.3.1
3                          October 20, 2015
4                    =============================
7 This is the latest stable release of Samba 4.3.
10 Changes since 4.3.0:
11 --------------------
13 o   Jeremy Allison <jra@samba.org>
14     * BUG 10252: s3: smbd: Fix our access-based enumeration on "hide unreadable"
15       to match Windows.
16     * BUG 10634: smbd: Fix file name buflen and padding in notify repsonse.
17     * BUG 11486: s3: smbd: Fix mkdir race condition.
18     * BUG 11522: s3: smbd: Fix opening/creating :stream files on the root share
19       directory.
20     * BUG 11535: s3: smbd: Fix NULL pointer bug introduced by previous 'raw'
21     * stream fix (bug #11522).
22     * BUG 11555: s3: lsa: lookup_name() logic for unqualified (no DOMAIN\
23       component) names is incorrect.
25 o   Ralph Boehme <slow@samba.org>
26     * BUG 11535: s3: smbd: Fix a crash in unix_convert().
27     * BUG 11543: vfs_fruit: Return value of ad_pack in vfs_fruit.c.
28     * BUG 11549: s3:locking: Initialize lease pointer in
29       share_mode_traverse_fn().
30     * BUG 11550: s3:smbstatus: Add stream name to share_entry_forall().
31     * BUG 11555: s3:lib: Validate domain name in lookup_wellknown_name().
33 o   Günther Deschner <gd@samba.org>
34     * BUG 11038: kerberos: Make sure we only use prompter type when available.
36 o   Volker Lendecke <vl@samba.org>
37     * BUG 11038: winbind: Fix 100% loop.
38     * BUG 11053: source3/lib/msghdr.c: Fix compiling error on Solaris.
40 o   Stefan Metzmacher <metze@samba.org>
41     * BUG 11316: s3:ctdbd_conn: make sure we destroy tevent_fd before closing
42       the socket.
43     * BUG 11515: s4:lib/messaging: Use 'msg.lock' and 'msg.sock' for messaging
44       related subdirs.
45     * BUG 11526: lib/param: Fix hiding of FLAG_SYNONYM values.
47 o   Björn Jacke <bj@sernet.de>
48     * BUG 10365: nss_winbind: Fix hang on Solaris on big groups.
49     * BUG 11355: build: Use as-needed linker flag also on OpenBSD.
51 o   Har Gagan Sahai <SHarGagan@novell.com>
52     * BUG 11509: s3: dfs: Fix a crash when the dfs targets are disabled.
54 o   Andreas Schneider <asn@samba.org>
55     * BUG 11502: pam_winbind: Fix a segfault if initialization fails.
57 o   Uri Simchoni <uri@samba.org>
58     * BUG 11528: net: Fix a crash with 'net ads keytab create'.
59     * BUG 11547: vfs_commit: set the fd on open before calling SMB_VFS_FSTAT.
61 #######################################
62 Reporting bugs & Development Discussion
63 #######################################
65 Please discuss this release on the samba-technical mailing list or by
66 joining the #samba-technical IRC channel on irc.freenode.net.
68 If you do report problems then please try to send high quality
69 feedback. If you don't provide vital information to help us track down
70 the problem then you will probably be ignored.  All bug reports should
71 be filed under the "Samba 4.1 and newer" product in the project's Bugzilla
72 database (https://bugzilla.samba.org/).
75 ======================================================================
76 == Our Code, Our Bugs, Our Responsibility.
77 == The Samba Team
78 ======================================================================
81 Older release notes to follow:
82 ------------------------------
84                    =============================
85                    Release Notes for Samba 4.3.0
86                            September 8, 2015
87                    =============================
90 This is the first stable release of Samba 4.3.
93 UPGRADING
94 =========
96 Read the "New FileChangeNotify subsystem" and "smb.conf changes" sections
97 (below).
100 NEW FEATURES
101 ============
103 Logging
104 -------
106 The logging code now supports logging to multiple backends.  In
107 addition to the previously available syslog and file backends, the
108 backends for logging to the systemd-journal, lttng and gpfs have been
109 added. Please consult the section for the 'logging' parameter in the
110 smb.conf manpage for details.
112 Spotlight
113 ---------
115 Support for Apple's Spotlight has been added by integrating with Gnome
116 Tracker.
118 For detailed instructions how to build and setup Samba for Spotlight,
119 please see the Samba wiki: <https://wiki.samba.org/index.php/Spotlight>
121 New FileChangeNotify subsystem
122 ------------------------------
124 Samba now contains a new subsystem to do FileChangeNotify. The
125 previous system used a central database, notify_index.tdb, to store
126 all notification requests. In particular in a cluster this turned out
127 to be a major bottleneck, because some hot records need to be bounced
128 back and forth between nodes on every change event like a new created
129 file.
131 The new FileChangeNotify subsystem works with a central daemon per
132 node. Every FileChangeNotify request and every event are handled by an
133 asynchronous message from smbd to the notify daemon. The notify daemon
134 maintains a database of all FileChangeNotify requests in memory and
135 will distribute the notify events accordingly. This database is
136 asynchronously distributed in the cluster by the notify daemons.
138 The notify daemon is supposed to scale a lot better than the previous
139 implementation. The functional advantage is cross-node kernel change
140 notify: Files created via NFS will be seen by SMB clients on other
141 nodes per FileChangeNotify, despite the fact that popular cluster file
142 systems do not offer cross-node inotify.
144 Two changes to the configuration were required for this new subsystem:
145 The parameters "change notify" and "kernel change notify" are not
146 per-share anymore but must be set globally. So it is no longer
147 possible to enable or disable notify per share, the notify daemon has
148 no notion of a share, it only works on absolute paths.
150 New SMB profiling code
151 ----------------------
153 The code for SMB (SMB1, SMB2 and SMB3) profiling uses a tdb instead
154 of sysv IPC shared memory. This avoids performance problems and NUMA
155 effects. The profile stats are a bit more detailed than before.
157 Improved DCERPC man in the middle detection for kerberos
158 --------------------------------------------------------
160 The gssapi based kerberos backends for gensec have support for
161 DCERPC header signing when using DCERPC_AUTH_LEVEL_PRIVACY.
163 SMB signing required in winbindd by default
164 -------------------------------------------
166 The effective value for "client signing" is required
167 by default for winbindd, if the primary domain uses active directory.
169 Experimental NTDB was removed
170 -----------------------------
172 The experimental NTDB library introduced in Samba 4.0 has been
173 removed again.
175 Improved support for trusted domains (as AD DC)
176 -----------------------------------------------
178 The support for trusted domains/forests has improved a lot.
180 samba-tool got "domain trust" subcommands to manage trusts:
182   create      - Create a domain or forest trust.
183   delete      - Delete a domain trust.
184   list        - List domain trusts.
185   namespaces  - Manage forest trust namespaces.
186   show        - Show trusted domain details.
187   validate    - Validate a domain trust.
189 External trusts between individual domains work in both ways
190 (inbound and outbound). The same applies to root domains of
191 a forest trust. The transitive routing into the other forest
192 is fully functional for kerberos, but not yet supported for NTLMSSP.
194 While a lot of things are working fine, there are currently a few limitations:
196   - Both sides of the trust need to fully trust each other!
197   - No SID filtering rules are applied at all!
198   - This means DCs of domain A can grant domain admin rights
199     in domain B.
200   - It's not possible to add users/groups of a trusted domain
201     into domain groups.
203 SMB 3.1.1 supported
204 -------------------
206 Both client and server have support for SMB 3.1.1 now.
208 This is the dialect introduced with Windows 10, it improves the secure
209 negotiation of SMB dialects and features.
211 There's also a new optinal encryption algorithm aes-gcm-128,
212 but for now this is only selected as fallback and aes-ccm-128
213 is preferred because of the better performance. This might change
214 in future versions when hardware encryption will be supported.
215 See https://bugzilla.samba.org/show_bug.cgi?id=11451.
217 New smbclient subcommands
218 -------------------------
220   - Query a directory for change notifications: notify <dir name>
221   - Server side copy: scopy <source filename> <destination filename>
223 New rpcclient subcommands
224 -------------------------
226   netshareenumall       - Enumerate all shares
227   netsharegetinfo       - Get Share Info
228   netsharesetinfo       - Set Share Info
229   netsharesetdfsflags   - Set DFS flags
230   netfileenum           - Enumerate open files
231   netnamevalidate       - Validate sharename
232   netfilegetsec         - Get File security
233   netsessdel            - Delete Session
234   netsessenum           - Enumerate Sessions
235   netdiskenum           - Enumerate Disks
236   netconnenum           - Enumerate Connections
237   netshareadd           - Add share
238   netsharedel           - Delete share
240 New modules
241 -----------
243   idmap_script          - see 'man 8 idmap_script'
244   vfs_unityed_media     - see 'man 8 vfs_unityed_media'
245   vfs_shell_snap        - see 'man 8 vfs_shell_snap'
247 New sparsely connected replia graph (Improved KCC)
248 --------------------------------------------------
250 The Knowledge Consistency Checker (KCC) maintains a replication graph
251 for DCs across an AD network. The existing Samba KCC uses a fully
252 connected graph, so that each DC replicates from all the others, which
253 does not scale well with large networks. In 4.3 there is an
254 experimental new KCC that creates a sparsely connected replication
255 graph and closely follows Microsoft's specification. It is turned off
256 by default. To use the new KCC, set "kccsrv:samba_kcc=true" in
257 smb.conf and let us know how it goes. You should consider doing this
258 if you are making a large new network. For small networks there is
259 little benefit and you can always switch over at a later date.
261 Configurable TLS protocol support, with better defaults
262 -------------------------------------------------------
264 The "tls priority" option can be used to change the supported TLS
265 protocols. The default is to disable SSLv3, which is no longer
266 considered secure.
268 Samba-tool now supports all 7 FSMO roles
269 -------------------------------------------------------
271 Previously "samba-tool fsmo" could only show, transfer or seize the
272 five well-known FSMO roles:
274         Schema Master
275         Domain Naming Master
276         RID Master
277         PDC Emulator
278         Infrastructure Master
280 It can now also show, transfer or seize the DNS infrastructure roles:
282         DomainDnsZones Infrastructure Master
283         ForestDnsZones Infrastructure Master
285 CTDB logging changes
286 --------------------
288 The destination for CTDB logging is now set via a single new
289 configuration variable CTDB_LOGGING.  This replaces CTDB_LOGFILE and
290 CTDB_SYSLOG, which have both been removed.  See ctdbd.conf(5) for
291 details of CTDB_LOGGING.
293 CTDB no longer runs a separate logging daemon.
295 CTDB NFS support changes
296 ------------------------
298 CTDB's NFS service management has been combined into a single 60.nfs
299 event script.  This updated 60.nfs script now uses a call-out to
300 interact with different NFS implementations.  See the CTDB_NFS_CALLOUT
301 option in the ctdbd.conf(5) manual page for details.  A default
302 call-out is provided to interact with the Linux kernel NFS
303 implementation.  The 60.ganesha event script has been removed - a
304 sample call-out is provided for NFS Ganesha, based on this script.
306 The method of configuring NFS RPC checks has been improved.  See
307 ctdb/config/nfs-checks.d/README for details.
309 Improved Cross-Compiling Support
310 --------------------------------
312 A new "hybrid" build configuration mode is added to improve
313 cross-compilation support.
315 A common challenge in cross-compilation is that of obtaining the results
316 of tests that have to run on the target, during the configuration
317 phase of the build. The Samba build system already supports the following
318 means to do so:
320   - Executing configure tests using the --cross-execute parameter
321   - Obtaining the results from an answers file using the --cross-answers
322     parameter
324 The first method has the drawback of inaccurate results if the tests are
325 run using an emulator, or a need to be connected to a running target
326 while building, if the tests are to be run on an actual target. The
327 second method presents a challenge of figuring out the test results.
329 The new hybrid mode runs the tests and records the result in an answer file.
330 To activate this mode, use both --cross-execute and --cross-answers in the
331 same configure invocation. This mode can be activated once against a
332 running target, and then the generated answers file can be used in
333 subsequent builds.
335 Also supplied is an example script that can be used as the
336 cross-execute program. This script copies the test to a running target
337 and runs the test on the target, obtaining the result. The obtained
338 results are more accurate than running the test with an emulator, because
339 they reflect the exact kernel and system libraries that exist on the
340 target.
342 Improved Sparse File Support
343 ----------------------------
344 Support for the FSCTL_SET_ZERO_DATA and FSCTL_QUERY_ALLOCATED_RANGES
345 SMB2 requests has been added to the smbd file server.
346 This allows for clients to deallocate (hole punch) regions within a
347 sparse file, and check which portions of a file are allocated.
350 ######################################################################
351 Changes
352 #######
354 smb.conf changes
355 ----------------
357   Parameter Name                Description             Default
358   --------------                -----------             -------
359   logging                       New                     (empty)
360   msdfs shuffle referrals       New                     no
361   smbd profiling level          New                     off
362   spotlight                     New                     no
363   tls priority                  New                     NORMAL:-VERS-SSL3.0
364   use ntdb                      Removed
365   change notify                 Changed to [global]
366   kernel change notify          Changed to [global]
367   client max protocol           Changed default         SMB3_11
368   server max protocol           Changed default         SMB3_11
370 Removed modules
371 ---------------
373 vfs_notify_fam - see section 'New FileChangeNotify subsystem'.
376 KNOWN ISSUES
377 ============
379 Currently none.
382 CHANGES SINCE 4.2.0rc4
383 ======================
385 o   Andrew Bartlett <abartlet@samba.org>
386     * Bug 10973: No objectClass found in replPropertyMetaData on ordinary
387       objects (non-deleted)
388     * Bug 11429: Python bindings don't check integer types
389     * Bug 11430: Python bindings don't check array sizes
391 o   Ralph Boehme <slow@samba.org>
392     * Bug 11467: Handling of 0 byte resource fork stream
394 o   Volker Lendecke <vl@samba.org>
395     * Bug 11488: AD samr GetGroupsForUser fails for users with "()" in
396       their name
398 o   Stefan Metzmacher <metze@samba.org>
399     * Bug 11429: Python bindings don't check integer types
401 o   Matthieu Patou <mat@matws.net>
402     * Bug 10973: No objectClass found in replPropertyMetaData on ordinary
403       objects (non-deleted)
406 CHANGES SINCE 4.2.0rc3
407 ======================
409 o   Ralph Boehme <slow@samba.org>
410     * Bug 11444: Crash in notify_remove caused by change notify = no
412 o   Günther Deschner <gd@samba.org>
413     * Bug 11411: smbtorture does not build when configured --with-system-mitkrb5
415 o   Volker Lendecke <vl@samba.org>
416     * Bug 11455: fix recursion problem in rep_strtoll in lib/replace/replace.c
417     * Bug 11464: xid2sid gives inconsistent results
418     * Bug 11465: ctdb: Fix the build on FreeBSD 10.1
420 o   Roel van Meer <roel@1afa.com>
421     * Bug 11427: nmbd incorrectly matches netbios names as own name
423 o   Stefan Metzmacher <metze@samba.org>
424     * Bug 11451: Poor SMB3 encryption performance with AES-GCM
425     * Bug 11458: --bundled-libraries=!ldb,!pyldb,!pyldb-util doesn't
426       disable ldb build and install
428 o   Andreas Schneider <asn@samba.org>
429     * Bug 9862: Samba "map to guest = Bad uid" doesn't work
432 CHANGES SINCE 4.3.0rc2
433 ======================
435 o   Andrew Bartlett <abartlet@samba.org>
436     * Bug 11436: samba-tool uncaught exception error
437     * Bug 10493: revert LDAP extended rule 1.2.840.113556.1.4.1941
438                  LDAP_MATCHING_RULE_IN_CHAIN changes
440 o   Ralph Boehme <slow@samba.org>
441     * Bug 11278: Stream names with colon don't work with
442                  fruit:encoding = native
443     * Bug 11426: net share allowedusers crashes
445 o   Amitay Isaacs <amitay@gmail.com>
446     * Bug 11432: Fix crash in nested ctdb banning
447     * Bug 11434: Cannot build ctdbpmda
448     * Bug 11431: CTDB's eventscript error handling is broken
450 o   Stefan Metzmacher <metze@samba.org>
451     * Bug 11451: Poor SMB3 encryption performance with AES-GCM (part1)
452     * Bug 11316: tevent_fd needs to be destroyed before closing the fd
454 o   Arvid Requate <requate@univention.de>
455     * Bug 11291: NetApp joined to a Samba/ADDC cannot resolve SIDs
457 o   Martin Schwenke <martin@meltin.net>
458     * Bug 11432: Fix crash in nested ctdb banning
461 CHANGES SINCE 4.3.0rc1
462 ======================
464 o   Jeremy Allison <jra@samba.org>
465     * BUG 11359: strsep is not available on Solaris
467 o   Björn Baumbach <bb@sernet.de>
468     * BUG 11421: Build with GPFS support is broken
470 o   Justin Maggard <jmaggard@netgear.com>
471     * BUG 11320: "force group" with local group not working
473 o   Martin Schwenke <martin@meltin.net>
474     * BUG 11424: Build broken with --disable-python
477 #######################################
478 Reporting bugs & Development Discussion
479 #######################################
481 Please discuss this release on the samba-technical mailing list or by
482 joining the #samba-technical IRC channel on irc.freenode.net.
484 If you do report problems then please try to send high quality
485 feedback. If you don't provide vital information to help us track down
486 the problem then you will probably be ignored.  All bug reports should
487 be filed under the "Samba 4.1 and newer" product in the project's Bugzilla
488 database (https://bugzilla.samba.org/).
491 ======================================================================
492 == Our Code, Our Bugs, Our Responsibility.
493 == The Samba Team
494 ======================================================================