build_docs: Use 'make distclean' instead of 'make clean'.
[sfrench/samba-autobuild/.git] / WHATSNEW.txt
index 001f0f8d70f881e22182d6290321b601f702e1bc..49d28cc490d6e06def7e58f57a60699ffaeae4b7 100644 (file)
-                   =================================
-                   Release Notes for Samba 3.2.0pre3
-                               Apr 25, 2008
-                   =================================
-
-This is the third preview release of Samba 3.2.0.  This is *not*
-intended for production environments and is designed for testing
-purposes only.  Please report any defects via the Samba bug reporting
-system at https://bugzilla.samba.org/.
+                   =============================
+                   Release Notes for Samba 3.3.0
+                         January, 27 2009
+                   =============================
 
-Please be aware that Samba is now distributed under the version 3
-of the new GNU General Public License.  You may refer to the COPYING
-file that accompanies these release notes for further licensing details.
+This is the first stable release of Samba 3.3.0.
 
-Major enhancements in Samba 3.2.0 include:
-
-  File Serving:
-  o Use of IDL generated parsing layer for several DCE/RPC
-    interfaces.
-  o Removal of the 1024 byte limit on pathnames and 256 byte limit on
-    filename components to honor the MAX_PATH setting from the host OS.
-  o Introduction of a registry based configuration system.
-  o Improved CIFS Unix Extensions support.
-  o Experimental support for file serving clusters.
-  o Support for IPv6 in the server, and client tools and libraries.
-  o Support for storing alternate data streams in xattrs.
-  o Encrypted SMB transport in client tools and libraries, and server.
-  o Support for Vista clients authenticating via Kerberos.
-
-  Winbind and Active Directory Integration:
-  o Full support for Windows 2003 cross-forest, transitive trusts
-    and one-way domain trusts.
-  o Support for userPrincipalName logons via pam_winbind and NSS
-    lookups.
-  o Expansion of nested domain groups via NSS calls.
-  o Support for Active Directory LDAP Signing policy.
-  o New LGPL Winbind client library (libwbclient.so).
-  o Support for establishing interdomain trust relationships with
-    Windows 2008.
-
-  Joining:
-  o New NetApi library for domain join related queries (libnetapi.so)
-    and example GTK+ Domain join gui.
-  o New client and server support for remotely joining and unjoining
-    Domains.
-  o Support for joining into Windows 2008 domains.
-
-  Users & Groups:
-  o New ldb backend for local group mapping tables
-  o Raised level of security defaults for authentication operations.
-  o New NetApi library for user account related queries.
-
-
-  Documentation:
-  o Inclusion of an HTML version of the 3rd edition of "Using Samba"
-    from O'Reilly Publishing.
-
-
-Now Licensed under the GNU GPLv3
-================================
-
-The Samba Team has adopted the Version 3 of the GNU General Public
-License for the 3.2 and later releases.   The GPLv3 is the updated
-version of the GPLv2 license under which Samba is currently
-distributed. It has been updated to improve compatibility with other
-licenses and to make it easier to adopt internationally, and is an
-improved version of the license to better suit the needs of Free
-Software in the 21st Century.
-
-The original announcement is available on-line at
-
-    http://news.samba.org/announcements/samba_gplv3/
-
-
-New Security Defaults for Authentication
-========================================
-
-Support for LanMan passwords is now disabled in both client and server
-applications.  Additionally, clear text authentication requests are
-disabled by default in client utilities such as smbclient and all
-libsmbclient based applications.  This will affect connection both
-to and from hosts running DOS, Windows 9x/ME, and OS/2.  Please refer
-to the "Changes" section for details on the exact parameters that were
-updated.
-
-
-Registry Configuration Backend
-==============================
-
-Samba is now able to use a registry based configuration backed to
-supplement smb.conf setting.  This feature may be enabled by setting
-"config backend = registry" and "registry shares = yes" in the [global]
-section of smb.conf and may be managed using the "net conf" command.
-
-More information may be obtained from the smb.conf(5) and net(8) man
-pages.
-
-
-Removed Features
-================
-
-Both the Python bindings and the libmsrpc shared library have been
-removed from the tree due to lack of an official maintainer.
-
-As smbfs is no longer supported in current kernel versions, smbmount has
-been removed in this Samba version. Please use cifs (mount.cifs) instead.
-See examples/scripts/mount/mount.smbfs as an example for a wrapper which
-calls mount.cifs instead of smbmount/mount.smbfs.
-
-
-Modified API for libsmbclient
-==============================================================================
-
-Maintaining ABI compatibility for libsmbclient has become increasingly
-difficult to accomplish, while also keeping the code organization such that it
-is easily readable.  Towards the goal of maintaining ABI compatibility and
-also keeping the code easy to maintain and enhance, the API has been enhanced.
-In particular, the fields in the SMBCCTX context structure are no longer
-intended to be read/write by the user, and are marked as deprecated.  An
-application that previously accessed the members of the SMBCCTX context
-structure will now encounter warnings if recompiled.  This is intentional, to
-encourage implementation of the small changes required for the new interface.
-The number of changes is expected to be quite small for the vast majority of
-applications, and no changes need be made for many applications.  The changes
-required for KDE (konqueror) to conform to the new interface, for example, are
-only four lines in only one file.
+Major enhancements in Samba 3.3.0 include:
 
