WHATSNEW: Update changes.
[Samba.git] / WHATSNEW.txt
blob2530e741af35e8961b0324fb477870b6b6287abc
1                    ================================
2                    Release Notes for Samba 3.3.0rc1
3                           November, 27 2008
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.
31  o The 'wbinfo' utility can now add, modify and remove identity mapping entries.
33  Libraries:
34  o NetApi library implements various new calls for User- and Group
35    Account Management.
38 Configure changes
39 =================
41 The configure option "--with-libdir" has been removed. The library
42 directory can still be specified by using the existing "--libdir" option.
43 A new option "--with-modulesdir" has been added to allow the specification
44 of a separate directory for the shared modules.
47 Winbind idmap backend changes
48 =============================
50 The idmap configuration has changed with version 3.3 to something that
51 allows a smoother upgrade path from pre-3.0.25 configurations that use
52 "idmap backend". The reason for this change is that to many, also to Samba
53 developers, the 3.0.25 style configuration with "idmap config" turned out
54 to be very complex. Version 3.3 no longer deprecates the "idmap backend"
55 parameter, instead with "idmap backend" the default idmap backend is
56 specified.
58 Accordingly, the "idmap config <domain> : default = yes" setting is no
59 longer being looked at.
61 The alloc backend defaults to the default backend, which should be able to
62 allocate IDs. In the default distribution the tdb and ldap backends can
63 allocate, the ad and rid backends can not. The idmap alloc range is now
64 being set with the "old" parameters "idmap uid" and "idmap gid".
66 The "idmap domains" parameter has been removed.
69 winbind reconnect delay
70 =======================
72 This is a new parameter which specifies the number of seconds the Winbind
73 daemon will wait between attempts to contact a Domain controller for a domain
74 that is determined to be down or not contactable.
77 Winbind's Name Aliasing
78 =======================
80 Name aliasing in Winbind is a feature that allows an administrator to
81 map a fully qualified user or group name from a Windows domain to a
82 convenient short name for Unix access.  This is similar to the username
83 map functionality supported by smbd but is primary intended for
84 clients and servers making use of Winbind's PAM and NSS libraries.
86 For example, the user "DOMAIN\fred" has been mapped to the Unix name
87 "freddie".
89    $ getent passwd "DOMAIN\fred"
90    freddie:x:1000:1001:Fred Jones:/home/freddie:/bin/bash
92    $ getent passwd freddie
93    freddie:x:1000:1001:Fred Jones:/home/freddie:/bin/bash
95 The name aliasing support is provided by individual nss_info plugins.
96 For example, the new "adex" plugin reads the uid attribute from Active
97 Directory to make a short login name to the fully qualified name.
98 While the new "hash" module utilizes a local file to map "short_name
99 = QUALIFIED\name".  Both user and group name mapping is supported.
100 Please refer to the "winbind nss info" option in smb.conf(5) and
101 to individual plugin man pages for further details.
104 idmap_hash
105 ==========
107 The idmap_hash plugin provides similar support as the idmap_rid
108 module.  However, uids and gids are generated from the full domain
109 SID using a hashing algorithm that maps the lower 19 bits from the user
110 or group RID to bits 0 - 19 in the Unix id and hashes 96 bits from
111 the domain SID to bits 20 - 30 in the Unix id.  The result is a 31 bit
112 uid or gid that is consistent across machines and provides support for
113 trusted domains.
115 Please refer to the idmap_hash(8) man page for more details.
118 idmap_adex
119 ==========
121 The adex idmap/nss_info plugin is an adaptation of the Likewise
122 Enterprise plugin with support for OU based cells removed
123 (since the Windows pieces to manage the cells are not available).
125 This plugin supports
127       * The RFC2307 schema for users and groups.
128       * Connections to trusted domains
129       * Global catalog searches
130       * Cross forest trusts
131       * User and group aliases
133 Prerequisite: Add the following attributes to the Partial Attribute
134 Set in global catalog:
136       * uidNumber
137       * uid
138       * gidNumber
140 A basic config using the current trunk code would look like:
142 [global]
143         idmap backend = adex
144         idmap uid = 10000 - 29999
145         idmap gid = 10000 - 29999
146         winbind nss info = adex
148         winbind normalize names = yes
149         winbind refresh tickets = yes
150         template homedir = /home/%D/%U
151         template shell = /bin/bash
153 Please refer to the idmap_adex(8) man page for more details.
156 ######################################################################
157 Changes
158 #######
160 smb.conf changes
161 ----------------
163     Parameter Name                      Description     Default
164     --------------                      -----------     -------
165     cups connection timeout             New             30
166     idmap domains                       Removed
167     init logon delayed hosts            New             ""
168     init logon delay                    New             100
169     winbind reconnect delay             New             30
172 Changes since 3.3.0pre2:
173 ------------------------
175 o   Michael Adam <obnox@samba.org>
176     * Fix eventlog crash.
177     * Make keytab filename argument mandatory to "net rpc vampire keytab".
178     * Add domain prefix to username in lookup_groupmem().
179     * Honour "winbind use default domain" in lookup_groupmem().
180     * Sanely handle NULL domain in add_member().
181     * Don't list the domain twice when expanding internal aliases.
182     * Prevent negative GM/ cache entries due to broken connections.
183     * Use the reconnect methods instead of the rpc methods directly.
186 o   Jeremy Allison <jra@samba.org>
187     * BUG 5080: Fix access to cups-printers with cups 1.3.4.
188     * BUG 5814: Fix Winbind crash bug while doing "rescan_trusted_domain".
189     * BUG 5818: Sort ACEs in smbcacl output properly and honor inheritance.
190     * BUG 5825: Fix account locking with an LDAP backend.
191     * BUG 5826: Fix truncated filenames when accessing old servers.
192     * BUG 5873: Fix ACL inheritance.
193     * BUG 5889: Fix "delete veto files = no".
194     * BUG 5891: Fix smbd crash when viewing the eventlog exported by "eventlog
195       list".
196     * BUG 5900: Fix vfs_readonly.
197     * BUG 5903: Fix breaking of file contents in vfs_streams_xattr.
198     * BUG 5904: Fix SIGABRT while servicing getaddrinfo() request caused by
199       libnss_wins.
200     * BUG 5914: Fix redefinition of struct name_list.
201     * Correctly fix smbclient to terminate on eof from server.
202     * Fix client timeout when searching for a large number of cups printers.
203     * Unify access checks for lsa server functions.
204     * Remove the requirement for ldap call made as root.
205     * Cope with MAXIMUM_ALLOWED_ACCESS requests when opening handles.
206     * Fix net rpc vampire, based on an *amazing* piece of debugging work by
207       "Cooper S. Blake" <the_analogkid@yahoo.com>.
208     * Fix memory leak in error path, spotted by Martin Zielinski <mz@seh.de>.
209     * Add vfs_acl_tdb.c module to do ACLs completely in userspace.
210     * Use fxattr calls whenever possible (trying to work around the strange
211       Linux kernel oplock bug).
214 o   Kai Blin <kai@samba.org>
215     * BUG 5892: Fix net rap printq info documentation.
216     * Add placeholder functions to libwbclient.
219 o   Gerald (Jerry) Carter <jerry@samba.org>
220     * Use the same prerequisite for DDNS update as Windows XP.
221     * Make "lwinet ads dns register" honor the "interfaces" parameter.
224 o   Steven Danneman <steven.danneman@isilon.com>
225     * Add options to manage identity mapping entries to wbinfo and Winbind.
226     * Fix to allow setting of NULL DACL/SACL.
229 o   Günther Deschner <gd@samba.org>
230     * BUG 5888: Fix remote rpc service management.
231     * Ensure consistency when reporting password complexity.
232     * Fix _lsa_GetUserName.
233     * Fix access check in _samr_QuerySecurity().
234     * _samr_DeleteUser needs to wipe out the user_handle on success.
235     * NetGroupEnum_r needs to handle servers with no groups.
236     * Fix numerous netapi issues.
237     * Add support for partial and delta netlogon replication in
238       "net rpc vampire".
239     * Add automatic machine password update in Winbind for member servers.
240     * Add German internalization for pam_winbind.
241     * Add Winbind krb5 locator plugin manpage.
242     * Add new wbclient wbcLookupDomainControllerEx call.
243     * Use autogenerated DCE/RPC routines for one more call on SVCCTL
244       named pipe.
245     * Use autogenerated NBT routines from Samba4 for Mailslot/CLDAP
246       parsing.
247     * Fix Winbind password change code for Windows 2000 DCs.
248     * Fix PNP_HwProfInfo NDR parsing.
249     * Add wbclient wbcLogonUser and wbcLogoffUserEx functions.
250     * Add automatic home directory creation for pam_winbind.
253 o   Mathias Dietz <MDIETZ@de.ibm.com>
254     * Search for gpfs functions in both libgpfs_gpl.so an libgpfs.so.
257 o   Dina Fine <dina@exanet.com>
258     * BUG 5908: Fix internal change notify on share directories.
261 o   Nils Goroll <nils.goroll@hamburg.de>
262     * BUG 5135: Prevent calling POSIX ACL vfs methods on zfs share.
263     * BUG 5446: Prevent calling POSIX ACL vfs methods on zfs share.
266 o   Jeff Layton <jlayton@redhat.com>
267     * Have uppercase_string return success on NULL pointer in mount.cifs.
268     * Make mount.cifs return codes match the return codes for /bin/mount.
271 o   Volker Lendecke <vl@samba.org>
272     * BUG 5691: Fig smbd panic on Solaris.
273     * BUG 5840: Fix segfault in "rpcclient lsaaddacctrights".
274     * BUG 5860: safe_strcpy gives a nasty error message for overlong strings.
275     * Fix the offset checks in the trans routines (CVE-2008-4314).
276     * Fix a potential NULL deref in found by the IBM Checker.
277     * Fix an uninitialized variable found by the IBM Checker.
278     * Fix an unlikely memleak found by the IBM Checker.
279     * Fix some missing error handlings.
280     * Add workaround for domain joins using a netbios name which is different
281       from the hostname.
282     * Fix a valgrind error in idmap_ad_sids_to_unixids().
283     * Make memcache_add_talloc NULL out the source pointer.
284     * Fix memleak in memcache_add_talloc found by Martin Zielinski <mz@seh.de>.
285     * Fix memleak in calculate_next_machine_pwd_change.
288 o   Jeff Layton <jlayton@redhat.com>
289     * mount.cifs: use lock/unlock_mtab scheme from util-linux-ng mount prog.
292 o   Derrell Lipman <derrell.lipman@unwireduniverse.com>
293     * BUG 5805: Don't close stdout when calling setup_logging multiple times.
296 o   Stefan Metzmacher <metze@samba.org>
297     * Return an error instead of crashing when no realm is given.
300 o   TAKAHASHI Motonobu <monyo@samba.gr.jp>
301     * 5901: Fix default value for streams_depot location.
304 o   Tim Prouty <tim.prouty@isilon.com>
305     * Fix several build warnings.
308 o   Andreas Schneider <mail@cynapses.org>
309     * Delete the krb5 ccname variable from the PAM environment if set.
310     * Add a function out of pam_sm_close_session to delete the credentials.
311     * Fix circular dependency error with autoconf 2.6.3.
314 o   Davide Sfriso <sfriso@virgilio.it>
315     * BUG 5906: Fix Winbind crash bug during 'getent group' on PDC.
318 o   Dan Sledz <dsledz@isilon.com>
319     * Add FreeBSD configure check for backtrace_symbols.
320     * Allow SYSLOG_FACILITY to be modified with a new configure option called
321       --with-syslog-facility.
324 o   Joe Smith <yasumoto7@gmail.com>
325     * Fix typo in source/utils/net_rap.c.
328 o   Martin Schwenke <martin@meltin.net>
329     * Prevent make errors for picky makes when $(EXTRA_ALL_TARGETS) is empty.
330     * Add @CIFSUPCALL_PROGS@ to "all" target so cifs.upcall gets built at
331       compile time rather than install time.
334 o   Yasuma Takeda <yasuma@osstech.co.jp>
335     * BUG 5909: Fix MS-DFS links containing multibyte characters on Vista.
338 o   Bo Yang <boyang@novell.com>
339     * Fix broken msgids in ntstatus_errors.
340     * i18n/l10n pam_winbind
343 Commit Highlights:
344 ------------------
346 o   Michael Adam <obnox@samba.org>
347     * BUG 5609: Remove configure option "--with-libdir" and add
348       "--with-modulesdir".
349     * Extend "net rpc vampire keytab" to support differential replication
350       and storing of kerberos keys.
351     * Rework internal logic of registry tdb code.
352     * Freeze autogenerated prototype headers (good bye "make proto").
355 o   Jeremy Allison <jra@samba.org>
356     * Add new "winbind reconnect delay" parameter.
357     * Make the change to smbcontrol for "all" to mean broadcast,
358       and "smbd" to mean the main smb daemon.
361 o   Gerald W. Carter <jerry@samba.org>
362     * Add support for name aliasing in Winbind.
363     * Add the idmap/nss-info provider from Likewise Open.
364     * Allow an admin to define the "uid" attribute for a RFC2307
365       user object in AD to be the username alias.
366     * Add new idmap backend "adex" to support RFC2307 enabled AD forests.
369 o   Guenther Deschner <gd@samba.org>
370     * BUG 5710: Fix changing of machine account passwords.
371     * Add "net rpc vampire keytab" and "net rpc vampire ldif".
374 o   Volker Lendecke <vl@samba.org>
375     * Rework of the Winbind idmap backend.
376     * Fix calculation of useable_space for trans2 and nttrans replies.
377     * Add mapping of generic bits when setting an NFSv4 ACL.
380 ######################################################################
381 Reporting bugs & Development Discussion
382 #######################################
384 Please discuss this release on the samba-technical mailing list or by
385 joining the #samba-technical IRC channel on irc.freenode.net.
387 If you do report problems then please try to send high quality
388 feedback. If you don't provide vital information to help us track down
389 the problem then you will probably be ignored.  All bug reports should
390 be filed under the Samba 3.3 product in the project's Bugzilla
391 database (https://bugzilla.samba.org/).
394 ======================================================================
395 == Our Code, Our Bugs, Our Responsibility.
396 == The Samba Team
397 ======================================================================