build_docs: Use 'make distclean' instead of 'make clean'.
[sfrench/samba-autobuild/.git] / WHATSNEW.txt
1                    =============================
2                    Release Notes for Samba 3.3.0
3                           January, 27 2009
4                    =============================
5
6 This is the first stable release of Samba 3.3.0.
7
8 Major enhancements in Samba 3.3.0 include:
9
10  General changes:
11  o The passdb tdbsam version has been raised.
12
13  Configuration/installation:
14  o Splitting of library directory into library directory and separate
15    modules directory.
16  o The default value of "ldap ssl" has been changed to "start tls".
17
18  File Serving:
19  o Extended Cluster support.
20  o New experimental VFS modules "vfs_acl_xattr" and "vfs_acl_tdb"
21    to store NTFS ACLs on Samba file servers.
22
23  Winbind:
24  o Simplified idmap configuration.
25  o New idmap backends "adex" and "hash".
26  o Added new parameter "winbind reconnect delay".
27  o Added support for user and group aliasing.
28  o Added support for multiple domains to idmap_ad.
29
30  Administrative tools:
31  o The destination "all" of smbcontrol does now affect all running
32    daemons including nmbd and winbindd.
33  o New 'net rpc vampire keytab' and 'net rpc vampire ldif' commands.
34  o The 'net' utility can now use kerberos for joining and authentication.
35  o The 'wbinfo' utility can now add, modify and remove identity mapping entries.
36
37  Libraries:
38  o NetApi library implements various new calls for User- and Group
39    Account Management.
40
41
42 General changes
43 ===============
44
45 The passdb tdbsam version has been raised as among other things the RID counter
46 has been moved from the winbindd_idmap.tdb to the passdb.tdb file to make
47 "passdb backend = tdbsam" working in clustered environments.
48
49 Please note that an updated passdb.tdb file is _not_ compatible with Samba
50 versions before 3.3.0! Please backup your passdb.tdb file if
51 you use "passdb backend = tdbsam". That can be achieved by running
52
53 'tdbbackup /etc/samba/passdb.tdb'
54
55 before the update.
56
57
58 Configure changes
59 =================
60
61 The configure option "--with-libdir" has been removed. The library
62 directory can still be specified by using the existing "--libdir" option.
63 A new option "--with-modulesdir" has been added to allow the specification
64 of a separate directory for the shared modules.
65
66
67 Configuration changes
68 =====================
69
70 The default value of "ldap ssl" has been changed to "start tls". This means,
71 Samba will use the LDAPv3 StartTLS extended operation (RFC2830) for
72 communicating with directory servers by default. If your directory servers
73 do not support this extended operation, you will have to set
74 "ldap ssl = no". Otherwise, Samba could not contact the directory servers
75 anymore!
76
77
78 Winbind idmap backend changes
79 =============================
80
81 The idmap configuration has changed with version 3.3 to something that
82 allows a smoother upgrade path from pre-3.0.25 configurations that use
83 "idmap backend". The reason for this change is that to many, also to Samba
84 developers, the 3.0.25 style configuration with "idmap config" turned out
85 to be very complex. Version 3.3 no longer deprecates the "idmap backend"
86 parameter, instead with "idmap backend" the default idmap backend is
87 specified.
88
89 Accordingly, the "idmap config <domain> : default = yes" setting is no
90 longer being looked at.
91
92 The alloc backend defaults to the default backend, which should be able to
93 allocate IDs. In the default distribution the tdb and ldap backends can
94 allocate, the ad and rid backends can not. The idmap alloc range is now
95 being set with the "old" parameters "idmap uid" and "idmap gid".
96
97 The "idmap domains" parameter has been removed.
98
99
100 winbind reconnect delay
101 =======================
102
103 This is a new parameter which specifies the number of seconds the Winbind
104 daemon will wait between attempts to contact a Domain controller for a domain
105 that is determined to be down or not contactable.
106
107
108 Winbind's Name Aliasing
109 =======================
110
111 Name aliasing in Winbind is a feature that allows an administrator to
112 map a fully qualified user or group name from a Windows domain to a
113 convenient short name for Unix access.  This is similar to the username
114 map functionality supported by smbd but is primary intended for
115 clients and servers making use of Winbind's PAM and NSS libraries.
116
117 For example, the user "DOMAIN\fred" has been mapped to the Unix name
118 "freddie".
119
120    $ getent passwd "DOMAIN\fred"
121    freddie:x:1000:1001:Fred Jones:/home/freddie:/bin/bash
122
123    $ getent passwd freddie
124    freddie:x:1000:1001:Fred Jones:/home/freddie:/bin/bash
125
126 The name aliasing support is provided by individual nss_info plugins.
127 For example, the new "adex" plugin reads the uid attribute from Active
128 Directory to make a short login name to the fully qualified name.
129 While the new "hash" module utilizes a local file to map "short_name
130 = QUALIFIED\name".  Both user and group name mapping is supported.
131 Please refer to the "winbind nss info" option in smb.conf(5) and
132 to individual plugin man pages for further details.
133
134
135 idmap_hash
136 ==========
137
138 The idmap_hash plugin provides similar support as the idmap_rid
139 module.  However, uids and gids are generated from the full domain
140 SID using a hashing algorithm that maps the lower 19 bits from the user
141 or group RID to bits 0 - 19 in the Unix id and hashes 96 bits from
142 the domain SID to bits 20 - 30 in the Unix id.  The result is a 31 bit
143 uid or gid that is consistent across machines and provides support for
144 trusted domains.
145
146 Please refer to the idmap_hash(8) man page for more details.
147
148
149 idmap_adex
150 ==========
151
152 The adex idmap/nss_info plugin is an adaptation of the Likewise
153 Enterprise plugin with support for OU based cells removed
154 (since the Windows pieces to manage the cells are not available).
155
156 This plugin supports
157
158       * The RFC2307 schema for users and groups.
159       * Connections to trusted domains
160       * Global catalog searches
161       * Cross forest trusts
162       * User and group aliases
163
164 Prerequisite: Add the following attributes to the Partial Attribute
165 Set in global catalog:
166
167       * uidNumber
168       * uid
169       * gidNumber
170
171 A basic config using the current trunk code would look like:
172
173 [global]
174         idmap backend = adex
175         idmap uid = 10000 - 29999
176         idmap gid = 10000 - 29999
177         winbind nss info = adex
178
179         winbind normalize names = yes
180         winbind refresh tickets = yes
181         template homedir = /home/%D/%U
182         template shell = /bin/bash
183
184 Please refer to the idmap_adex(8) man page for more details.
185
186
187 ######################################################################
188 Changes
189 #######
190
191 smb.conf changes
192 ----------------
193
194     Parameter Name                      Description     Default
195     --------------                      -----------     -------
196     cups connection timeout             New             30
197     idmap config DOM:range              Removed
198     idmap domains                       Removed
199     init logon delayed hosts            New             ""
200     init logon delay                    New             100
201     ldap ssl                            Changed Default start tls
202     winbind reconnect delay             New             30
203
204
205 Changes since 3.3.0rc2:
206 -----------------------
207
208
209 o   Jeremy Allison <jra@samba.org>
210     * BUG 5979: Fix level 2 oplocks being granted improperly.
211     * BUG 5980: Race condition when granting level2 oplocks can cause break
212       notify to be missed.
213     * BUG 5986: Editing a stream is broken (rename problems).
214     * BUG 5990: Strict allocate should be checked before ftruncate.
215     * BUG 6009: Setting "min receivefile size = 1" breaks writes.
216     * Fix gcc 4.3.2 warnings.
217     * Fix more asprintf errors and error code paths.
218
219
220 o   Michael Adam <obnox@samba.org>
221     * Fix build of pam_winbind.so on older Linux systems.
222     * Packaging RHEL-CTDB: Fix build of [u]mount.cifs.
223     * Prevent access to root filesystem when connecting with empty service name.
224
225
226 o   Kai Blin <kai@samba.org>
227     * BUG 5953: Fix smbclient crashes.
228
229
230 o   Gerald (Jerry) Carter <jerry@samba.org>
231     * Fix "allow trusted domain" so it disables trusted domains.
232
233
234 o   SATOH Fumiyasu <fumiyas@osstech.jp>
235     * Fix gmem->numgids and gmem->maxgids breakage on Solaris 64-bit.
236     * Fix SIGBUS on non-x86 CPUs in libsmbclient.
237     * Fix a compile-time warning.
238
239
240 o   Holger Hetterich <hhetter@novell.com>
241     * Add a simple tdb integrity check to tdbtool.
242
243
244 o   Björn Jacke <bj@sernet.de>
245     * Correct the description of the "ldap timeout" parameter.
246
247
248 o   Volker Lendecke <vl@samba.org>
249     * BUG 5913: Fix build error with at least GCC 4.2.2.
250     * BUG 5933: Fix incrementing/decrementing of num_validated_vuids.
251     * BUG 5953: Make cli_send_smb_direct_writeX use writev.
252     * BUG 5969: Optimize smbclient put command.
253     * BUG 6012: Add "get_real_filename" to full_audit.
254     * BUG 6014: Fix segfault when calling mget without arguments.
255     * Fix a spinning smbd when printing.
256     * Fix a memory leak in cups_pull_comment_location.
257     * Fix a valgrind error.
258     * Fix a "ignoring function call result" warning.
259     * Fix some C++ warnings.
260     * Fix an ancient uninitialized variable read.
261     * Fix a bad memleak in vfs_full_audit.
262
263
264 o   Stefan Metzmacher <metze@samba.org>
265     * net_status: Use dbwrap to open sessionid.tdb.
266     * Fix dbwrap_store_uint32() to match dbwrap_store_int32().
267     * Make marshalling struct samu from and to a buffer more generic.
268     * Store the next rid counter in passdb.tdb instead of winbind_idmap.tdb.
269     * Register the client connection via CTDB_CONTROL_TCP_ADD.
270     * Don't need to call messaging_reinit() twice.
271     * Raise TDBSAM_VERSION.
272
273
274 o   Lars Müller <lars@samba.org>
275     * Tweak with pam defines of older Linux versions.
276
277
278 o   Tim Prouty <tprouty@samba.org>
279     * Fix stream marshalling to return the correct streaminfo status.
280
281
282 o   Karolin Seeger <kseeger@samba.org>
283     * Change default value of "ldap ssl" to "start tls".
284     * Update version number in the manpages.
285     * Fix several small issues and typos in the manpages.
286
287
288 ######################################################################
289 Reporting bugs & Development Discussion
290 #######################################
291
292 Please discuss this release on the samba-technical mailing list or by
293 joining the #samba-technical IRC channel on irc.freenode.net.
294
295 If you do report problems then please try to send high quality
296 feedback. If you don't provide vital information to help us track down
297 the problem then you will probably be ignored.  All bug reports should
298 be filed under the Samba 3.3 product in the project's Bugzilla
299 database (https://bugzilla.samba.org/).
300
301
302 ======================================================================
303 == Our Code, Our Bugs, Our Responsibility.
304 == The Samba Team
305 ======================================================================
306