1 ==============================
2 Release Notes for Samba 4.16.3
4 ==============================
7 This is the latest stable release of the Samba 4.16 release series.
13 o Jeremy Allison <jra@samba.org>
14 * BUG 15099: Using vfs_streams_xattr and deleting a file causes a panic.
16 o Douglas Bagnall <douglas.bagnall@catalyst.net.nz>
17 * BUG 14986: Add support for bind 9.18.
18 * BUG 15076: logging dsdb audit to specific files does not work.
20 o Samuel Cabrero <scabrero@samba.org>
21 * BUG 14979: Problem when winbind renews Kerberos.
22 * BUG 15095: Samba with new lorikeet-heimdal fails to build on gcc 12.1 in
25 o Volker Lendecke <vl@samba.org>
26 * BUG 15105: Crash in streams_xattr because fsp->base_fsp->fsp_name is NULL.
27 * BUG 15118: Crash in rpcd_classic - NULL pointer deference in
30 o Noel Power <noel.power@suse.com>
31 * BUG 15100: smbclient commands del & deltree fail with
32 NT_STATUS_OBJECT_PATH_NOT_FOUND with DFS.
34 o Christof Schmitt <cs@samba.org>
35 * BUG 15120: Fix check for chown when processing NFSv4 ACL.
37 o Andreas Schneider <asn@samba.org>
38 * BUG 15082: The pcap background queue process should not be stopped.
39 * BUG 15097: testparm: Fix typo in idmap rangesize check.
40 * BUG 15106: net ads info returns LDAP server and LDAP server name as null.
41 * BUG 15108: ldconfig: /lib64/libsmbconf.so.0 is not a symbolic link.
43 o Martin Schwenke <martin@meltin.net>
44 * BUG 15090: CTDB child process logging does not work as expected.
47 #######################################
48 Reporting bugs & Development Discussion
49 #######################################
51 Please discuss this release on the samba-technical mailing list or by
52 joining the #samba-technical:matrix.org matrix room, or
53 #samba-technical IRC channel on irc.libera.chat.
55 If you do report problems then please try to send high quality
56 feedback. If you don't provide vital information to help us track down
57 the problem then you will probably be ignored. All bug reports should
58 be filed under the Samba 4.1 and newer product in the project's Bugzilla
59 database (https://bugzilla.samba.org/).
62 ======================================================================
63 == Our Code, Our Bugs, Our Responsibility.
65 ======================================================================
68 Release notes for older releases follow:
69 ----------------------------------------
70 ==============================
71 Release Notes for Samba 4.16.2
73 ==============================
76 This is the latest stable release of the Samba 4.16 release series.
82 o Jeremy Allison <jra@samba.org>
83 * BUG 15042: Use pathref fd instead of io fd in vfs_default_durable_cookie.
85 o Ralph Boehme <slow@samba.org>
86 * BUG 15069: vfs_gpfs with vfs_shadowcopy2 fail to restore file if original
87 file had been deleted.
89 o Samuel Cabrero <scabrero@samba.org>
90 * BUG 15087: netgroups support removed.
92 o Samuel Cabrero <scabrero@suse.de>
93 * BUG 14674: net ads info shows LDAP Server: 0.0.0.0 depending on contacted
96 o Volker Lendecke <vl@samba.org>
97 * BUG 15062: Update from 4.15 to 4.16 breaks discovery of [homes] on
98 standalone server from Win and IOS.
100 o Stefan Metzmacher <metze@samba.org>
101 * BUG 15071: waf produces incorrect names for python extensions with Python
104 o Noel Power <noel.power@suse.com>
105 * BUG 15075: smbclient -E doesn't work as advertised.
107 o Andreas Schneider <asn@samba.org>
108 * BUG 15071: waf produces incorrect names for python extensions with Python
110 * BUG 15081: The samba background daemon doesn't refresh the printcap cache
113 o Robert Sprowson <webpages@sprow.co.uk>
114 * BUG 14443: Out-by-4 error in smbd read reply max_send clamp..
117 #######################################
118 Reporting bugs & Development Discussion
119 #######################################
121 Please discuss this release on the samba-technical mailing list or by
122 joining the #samba-technical:matrix.org matrix room, or
123 #samba-technical IRC channel on irc.libera.chat.
125 If you do report problems then please try to send high quality
126 feedback. If you don't provide vital information to help us track down
127 the problem then you will probably be ignored. All bug reports should
128 be filed under the Samba 4.1 and newer product in the project's Bugzilla
129 database (https://bugzilla.samba.org/).
132 ======================================================================
133 == Our Code, Our Bugs, Our Responsibility.
135 ======================================================================
138 ----------------------------------------------------------------------
139 ==============================
140 Release Notes for Samba 4.16.1
142 ==============================
145 This is the latest stable release of the Samba 4.16 release series.
151 o Jeremy Allison <jra@samba.org>
152 * BUG 14831: Share and server swapped in smbget password prompt.
153 * BUG 15022: Durable handles won't reconnect if the leased file is written
155 * BUG 15023: rmdir silently fails if directory contains unreadable files and
156 hide unreadable is yes.
157 * BUG 15038: SMB2_CLOSE_FLAGS_FULL_INFORMATION fails to return information on
160 o Andrew Bartlett <abartlet@samba.org>
161 * BUG 8731: Need to describe --builtin-libraries= better (compare with
162 --bundled-libraries).
164 o Ralph Boehme <slow@samba.org>
165 * BUG 14957: vfs_shadow_copy2 breaks "smbd async dosmode" sync fallback.
166 * BUG 15035: shadow_copy2 fails listing snapshotted dirs with
169 o Samuel Cabrero <scabrero@samba.org>
170 * BUG 15046: PAM Kerberos authentication incorrectly fails with a clock skew
173 o Pavel Filipenský <pfilipen@redhat.com>
174 * BUG 15041: Username map - samba erroneously applies unix group memberships
175 to user account entries.
177 o Stefan Metzmacher <metze@samba.org>
178 * BUG 14951: KVNO off by 100000.
180 o Christof Schmitt <cs@samba.org>
181 * BUG 15027: Uninitialized litemask in variable in vfs_gpfs module.
182 * BUG 15055: vfs_gpfs recalls=no option prevents listing files.
184 o Andreas Schneider <asn@cryptomilk.org>
185 * BUG 15054: smbd doesn't handle UPNs for looking up names.
188 #######################################
189 Reporting bugs & Development Discussion
190 #######################################
192 Please discuss this release on the samba-technical mailing list or by
193 joining the #samba-technical:matrix.org matrix room, or
194 #samba-technical IRC channel on irc.libera.chat.
196 If you do report problems then please try to send high quality
197 feedback. If you don't provide vital information to help us track down
198 the problem then you will probably be ignored. All bug reports should
199 be filed under the Samba 4.1 and newer product in the project's Bugzilla
200 database (https://bugzilla.samba.org/).
203 ======================================================================
204 == Our Code, Our Bugs, Our Responsibility.
206 ======================================================================
209 ----------------------------------------------------------------------
210 ==============================
211 Release Notes for Samba 4.16.0
213 ==============================
215 This is the first stable release of the Samba 4.16 release series.
216 Please read the release notes carefully before upgrading.
222 New samba-dcerpcd binary to provide DCERPC in the member server setup
223 ---------------------------------------------------------------------
225 In order to make it much easier to break out the DCERPC services
226 from smbd, a new samba-dcerpcd binary has been created.
228 samba-dcerpcd can be used in two ways. In the normal case without
229 startup script modification it is invoked on demand from smbd or
230 winbind --np-helper to serve DCERPC over named pipes. Note that
231 in order to run in this mode the smb.conf [global] section has
232 a new parameter "rpc start on demand helpers = [true|false]".
233 This parameter is set to "true" by default, meaning no changes to
234 smb.conf files are needed to run samba-dcerpcd on demand as a named
237 It can also be used in a standalone mode where it is started
238 separately from smbd or winbind but this requires changes to system
239 startup scripts, and in addition a change to smb.conf, setting the new
240 [global] parameter "rpc start on demand helpers = false". If "rpc
241 start on demand helpers" is not set to false, samba-dcerpcd will
242 refuse to start in standalone mode.
244 Note that when Samba is run in the Active Directory Domain Controller
245 mode the samba binary that provides the AD code will still provide its
246 normal DCERPC services whilst allowing samba-dcerpcd to provide
247 services like SRVSVC in the same way that smbd used to in this
250 The parameters that allowed some smbd-hosted services to be started
251 externally are now gone (detailed below) as this is now the default
254 samba-dcerpcd can also be useful for use outside of the Samba
255 framework, for example, use with the Linux kernel SMB2 server ksmbd or
256 possibly other SMB2 server implementations.
258 Heimdal-8.0pre used for Samba Internal Kerberos, adds FAST support
259 ------------------------------------------------------------------
261 Samba has since Samba 4.0 included a snapshot of the Heimdal Kerberos
262 implementation. This snapshot has now been updated and will closely
263 match what will be released as Heimdal 8.0 shortly.
265 This is a major update, previously we used a snapshot of Heimdal from
266 2011, and brings important new Kerberos security features such as
267 Kerberos request armoring, known as FAST. This tunnels ticket
268 requests and replies that might be encrypted with a weak password
269 inside a wrapper built with a stronger password, say from a machine
272 In Heimdal and MIT modes Samba's KDC now supports FAST, for the
273 support of non-Windows clients.
275 Windows clients will not use this feature however, as they do not
276 attempt to do so against a server not advertising domain Functional
277 Level 2012. Samba users are of course free to modify how Samba
278 advertises itself, but use with Windows clients is not supported "out
281 Finally, Samba also uses a per-KDC, not per-realm 'cookie' to secure part of
282 the FAST protocol. A future version will align this more closely with
283 Microsoft AD behaviour.
285 If FAST needs to be disabled on your Samba KDC, set
291 The Samba project wishes to thank the numerous developers who have put
292 in a massive effort to make this possible over many years. In
293 particular we thank Stefan Metzmacher, Joseph Sutton, Gary Lockyer,
294 Isaac Boukris and Andrew Bartlett. Samba's developers in turn thank
295 their employers and in turn their customers who have supported this
296 effort over many years.
298 Certificate Auto Enrollment
299 ---------------------------
301 Certificate Auto Enrollment allows devices to enroll for certificates from
302 Active Directory Certificate Services. It is enabled by Group Policy.
303 To enable Certificate Auto Enrollment, Samba's group policy will need to be
304 enabled by setting the smb.conf option `apply group policies` to Yes. Samba
305 Certificate Auto Enrollment depends on certmonger, the cepces certmonger
306 plugin, and sscep. Samba uses sscep to download the CA root chain, then uses
307 certmonger paired with cepces to monitor the host certificate templates.
308 Certificates are installed in /var/lib/samba/certs and private keys are
309 installed in /var/lib/samba/private/certs.
311 Ability to add ports to dns forwarder addresses in internal DNS backend
312 -----------------------------------------------------------------------
314 The internal DNS server of Samba forwards queries non-AD zones to one or more
315 configured forwarders. Up until now it has been assumed that these forwarders
316 listen on port 53. Starting with this version it is possible to configure the
317 port using host:port notation. See smb.conf for more details. Existing setups
318 are not affected, as the default port is 53.
323 * The "recovery master" role has been renamed "leader"
325 Documentation and logs now refer to "leader".
327 The following ctdb tool command names have changed:
330 setrecmasterrole -> setleaderrole
332 Command output has changed for the following commands:
337 The "[legacy] -> recmaster capability" configuration option has been
338 renamed and moved to the cluster section, so this is now:
340 [cluster] -> leader capability
342 * The "recovery lock" has been renamed "cluster lock"
344 Documentation and logs now refer to "cluster lock".
346 The "[cluster] -> recovery lock" configuration option has been
347 deprecated and will be removed in a future version. Please use
348 "[cluster] -> cluster lock" instead.
350 If the cluster lock is enabled then traditional elections are not
351 done and leader elections use a race for the cluster lock. This
352 avoids various conditions where a node is elected leader but can not
353 take the cluster lock. Such conditions included:
355 - At startup, a node elects itself leader of its own cluster before
356 connecting to other nodes
358 - Cluster filesystem failover is slow
360 The abbreviation "reclock" is still used in many places, because a
361 better abbreviation eludes us (i.e. "clock" is obvious bad) and
362 changing all instances would require a lot of churn. If the
363 abbreviation "reclock" for "cluster lock" is confusing, please
364 consider mentally prefixing it with "really excellent".
366 * CTDB now uses leader broadcasts and an associated timeout to
367 determine if an election is required
369 The leader broadcast timeout can be configured via new configuration
372 [cluster] -> leader timeout
374 This specifies the number of seconds without leader broadcasts
375 before a node calls an election. The default is 5.
381 Older SMB1 protocol SMBCopy command removed
382 -------------------------------------------
384 SMB is a nearly 30-year old protocol, and some protocol commands that
385 while supported in all versions, have not seen widespread use.
387 One of those is SMBCopy, a feature for a server-side copy of a file.
388 This feature has been so unmaintained that Samba has no testsuite for
391 The SMB1 command SMB_COM_COPY (SMB1 command number 0x29) was
392 introduced in the LAN Manager 1.0 dialect and it was rendered obsolete
393 in the NT LAN Manager dialect.
395 Therefore it has been removed from the Samba smbd server.
397 We do note that a fully supported and tested server-side copy is
398 present in SMB2, and can be accessed with "scopy" subcommand in
401 SMB1 server-side wildcard expansion removed
402 -------------------------------------------
404 Server-side wildcard expansion is another feature that sounds useful,
405 but is also rarely used and has become problematic - imposing extra
406 work on the server (both in terms of code and CPU time).
408 In actual OS design, wildcard expansion is handled in the local shell,
409 not at the remote server using SMB wildcard syntax (which is not shell
412 In Samba 4.16 the ability to process file name wildcards in requests
413 using the SMB1 commands SMB_COM_RENAME (SMB1 command number 0x7),
414 SMB_COM_NT_RENAME (SMB1 command number 0xA5) and SMB_COM_DELETE (SMB1
415 command number 0x6) has been removed.
417 SMB1 protocol has been deprecated, particularly older dialects
418 --------------------------------------------------------------
420 We take this opportunity to remind that we have deprecated and
421 disabled by default, but not removed, the whole SMB1 protocol since
422 Samba 4.11. If needed for security purposes or code maintenance we
423 will continue to remove older protocol commands and dialects that are
424 unused or have been replaced in more modern SMB1 versions.
426 We specifically deprecate the older dialects older than "NT LM 0.12"
427 (also known as "NT LANMAN 1.0" and "NT1").
429 Please note that "NT LM 0.12" is the dialect used by software as old
430 as Windows 95, Windows NT and Samba 2.0, so this deprecation applies
431 to DOS and similar era clients.
433 We do reassure that that 'simple' operation of older clients than
434 these (eg DOS) will, while untested, continue for the near future, our
435 purpose is not to cripple use of Samba in unique situations, but to
436 reduce the maintaince burden.
438 Eventually SMB1 as a whole will be removed, but no broader change is
441 In the rare case where the above changes cause incompatibilities,
442 users requiring support for these features will need to use older
445 No longer using Linux mandatory locks for sharemodes
446 ====================================================
448 smbd mapped sharemodes to Linux mandatory locks. This code in the Linux kernel
449 was broken for a long time, and is planned to be removed with Linux 5.15. This
450 Samba release removes the usage of mandatory locks for sharemodes and the
451 "kernel share modes" config parameter is changed to default to "no". The Samba
452 VFS interface is kept, so that file-system specific VFS modules can still use
453 private calls for enforcing sharemodes.
459 Parameter Name Description Default
460 -------------- ----------- -------
461 kernel share modes New default No
462 dns forwarder Changed
465 rpc start on demand helpers Added true
468 CHANGES SINCE 4.16.0rc5
469 =======================
471 o Andrew Bartlett <abartlet@samba.org>
472 * BUG 15000: Memory leak in FAST cookie handling.
474 o Elia Geretto <elia.f.geretto@gmail.com>
475 * BUG 14983: NT_STATUS_ACCESS_DENIED translates into EPERM instead of EACCES
476 in SMBC_server_internal.
478 o Stefan Metzmacher <metze@samba.org>
479 * BUG 13879: Simple bind doesn't work against an RODC (with non-preloaded
481 * BUG 14641: Crash of winbind on RODC.
482 * BUG 15001: LDAP simple binds should honour "old password allowed period".
483 * BUG 15002: S4U2Self requests don't work against servers without FAST
485 * BUG 15003: wbinfo -a doesn't work reliable with upn names.
486 * BUG 15005: A cross-realm kerberos client exchanges fail using KDCs with and
488 * BUG 15015: PKINIT: hdb_samba4_audit: Unhandled hdb_auth_status=9 =>
491 o Garming Sam <garming@catalyst.net.nz>
492 * BUG 13879: Simple bind doesn't work against an RODC (with non-preloaded
495 o Andreas Schneider <asn@samba.org>
496 * BUG 15016: Regression: create krb5 conf = yes doesn't work with a single
499 o Joseph Sutton <josephsutton@catalyst.net.nz>
500 * BUG 15015: PKINIT: hdb_samba4_audit: Unhandled hdb_auth_status=9 =>
504 CHANGES SINCE 4.16.0rc4
505 =======================
507 o Jeremy Allison <jra@samba.org>
508 * BUG 14737: Samba does not response STATUS_INVALID_PARAMETER when opening 2
509 objects with same lease key.
511 o Jule Anger <janger@samba.org>
512 * BUG 14999: Listing shares with smbstatus no longer works.
514 o Douglas Bagnall <douglas.bagnall@catalyst.net.nz>
515 * BUG 14996: Fix ldap simple bind with TLS auditing.
517 o Andrew Bartlett <abartlet@samba.org>
518 * BUG 14995: Use Heimdal 8.0 (pre) rather than an earlier snapshot.
520 o Volker Lendecke <vl@samba.org>
521 * BUG 14989: Fix a use-after-free in SMB1 server.
523 o Stefan Metzmacher <metze@samba.org>
524 * BUG 14865: Uncached logon on RODC always fails once.
525 * BUG 14984: Changing the machine password against an RODC likely destroys
527 * BUG 14993: authsam_make_user_info_dc() steals memory from its struct
528 ldb_message *msg argument.
529 * BUG 14995: Use Heimdal 8.0 (pre) rather than an earlier snapshot.
531 o Joseph Sutton <josephsutton@catalyst.net.nz>
532 * BUG 14995: Use Heimdal 8.0 (pre) rather than an earlier snapshot.
535 CHANGES SINCE 4.16.0rc3
536 =======================
538 o Samuel Cabrero <scabrero@suse.de>
539 * BUG 14979: Problem when winbind renews Kerberos.
541 o Björn Jacke <bj@sernet.de>
542 * BUG 13631: DFS fix for AIX broken.
543 * BUG 14974: Solaris and AIX acl modules: wrong function arguments.
544 * BUG 7239: Function aixacl_sys_acl_get_file not declared / coredump.
546 o Andreas Schneider <asn@samba.org>
547 * BUG 14967: Samba autorid fails to map AD users if id rangesize fits in the
550 o Martin Schwenke <martin@meltin.net>
551 * BUG 14958: CTDB can get stuck in election and recovery.
554 CHANGES SINCE 4.16.0rc2
555 =======================
557 o Jeremy Allison <jra@samba.org>
558 * BUG 14169: Renaming file on DFS root fails with
559 NT_STATUS_OBJECT_PATH_NOT_FOUND.
560 * BUG 14938: NT error code is not set when overwriting a file during rename
563 o Ralph Boehme <slow@samba.org>
564 * BUG 14674: net ads info shows LDAP Server: 0.0.0.0 depending on contacted
567 o Pavel Filipenský <pfilipen@redhat.com>
568 * BUG 14971: virusfilter_vfs_openat: Not scanned: Directory or special file.
570 o Volker Lendecke <vl@samba.org>
571 * BUG 14900: Regression: Samba 4.15.2 on macOS segfaults intermittently
572 during strcpy in tdbsam_getsampwnam.
573 * BUG 14975: Fix a crash in vfs_full_audit - CREATE_FILE can free a used fsp.
575 o Stefan Metzmacher <metze@samba.org>
576 * BUG 14968: smb2_signing_decrypt_pdu() may not decrypt with
577 gnutls_aead_cipher_decrypt() from gnutls before 3.5.2.
579 o Andreas Schneider <asn@samba.org>
580 * BUG 14960: SDB uses HDB flags directly which can lead to unwanted side
584 CHANGES SINCE 4.16.0rc1
585 =======================
587 o Jeremy Allison <jra@samba.org>
588 * BUG 14911: CVE-2021-44141: UNIX extensions in SMB1 disclose whether the
589 outside target of a symlink exists.
591 o Ralph Boehme <slow@samba.org>
592 * BUG 14914: CVE-2021-44142: Out-of-Bound Read/Write on Samba vfs_fruit
594 * BUG 14961: install elasticsearch_mappings.json
596 o FeRD (Frank Dana) <ferdnyc@gmail.com>
597 * BUG 14947: samba-bgqd still notifying systemd, triggering log warnings
598 without NotifyAccess=all.
600 o Stefan Metzmacher <metze@samba.org>
601 * BUG 14867: Printing no longer works on Windows 7 with 2021-10 monthly
603 * BUG 14956: ndr_push_string() adds implicit termination for
604 STR_NOTERM|REMAINING empty strings.
606 o Joseph Sutton <josephsutton@catalyst.net.nz>
607 * BUG 14950: CVE-2022-0336: Re-adding an SPN skips subsequent SPN conflict
614 https://wiki.samba.org/index.php/Release_Planning_for_Samba_4.16#Release_blocking_bugs
617 #######################################
618 Reporting bugs & Development Discussion
619 #######################################
621 Please discuss this release on the samba-technical mailing list or by
622 joining the #samba-technical:matrix.org matrix room, or
623 #samba-technical IRC channel on irc.libera.chat
625 If you do report problems then please try to send high quality
626 feedback. If you don't provide vital information to help us track down
627 the problem then you will probably be ignored. All bug reports should
628 be filed under the Samba 4.1 and newer product in the project's Bugzilla
629 database (https://bugzilla.samba.org/).
632 ======================================================================
633 == Our Code, Our Bugs, Our Responsibility.
635 ======================================================================