VERSION: Raise version number.
[Samba/gbeck.git] / WHATSNEW.txt
blob76cb29d8de029dd17f4bb04477039aabad7b594f
1                    ================================
2                    Release Notes for Samba 3.3.0rc2
3                           December, 15 2008
4                    ================================
6 This is the second release candidate of Samba 3.3.0.  This is *not*
7 intended for production environments and is designed for testing
8 purposes only.  Please report any defects via the Samba bug reporting
9 system at https://bugzilla.samba.org/.
11 Major enhancements in Samba 3.3.0 include:
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".
18  File Serving:
19  o Extended Cluster support.
21  Winbind:
22  o Simplified idmap configuration.
23  o New idmap backends "adex" and "hash".
24  o Added new parameter "winbind reconnect delay".
25  o Added support for user and group aliasing.
26  o Added support for multiple domains to idmap_ad.
28  Administrative tools:
29  o The destination "all" of smbcontrol does now affect all running
30    daemons including nmbd and winbindd.
31  o New 'net rpc vampire keytab' and 'net rpc vampire ldif' commands.
32  o The 'net' utility can now use kerberos for joining and authentication.
33  o The 'wbinfo' utility can now add, modify and remove identity mapping entries.
35  Libraries:
36  o NetApi library implements various new calls for User- and Group
37    Account Management.
40 Configure changes
41 =================
43 The configure option "--with-libdir" has been removed. The library
44 directory can still be specified by using the existing "--libdir" option.
45 A new option "--with-modulesdir" has been added to allow the specification
46 of a separate directory for the shared modules.
49 Configuration changes
50 =====================
52 The default value of "ldap ssl" has been changed to "start tls". This means,
53 Samba will use the LDAPv3 StartTLS extended operation (RFC2830) for
54 communicating with directory servers by default. If your directory servers
55 do not support this extended operation, you will have to set
56 "ldap ssl = no". Otherwise, Samba could not contact the directory servers
57 anymore!
60 Winbind idmap backend changes
61 =============================
63 The idmap configuration has changed with version 3.3 to something that
64 allows a smoother upgrade path from pre-3.0.25 configurations that use
65 "idmap backend". The reason for this change is that to many, also to Samba
66 developers, the 3.0.25 style configuration with "idmap config" turned out
67 to be very complex. Version 3.3 no longer deprecates the "idmap backend"
68 parameter, instead with "idmap backend" the default idmap backend is
69 specified.
71 Accordingly, the "idmap config <domain> : default = yes" setting is no
72 longer being looked at.
74 The alloc backend defaults to the default backend, which should be able to
75 allocate IDs. In the default distribution the tdb and ldap backends can
76 allocate, the ad and rid backends can not. The idmap alloc range is now
77 being set with the "old" parameters "idmap uid" and "idmap gid".
79 The "idmap domains" parameter has been removed.
82 winbind reconnect delay
83 =======================
85 This is a new parameter which specifies the number of seconds the Winbind
86 daemon will wait between attempts to contact a Domain controller for a domain
87 that is determined to be down or not contactable.
90 Winbind's Name Aliasing
91 =======================
93 Name aliasing in Winbind is a feature that allows an administrator to
94 map a fully qualified user or group name from a Windows domain to a
95 convenient short name for Unix access.  This is similar to the username
96 map functionality supported by smbd but is primary intended for
97 clients and servers making use of Winbind's PAM and NSS libraries.
99 For example, the user "DOMAIN\fred" has been mapped to the Unix name
100 "freddie".
102    $ getent passwd "DOMAIN\fred"
103    freddie:x:1000:1001:Fred Jones:/home/freddie:/bin/bash
105    $ getent passwd freddie
106    freddie:x:1000:1001:Fred Jones:/home/freddie:/bin/bash
108 The name aliasing support is provided by individual nss_info plugins.
109 For example, the new "adex" plugin reads the uid attribute from Active
110 Directory to make a short login name to the fully qualified name.
111 While the new "hash" module utilizes a local file to map "short_name
112 = QUALIFIED\name".  Both user and group name mapping is supported.
113 Please refer to the "winbind nss info" option in smb.conf(5) and
114 to individual plugin man pages for further details.
117 idmap_hash
118 ==========
120 The idmap_hash plugin provides similar support as the idmap_rid
121 module.  However, uids and gids are generated from the full domain
122 SID using a hashing algorithm that maps the lower 19 bits from the user
123 or group RID to bits 0 - 19 in the Unix id and hashes 96 bits from
124 the domain SID to bits 20 - 30 in the Unix id.  The result is a 31 bit
125 uid or gid that is consistent across machines and provides support for
126 trusted domains.
128 Please refer to the idmap_hash(8) man page for more details.
131 idmap_adex
132 ==========
134 The adex idmap/nss_info plugin is an adaptation of the Likewise
135 Enterprise plugin with support for OU based cells removed
136 (since the Windows pieces to manage the cells are not available).
138 This plugin supports
140       * The RFC2307 schema for users and groups.
141       * Connections to trusted domains
142       * Global catalog searches
143       * Cross forest trusts
144       * User and group aliases
146 Prerequisite: Add the following attributes to the Partial Attribute
147 Set in global catalog:
149       * uidNumber
150       * uid
151       * gidNumber
153 A basic config using the current trunk code would look like:
155 [global]
156         idmap backend = adex
157         idmap uid = 10000 - 29999
158         idmap gid = 10000 - 29999
159         winbind nss info = adex
161         winbind normalize names = yes
162         winbind refresh tickets = yes
163         template homedir = /home/%D/%U
164         template shell = /bin/bash
166 Please refer to the idmap_adex(8) man page for more details.
169 ######################################################################
170 Changes
171 #######
173 smb.conf changes
174 ----------------
176     Parameter Name                      Description     Default
177     --------------                      -----------     -------
178     cups connection timeout             New             30
179     idmap domains                       Removed
180     init logon delayed hosts            New             ""
181     init logon delay                    New             100
182     ldap ssl                            Changed Default start tls
183     winbind reconnect delay             New             30
186 Changes since 3.3.0rc1:
187 ------------------------
190 o   Jeremy Allison <jra@samba.org>
191     * BUG 1254: Fix "write list" in setups using "security = share".
192     * BUG 5937: Fix filenames with "*" char hiding other files.
193     * BUG 5953: Fix segfaults in smbclient.
194     * Fix usrmgr opening a user object as non-root.
197 o   Michael Adam <obnox@samba.org>
198     * BUG 3661: Add support for trusted domains to idmap_ad.
199     * Fix default backend handling for ad backends.
200     * Fix potential segfault in vfs_tsmsm.
201     * Fix several RHEL CTDB packaging issues.
204 o   Günther Deschner <gd@samba.org>
205     * BUG 5957: Do not abort rename process on valid rename script.
206     * Fix various potential memleaks in samr_SetUserInfo.
207     * Fix access bits in netapi.
210 o   Steve French <stevef@smf-t60p.smfdom>
211     * BUG 5934: Use USER environment in mount.cifs when no user is specified.
212     * variable
215 o   SATOH Fumiyasu <fumiyas@osstech.co.jp>
216     * BUG 5688: LPQ process is orphaned if socket address parameter is invalid.
217     * Vars for signals must be volatile sig_atomic_t.
220 o   Henning Henkel <henning.henkel@fh-furtwangen.de>
221     * BUG 5929: Fix build of vfs_prealloc with option --with-cluster-support and
222       GPFS.
225 o   Tomasz Krasuski <kr0tki@poczta.onet.pl>
226     * BUG 5928: Fix 'testparm --version'.
229 o   Jeff Layton <jlayton@redhat.com>
230     * Allow mounts to ipv6 capable servers in mount.cifs.
233 o   Volker Lendecke <vl@samba.org>
234     * Fix crash bug when freeing a non-malloc'ed buffer if the client sends a
235       non-encrypted packet with the crypto state set.
236     * Fix error code when smbclient puts a file over an existing directory.
237     * Pass the get_real_filename operation through the VFS.
240 o   Stefan Metzmacher <metze@samba.org>
241     * BUG 5749: Re-set acctflags while joining.
242     * Fix several issues concerning Alternate Data Streams.
243     * Fix valgrind bug lp_parm_const_string().
244     * Fix setting of trust passwords using 'net rpc trustdom add'.
245     * Correctly detect if the current dc is the closest one.
248 o   Tim Prouty <tprouty@samba.org>
249     * Fix a delete on close divergence from windows.
252 o   Dan Sledz <dsledz@isilon.com>
253     * Fix logging to syslog.
256 o   Yasuma Takeda <yasuma@osstech.co.jp>
257     * BUG 5944: Fix starting of nmbd with "socket address" set to "".
260 o   Bo Yang <boyang@novell.com>
261     * Fix script installmo.sh when no .po file exists.
264 ######################################################################
265 Reporting bugs & Development Discussion
266 #######################################
268 Please discuss this release on the samba-technical mailing list or by
269 joining the #samba-technical IRC channel on irc.freenode.net.
271 If you do report problems then please try to send high quality
272 feedback. If you don't provide vital information to help us track down
273 the problem then you will probably be ignored.  All bug reports should
274 be filed under the Samba 3.3 product in the project's Bugzilla
275 database (https://bugzilla.samba.org/).
278 ======================================================================
279 == Our Code, Our Bugs, Our Responsibility.
280 == The Samba Team
281 ======================================================================