updated
[jra/samba/.git] / WHATSNEW.txt
1           WHATS NEW IN 1.9.18alpha11 Nov 2nd 1997
2           =======================================
3
4 This is NOT a production release of Samba code.
5 For production servers please run Samba 1.9.17p4
6 or later releases in the 1.9.17 series.
7
8 This release contains some experimental features and
9 changes and is being made available so people can
10 test and provide feedback and patches for ongoing
11 Samba development.
12
13 Please note that only the Domain controller code
14 is truly experimental. The other changes have
15 been extensively tested and are of the same
16 quality as normal Samba alpha releases. The
17 Domain controller code is disabled in the Makefile
18 by default and is being made available to Samba
19 programmers in the interests of advancing a 
20 public implementation of this important protocol.
21
22 This release contains three major changes to the 
23 1.9.17 series and much re-written code.
24
25
26 The main changes are :
27
28 1). Oplock support now operational.
29 -----------------------------------
30
31 Samba now supports 'exclusive' and 'batch' oplocks.
32 These are an advanced networked file system feature
33 that allows clients to obtain a exclusive use of a 
34 file. This allows a client to cache any changes it
35 makes locally, and greatly improves performance.
36
37 Windows NT has this feature and prior to this
38 release this was one of the reasons Windows NT
39 could be faster in some situations.
40
41 The oplock code in Samba has been extensively
42 tested and is believed to be completely stable.
43
44 Please report any problems to the samba-bugs alias.
45
46
47 2). Experimental Primary Domain controller code.
48 ------------------------------------------------
49
50 Samba now contains a *VERY* experimental client and
51 server implementation of part of the Windows NT
52 4.x Domain Controller specification, as
53 published by Paul Ashton (now a Samba Team
54 member).
55
56 This code is not enabled in the Makefile by default,
57 and to work on this code you must read the file :
58
59    docs/NTDOMAIN.txt
60
61 Please note that as this code is not complete,
62 it is being made available as part of this release
63 to allow interested parties to contribute and help
64 the Samba Team in documenting and implementing
65 this important feature.
66
67 Please do not expect to be able to replace your
68 NT Domain Controllers with Samba until this code
69 is finished, tested and an announcement is made.
70
71 At present the Domain Controller code is for 
72 programmers and people interested in Microsoft 
73 protocols only.
74
75
76 3). New Internationalization support.
77 -------------------------------------
78
79 With this release Samba no longer needs to be
80 separately compiled for Japanese (Kanji) support,
81 the same binary will serve both Kanji and non-Kanji
82 clients.
83
84 A new method of dynamically loading client code pages
85 has been added to allow the case insensitivity to
86 be done dependent on the code page of the client.
87
88 Note that Samba still will only handle one client
89 code page at a time. This will be fixed when
90 Samba is fully UNICODE enabled.
91
92 Please see the new man page for make_smbcodepage
93 for details on adding additional client code page
94 support.
95
96
97 Changed code.
98 -------------
99
100 Samba no longer needs the libdes library to support
101 encrypted passwords. Samba now contains a restricted
102 version of DES that can only be used for authentication
103 purposes (to comply with the USA export encryption
104 regulations and to allow USA Mirror sites to carry
105 Samba source code). The 'encrypt passwords' parameter
106 may now be used without recompiling.
107
108 Much of the internals of Samba has been re-structured
109 to support the oplock and Domain controller changes.
110
111 The WINS client and WINS server capabilities in nmbd
112 are also being restructured, to make it easier to
113 understand and maintain.
114
115 Samba supports the NT 3.51 and 4.0 Domain Authentication
116 Protocol to a degree sufficient to download Profiles to an
117 NT 3.51 or 4.0 Workstation ("Welcome to the SAMBA Domain").
118
119 There is also code in smbclient to generate the same
120 requests as an NT Workstation would when doing an NT
121 Domain Logon.  This has only been tested against a Samba
122 "Experimental" PDC so far.
123
124 Some of the new parameters for NT Domain Logons and
125 Profile support are now also used by the Win95 Domain
126 Logons and Profile support.
127
128 The Automount code has been slightly reshuffled, such
129 that the home directory (and profile location) can be
130 specified by \\%N\homes and \\%N\homes\profiles
131 respectively, which are the defaults for these values.
132 If -DAUTOMOUNT is enabled, then %N is the server
133 component of the user's NIS auto.home entry.  Obviously,
134 you will need to be running Samba on the user's home
135 server as well as the one they just logged in on.
136
137 The RPC Domain code has been moved into a separate directory
138 rpc_pipe/, and a GLPL License issued specifically for code
139 in this directory.  This is so that people can use this
140 code in other projects.
141
142 New workstation accounts are added to the smbpasswd file,
143 when a user first logs in from that workstation.  The
144 default machine password is used.  NTDOMAIN.txt has been
145 updated to reflect this (you used to have to add workstation
146 accounts manually).
147
148 The "domain hosts allow/deny" parameters have been added
149 to control access to the domain from specific workstations.
150
151
152 New parameters in smb.conf.
153 ---------------------------
154
155 New Global parameters.
156 ----------------------
157
158 Documented in the smb.conf man pages :
159
160         "bind interfaces only"
161         "username level"
162
163         "domain hosts allow"
164         "domain hosts deny"
165
166         "domain sid"
167         "domain groups"
168
169         "logon drive"
170         "logon home"
171
172
173 Not yet documented in the smb.conf man page, please 
174 read docs/NTDOMAIN.txt or examine the source code for
175 information on the next parameters :
176
177         "domain other sids"
178         "domain admin users"
179         "domain guest users"
180
181
182 New Share level parameters.
183 ---------------------------
184
185 Documented in the smb.con man pages :
186
187         "delete veto files"
188         "oplocks"
189
190
191 Reporting bugs.
192 ---------------
193
194 If you have problems, or think you have found a
195 bug please email a report to :
196
197         samba-bugs@samba.anu.edu.au
198
199 Please state the version number of Samba that
200 you are running, and *full details* of the steps
201 we need to reproduce the problem.
202
203 As always, all bugs are our responsibility.
204
205 Regards,
206
207         The Samba Team.
208