Fixed oplock test path spec bug.
[samba.git] / WHATSNEW.txt
index 91225e2cefa173d9f2bec7781ed7171df8f35fe5..bff189c2dbafa21065e8edd80f8bbc4c98dd131a 100644 (file)
-          WHATS NEW IN 1.9.18alpha11 Nov 2nd 1997
-          =======================================
+          WHATS NEW IN Samba 2.0.0 beta1
+          ==============================
 
-This is NOT a production release of Samba code.
-For production servers please run Samba 1.9.17p4
-or later releases in the 1.9.17 series.
+This is a MAJOR new release of Samba, the UNIX based SMB/CIFS file 
+and print server for Windows systems.
 
-This release contains some experimental features and
-changes and is being made available so people can
-test and provide feedback and patches for ongoing
-Samba development.
+There have been many changes in Samba since the last major release,
+1.9.18.  These have mainly been in the areas of performance and
+SMB protocol correctness.  In addition, a Web based GUI interface
+for configuring Samba has been added.
 
-Please note that only the Domain controller code
-is truly experimental. The other changes have
-been extensively tested and are of the same
-quality as normal Samba alpha releases. The
-Domain controller code is disabled in the Makefile
-by default and is being made available to Samba
-programmers in the interests of advancing a 
-public implementation of this important protocol.
+In addition, Samba has been re-written to help portability to
+other POSIX-based systems, based on the GNU autoconf tool.
 
-This release contains three major changes to the 
-1.9.17 series and much re-written code.
+Major changes in Samba 2.0
+--------------------------
 
+There are many major changes in Samba for version 2.0.  Here are 
+some of them:
 
-The main changes are :
+=====================================================================
 
-1). Oplock support now operational.
------------------------------------
+1). Speed
+---------
 
-Samba now supports 'exclusive' and 'batch' oplocks.
-These are an advanced networked file system feature
-that allows clients to obtain a exclusive use of a 
-file. This allows a client to cache any changes it
-makes locally, and greatly improves performance.
+Samba has been benchmarked on high-end UNIX hardware as out-performing
+all other SMB/CIFS servers using the Ziff-Davis NetBench benchmark.
+Many changes to the code to optimise high-end performance have been made.
 
-Windows NT has this feature and prior to this
-release this was one of the reasons Windows NT
-could be faster in some situations.
-
-The oplock code in Samba has been extensively
-tested and is believed to be completely stable.
-
-Please report any problems to the samba-bugs alias.
-
-
-2). Experimental Primary Domain controller code.
-------------------------------------------------
-
-Samba now contains a *VERY* experimental client and
-server implementation of part of the Windows NT
-4.x Domain Controller specification, as
-published by Paul Ashton (now a Samba Team
-member).
-
-This code is not enabled in the Makefile by default,
-and to work on this code you must read the file :
-
-   docs/NTDOMAIN.txt
-
-Please note that as this code is not complete,
-it is being made available as part of this release
-to allow interested parties to contribute and help
-the Samba Team in documenting and implementing
-this important feature.
-
-Please do not expect to be able to replace your
-NT Domain Controllers with Samba until this code
-is finished, tested and an announcement is made.
-
-At present the Domain Controller code is for 
-programmers and people interested in Microsoft 
-protocols only.
-
-
-3). New Internationalization support.
--------------------------------------
-
-With this release Samba no longer needs to be
-separately compiled for Japanese (Kanji) support,
-the same binary will serve both Kanji and non-Kanji
-clients.
-
-A new method of dynamically loading client code pages
-has been added to allow the case insensitivity to
-be done dependent on the code page of the client.
-
-Note that Samba still will only handle one client
-code page at a time. This will be fixed when
-Samba is fully UNICODE enabled.
+2). Correctness
+---------------
 
-Please see the new man page for make_smbcodepage
-for details on adding additional client code page
-support.
+Samba now supports the Windows NT specific SMB requests.  This
+means that on platforms that are capable Samba now presents a
+64 bit view of the filesystem to Windows NT clients and is
+capable of handling very large files.
 
+3). Portability
+---------------
 
-Changed code.
--------------
+Samba is now self-configuring using GNU autoconf, removing
+the need for people installing Samba to have to hand configure
+Makefiles, as was needed in previous versions.
 
-Samba no longer needs the libdes library to support
-encrypted passwords. Samba now contains a restricted
-version of DES that can only be used for authentication
-purposes (to comply with the USA export encryption
-regulations and to allow USA Mirror sites to carry
-Samba source code). The 'encrypt passwords' parameter
-may now be used without recompiling.
+You now configure Samba by running "./configure" then "make".  See
+docs/textdocs/UNIX_INSTALL.txt for details.
 
-Much of the internals of Samba has been re-structured
-to support the oplock and Domain controller changes.
+4). Web based GUI configuration
+-------------------------------
 
-The WINS client and WINS server capabilities in nmbd
-are also being restructured, to make it easier to
-understand and maintain.
+Samba now comes with SWAT, a web based GUI config system.  See
+the swat man page for details on how to set it up.
 
