- lib/unix_sec_ctxt.c
[samba.git] / WHATSNEW.txt
index 44d0acf9a9f5c39ce664fa239c88f7ba3a224944..bff189c2dbafa21065e8edd80f8bbc4c98dd131a 100644 (file)
-          WHATS NEW IN 1.9.18alpha14 Dec 23rd 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.17p5
-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.
 
-In this release (1.9.18alpha14) the Domain controller 
-code should not be turned on. The Domain controller 
-code stream is now being developed in a separate code 
-development branch. To participate in this important 
-work, read the instructions on how to get the source
-code for the BRANCH_NTDOM Samba branch in the document 
+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.
 
-docs/CVS_ACCESS.txt 
+In addition, Samba has been re-written to help portability to
+other POSIX-based systems, based on the GNU autoconf tool.
 
-available in this Samba release.
+Major changes in Samba 2.0
+--------------------------
 
-This release contains three major changes to th
-1.9.17 series and much re-written code.
+There are many major changes in Samba for version 2.0.  Here ar
+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.
-
-Windows NT has this feature and prior to this
-release this was one of the reasons Windows NT
-could be faster in some situations. Samba has
-now been benchmarked as out performing Windows
-NT on equivalently priced hardware.
-
-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). NetBIOS name daemon re-written.
------------------------------------
-
-The old nmbd that has caused some users problems
-has now been completely re-written and now is
-much easier to maintain and add changes to.
-
-Changes include support for multi-homed hosts
-in the same way as an NT Server with multiple
-IP interfaces behaves (registers with the WINS
-server as a multi-homed name type), and also
-support for multi-homed name registration in
-the Samba WINS server. Another added feature
-is robustness in the face of WINS server failure,
-nmbd will now keep trying to contact the WINS 
-server until it is successful, in the same
-way as an NT Server.
-
-Also in this release is an implementation
-of the Lanman announce protocol used by
-OS/2 clients. Thanks to Jacco de Leeuw for 
-this code.
+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.
 
-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.
-
-Please see the new man page for make_smbcodepage
-for details on adding additional client code page
-support.
+2). Correctness
+---------------
 
+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.
 
-Changed code.
--------------
+3). Portability
+---------------
 
-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.
+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.
 
-Much of the internals of Samba has been re-structured
-to support the oplock and Domain controller changes.
+You now configure Samba by running "./configure" then "make".  See
+docs/textdocs/UNIX_INSTALL.txt for details.
 
-An implementation of the Windows 95 automatic printer
-driver installation has been added to smbd. To use this
-new feature please read the document:
+4). Web based GUI configuration
+-------------------------------
 
-docs/PRINTER_DRIVER.txt 
+Samba now comes with SWAT, a web based GUI config system.  See
+the swat man page for details on how to set it up.
 
-Thanks to Jean-Francois Micouleau for this new code.
+5). Cross protocol data integrity
+---------------------------------
 
-Printer support on System V systems (notably Solaris)
-has been improved with the addition of code generously
-donated by Norm Jacobs of Sun Microsystems. Sun have
-also made a Solaris SPARC workstation available to the
-Samba Team to aid in their porting efforts.
+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.
 
-Samba now contains an implementation of share modes
-using System V shared memory as well as the mmap()
-based code. This was done to allow the 'FAST_SHARE_MODES'
-to be used on more systems (especially HPUX 9.x) that
-have System V shared memory, but not the mmap() call.
+6). Domain client capability
+----------------------------
 
-The System V shared memory code is used by default on
-many systems as it has benchmarked as faster on many
-systems.
+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 Automount code has been slightly re-shuffled, 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.
+7). Documentation Updates
+-------------------------
 
-The RPC Domain code has been moved into a separate directory
-rpc_pipe/, and a LGPL License issued specifically for code
-in this directory.  This is so that people can use this
-code in other projects.
+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.
 
-Missing feature.
-----------------
+=====================================================================
 
-One feature that we wanted to get into this release
-that was not possible due to the re-write of the nmbd
-code was the scalability features in the Samba WINS server.
-This feature is now tentatively scheduled for the next
-release (1.9.19). Apologies to anyone who was hoping
-for this feature to be included. The nmbd re-write
-will make it much easier to add such things in future.
+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"
+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 :
 
-        "lm announce"
-        "lm interval"
+security=share
 
-       "logon drive"
-       "logon home"
+to get exactly the same behaviour with Samba 2.0 as you
+did with previous versions of Samba.
 
-        "min wins ttl"
-        "max wins ttl"
+********END IMPORTANT NOTE*************
 
-       "username level"
+In addition, Samba now defaults to case sensitivity options that
+match a Windows NT server precisely, that is, case insensitive 
+but case preserving.
 
-New Share level parameters.
----------------------------
+=====================================================================
 
-Documented in the smb.conf man pages :
+NOTE - Primary Domain Controller Functionality
+----------------------------------------------
 
-       "delete veto files"
-       "oplocks"
+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.
 
-Nascent web interface for configuration.
-----------------------------------------
+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.
 
-source/wsmbconf.c is a cgi-bin program for editing smb.conf. It can
-also be run standalone. This is in a very early stage of development.
+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 :
 
-Debugging support.
-------------------
+http://samba.org/listproc/
 
-smbd and nmbd will now modify their debug log level when
-they receive a USR1 signal (increase debug level by one)
-and USR2 signal (decrease debug level by one). This has
-been added to aid administrators track down faults that
-only occur after long periods of time, or transiently.
+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.