WHATSNEW: document fruit:resource option spelling issue
[samba.git] / WHATSNEW.txt
1 Release Announcements
2 =====================
3
4 This is the first preview release of Samba 4.6.  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/.
8
9 Samba 4.6 will be the next version of the Samba suite.
10
11
12 UPGRADING
13 =========
14
15 vfs_fruit option "fruit:resource" spelling correction
16 -----------------------------------------------------
17
18 Due to a spelling error in the vfs_fruit option parsing for the "fruit:resource"
19 option, users who have set this option in their smb.conf were still using the
20 default setting "fruit:resource = file" as the parser was looking for the string
21 "fruit:ressource" (two "s").
22
23 After upgrading to this Samba version 4.6, you MUST either remove the option
24 from your smb.conf or set it to the default "fruit:resource = file", otherwise
25 your macOS clients will not be able to access the resource fork data.
26
27 This version Samba 4.6 accepts both the correct and incorrect spelling, but the
28 next Samba version 4.7 will not accept the wrong spelling.
29
30 Users who were using the wrong spelling "ressource" with two "s" can keep the
31 setting, but are advised to switch to the correct spelling.
32
33 NEW FEATURES/CHANGES
34 ====================
35
36 kerberos client encryption types
37 --------------------------------
38 Some parts of Samba (most notably winbindd) perform Kerberos client
39 operations based on a Samba-generated krb5.conf file. A new
40 parameter, "kerberos encryption types" allows configuring the
41 encryption types set in this file, thereby allowing the user to
42 enforce strong or legacy encryption in Kerberos exchanges.
43
44 The default value of "all" is compatible with previous behavior, allowing
45 all encryption algorithms to be negotiated. Setting the parameter to "strong"
46 only allows AES-based algorithms to be negotiated. Setting the parameter to
47 "legacy" allows only RC4-HMAC-MD5 - the legacy algorithm for Active Directory.
48 This can solves some corner cases of mixed environments with Server 2003R2 and
49 newer DCs.
50
51
52 new option for owner inheritance
53 --------------------------------
54 The "inherit owner" smb.conf parameter instructs smbd to set the
55 owner of files to be the same as the parent directory's owner.
56 Up until now, this parameter could be set to "yes" or "no".
57 A new option, "unix only", enables this feature only for the UNIX owner
58 of the file, not affecting the SID owner in the Windows NT ACL of the
59 file. This can be used to emulate something very similar to folder quotas.
60
61
62 REMOVED FEATURES
63 ================
64
65
66 smb.conf changes
67 ================
68
69   Parameter Name                Description             Default
70   --------------                -----------             -------
71   kerberos encryption types     New                     all
72   inherit owner                 New option
73   fruit:resource                Spelling correction
74
75
76 KNOWN ISSUES
77 ============
78
79 Currently none.
80
81 #######################################
82 Reporting bugs & Development Discussion
83 #######################################
84
85 Please discuss this release on the samba-technical mailing list or by
86 joining the #samba-technical IRC channel on irc.freenode.net.
87
88 If you do report problems then please try to send high quality
89 feedback. If you don't provide vital information to help us track down
90 the problem then you will probably be ignored.  All bug reports should
91 be filed under the Samba 4.1 and newer product in the project's Bugzilla
92 database (https://bugzilla.samba.org/).
93
94
95 ======================================================================
96 == Our Code, Our Bugs, Our Responsibility.
97 == The Samba Team
98 ======================================================================
99