vfs: Change the condition when to fill the getwd cache
[samba4-gss.git] / WHATSNEW.txt
blob9a056da48100aa40d19b3226b68ffb80b96a9140
1 Release Announcements
2 =====================
4 This is the first pre release of Samba 4.22.  This is *not*
5 intended for production environments and is designed for testing
6 purposes only.  Please report any defects via the Samba bug reporting
7 system at https://bugzilla.samba.org/.
9 Samba 4.22 will be the next version of the Samba suite.
12 UPGRADING
13 =========
16 NEW FEATURES/CHANGES
17 ====================
19 SMB3 Directory Leases
20 ---------------------
22 Starting with Samba 4.22 SMB3 Directory Leases are supported. The new global
23 option "smb3 directory leases" controls whether the feature is enabled or
24 not. By default, SMB3 Directory Leases are enabled on non-clustered Samba and
25 disabled on clustered Samba, based on the "clustering" option. See man smb.conf
26 for more details.
28 SMB3 Directory Leases allow clients to cache directory listings and, depending
29 on the workload, result in a decent reduction in SMB requests from clients.
31 Netlogon Ping over LDAP and LDAPS
32 ---------------------------------
34 Samba must query domain controller information via simple queries on
35 the AD rootdse's netlogon attribute. Typically this is done via
36 connectionless LDAP, using UDP on port 389. The same information is
37 also available via classic LDAP rootdse queries over TCP. Samba can
38 now be configured to use TCP via the new "client netlogon ping
39 protocol" parameter to enable running in environments where firewalls
40 completely block port 389 or UDP traffic to domain controllers.
42 REMOVED FEATURES
43 ================
45 The "nmbd proxy logon" feature was removed. This was used before
46 Samba4 acquired a NBT server.
48 The parameter "cldap port" has been removed. CLDAP runs over UDP port
49 389, we don't see a reason why this should ever be changed to a
50 different port. Moreover, we had several places in the code where
51 Samba did not respect this parameter, so the behaviour was at least
52 inconsistent.
54 fruit:posix_rename
55 ------------------
57 This option of the vfs_fruit VFS module that could be used to enable POSIX
58 directory rename behaviour for OS X clients has been removed as it could result
59 in severe problems for Windows clients.
61 As a possible workaround it is possible to prevent creation of .DS_Store files
62 (a Finder thingy to store directory view settings) on network mounts by running
64   $ defaults write com.apple.desktopservices DSDontWriteNetworkStores true
66 on the Mac.
69 smb.conf changes
70 ================
72   Parameter Name                          Description     Default
73   --------------                          -----------     -------
74   smb3 directory leases                   New             Auto
75   vfs mkdir use tmp name                  New             Auto
76   client netlogon ping protocol           New             cldap
77   fruit:posix_rename                      Removed
78   cldap port                              Removed
80 KNOWN ISSUES
81 ============
83 https://wiki.samba.org/index.php/Release_Planning_for_Samba_4.22#Release_blocking_bugs
86 #######################################
87 Reporting bugs & Development Discussion
88 #######################################
90 Please discuss this release on the samba-technical mailing list or by
91 joining the #samba-technical:matrix.org matrix room, or
92 #samba-technical IRC channel on irc.libera.chat
94 If you do report problems then please try to send high quality
95 feedback. If you don't provide vital information to help us track down
96 the problem then you will probably be ignored.  All bug reports should
97 be filed under the Samba 4.1 and newer product in the project's Bugzilla
98 database (https://bugzilla.samba.org/).
101 ======================================================================
102 == Our Code, Our Bugs, Our Responsibility.
103 == The Samba Team
104 ======================================================================