afs-release-notes-20040405
[openafs.git] / doc / txt / winnotes / afs-changes-since-1.2.txt
1 Since 1.3.62:
2    * All of the resource files have been restructured to adhere to
3      a set of rules IBM implemented for loading string resources.
4      These rules had either been forgotten or were not discovered
5      by folks working on the OpenAFS sources.  The end result was
6      memory corruption.  This is primary item which was preventing
7      the AFS Server from working.
8
9    * Increased the size of the maximum ticket size stored in a token
10      from 344 bytes to 12,000.  Increased the buffers used to convey
11      messages between the pioctl() caller and the SMB Server from
12      1000 bytes to 12,512.  The code appeared to have been writing
13      above the top of the stack by quite a few number of bytes.
14      (The increased ticket size is necessary for the next item.)
15
16    * When obtaining AFS Tokens via KFW, krb524 is no longer required.
17      Instead the raw Kerberos 5 ticket is used in its entirety.  This
18      is extremely important as it allows us to use pure Kerberos 5 KDCs
19      as the source of the AFS authentication.  The use of up to 12,000 byte
20      tickets will allow tickets produced by all versions of Microsoft
21      Active Directory to be used.
22       - create a user account.       
23       - designate it DES only
24       - disable pre-auth
25       - specify its UPN to be  "afs@realm"
26       - assign a SPN of "afs/cellname" to the UPN with setspn.exe
27
28    * Do not enforce the funky 8dot3 pattern matching rule that the first "."
29      is special when using long file names.  (you must use "*.*" and not "*")
30      Instead only enforce it when performing 8dot3 searches. 
31
32    * Fixed the DST problem with creation times being set one hour ahead
33
34    * Fixed the problem when using \\afs\cell-alias.  For example, 
35      \\afs\uncc instead of \\afs\uncc.edu.  Do not a new cell struct
36      for the alias name; instead simply expand the name.  One of the
37      symptoms of this problem was a loss of acquired tokens.
38
39    * Fixed the AFS Shell Extension.  The Symbolic Link menu was empty 
40      of strings.  (Only English strings provided.)
41
42    * Fixed the installer to properly replace in use files.  
43
44    * Fixed the build system to cleanup generated component version files
45
46    * The release build compiled with MSVC 6.0 compiler to avoid the 
47      afsd_service.exe shutdown crash.  This does not solve the problem
48      but simply avoids it for the time being.
49
50 Since 1.3.61:
51
52  * fix afslogon.dll to not corrupt memory when High Security mode
53    is not used.  
54
55  * fix afsd_service.exe to not attempt to restore the stack when
56    an exception occurs.  (not safe in multi-threaded programs)
57
58  * fix uninstaller to properly remove the CRT and MFC DLLs
59  
60  * remove a Message Box from afscreds.exe when getcellconfig()
61    fails on a kerberos realm which is not a cell
62
63 The following is a list of changes to the OpenAFS for Window client
64 since 1.3.60.
65
66  * "fs setserverprefs" will leave afsd service deadlocked
67
68  * "vos listaddrs" will core dump
69
70  * installer sets the appropriate keys to support Integrated Logon
71
72  * installer disables the "Find Lana by Name" functionality as it
73    was causing headaches for many users
74
75  * fix the intermittent crash of the power management thread when
76    shutting down the AFS Client Service
77
78  * optimizes the obtain drive mount list functionality which is 
79    executed every time the mount tab in afscreds.exe and afs_config.exe
80    are refreshed.  (this happens a lot)
81
82  * fix the service shutdown logic.  add the STOP_PENDING state
83    and do not accept additional service events after we declare
84    ourselves STOPPED.
85
86 The following is a list of changes to the OpenAFS for Window client
87 since 1.2.10.
88
89 * flexelint was run against the source tree and hundreds (perhaps 
90   thousands) of corrections were applied to ensure prototypes 
91   were in use; types were used consistently; variables were 
92   initialized; unused variables were removed; etc.
93
94 * A wide variety of instrumentation was added including the 
95   ability to produce a stack trace from within afsd_service.exe
96   when it crashes.
97
98 * Dynamic configuration of the RDRtimeout value based upon the
99   LanMan Workstation Session Timeout
100
101 * The mount root no longer needs to be called "/afs".  This 
102   is now set by a registry value "MountRoot" within the key
103   HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
104
105 * The cell list is now only read out of afsdcell.ini when the
106   file changes instead of each time a cell is resolved.
107
108 * Thread synchronization was added to cm_server.c and ktc_nt.c
109
110 * All calls to GlobalAlloc()/GlobalFree() were replaced with 
111   calloc()/free().  The Global functions were needed on Windows 3.x
112   but have caused a variety of problems on the Win32 platforms.
113   Avoiding them is highly recommended by several Microsoft 
114   Knowledgebase articles
115
116 * Support for Symbolic Links added to the AFS Shell Extension
117
118 * Added a registry value "OverlayEnabled" to determine if
119   Shell Extension Overlays should be enabled.  
120   HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
121
122 * New Build system to support VC6, VC.NET, VC.NET2003 compilers and
123   separate trees for checked and free builds.  Build system supports
124   a custom directory src\WINNT\extra which can be used as a grafting
125   location of organization specific additions to the build tree.
126
127 * New installer built using NSIS 2.0.  
128
129 * Named all kernel objects in order to allow them to be monitored
130   with tools such as SysInternals' ProcExp.exe.
131   
132 * Introduced new EventLog framework for AFSD
133
134 * Introduced Power Management interface to AFSD for Standby and 
135   Hibernate modes to allow cache to be flushed prior to network
136   disconnect
137
138 * Utilize Win32 DNSQuery API instead of internal routines.  This 
139   allows DNS SRV queries to be sent to all current domain name 
140   servers.  Not just one specified in an INI file.  DNS is now
141   always activated.
142
143 * "NetbiosName" registry value may be used to specify a fixed
144   Netbios Name such as "AFS" to be used instead of "HOSTNAME-AFS"
145   when the loopback adapter is in use.  If you need to use the 
146   old notation with a loopback adapter installed specify a registry
147   entry of 
148
149      "NetbiosName" REG_EXPAND_SZ = "%COMPUTERNAME%-AFS"
150
151 * Refactor all modules which depend on LAN Adapter and NetbiosName
152   determination in a new library: lanahelper.lib.  This allows for
153   consistent behavior throughout the product.
154
155 * Move the afsd.log and afsd_init.log files to the directory specified
156   by the "TEMP" environment variable.  This is usually %WINDIR%\TEMP
157   for services.  Added the Date to the log entries.
158
159 * New registry value "RxMaxMTU" used to limit the size of the RX 
160   packets sent by the AFS Client Service to the Server.  In order
161   to enable OpenAFS to work across the Cisco IPSec VPN the packet
162   size must be restricted to 1264 or smaller.  The latest NSIS
163   installer sets a value of 1260 by default.
164
165 * New registry value "RxNoJumbo" to disable the use of Jumbo Rx
166   packets.  This is not needed in order to work across the Cisco
167   VPN but might be needed for other network environments.  This
168   value is not set by the NSIS installer.
169
170 * New registry value "HideDotFiles" is used to apply the Hidden
171   attribute to files whose names begin with a '.'.   This value
172   is set by the NSIS installer.
173
174 * New registry value "MaxMpxRequests" allows the maximum number
175   of multiplexed sessions to be configured at run time.  This
176   value is not set by the NSIS installer.  The default value is
177   50.
178
179 * New registry value "MaxVCPerServer" allows the maxmimum number
180   of VCs per server to be configured at run time.  This value is
181   not set by the NSIS installer.  The default value is 100.
182
183 * New registry value "AllSubmount" allows the "all" submount to
184   be disabled by setting its value to 0x00.
185
186 * Allow cells names to be valid mount points 
187     \\<netbiosName>\<cellname>
188
189 * Store the active state of drive mappings in order for afscreds.exe
190   to restore them upon startup
191
192 * Add exception handling to generate a Stack Trace to the afsd_init.log
193   file if one happens to occur.
194
195 * Add lots of logging to help detect the cause of invalid SMB packets
196
197 * Enable Kerberos for Windows to be used to obtain AFS Tokens via
198   conversion of Kerberos 5 "afs" service tickets.  Supports auto-
199   renewal of expiring tokens as long as afscreds.exe is running.
200
201 * New afscreds.exe command line options:
202     -A = autoinit
203     -M = renew drive maps
204     -N = ip address change detection
205     -Z = unmap drives
206
207 * New registry value "EnableKFW" in {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
208   determines whether or not MIT Kerberos for Windows should be used
209   to obtain tokens via Kerberos 5 tickets.
210
211 * New registry value "AfscredsShortcutParams" in 
212   {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
213   determines the command line parameters to be specified when "fixing"
214   the AFS Shortcut in the user's startup folder.
215
216 * The "ShowTrayIcon" registry value has been moved from 
217   HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
218   {HKCU,HKLM}SOFTWARE\OpenAFS\Client 
219   
220 * The <cell name> registry values used to store the token expiration
221   reminders have been moved from 
222   HKLM\Software\TransarcCorporation\AFS Client\AfsCreds to
223   {HKCU,HKLM}SOFTWARE\OpenAFS\Client\Reminders
224  
225 * Obtain the Logon User Name from the Explorer key when available
226
227 * new text document doc\txt\winnotes\registry.txt lists all registry
228   values used by OpenAFS (excluding the AFS Server)
229
230 * BUG: rx_securityClass objects were not properly reference 
231   counted and were never freed.  
232
233 * BUG: reduce the number of conditions under which CM_ERROR_TIMEOUT
234   would be generated.  The existence of a server does not imply
235   that it is not down.  If all of the servers for a cell are down
236   return CM_ERROR_NOSUCHVOLUME instead.  This prevents the Explorer
237   Shell from hanging.
238
239 * BUG: the directory name lookup cache failed to free the entries
240   in the cache when the name cache entries cycled.  The entries
241   in the cache would become dereferenced without being freed.
242
243 * BUG: fs setserverprefs could be executed without Administrator
244   privileges
245
246 * BUG: the number of allocated NCB objects (100) exceeded the number
247   which could actually be waited upon by the kernel (64).  Any objects
248   which were utilized above the limit could never have event completions
249   detected.
250
251 * BUG: smb_username_t objects were not being reference counted and 
252   were not properly freed.
253
254 * BUG: smb_tid_t objects could under unusual circumstances be freed
255   before they were no longer referenced.
256
257 * BUG: smb_fid_t object pointer were frequently used even when 
258   their value could be NULL.   They were not properly released and
259   therefore they were never freed.
260
261 * BUG: smb_packet_t data structures were not completely initialized
262   upon creation
263
264 * BUG: when Rx produces a CM_ERROR_NOIPC error do not return "Access
265   Denied" because that causes the Explorer Shell to try again until
266   access is obtained.  Instead return "Remote Resources" which allows 
267   the shell to move on and treat the error as transient.
268
269 * BUG: when initializing the NCBreturns structure, separate Event objects
270   were created for each NCB although a single Event object was supposed
271   to be shared by all.
272
273 * BUG: smb_dirSearch_t objects were not being properly referenced counted
274   or freed.
275
276 * BUG: smb_tran2Packet_t objects were not being properly referenced 
277   counted or freed.
278
279 * BUG: directory path creation did not handle the case of multiple
280   directories requiring creation in one attempt
281
282 * BUG: SMB requests which required an Extended Response were ignored.
283   This prevented some files from being written to AFS volumes.
284
285 * BUG: character strings were being freed even after they were 
286   inserted into in use data structures
287
288 * BUG: inconsistent usernames were used when High Security mode was
289   enabled.  (there is still much to do in this area)
290
291 * BUG: pioctl() calls which require out of band RPC operations were
292   susceptible to race conditions when performed by multiple processes
293
294 * BUG: memory allocation and deallocation crossed instances of the
295   C Runtime Library producing memory leakage and corruption in 
296   afscreds and the client configurator.
297
298
299