-Instead of the application manually changing or reading values in the context
-structure, there are now setter and getter functions for each configurable
-member in that structure.  Similarly, the smbc_option_get() and
-smbc_option_set() functions are deprecated in favor of the setter/getter
-interface.  The setters and getters are all documented in libsmbclient.h
-under these comment blocks:
+ General changes:
+ o The passdb tdbsam version has been raised.
 
-  Getters and setters for CONFIGURATION
-  Getters and setters for OPTIONS
-  Getters and setters for FUNCTIONS
-  Callable functions for files
-  Callable functions for directories
-  Callable functions applicable to both files and directories
+ Configuration/installation:
+ o Splitting of library directory into library directory and separate
+   modules directory.
+ o The default value of "ldap ssl" has been changed to "start tls".
 
-Example changes that may be required to eliminate "deprecated" warnings:
+ File Serving:
+ o Extended Cluster support.
+ o New experimental VFS modules "vfs_acl_xattr" and "vfs_acl_tdb"
+   to store NTFS ACLs on Samba file servers.
 
-  /* Set the debug level */
-  context->debug = 99;
-changes to:
-  smbc_setDebug(context, 99);
+ Winbind:
+ o Simplified idmap configuration.
+ o New idmap backends "adex" and "hash".
+ o Added new parameter "winbind reconnect delay".
+ o Added support for user and group aliasing.
+ o Added support for multiple domains to idmap_ad.
 
-  /* Specify the authentication callback function */
-  context->callbacks.auth_fn = auth_smbc_get_data;
-changes to:
-  smbc_setFunctionAuthData(context, auth_smbc_get_data);
+ Administrative tools:
+ o The destination "all" of smbcontrol does now affect all running
+   daemons including nmbd and winbindd.
+ o New 'net rpc vampire keytab' and 'net rpc vampire ldif' commands.
+ o The 'net' utility can now use kerberos for joining and authentication.
+ o The 'wbinfo' utility can now add, modify and remove identity mapping entries.
 
-  /* Specify the new-style authentication callback with context parameter */
-  smbc_option_set("auth_function", auth_smbc_get_data_with_ctx);
-changes to:
-  smbc_setFunctionAuthDataWithContext(context, auth_smbc_get_data_with_ctx);
+ Libraries:
+ o NetApi library implements various new calls for User- and Group
+   Account Management.
 
-  /* Set kerberos flags */
-  context->flags = (SMB_CTX_FLAG_USE_KERBEROS |
-                    SMB_CTX_FLAG_FALLBACK_AFTER_KERBEROS);
-changes to:
-  smbc_setOptionUseKerberos(context, 1);
-  smbc_setOptionFallbackAfterKerberos(context, 1);
 
+General changes
+===============
 
+The passdb tdbsam version has been raised as among other things the RID counter
+has been moved from the winbindd_idmap.tdb to the passdb.tdb file to make
+"passdb backend = tdbsam" working in clustered environments.
 
+Please note that an updated passdb.tdb file is _not_ compatible with Samba
+versions before 3.3.0! Please backup your passdb.tdb file if
+you use "passdb backend = tdbsam". That can be achieved by running
 
-######################################################################
-Changes
-#######
+'tdbbackup /etc/samba/passdb.tdb'
 
-smb.conf changes
-----------------
+before the update.
 
-    Parameter Name                      Description     Default
-    --------------                      -----------     -------
-    client lanman auth                 Changed Default No
-    client ldap sasl wrapping          New             plain
-    client plaintext auth              Changed Default No
-    clustering                         New             No
-    cluster addresses                  New             ""
-    config backend                     New             file
-    ctdb socket                                New             ""
-    debug class                                New             No
-    administrative share               New             No
-    lanman auth                                Changed Default No
-    ldap debug level                   New             0
-    ldap debug threshold               New             10
-    mangle map                         Removed
-    min receive file size              New             0
-    open files database hashsize       Removed
-    read bmpx                          Removed
-    registry shares                    New             No
-    winbind expand groups              New             1
-    winbind rpc only                   New             No
-
-
-Changes since 3.2.0pre2:
------------------------
 
