1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml">
5 <title>Samba 4.3.0 - Release Notes</title>
8 <H2>Samba 4.3.0 Available for Download</H2>
10 <a href="https://download.samba.org/pub/samba/stable/samba-4.3.0.tar.gz">Samba 4.3.0 (gzipped)</a><br>
11 <a href="https://download.samba.org/pub/samba/stable/samba-4.3.0.tar.asc">Signature</a>
15 =============================
16 Release Notes for Samba 4.3.0
18 =============================
21 This is the first stable release of Samba 4.3.
27 Read the "New FileChangeNotify subsystem" and "smb.conf changes" sections
37 The logging code now supports logging to multiple backends. In
38 addition to the previously available syslog and file backends, the
39 backends for logging to the systemd-journal, lttng and gpfs have been
40 added. Please consult the section for the 'logging' parameter in the
41 smb.conf manpage for details.
46 Support for Apple's Spotlight has been added by integrating with Gnome
49 For detailed instructions how to build and setup Samba for Spotlight,
50 please see the Samba wiki: <https://wiki.samba.org/index.php/Spotlight>
52 New FileChangeNotify subsystem
53 ------------------------------
55 Samba now contains a new subsystem to do FileChangeNotify. The
56 previous system used a central database, notify_index.tdb, to store
57 all notification requests. In particular in a cluster this turned out
58 to be a major bottleneck, because some hot records need to be bounced
59 back and forth between nodes on every change event like a new created
62 The new FileChangeNotify subsystem works with a central daemon per
63 node. Every FileChangeNotify request and every event are handled by an
64 asynchronous message from smbd to the notify daemon. The notify daemon
65 maintains a database of all FileChangeNotify requests in memory and
66 will distribute the notify events accordingly. This database is
67 asynchronously distributed in the cluster by the notify daemons.
69 The notify daemon is supposed to scale a lot better than the previous
70 implementation. The functional advantage is cross-node kernel change
71 notify: Files created via NFS will be seen by SMB clients on other
72 nodes per FileChangeNotify, despite the fact that popular cluster file
73 systems do not offer cross-node inotify.
75 Two changes to the configuration were required for this new subsystem:
76 The parameters "change notify" and "kernel change notify" are not
77 per-share anymore but must be set globally. So it is no longer
78 possible to enable or disable notify per share, the notify daemon has
79 no notion of a share, it only works on absolute paths.
81 New SMB profiling code
82 ----------------------
84 The code for SMB (SMB1, SMB2 and SMB3) profiling uses a tdb instead
85 of sysv IPC shared memory. This avoids performance problems and NUMA
86 effects. The profile stats are a bit more detailed than before.
88 Improved DCERPC man in the middle detection for kerberos
89 --------------------------------------------------------
91 The gssapi based kerberos backends for gensec have support for
92 DCERPC header signing when using DCERPC_AUTH_LEVEL_PRIVACY.
94 SMB signing required in winbindd by default
95 -------------------------------------------
97 The effective value for "client signing" is required
98 by default for winbindd, if the primary domain uses active directory.
100 Experimental NTDB was removed
101 -----------------------------
103 The experimental NTDB library introduced in Samba 4.0 has been
106 Improved support for trusted domains (as AD DC)
107 -----------------------------------------------
109 The support for trusted domains/forests has improved a lot.
111 samba-tool got "domain trust" subcommands to manage trusts:
113 create - Create a domain or forest trust.
114 delete - Delete a domain trust.
115 list - List domain trusts.
116 namespaces - Manage forest trust namespaces.
117 show - Show trusted domain details.
118 validate - Validate a domain trust.
120 External trusts between individual domains work in both ways
121 (inbound and outbound). The same applies to root domains of
122 a forest trust. The transitive routing into the other forest
123 is fully functional for kerberos, but not yet supported for NTLMSSP.
125 While a lot of things are working fine, there are currently a few limitations:
127 - Both sides of the trust need to fully trust each other!
128 - No SID filtering rules are applied at all!
129 - This means DCs of domain A can grant domain admin rights
131 - It's not possible to add users/groups of a trusted domain
137 Both client and server have support for SMB 3.1.1 now.
139 This is the dialect introduced with Windows 10, it improves the secure
140 negotiation of SMB dialects and features.
142 There's also a new optinal encryption algorithm aes-gcm-128,
143 but for now this is only selected as fallback and aes-ccm-128
144 is preferred because of the better performance. This might change
145 in future versions when hardware encryption will be supported.
146 See https://bugzilla.samba.org/show_bug.cgi?id=11451.
148 New smbclient subcommands
149 -------------------------
151 - Query a directory for change notifications: notify <dir name>
152 - Server side copy: scopy <source filename> <destination filename>
154 New rpcclient subcommands
155 -------------------------
157 netshareenumall - Enumerate all shares
158 netsharegetinfo - Get Share Info
159 netsharesetinfo - Set Share Info
160 netsharesetdfsflags - Set DFS flags
161 netfileenum - Enumerate open files
162 netnamevalidate - Validate sharename
163 netfilegetsec - Get File security
164 netsessdel - Delete Session
165 netsessenum - Enumerate Sessions
166 netdiskenum - Enumerate Disks
167 netconnenum - Enumerate Connections
168 netshareadd - Add share
169 netsharedel - Delete share
174 idmap_script - see 'man 8 idmap_script'
175 vfs_unityed_media - see 'man 8 vfs_unityed_media'
176 vfs_shell_snap - see 'man 8 vfs_shell_snap'
178 New sparsely connected replia graph (Improved KCC)
179 --------------------------------------------------
181 The Knowledge Consistency Checker (KCC) maintains a replication graph
182 for DCs across an AD network. The existing Samba KCC uses a fully
183 connected graph, so that each DC replicates from all the others, which
184 does not scale well with large networks. In 4.3 there is an
185 experimental new KCC that creates a sparsely connected replication
186 graph and closely follows Microsoft's specification. It is turned off
187 by default. To use the new KCC, set "kccsrv:samba_kcc=true" in
188 smb.conf and let us know how it goes. You should consider doing this
189 if you are making a large new network. For small networks there is
190 little benefit and you can always switch over at a later date.
192 Configurable TLS protocol support, with better defaults
193 -------------------------------------------------------
195 The "tls priority" option can be used to change the supported TLS
196 protocols. The default is to disable SSLv3, which is no longer
199 Samba-tool now supports all 7 FSMO roles
200 -------------------------------------------------------
202 Previously "samba-tool fsmo" could only show, transfer or seize the
203 five well-known FSMO roles:
209 Infrastructure Master
211 It can now also show, transfer or seize the DNS infrastructure roles:
213 DomainDnsZones Infrastructure Master
214 ForestDnsZones Infrastructure Master
219 The destination for CTDB logging is now set via a single new
220 configuration variable CTDB_LOGGING. This replaces CTDB_LOGFILE and
221 CTDB_SYSLOG, which have both been removed. See ctdbd.conf(5) for
222 details of CTDB_LOGGING.
224 CTDB no longer runs a separate logging daemon.
226 CTDB NFS support changes
227 ------------------------
229 CTDB's NFS service management has been combined into a single 60.nfs
230 event script. This updated 60.nfs script now uses a call-out to
231 interact with different NFS implementations. See the CTDB_NFS_CALLOUT
232 option in the ctdbd.conf(5) manual page for details. A default
233 call-out is provided to interact with the Linux kernel NFS
234 implementation. The 60.ganesha event script has been removed - a
235 sample call-out is provided for NFS Ganesha, based on this script.
237 The method of configuring NFS RPC checks has been improved. See
238 ctdb/config/nfs-checks.d/README for details.
240 Improved Cross-Compiling Support
241 --------------------------------
243 A new "hybrid" build configuration mode is added to improve
244 cross-compilation support.
246 A common challenge in cross-compilation is that of obtaining the results
247 of tests that have to run on the target, during the configuration
248 phase of the build. The Samba build system already supports the following
251 - Executing configure tests using the --cross-execute parameter
252 - Obtaining the results from an answers file using the --cross-answers
255 The first method has the drawback of inaccurate results if the tests are
256 run using an emulator, or a need to be connected to a running target
257 while building, if the tests are to be run on an actual target. The
258 second method presents a challenge of figuring out the test results.
260 The new hybrid mode runs the tests and records the result in an answer file.
261 To activate this mode, use both --cross-execute and --cross-answers in the
262 same configure invocation. This mode can be activated once against a
263 running target, and then the generated answers file can be used in
266 Also supplied is an example script that can be used as the
267 cross-execute program. This script copies the test to a running target
268 and runs the test on the target, obtaining the result. The obtained
269 results are more accurate than running the test with an emulator, because
270 they reflect the exact kernel and system libraries that exist on the
273 Improved Sparse File Support
274 ----------------------------
275 Support for the FSCTL_SET_ZERO_DATA and FSCTL_QUERY_ALLOCATED_RANGES
276 SMB2 requests has been added to the smbd file server.
277 This allows for clients to deallocate (hole punch) regions within a
278 sparse file, and check which portions of a file are allocated.
281 ######################################################################
288 Parameter Name Description Default
289 -------------- ----------- -------
291 msdfs shuffle referrals New no
292 smbd profiling level New off
294 tls priority New NORMAL:-VERS-SSL3.0
296 change notify Changed to [global]
297 kernel change notify Changed to [global]
298 client max protocol Changed default SMB3_11
299 server max protocol Changed default SMB3_11
304 vfs_notify_fam - see section 'New FileChangeNotify subsystem'.
313 CHANGES SINCE 4.2.0rc4
314 ======================
316 o Andrew Bartlett <abartlet@samba.org>
317 * Bug 10973: No objectClass found in replPropertyMetaData on ordinary
318 objects (non-deleted)
319 * Bug 11429: Python bindings don't check integer types
320 * Bug 11430: Python bindings don't check array sizes
322 o Ralph Boehme <slow@samba.org>
323 * Bug 11467: Handling of 0 byte resource fork stream
325 o Volker Lendecke <vl@samba.org>
326 * Bug 11488: AD samr GetGroupsForUser fails for users with "()" in
329 o Stefan Metzmacher <metze@samba.org>
330 * Bug 11429: Python bindings don't check integer types
332 o Matthieu Patou <mat@matws.net>
333 * Bug 10973: No objectClass found in replPropertyMetaData on ordinary
334 objects (non-deleted)
337 CHANGES SINCE 4.2.0rc3
338 ======================
340 o Ralph Boehme <slow@samba.org>
341 * Bug 11444: Crash in notify_remove caused by change notify = no
343 o Günther Deschner <gd@samba.org>
344 * Bug 11411: smbtorture does not build when configured --with-system-mitkrb5
346 o Volker Lendecke <vl@samba.org>
347 * Bug 11455: fix recursion problem in rep_strtoll in lib/replace/replace.c
348 * Bug 11464: xid2sid gives inconsistent results
349 * Bug 11465: ctdb: Fix the build on FreeBSD 10.1
351 o Roel van Meer <roel@1afa.com>
352 * Bug 11427: nmbd incorrectly matches netbios names as own name
354 o Stefan Metzmacher <metze@samba.org>
355 * Bug 11451: Poor SMB3 encryption performance with AES-GCM
356 * Bug 11458: --bundled-libraries=!ldb,!pyldb,!pyldb-util doesn't
357 disable ldb build and install
359 o Andreas Schneider <asn@samba.org>
360 * Bug 9862: Samba "map to guest = Bad uid" doesn't work
363 CHANGES SINCE 4.3.0rc2
364 ======================
366 o Andrew Bartlett <abartlet@samba.org>
367 * Bug 11436: samba-tool uncaught exception error
368 * Bug 10493: revert LDAP extended rule 1.2.840.113556.1.4.1941
369 LDAP_MATCHING_RULE_IN_CHAIN changes
371 o Ralph Boehme <slow@samba.org>
372 * Bug 11278: Stream names with colon don't work with
373 fruit:encoding = native
374 * Bug 11426: net share allowedusers crashes
376 o Amitay Isaacs <amitay@gmail.com>
377 * Bug 11432: Fix crash in nested ctdb banning
378 * Bug 11434: Cannot build ctdbpmda
379 * Bug 11431: CTDB's eventscript error handling is broken
381 o Stefan Metzmacher <metze@samba.org>
382 * Bug 11451: Poor SMB3 encryption performance with AES-GCM (part1)
383 * Bug 11316: tevent_fd needs to be destroyed before closing the fd
385 o Arvid Requate <requate@univention.de>
386 * Bug 11291: NetApp joined to a Samba/ADDC cannot resolve SIDs
388 o Martin Schwenke <martin@meltin.net>
389 * Bug 11432: Fix crash in nested ctdb banning
392 CHANGES SINCE 4.3.0rc1
393 ======================
395 o Jeremy Allison <jra@samba.org>
396 * BUG 11359: strsep is not available on Solaris
398 o Björn Baumbach <bb@sernet.de>
399 * BUG 11421: Build with GPFS support is broken
401 o Justin Maggard <jmaggard@netgear.com>
402 * BUG 11320: "force group" with local group not working
404 o Martin Schwenke <martin@meltin.net>
405 * BUG 11424: Build broken with --disable-python