Fix bug 4901
[samba.git] / WHATSNEW.txt
index 76a66b3d297910ff484999d6b403514da9be3afd..a9ca3526b39a7a2d13cadcbfff1188ca2575bf22 100644 (file)
@@ -1,6 +1,6 @@
                    =================================
                    Release Notes for Samba 3.2.0pre2
-                               Feb 29, 2008
+                               Mar 04, 2008
                    =================================
 
 This is the second preview release of Samba 3.2.0.  This is *not*
@@ -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.
   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).
 
+  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.
 
 
@@ -99,6 +105,63 @@ 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);
+
+
+
 
 ######################################################################
 Changes
@@ -117,13 +180,14 @@ smb.conf changes
     config backend                     New             file
     ctdb socket                                New             ""
     debug class                                New             No
-    hidden                             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
@@ -188,6 +252,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>
@@ -195,7 +293,7 @@ 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.
@@ -207,16 +305,20 @@ o  Volker Lendecke <vl@samba.org>
     * 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
@@ -240,7 +342,7 @@ o   Andreas Schneider <anschneider@suse.de>
       initialization.
     * Fix Windows 2008 (Longhorn) join.
     * Fix crashbug in winbindd.
-    * Add share parameter "hidden".
+    * Add share parameter "administrative share".
 
 
 o   Karolin Seeger <ks@sernet.de>