+Configure changes
+=================
 
-o   Michael Adam <obnox@samba.org>
-    * Fix session setup with security = share.
-    * Fix segfault in testparm.
-    * Fix several Makefile issues.
-    * Fix build of bin/net on Solaris.
-    * Reformat the parm table of loadparm to use named initializers.
-    * Fix %I macro expansion for IPv4 mapped IPv6 addresses.
-    * Convert registry.tdb to use dbwrap and fix memleaks.
-    * Several make test fixes and improvements.
-    * Rename libnet_conf to libsmbconf and introduce backend abstraction layer.
-    * Add text backend to libsmbconf, based on params.c.
-    * Fix handling of includes in registry libsmbconf backend.
-    * Fix net conf import by reading from text backend.
-    * Add a "net registry" command to locally access the registry.
-    * Add testsuites for libsmbconf and "net registry".
-    * Fix Coverity IDs 517, 536, 545.
+The configure option "--with-libdir" has been removed. The library
+directory can still be specified by using the existing "--libdir" option.
+A new option "--with-modulesdir" has been added to allow the specification
+of a separate directory for the shared modules.
 
 
-o   Jeremy Allison <jra@samba.org>
-    * BUG 5311: Fix IPv6 issue with hosts allow/deny settings.
-    * BUG 5372: Fix client timeouts in large CUPS installations.
-    * Fix problem with nmbd not waiting until interfaces come up.
-    * Fix S3 to pass the test_raw_oplock_exclusive3 test.
-    * Fix MSDFS bug breaking MS clients in some cases by ensuring 
-      the target host is ourselves.
-    * Rewrite the wrap checks to deal with gcc 4.x optimisations.
+Configuration changes
+=====================
 
+The default value of "ldap ssl" has been changed to "start tls". This means,
+Samba will use the LDAPv3 StartTLS extended operation (RFC2830) for
+communicating with directory servers by default. If your directory servers
+do not support this extended operation, you will have to set
+"ldap ssl = no". Otherwise, Samba could not contact the directory servers
+anymore!
 
-o   Kai Blin <kai@samba.org>
-    * BUG 4235: Prevent ntlm_auth from sending BH responses without a message.
-    * Fix one BH message.
 
+Winbind idmap backend changes
+=============================
 
-o   Gerald (Jerry) Carter <jerry@samba.org>
-    * Fix libtdb some to move back towards allowing out of tree builds.
-    * Ignore port when pulling IP addr from struct sockaddr_storage..
-
-
-o   Guenther Deschner <gd@samba.org>
-    * Fix build of pam_smbpass.
-    * Fix lp_load with an empty registry and "config backend = registry".
-    * Fix build targets for bin/net.
-    * Fix _dssetup_DsRoleGetPrimaryDomainInformation().
-    * Fix the build of cifs.spnego.
-    * Migration of the SRVSVC client and server DCE/RPC code to IDL
-      based structures and autogenerated code
-    * Fix Kerberos session setup with Vista SP1 (ignore PAC type 12)
-    * Fix support for vampire of lockout policies and
-      for storing dialin/terminal server settings.
-    * Fix remote join/unjoin server implementation.
-    * BUG 5328: Fix netlogon credential chain with Windows 2008
-      (this also fixes joining Windows 2008 with rpc methods).
-    * Various fixes for establishing and validating interdomain trust
-      relationships with Windows 2008.
-    * Use IDL for storing domain controller information in dsgetdcname.
-    * Re-arranged internal structure of libnetapi.
-    * Add support for domain\dcname syntax in libnetjoin.
-    * Add support for browsing/joining OUs in netdomjoin-gui.
-    * Add various new calls to libnetapi.
+The idmap configuration has changed with version 3.3 to something that
+allows a smoother upgrade path from pre-3.0.25 configurations that use
+"idmap backend". The reason for this change is that to many, also to Samba
+developers, the 3.0.25 style configuration with "idmap config" turned out
+to be very complex. Version 3.3 no longer deprecates the "idmap backend"
+parameter, instead with "idmap backend" the default idmap backend is
+specified.
 
+Accordingly, the "idmap config <domain> : default = yes" setting is no
+longer being looked at.
 
-o   Björn Jacke <bj@sernet.de>
-    * Add AC_TRY_RUN_STRICT support for Sun Studio compiler.
+The alloc backend defaults to the default backend, which should be able to
+allocate IDs. In the default distribution the tdb and ldap backends can
+allocate, the ad and rid backends can not. The idmap alloc range is now
+being set with the "old" parameters "idmap uid" and "idmap gid".
 
