Fix Coverity ID 504
[jra/samba/.git] / WHATSNEW.txt
index 13be7ee59ce1205d0ab4ee05c474484b47b6bea5..cdee28d6e7c46bd89f73b1f0cc91a1ba7debb585 100644 (file)
@@ -1,9 +1,9 @@
                    =================================
-                   Release Notes for Samba 3.2.0pre2
-                               Feb 29, 2008
+                   Release Notes for Samba 3.2.0pre3
+                               Mar 28, 2008
                    =================================
 
-This is the second preview release of Samba 3.2.0.  This is *not*
+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/.
@@ -25,17 +25,23 @@ Major enhancements in Samba 3.2.0 include:
   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
+    and one-way domain trusts.
   o Support for userPrincipalName logons via pam_winbind and NSS
     lookups.
-  o Support in pam_winbind for logging on using the userPrincipalName.
   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 New LGPL Winbind client library (libwbclient.so).
 
+  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
@@ -43,7 +49,7 @@ Major enhancements in Samba 3.2.0 include:
 
 
   Documentation:
-  o Inclusion of an HTLM version of the 3rd edition of "Using Samba"
+  o Inclusion of an HTML version of the 3rd edition of "Using Samba"
     from O'Reilly Publishing.
 
 
@@ -75,7 +81,6 @@ to the "Changes" section for details on the exact parameters that were
 updated.
 
 
-
 Registry Configuration Backend
 ==============================
 
@@ -94,6 +99,68 @@ 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.
+
+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:
+
+  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
+
+Example changes that may be required to eliminate "deprecated" warnings:
+
+  /* Set the debug level */
+  context->debug = 99;
+changes to:
+  smbc_setDebug(context, 99);
+
+  /* Specify the authentication callback function */
+  context->callbacks.auth_fn = auth_smbc_get_data;
+changes to:
+  smbc_setFunctionAuthData(context, auth_smbc_get_data);
+
+  /* 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);
+
+  /* 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);
+
+
 
 
 ######################################################################
@@ -113,17 +180,23 @@ smb.conf changes
     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                         
+    read bmpx                          Removed
     registry shares                    New             No
     winbind expand groups              New             1
     winbind rpc only                   New             No
 
 
+Changes since 3.2.0pre2:
+-----------------------
+
+
 Changes since 3.2.0pre1:
 -----------------------
 
@@ -162,6 +235,7 @@ o   Jeremy Allison <jra@samba.org>
       (based on work from Andreas Schneider).
     * Encrypted SMB transport in client tools and libraries, and server.
 
+
 o   Kai Blin <kai@samba.org>
     * Added support for an SMB_CONF_PATH environment variable
       containing the path to smb.conf.
@@ -182,6 +256,40 @@ o   Guenther Deschner <gd@samba.org>
       (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>
@@ -189,26 +297,32 @@ o   Steve Langasek <vorlon@debian.org>
       for better adherence to the FHS standard.
 
 
-o  Volker Lendecke <vl@samba.org>
+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()
-
+    * 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>
-    * Fixes for libreplace.
+    * 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.
-    * Add nss_wrapper support.
-    * Start and test winbindd by 'make test'
-    * Split up child_dispatch_table into domain, idmap and locator tables
-      in winbindd.
     * 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
@@ -230,6 +344,9 @@ o   James Peach <jpeach@samba.org>
 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".
 
 
 o   Karolin Seeger <ks@sernet.de>
@@ -237,6 +354,7 @@ o   Karolin Seeger <ks@sernet.de>
     * Add 'net rap file user'.
     * Change LDAP search filter to find machine accounts which
       are not located in the user suffix.
+    * Remove smbmount.
 
 
 o   David Shaw <dshaw@jabberwocky.com>
@@ -260,8 +378,9 @@ o   Andrew Tridgell <tridge@samba.org>
 o   Jelmer Vernooij <jelmer@samba.org>
     * Additional portability support for building shared libraries.
 
+
 o   Corinna Vinschen <corinna@vinschen.de>
-    * Get Samba version or capability information from Windows user space
+    * Get Samba version or capability information from Windows user space.
 
 
 Original 3.2.0pre1 commits:
@@ -341,7 +460,7 @@ o   Volker Lendecke <vl@samba.org>
 
 
 o   Steve French <sfrench@samba.org>
-    * Fixes for mount.cfs Linux utility.
+    * Fixes for mount.cifs Linux utility.
 
 
 o   Stefan Metzmacher <metze@samba.org>