-Samba supports the NT 3.51 and 4.0 Domain Authentication
-Protocol to a degree sufficient to download Profiles to an
-NT 3.51 or 4.0 Workstation ("Welcome to the SAMBA Domain").
+5). Cross protocol data integrity
+---------------------------------
 
-There is also code in smbclient to generate the same
-requests as an NT Workstation would when doing an NT
-Domain Logon.  This has only been tested against a Samba
-"Experimental" PDC so far.
+An open function interface has been defined to allow 
+"opportunistic locks" (oplocks for short) granted by Samba
+to be seen by other UNIX processes.  This allows complete
+cross protocol (NFS and SMB) data integrety using Samba
+with platforms that support this feature.
 
-Some of the new parameters for NT Domain Logons and
-Profile support are now also used by the Win95 Domain
-Logons and Profile support.
+6). Domain client capability
+----------------------------
 
-The Automount code has been slightly reshuffled, such
-that the home directory (and profile location) can be
-specified by \\%N\homes and \\%N\homes\profiles
-respectively, which are the defaults for these values.
-If -DAUTOMOUNT is enabled, then %N is the server
-component of the user's NIS auto.home entry.  Obviously,
-you will need to be running Samba on the user's home
-server as well as the one they just logged in on.
+Samba is now capable of using a Windows NT PDC for user
+authentication in exactly the same way that a Windows NT
+workstation does, i.e. it can be a member of a Domain.  See
+docs/textdocs/DOMAIN_MEMBER.txt for details.
 
-The RPC Domain code has been moved into a separate directory
-rpc_pipe/, and a GLPL License issued specifically for code
-in this directory.  This is so that people can use this
-code in other projects.
+7). Documentation Updates
+-------------------------
 
-New workstation accounts are added to the smbpasswd file,
-when a user first logs in from that workstation.  The
-default machine password is used.  NTDOMAIN.txt has been
-updated to reflect this (you used to have to add workstation
-accounts manually).
+All the reference parts of the Samba documentation (the
+manual pages) have been updated and converted to a document
+format that allows automatic generation of HTML, SGML, and
+text formats.  These documents now ship as standard in HTML
+and manpage format.
 
-The "domain hosts allow/deny" parameters have been added
-to control access to the domain from specific workstations.
+=====================================================================
 
+NOTE - Some important option defaults changed
+---------------------------------------------
 
-New parameters in smb.conf.
----------------------------
+Several parameters have changed their default values.  The most
+important of these is that the default security mode is now user
+level security rather than share level security.
 
-New Global parameters.
-----------------------
+This (incompatible) change was made to ease new Samba installs
+as user level security is easier to use for Windows 95/98 and
+Windows NT clients.
 
-Documented in the smb.conf man pages :
+********IMPORTANT NOTE****************
 
-       "bind interfaces only"
-       "username level"
+If you have no "security=" line in the [global] section of 
+your current smb.conf and you update to Samba 2.0 you will
+need to add the line :
 
-       "domain hosts allow"
-       "domain hosts deny"
+security=share
 
-       "domain sid"
-       "domain groups"
+to get exactly the same behaviour with Samba 2.0 as you
+did with previous versions of Samba.
 
-       "logon drive"
-       "logon home"
+********END IMPORTANT NOTE*************
 
+In addition, Samba now defaults to case sensitivity options that
+match a Windows NT server precisely, that is, case insensitive 
+but case preserving.
 
-Not yet documented in the smb.conf man page, please 
-read docs/NTDOMAIN.txt or examine the source code for
-information on the next parameters :
+=====================================================================
 
-       "domain other sids"
-       "domain admin users"
-       "domain guest users"
+NOTE - Primary Domain Controller Functionality
+----------------------------------------------
 
+This version of Samba contains code that correctly implements
+the undocumented Primary Domain Controller authentication
+protocols.  However, there is much more to being a Primary
+Domain Controller than serving Windows NT logon requests.
 
-New Share level parameters.
----------------------------
+A useful version of a Primary Domain Controller contains
+many remote procedure calls to do things like enumerate users, 
+groups, and security information, only some of which Samba currently
+implements.  For this reason we have chosen not to advertise
+and actively support Primary Domain Controller functionality
+with this release.
 
-Documented in the smb.con man pages :
+This work is being done in the CVS (developer) versions of Samba,
+development of which continues at a fast pace.  If you are
+interested in participating in or helping with this development
+please join the Samba-NTDOM mailing list.  Details on joining
+are available at :
 
-       "delete veto files"
-       "oplocks"
+http://samba.org/listproc/
 
+Details on obtaining CVS (developer) versions of Samba
+are available at:
 
-Reporting bugs.
----------------
+http://samba.org/cvs.html
 
-If you have problems, or think you have found a
-bug please email a report to :
+=====================================================================
 
-       samba-bugs@samba.anu.edu.au
+If you have problems, or think you have found a bug please email 
+a report to :
 
-Please state the version number of Samba that
-you are running, and *full details* of the steps
-we need to reproduce the problem.
+        samba-bugs@samba.org
 
 As always, all bugs are our responsibility.
 
 Regards,
 
-       The Samba Team.
+        The Samba Team.