+The "idmap domains" parameter has been removed.
 
-o   Volker Lendecke <vl@samba.org>
-    * Add support for async SMB requests.
-    * Add transactions to the dbwrap API.
-    * Add "net idmap aclmapset".
-    * Change default bufsize to 512k.
-    * Fix Coverity IDs 473, 481, 506, 507, 525, 526, 527, 528, 529, 530, 537,
-      538, 547, 548, 551, 552, 553, 554, 555, 557, 558, 559, 563, 564, 567.
-      ... and half a ton more
-    * Fix some warnings in the tsmsm module.
-    * Fix warnings.
-    * BUG 4901: Fix "ldap passwd sync = only".
-    * BUG 5334: Fix download of empty files using smbclient.
-    * BUG 5307: Fix notify changes.
-    * BUG 5317: Fix debug output in domain_client_validate.
-    * BUG 5338: Fix format string issue in rpcclient.
-    * Convert account_pol.tdb and share_info.tdb to dbwrap.
-    * Protect group_mapping.tdb ops with transactions.
-    * BUG 5366: "passwd program" should work on Solaris 10 again now.
-    * A level 25 setuserinfo does change the pwdlastset, fixes XP joins.
-    * BUG 5350: A Samba DC trusting NT4 should do an anon session setup.
-    * BUG 5375: Fix a segfault with "security=share" and [in]valid users.
-    * Fix printing from DOS clients -- introduced by inbuf/outbuf rewrite.
-    * Fix wbinfo -a trusted\\user%password on a Samba DC with trusts.
-    * BUG 5341: Fix async smbclient get command on Solaris.
-    * Make winbind use NetSamLogonEx when possible.
-    * Merge fixes in the 3-0-ctdb cluster code.
-    * Fix a segfault in snprintf replacement code.
-
-
-o   Derrell Lipman <derrell@samba.org>
-    * Check for NULL pointers before dereferencing them.
-    * Fix use of AuthDataWithContext capability.
 
+winbind reconnect delay
+=======================
 
-o   Stefan Metzmacher <metze@samba.org>
-    * Add dbwrap_tdb2 backend, useful for cluster setups.
-    * Add more functions to libwbclient:
-      - wbcGetGroups()
-      - wbcInterfaceDetails()
-      - wbcListUsers()
-      - wbcListGroups()
-      - wbcLookupUserSids()
-      - wbcSetUidMapping()
-      - wbcSetGidMapping()
-      - wbcSetUidHwm()
-      - wbcSetGidHwm()
-      - wbcResolveWinsByName()
-      - wbcResolveWinsByIP()
-      - wbcCheckTrustCredentials()
-    * Let wbinfo use libwbclient where possible.
-    * Let net use only libwbclient to access winbindd.
-    * Make socket wrapper pcap support more portable.
-    * Some libreplace backports from v4-0-test.
-    * Store the write time in the locking.tdb,
-      so that smbd passes the BASE-DELAYWRITE test.
-    * Run RAW-SEARCH and BASE-DELAYWRITE by 'make test'.
-    * Let each process use its own connection to ctdb
-      in cluster mode.
-    * Add a reinit_after_fork() helper function to correct
-      reinitialize the same things in all cases.
-    * Fix a chicken and egg problem with "include = registry".
+This is a new parameter which specifies the number of seconds the Winbind
+daemon will wait between attempts to contact a Domain controller for a domain
+that is determined to be down or not contactable.
 
 
-o   Karolin Seeger <kseeger@samba.org>
-    * Fix usage message for "net idmap dump".
+Winbind's Name Aliasing
+=======================
 
+Name aliasing in Winbind is a feature that allows an administrator to
+map a fully qualified user or group name from a Windows domain to a
+convenient short name for Unix access.  This is similar to the username
+map functionality supported by smbd but is primary intended for
+clients and servers making use of Winbind's PAM and NSS libraries.
 
-o   Andrew Tridgell <tridge@samba.org>
-    * Suppress superfluous message.
+For example, the user "DOMAIN\fred" has been mapped to the Unix name
+"freddie".
 
+   $ getent passwd "DOMAIN\fred"
+   freddie:x:1000:1001:Fred Jones:/home/freddie:/bin/bash
 
-o   Marc VanHeyningen <marc.vanheyningen@isilon.com>
-    * Coverity fixes.
+   $ getent passwd freddie
+   freddie:x:1000:1001:Fred Jones:/home/freddie:/bin/bash
 
