winbindd: speed up fill_grent_mem (i.e. winbindd_getgrent) a lot.
[Samba.git] / WHATSNEW.txt
blob19258661201c537e3ec119fd95aa787d7e7d8cc0
1                    ================================
2                    Release Notes for Samba 3.3.0rc1
3                            
4                    ================================
6 This is the first 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.
17  File Serving:
18  o Extended Cluster support.
20  Winbind:
21  o Simplified idmap configuration.
22  o New idmap backends "adex" and "hash".
23  o Added new parameter "winbind reconnect delay".
24  o Added support for user and group aliasing.
26  Administrative tools:
27  o The destination "all" of smbcontrol does now affect all running
28    daemons including nmbd and winbindd.
29  o New 'net rpc vampire keytab' and 'net rpc vampire ldif' commands.
30  o The 'net' utility can now use kerberos for joining and authentication.
32  Libraries:
33  o NetApi library implements various new calls for User- and Group
34    Account Management.
37 Configure changes
38 =================
40 The configure option "--with-libdir" has been removed. The library
41 directory can still be specified by using the existing "--libdir" option.
42 A new option "--with-modulesdir" has been added to allow the specification
43 of a separate directory for the shared modules.
46 Winbind idmap backend changes
47 =============================
49 The idmap configuration has changed with version 3.3 to something that
50 allows a smoother upgrade path from pre-3.0.25 configurations that use
51 "idmap backend". The reason for this change is that to many, also to Samba
52 developers, the 3.0.25 style configuration with "idmap config" turned out
53 to be very complex. Version 3.3 no longer deprecates the "idmap backend"
54 parameter, instead with "idmap backend" the default idmap backend is
55 specified.
57 Accordingly, the "idmap config <domain> : default = yes" setting is no
58 longer being looked at.
60 The alloc backend defaults to the default backend, which should be able to
61 allocate IDs. In the default distribution the tdb and ldap backends can
62 allocate, the ad and rid backends can not. The idmap alloc range is now
63 being set with the "old" parameters "idmap uid" and "idmap gid".
65 The "idmap domains" parameter has been removed.
68 winbind reconnect delay
69 =======================
71 This is a new parameter which specifies the number of seconds the Winbind
72 daemon will wait between attempts to contact a Domain controller for a domain
73 that is determined to be down or not contactable.
76 Winbind's Name Aliasing
77 =======================
79 Name aliasing in Winbind is a feature that allows an administrator to
80 map a fully qualified user or group name from a Windows domain to a
81 convenient short name for Unix access.  This is similar to the username
82 map functionality supported by smbd but is primary intended for
83 clients and servers making use of Winbind's PAM and NSS libraries.
85 For example, the user "DOMAIN\fred" has been mapped to the Unix name
86 "freddie".
88    $ getent passwd "DOMAIN\fred"
89    freddie:x:1000:1001:Fred Jones:/home/freddie:/bin/bash
91    $ getent passwd freddie
92    freddie:x:1000:1001:Fred Jones:/home/freddie:/bin/bash
94 The name aliasing support is provided by individual nss_info plugins.
95 For example, the new "adex" plugin reads the uid attribute from Active
96 Directory to make a short login name to the fully qualified name.
97 While the new "hash" module utilizes a local file to map "short_name
98 = QUALIFIED\name".  Both user and group name mapping is supported.
99 Please refer to the "winbind nss info" option in smb.conf(5) and
100 to individual plugin man pages for further details.
103 idmap_hash
104 ==========
106 The idmap_hash plugin provides similar support as the idmap_rid
107 module.  However, uids and gids are generated from the full domain
108 SID using a hashing algorithm that maps the lower 19 bits from the user
109 or group RID to bits 0 - 19 in the Unix id and hashes 96 bits from
110 the domain SID to bits 20 - 30 in the Unix id.  The result is a 31 bit
111 uid or gid that is consistent across machines and provides support for
112 trusted domains.
114 Please refer to the idmap_hash(8) man page for more details.
117 idmap_adex
118 ==========
120 The adex idmap/nss_info plugin is an adaptation of the Likewise
121 Enterprise plugin with support for OU based cells removed
122 (since the Windows pieces to manage the cells are not available).
124 This plugin supports
126       * The RFC2307 schema for users and groups.
127       * Connections to trusted domains
128       * Global catalog searches
129       * Cross forest trusts
130       * User and group aliases
132 Prerequisite: Add the following attributes to the Partial Attribute
133 Set in global catalog:
135       * uidNumber
136       * uid
137       * gidNumber
139 A basic config using the current trunk code would look like:
141 [global]
142         idmap backend = adex
143         idmap uid = 10000 - 29999
144         idmap gid = 10000 - 29999
145         winbind nss info = adex
147         winbind normalize names = yes
148         winbind refresh tickets = yes
149         template homedir = /home/%D/%U
150         template shell = /bin/bash
152 Please refer to the idmap_adex(8) man page for more details.
155 ######################################################################
156 Changes
157 #######
159 smb.conf changes
160 ----------------
162     Parameter Name                      Description     Default
163     --------------                      -----------     -------
164     cups connection timeout             New             30
165     idmap domains                       Removed
166     init logon delayed hosts            New             ""
167     init logon delay                    New             100
168     winbind reconnect delay             New             30
171 Changes since 3.3.0pre2:
172 ------------------------
175 o   Jeremy Allison <jra@samba.org>
176     * BUG 5080: Fix access to cups-printers with cups 1.3.4.
177     * BUG 5814: Fix Winbind crash bug while doing "rescan_trusted_domain".
178     * BUG 5818: Sort ACEs in smbcacl output properly and honor inheritance.
179     * BUG 5826: Fix truncated filenames when accessing old servers.
180     * Correctly fix smbclient to terminate on eof from server.
181     * Fix client timeout when searching for a large number of cups printers.
182     * Unify access checks for lsa server functions.
183     * Remove the requirement for ldap call made as root.
184     * Cope with MAXIMUM_ALLOWED_ACCESS requests when opening handles.
185     * Fix net rpc vampire, based on an *amazing* piece of debugging work by
186       "Cooper S. Blake" <the_analogkid@yahoo.com>.
189 o   Gerald (Jerry) Carter <jerry@samba.org>
190     * Use the same prerequisite for DDNS update as Windows XP.
191     * Make "lwinet ads dns register" honor the "interfaces" parameter.
194 o   Günther Deschner <gd@samba.org>
195     * Ensure consistency when reporting password complexity.
196     * Fix _lsa_GetUserName.
197     * Fix access check in _samr_QuerySecurity().
198     * _samr_DeleteUser needs to wipe out the user_handle on success.
199     * NetGroupEnum_r needs to handle servers with no groups.
202 o   Jeff Layton <jlayton@redhat.com>
203     * Have uppercase_string return success on NULL pointer in mount.cifs.
204     * Make mount.cifs return codes match the return codes for /bin/mount.
207 o   Volker Lendecke <vl@samba.org>
208     * BUG 5691: Fig smbd panic on Solaris.
209     * BUG 5840: Fix segfault in "rpcclient lsaaddacctrights".
210     * Fix a potential NULL deref in found by the IBM Checker.
211     * Fix an uninitialized variable found by the IBM Checker.
212     * Fix an unlikely memleak found by the IBM Checker.
213     * Fix some missing error handlings.
214     * Add workaround for domain joins using a netbios name which is different
215       from the hostname.
216     * Fix a valgrind error in idmap_ad_sids_to_unixids().
219 o   Derrell Lipman <derrell.lipman@unwireduniverse.com>
220     * BUG 5805: Don't close stdout when calling setup_logging multiple times.
223 o   Tim Prouty <tim.prouty@isilon.com>
224     * Fix several build warnings.
227 o   Andreas Schneider <mail@cynapses.org>
228     * Delete the krb5 ccname variable from the PAM environment if set.
231 Commit Highlights:
232 ------------------
234 o   Michael Adam <obnox@samba.org>
235     * BUG 5609: Remove configure option "--with-libdir" and add
236       "--with-modulesdir".
237     * Extend "net rpc vampire keytab" to support differential replication
238       and storing of kerberos keys.
239     * Rework internal logic of registry tdb code.
240     * Freeze autogenerated prototype headers (good bye "make proto").
243 o   Jeremy Allison <jra@samba.org>
244     * Add new "winbind reconnect delay" parameter.
245     * Make the change to smbcontrol for "all" to mean broadcast,
246       and "smbd" to mean the main smb daemon.
249 o   Gerald W. Carter <jerry@samba.org>
250     * Add support for name aliasing in Winbind.
251     * Add the idmap/nss-info provider from Likewise Open.
252     * Allow an admin to define the "uid" attribute for a RFC2307
253       user object in AD to be the username alias.
254     * Add new idmap backend "adex" to support RFC2307 enabled AD forests.
257 o   Guenther Deschner <gd@samba.org>
258     * BUG 5710: Fix changing of machine account passwords.
259     * Add "net rpc vampire keytab" and "net rpc vampire ldif".
262 o   Volker Lendecke <vl@samba.org>
263     * Rework of the Winbind idmap backend.
264     * Fix calculation of useable_space for trans2 and nttrans replies.
265     * Add mapping of generic bits when setting an NFSv4 ACL.
268 ######################################################################
269 Reporting bugs & Development Discussion
270 #######################################
272 Please discuss this release on the samba-technical mailing list or by
273 joining the #samba-technical IRC channel on irc.freenode.net.
275 If you do report problems then please try to send high quality
276 feedback. If you don't provide vital information to help us track down
277 the problem then you will probably be ignored.  All bug reports should
278 be filed under the Samba 3.3 product in the project's Bugzilla
279 database (https://bugzilla.samba.org/).
282 ======================================================================
283 == Our Code, Our Bugs, Our Responsibility.
284 == The Samba Team
285 ======================================================================