+The name aliasing support is provided by individual nss_info plugins.
+For example, the new "adex" plugin reads the uid attribute from Active
+Directory to make a short login name to the fully qualified name.
+While the new "hash" module utilizes a local file to map "short_name
+= QUALIFIED\name".  Both user and group name mapping is supported.
+Please refer to the "winbind nss info" option in smb.conf(5) and
+to individual plugin man pages for further details.
 
-Changes since 3.2.0pre1:
------------------------
 
-o   Michael Adam <obnox@samba.org>
-    * Add library for access to the registry configuration data.
-    * BUG 5023: Separate NFS4 and POSIX ACL code in file access checks.
-    * BUG 4308: Fix Excel save operation ACL bug.
-    * Refactor and consolidate logic for retrieving the machine
-      trust password information.
-    * VFS API cleanup (remove redundant parameter).
-    * BUG 4801: Correctly implement LSA lookup levels for LookupNames.
-    * Add new option "debug class" to control printing of the debug class.
-      in debug headers.
-    * Enable building of the zfsacl and notify_fam vfs modules.
-    * BUG 5083: Fix memleak in solarisacl module.
-    * BUG 5063: Fix build on RHEL5.
-    * New smb.conf parameter "config backend = registry" to enable registry
-      only configuration.
-    * Move "net conf" functionality into a separate module libnet_conf.c
-    * Restructure registry code, eliminating the dynamic overlay.
-      Make use of reg_api instead of backend code in most places.
-    * Add support for intercepting LDAP libraries' debug output and print
-      it in Samba's debugging system.
-    * Libreplace fixes.
-    * Build fixes.
-    * Initial support for using subsystems as shared libraries.
-      Use talloc, tdb, and libnetapi as shared libraries internally.
+idmap_hash
+==========
 
+The idmap_hash plugin provides similar support as the idmap_rid
+module.  However, uids and gids are generated from the full domain
+SID using a hashing algorithm that maps the lower 19 bits from the user
+or group RID to bits 0 - 19 in the Unix id and hashes 96 bits from
+the domain SID to bits 20 - 30 in the Unix id.  The result is a 31 bit
+uid or gid that is consistent across machines and provides support for
+trusted domains.
 
-o   Jeremy Allison <jra@samba.org>
-    * Added support for IPv6 client and server connections.
-    * Add in the recvfile entry to the VFS layer.
-    * Removal of pstring data type.
-    * Remove unused utilities: smbctool and rpctorture.
-    * Fix service principal detection to match Windows Vista
-      (based on work from Andreas Schneider).
-    * Encrypted SMB transport in client tools and libraries, and server.
-
+Please refer to the idmap_hash(8) man page for more details.
 
-o   Kai Blin <kai@samba.org>
-    * Added support for an SMB_CONF_PATH environment variable
-      containing the path to smb.conf.
-    * Various fixes to ntlm_auth.
-    * make test now supports more extensive SPOOLSS testing using vlp.
-    * Correctly handle mixed-case hostnames in NTLMv2 authentication.
 
+idmap_adex
+==========
 
-o   Gerald (Jerry) Carter <jerry@samba.org>
-    * Add Winbind client library.
-    * Decouple static linking between smbd and winbindd's client
-      interface.
-
-
-o   Guenther Deschner <gd@samba.org>
-    * Enhance client and server remote registry access.
-    * Add client calls for remotely joining a computer to a domain
-      (including calls from "net dom" command).
-    * Add libnetapi.so library for joining domains including
-      sample GTK+ app.
-    * Fixes for Vista SP1 Kerberos authdata handling to only pickup
-      the PAC.
-    * Various error code and error message fixes.
-    * Add initial draft of libnetconf to allow programmatic
-      configuration changes.
-    * Add libnet_join internal library for programmatically joining
-      and unjoining Domains.
-    * Add various fixes and new calls to libnetapi.so library.
-    * Various fixes for DsGetDcName and conversion to IDL based
-      structures.
-    * Fixes for pidl to correctly generate WERROR based client calls.
-    * Fixes for pidl to generate output that complies to coding
-      conventions.
-    * Various IDL fixes.
-    * Add ads_get_joinable_ous() to libads to get list of joinable ous.
-    * Add get_logon_hours_from_pdb() to comply with new IDL based
-      structures.
-    * Add debugging capabilities to dump AD connections to libads
-      (using ndr_print).
-    * Add "dump-domain-list" command for smbcontrol to retrieve better
-      debugging information out of winbindd.
-    * Migration of the entire client and server DCE/RPC code to IDL
-      based structures and autogenerated code for DSSETUP, LSA, SAMR
-      and NETLOGON.
-    * Started migration of client and server DCE/RPC code to IDL based
-      structures and autogenerated code for NTSSVC, SVCCTL and
-      EVENTLOG.
-    * Use IDL and autogenerated code for samlogoncache and Kerberos
-      PAC handling.
-    * Various fixes and cleanup of Kerberos PAC handling.
-    * Fix segfault in _srv_net_file_enum.
-    * Conversion of client join and unjoin code to libnet_join.
-    * Add remote join/unjoin server-side implementation.
-    * Removed a lot of code which has become obsolete.
-
-
-o   Steve Langasek <vorlon@debian.org>
-    * Integrate 2 out of 3 --with-fhs patches from Debian packaging
-      for better adherence to the FHS standard.
-
-
-o   Volker Lendecke <vl@samba.org>
-    * Add talloc_stackframe() and talloc_pool() features.
-    * Removal of pstring data type.
-    * Add generic a in-memory cache.
-    * Import the Linux red-black tree implementation.
-    * Remove large amount of global variables.
-    * Support for storing xattrs in tdb files.
-    * Support for storing alternate data streams in xattrs.
-    * Implement a generic in-memory cache based on rb-trees.
-    * Add implicit temporary talloc contexts via talloc_stack().
-    * Speed up the smbclient "get" command
-    * Add the aio_fork module
-    * Fix bug 4901
-
-o   Derrell Lipman <derrell@samba.org>
-    * Modified libsmbclient API for more easily maintaining ABI compatibility
-      while adding new features to libsmbclient.
-
-o   Stefan Metzmacher <metze@samba.org>
-    * Refactor Winbind internal parent-child interface tables
-      to achieve better unit testing support.
-    * Add nss_wrapper API for local Winbind unit tests.
-    * Networking fixes to the libreplace library.
-    * Pidl fixes.
-    * Remove unused Winbind pipe calls.
-    * Build fixes.
-    * Fix for a crash bug in pidl generated client code.
-      This could have happend with [in,out,unique] pointers
-      when the client sends a valid pointer, but the server
-      responds with a NULL pointer (as samba-3.0.26a does for some calls).
-    * Change NTSTATUS into enum ndr_err_code in librpc/ndr.
-    * Remove unused calls in the struct based winbindd protocol.
-    * Add --configfile option to wbinfo.
-    * Convert winbind_env_set(), winbind_on() and winbind_off() into macros.
-    * Return rids and other_sids arrays in WBFLAG_PAM_INFO3_TEXT mode.
-    * Implement wbcErrorString() and wbcAuthenticateUserEx().
-    * Convert auth_winbind to use wbcAuthenticateUserEx().
+The adex idmap/nss_info plugin is an adaptation of the Likewise
+Enterprise plugin with support for OU based cells removed
+(since the Windows pieces to manage the cells are not available).
 
+This plugin supports
 
-o   James Peach <jpeach@samba.org>
-    * Add support for DNS Service Discovery.  Based on work from
-      Rishi Srivatsavai <rishisv@gmail.com>.
+      * The RFC2307 schema for users and groups.
+      * Connections to trusted domains
+      * Global catalog searches
+      * Cross forest trusts
+      * User and group aliases
 
+Prerequisite: Add the following attributes to the Partial Attribute
+Set in global catalog:
 
-o   Andreas Schneider <anschneider@suse.de>
-    * Don't restart winbind if a corrupted tdb is found during
-      initialization.
-    * Fix Windows 2008 (Longhorn) join.
-    * Fix crashbug in winbindd.
-    * Add share parameter "administrative share".
+      * uidNumber
+      * uid
+      * gidNumber
 
+A basic config using the current trunk code would look like:
 
-o   Karolin Seeger <ks@sernet.de>
-    * Improve error messages of net subcommands.
-    * Add 'net rap file user'.
-    * Change LDAP search filter to find machine accounts which
-      are not located in the user suffix.
-    * Remove smbmount.
+[global]
+       idmap backend = adex
+       idmap uid = 10000 - 29999
+       idmap gid = 10000 - 29999
+       winbind nss info = adex
 
+       winbind normalize names = yes
+       winbind refresh tickets = yes
+       template homedir = /home/%D/%U
+       template shell = /bin/bash
 
-o   David Shaw <dshaw@jabberwocky.com>
-    * BUG 5073: Allow "delete readonly = yes" to correctly override
-      deletion of a file.
+Please refer to the idmap_adex(8) man page for more details.
 
 
-o   Rishi Srivatsavai <rishisv@gmail.com>
-    * Register the smb service with mDNS if mDNS is supported.
-    * Add smbclient support for basic mDNS browsing.
-
-
-o   Andrew Tridgell <tridge@samba.org>
-    * Fix padding between Winbind 32bit/64bit client library in
-      the request/response structures.
-    * Added a syncops VFS module for file systems which do not
-      guarantee meta-data operations are immediately committed to
-      disk in stable form.
-
-
-o   Jelmer Vernooij <jelmer@samba.org>
-    * Additional portability support for building shared libraries.
+######################################################################
+Changes
+#######
 
+smb.conf changes
+----------------
 
-o   Corinna Vinschen <corinna@vinschen.de>
-    * Get Samba version or capability information from Windows user space.
+    Parameter Name                      Description     Default
+    --------------                      -----------     -------
+    cups connection timeout            New             30
+    idmap config DOM:range             Removed
+    idmap domains                      Removed
+    init logon delayed hosts           New             ""
+    init logon delay                   New             100
+    ldap ssl                           Changed Default start tls
+    winbind reconnect delay            New             30
 
 
-Original 3.2.0pre1 commits:
----------------------------
-o   Michael Adam <obnox@samba.org>
-    * Unified POSIX ACL detection including support for FreeBSD and
-      HP-UX.
-    * Performance improvements for Winbind's lookup functions (names,
-      SIDs, and group membership) when joined to an AD domain.
-    * Winbind cache validation support.
-    * Store domain trust passwords for Samba domain controller's in
-      the domain's passdb backend.
-    * Merged \winreg server code from the SAMBA_3_2 development branch.
-    * Fixes for libreplace.
-    * Implement new registry configuration backend.
+Changes since 3.3.0rc2:
+-----------------------
 
 
 o   Jeremy Allison <jra@samba.org>
-    * Add support for file system objectIDs.
-    * Winbind cache validation support.
-    * Add in the UNIX capability for 24-bit readX.
-    * Improve Delete-on-Close semantics.
-    * Removal of static file and path name buffers in SMB file serving
-      code.
+    * BUG 5979: Fix level 2 oplocks being granted improperly.
+    * BUG 5980: Race condition when granting level2 oplocks can cause break
+      notify to be missed.
+    * BUG 5986: Editing a stream is broken (rename problems).
+    * BUG 5990: Strict allocate should be checked before ftruncate.
+    * BUG 6009: Setting "min receivefile size = 1" breaks writes.
+    * Fix gcc 4.3.2 warnings.
+    * Fix more asprintf errors and error code paths.
 
 
-o   Danilo Almeida <dalmeida@centeris.com>
-    * Move the machine account to the OU specified when running "net
-      ads join".
+o   Michael Adam <obnox@samba.org>
+    * Fix build of pam_winbind.so on older Linux systems.
+    * Packaging RHEL-CTDB: Fix build of [u]mount.cifs.
+    * Prevent access to root filesystem when connecting with empty service name.
 
 
-o   Andrew Bartlett <abartlet@samba.org>
-    * Tighten authentication protocol defaults in client tools and
-      servers.
+o   Kai Blin <kai@samba.org>
+    * BUG 5953: Fix smbclient crashes.
 
 
 o   Gerald (Jerry) Carter <jerry@samba.org>
-    * Implement support for one-way trusts and two-way cross-forest
-      transitive trust in winbindd.
-    * Fixes for Winbind's offline/disconnected logon support when
-      using remote idmap backends.
-    * Fix LookupNames and LookupSids to use the same resolution
-      heuristics as Windows XP.
-    * Fix lockups in Winbind when running nscd.
-    * UPN logon support in pam_winbind.
-    * Add support for GNU linker scripts when build shared libraries
-      (based on work by Julien Cristau <jcristau@debian.org> and James
-      Peach).
-
-
-o   Guenther Deschner <gd@samba.org>
-    * Additional support for decoding and downloading group policy
-      objects from Active Directory.
-    * Improvements to "net ads keytab" command.
-    * Fixes for linking against Heimdal Kerberos client libs.
-    * Support LDAP range retrieval searches.
-    * Fixes for failure to refresh user ticket caches in Winbind.
-    * UPN logon support in pam_winbind.
-    * Add KDC locator plugin for MIT kerberos 1.6 or later.
-
-
-o   Steve Langasek <vorlon@debian.org>
-    * Allow SIGTERM to cause nmbd to exit while awaiting a interface
-      to come up.
+    * Fix "allow trusted domain" so it disables trusted domains.
 
 
-o   Volker Lendecke <vl@samba.org>
-    * Merge experimental cluster support patches from the ctdb branch.
-    * Add tdb storage abstraction for ctdb.
-    * Use IDL for internal message passing system.
-    * Add client support for the SamLogonEx() authentication request.
-    * Implement RPC proxy stubs in the Samba server code to allow
-      replacing implementation functions one by one.
-    * Remove static incoming and outgoing buffers from core server SMB
-      packet processing code.
-    * Add "net sam rights" command.
-
+o   SATOH Fumiyasu <fumiyas@osstech.jp>
+    * Fix gmem->numgids and gmem->maxgids breakage on Solaris 64-bit.
+    * Fix SIGBUS on non-x86 CPUs in libsmbclient.
+    * Fix a compile-time warning.
 
-o   Steve French <sfrench@samba.org>
-    * Fixes for mount.cifs Linux utility.
-
-
-o   Stefan Metzmacher <metze@samba.org>
-    * Fixes for libreplace.
-    * Add support for LDAP digital signing policy.
-    * Experimental clustered file system support.
 
+o   Holger Hetterich <hhetter@novell.com>
+    * Add a simple tdb integrity check to tdbtool.
 
-o   Lars Mueller <lars@samba.org>
-    * Makefile and build fixes.
-    * Add pam_pwd_expire for pam_winbind (original patch from Andreas
-      Schneider).
-
-
-o   James Peach <jpeach@apple.com>
-    * Fixes for setgroups() and *BSD and Darwin.
-    * Support membership of >16 groups on Darwin.
 
+o   Björn Jacke <bj@sernet.de>
+    * Correct the description of the "ldap timeout" parameter.
 
-o   Jiri Sasek <Jiri.Sasek@Sun.COM>
-    * Added vfs_zfsacl module.
 
+o   Volker Lendecke <vl@samba.org>
+    * BUG 5913: Fix build error with at least GCC 4.2.2.
+    * BUG 5933: Fix incrementing/decrementing of num_validated_vuids.
+    * BUG 5953: Make cli_send_smb_direct_writeX use writev.
+    * BUG 5969: Optimize smbclient put command.
+    * BUG 6012: Add "get_real_filename" to full_audit.
+    * BUG 6014: Fix segfault when calling mget without arguments.
+    * Fix a spinning smbd when printing.
+    * Fix a memory leak in cups_pull_comment_location.
+    * Fix a valgrind error.
+    * Fix a "ignoring function call result" warning.
+    * Fix some C++ warnings.
+    * Fix an ancient uninitialized variable read.
+    * Fix a bad memleak in vfs_full_audit.
 
-o   Karolin Seeger <ks@sernet.de>
-    * Add deletelocalgroup and unmapunixgroup subcommand to "net sam".
-    * Cleanup internal passdb functions.
 
+o   Stefan Metzmacher <metze@samba.org>
+    * net_status: Use dbwrap to open sessionid.tdb.
+    * Fix dbwrap_store_uint32() to match dbwrap_store_int32().
+    * Make marshalling struct samu from and to a buffer more generic.
+    * Store the next rid counter in passdb.tdb instead of winbind_idmap.tdb.
+    * Register the client connection via CTDB_CONTROL_TCP_ADD.
+    * Don't need to call messaging_reinit() twice.
+    * Raise TDBSAM_VERSION.
 
-o   Simo Sorce <idra@samba.org>
-    * Fixes for IDmap and Passdb backends.
 
+o   Lars Müller <lars@samba.org>
+    * Tweak with pam defines of older Linux versions.
 
-o   Andrew Tridgell <tridge@samba.org>
-    * Port ldb from the Samba 4 tree and add ldb group mapping plugin.
-    * Move several file serving related tdb files to use the dbwrap
-      API internally.
-    * Cleanup the GPFS VFS plugin.
-    * Experimental clustered file system support.
 
+o   Tim Prouty <tprouty@samba.org>
+    * Fix stream marshalling to return the correct streaminfo status.
 
-o   Jelmer Vernooij <jelmer@samba.org>
-    * Implement NDR basic to support utilizing IDL files from Samba 4
-      tree for general DCE/RPC parsing stubs.
 
+o   Karolin Seeger <kseeger@samba.org>
+    * Change default value of "ldap ssl" to "start tls".
+    * Update version number in the manpages.
+    * Fix several small issues and typos in the manpages.
 
 
 ######################################################################
@@ -660,7 +295,7 @@ joining the #samba-technical IRC channel on irc.freenode.net.
 If you do report problems then please try to send high quality
 feedback. If you don't provide vital information to help us track down
 the problem then you will probably be ignored.  All bug reports should
-be filed under the Samba 3.2 product in the project's Bugzilla
+be filed under the Samba 3.3 product in the project's Bugzilla
 database (https://bugzilla.samba.org/).