.shape {behavior:url(#default#VML);}
</style>
<![endif]-->
-<title>OpenAFS for Windows 1.5.33 Release Notes</title>
+<title>OpenAFS for Windows 1.5.34 Release Notes</title>
<o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
name="PostalCode"/>
<o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
font-family:"Times New Roman","serif";}
</style>
<![endif]--><!--[if gte mso 9]><xml>
- <o:shapedefaults v:ext="edit" spidmax="8194"/>
-</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1"/>
</o:shapelayout></xml><![endif]-->
+<base target="_self">
+<!--[if gte mso 9]>
+<xml><o:shapedefaults v:ext="edit" spidmax="1027"/>
+</xml><![endif]-->
</head>
-<body lang=EN-US link=navy vlink=maroon style='tab-interval:.5in;line-break:
+<body lang=EN-US link=#000080 vlink=#800000 style='tab-interval:.5in;line-break:
strict'>
<div class=Section1>
-<p class=MsoTitle>OpenAFS for Windows 1.5.33<br>
+<p class=MsoTitle>OpenAFS for Windows 1.5.34<br>
Release Notes</p>
<p class=MsoBodyText>The Andrew File System (AFS) is a location-independent
</v:formulas>
<v:path o:extrusionok="f" gradientshapeok="t" o:connecttype="rect"/>
<o:lock v:ext="edit" aspectratio="t"/>
-</v:shapetype><v:shape id="Picture_x0020_1" o:spid="_x0000_i1027" type="#_x0000_t75"
+</v:shapetype><v:shape id="Picture_x0020_1" o:spid="_x0000_s1027" type="#_x0000_t75"
alt="netidmgr_main" style='width:417pt;height:509.25pt;visibility:visible;
mso-wrap-style:square'>
<v:imagedata src="relnotes_files/image001.png" o:title="netidmgr_main"/>
</v:shape><![endif]--><![if !vml]><img border=0 width=556 height=679
-src="relnotes_files/image007.jpg" alt="netidmgr_main" v:shapes="Picture_x0020_1"><![endif]></span></p>
+src="relnotes_files/image002.jpg" alt="netidmgr_main" v:shapes="Picture_x0020_1"><![endif]></span></p>
<p class=MsoNormal>The Network Identity Manager replaces the former KFW ticket
manager, Leash\94, and when combined with the OpenAFS Provider, it is intended to
tokens for multiple cells from one or more Kerberos v5 identities.</p>
<p class=MsoNormal align=center style='text-align:center'><span
-style='mso-no-proof:yes'><!--[if gte vml 1]><v:shape id="Picture_x0020_2"
- o:spid="_x0000_i1026" type="#_x0000_t75" alt="netidmgr_afs_opt" style='width:406.5pt;
- height:294.75pt;visibility:visible;mso-wrap-style:square'>
+style='mso-no-proof:yes'><!--[if gte vml 1]><v:shape
+ id="Picture_x0020_2" o:spid="_x0000_s1026" type="#_x0000_t75" alt="netidmgr_afs_opt"
+ style='width:406.5pt;height:294.75pt;visibility:visible;mso-wrap-style:square'>
<v:imagedata src="relnotes_files/image003.png" o:title="netidmgr_afs_opt"/>
</v:shape><![endif]--><![if !vml]><img border=0 width=542 height=393
-src="relnotes_files/image008.jpg" alt="netidmgr_afs_opt" v:shapes="Picture_x0020_2"><![endif]></span></p>
+src="relnotes_files/image004.jpg" alt="netidmgr_afs_opt" v:shapes="Picture_x0020_2"><![endif]></span></p>
<p class=MsoNormal>The AFS configuration panel for each Kerberos v5 identity is
used to configure which cells credentials should be obtained for and how they
Kerberos v5 tickets as tokens, then a krb524 service can be configured.</p>
<p class=MsoNormal align=center style='text-align:center'><span
-style='mso-no-proof:yes'><!--[if gte vml 1]><v:shape id="Picture_x0020_3"
- o:spid="_x0000_i1025" type="#_x0000_t75" alt="netidmgr_afs_cfg" style='width:406.5pt;
- height:294.75pt;visibility:visible;mso-wrap-style:square'>
+style='mso-no-proof:yes'><!--[if gte vml 1]><v:shape
+ id="Picture_x0020_3" o:spid="_x0000_s1025" type="#_x0000_t75" alt="netidmgr_afs_cfg"
+ style='width:406.5pt;height:294.75pt;visibility:visible;mso-wrap-style:square'>
<v:imagedata src="relnotes_files/image005.png" o:title="netidmgr_afs_cfg"/>
</v:shape><![endif]--><![if !vml]><img border=0 width=542 height=393
-src="relnotes_files/image009.jpg" alt="netidmgr_afs_cfg" v:shapes="Picture_x0020_3"><![endif]></span></p>
+src="relnotes_files/image006.jpg" alt="netidmgr_afs_cfg" v:shapes="Picture_x0020_3"><![endif]></span></p>
<p class=MsoNormal>The OpenAFS Provider configuration panel can be used to
check the status of the AFS Client Service and its version.<span
<h2><a name="_Toc191662124"></a><a name="_Toc139993137"></a><a
name="_Toc126872214"></a><a name="_Toc115417085"></a><span style='mso-bookmark:
_Toc191662124'><span style='mso-fareast-font-family:"Times New Roman"'>4.4.
-Using SysInternal\92s DbgView and ProcMon or FileMon Tools</span></span><span
+Using SysInternal\92s Debug Viewer, Process Monitor and Process Explorer Tools</span></span><span
style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h2>
<p class=MsoNormal>An alternatve option to the use of "fs trace
-dump" to capture internal OpenAFS Client Service events is to use a tool
-such as Sysinternal's DbgView to capture real-time debugging output. When
+such as Sysinternal's
+<a href="http://technet.microsoft.com/en-us/sysinternals/bb896647.aspx">Debug Viewer</a> to capture real-time debugging output. When
the OpenAFS Client Service starts and Bit 2 of the <a
href="#_Value__:_TraceOption">TraceOption</a> value in the registry is set, all
trace log events are output using the Windows Debug Monitor interface
<p class=MsoNormal><a name="_Toc115416150"></a><a name="_Toc126872215"></a><a
name="_Toc115417086"></a><span style='mso-bookmark:_Toc115416150'>Sysinternal\92s
-ProcMon or FileMon utilities can be use to monitor the file operations
+<a href="http://technet.microsoft.com/en-us/sysinternals/bb896645.aspx">Process Monitor</a> can be use to monitor the file operations
requested by applications and their success or failure. </span></p>
-<p class=MsoNormal><span style='mso-bookmark:_Toc115416150'>In FileMon, use the
-Volumes menu to restrict monitoring to <i>Network</i> volumes only in order to
-reduce the output to just the CIFS requests. Turn on the <i>Advanced
-Output</i> option in order to log with finer granularity.</span></p>
-
-<p class=MsoNormal>In ProcMon, set a filter to include only events on file
+<p class=MsoNormal>In Process Monitor, set a filter to include only events on file
paths that refer to the AFS name space. Be sure to include both the UNC path as
well as any drive letters mapped to AFS. </p>
and the resulting OpenAFS Client Service operations. The captured
data can be stored to files for inclusion in <a href="#_5._Reporting_Bugs:">bug
reports</a>.</p>
+<p class=MsoNormal>Sysinternal's
+<a href="http://technet.microsoft.com/en-us/sysinternals/bb896653.aspx">Process
+Explorer</a> is a replacement for the Windows Task Manager and so much more.
+Process Explorer can be configured to use the DbgHelp.dll from "<a href="http://www.microsoft.com/whdc/devtools/debugging/default.mspx">Microsoft
+Debugging Tools for Windows</a>" as well as the debug symbols shipped as an
+optional component of the OpenAFS for Windows installer.
+(Options->Configure Symbols) Once configured the "Threads" tab of
+the process properties dialog will permit the viewing of a fully documented
+stack for each displayed thread. Hint: If there is a deadlock in the cache
+manager, two or more of the threads will be stuck in a call to osi_TWait().</p>
<h2><a name="_Toc191662125"><span style='mso-fareast-font-family:"Times New Roman"'>4.5.
Microsoft MiniDumps <br>
communication there may be a serious error that can only be debugged by someone
with access to the source code and a debugger. The "fs
minidump" command can be used to force the generation of a MiniDump file
-containing the state of all of the threads in the AFS Client Service process.</p>
+containing the state of all of the threads in the AFS Client Service process.
+The most accurate MiniDump files will be produced after installing "<a href="http://www.microsoft.com/whdc/devtools/debugging/default.mspx">Microsoft
+Debugging Tools for Windows</a>".</p>
<p class=MsoNormal>The <a href="#_Toc190064189">MiniDumpType</a> registry value
can be used to adjust the scope of the process information included within the
-dump file.</p>
+dump file. By default the MiniDump only contains the stacks of all threads
+and the values of all global variables. A much more useful MiniDump is one
+that contains the contents of the heap. Be warned, a MiniDump with heap
+will be as large as the cache file. In addition, it will include all of
+the data stored within the cache. If there are privacy concerns, do not
+produce a MiniDump with heap.</p>
<h2><a name="_Toc191662126"></a><a name="_Toc139993139"></a><a
name="_Toc126872216"></a><a name="_Toc115417087"></a><span style='mso-bookmark:
style='mso-bookmark:_Toc115416204'><span style='mso-fareast-font-family:"Times New Roman"'>Value:
Daemons</span></span></span></span><span style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h5>
<p class=MsoBodyText>Type: DWORD<br>
- Default: 2 (CM_CONFIGDEFAULT_DAEMONS)<br>
+ Default: 4 (CM_CONFIGDEFAULT_DAEMONS)<br>
Variable: numBkgD</p>
<p class=MsoBodyText>Number of background daemons (number of threads of
cm_BkgDaemon). (see cm_BkgDaemon in cm_daemon.c)</p>
style='mso-fareast-font-family:"Times New Roman"'>Value: TraceBufferSize</span></span></span><span
style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h5>
<p class=MsoBodyText>Type: DWORD<br>
- Default: 5000 (CM_CONFIGDEFAULT_TRACEBUFSIZE)<br>
+ Default: 10000 (CM_CONFIGDEFAULT_TRACEBUFSIZE)<br>
Variable: traceBufSize</p>
<p class=MsoBodyText>Number of entries to keep in trace log.</p>
</td>
<tr style='mso-yfti-irow:25;height:79.25pt'>
<td width=590 valign=top style='width:6.15in;padding:0in 5.4pt 0in 5.4pt;
height:79.25pt'>
- <h5><a name="_Toc191662205"></a><a name="_Toc152605168"></a><a
- name="_Toc115416226"></a><a name="_Toc126872295"></a><a name="_Toc139993218"></a><span
- style='mso-bookmark:_Toc191662205'><span style='mso-bookmark:_Toc152605168'><span
- style='mso-bookmark:_Toc115416226'><span style='mso-fareast-font-family:"Times New Roman"'>Value:
- RxNoJumbo</span></span></span></span><span style='mso-fareast-font-family:
+ <h5>
+ <span style='mso-fareast-font-family:"Times New Roman"; mso-bookmark:_Toc115416226'>Value:
+ RxEnablePeerStats</span></h5>
+ <p class=MsoBodyText>Type: DWORD {0, 1}<br>
+ Default: 1<br>
+ Variable: rx_enable_peer_stats</p>
+ <p class=MsoBodyText>When set to 1, the Rx library collects peer statistics.</p>
+ <p> </td>
+ </tr>
+ <tr style='mso-yfti-irow:25;height:79.25pt'>
+ <td width=590 valign=top style='width:6.15in;padding:0in 5.4pt 0in 5.4pt;
+ height:79.25pt'>
+ <h5>
+ <span style='mso-fareast-font-family:"Times New Roman"; mso-bookmark:_Toc115416226'>Value:
+ Rx</span>EnableProcessStats<span style='mso-fareast-font-family:
"Times New Roman"'><o:p></o:p></span></h5>
- <p class=MsoBodyText>Type: DWORD {0,1}<br>
- Default: 0<br>
- Variable: rx_nojumbo</p>
- <p class=MsoBodyText>If enabled, does not send or indicate that we are able
- to send or receive RX jumbograms.</p>
+ <p class=MsoBodyText>Type: DWORD {0, 1}<br>
+ Default: 1<br>
+ Variable: rx_extra_process_stats</p>
+ <p class=MsoBodyText>When set to 1, the Rx library collects process
+ statistics.</p>
+ </td>
+ </tr>
+ <tr style='mso-yfti-irow:26;height:124.75pt'>
+ <td width=590 valign=top style='width:6.15in;padding:0in 5.4pt 0in 5.4pt;
+ height:124.75pt'>
+ <h5>
+ <span style='mso-fareast-font-family:"Times New Roman"; mso-bookmark:_Toc115416226'>Value:
+ RxExtraPackets</span><span style='mso-fareast-font-family:
+ "Times New Roman"'><o:p></o:p></span></h5>
+ <p class=MsoBodyText>Type: DWORD <br>
+ Default: 120<br>
+ Variable: rx_extraPackets</p>
+ <p class=MsoBodyText>When set, this number of extra Rx packets are allocated
+ at startup.</p>
</td>
</tr>
<tr style='mso-yfti-irow:26;height:124.75pt'>
style='mso-fareast-font-family:"Times New Roman"'>Value: RxMaxMTU</span></span></span><span
style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h5>
<p class=MsoBodyText>Type: DWORD<br>
- Default: -1<br>
+ Default: 0<br>
Variable: rx_mtu</p>
- <p class=MsoBodyText>If set to anything other than -1, uses that value as the
- maximum MTU supported by the RX interface.</p>
- <p class=MsoBodyText>In order to enable OpenAFS to operate across the Cisco
- IPSec VPN client, this value must be set to 1264 or smaller.</p>
+ <p class=MsoBodyText>If set to anything other than 0, that value is used as the
+ maximum send and receive MTU supported by the RX interface.</p>
+ <p class=MsoBodyText>In order to enable OpenAFS to operate across releases of the Cisco
+ IPSec VPN client prior than 5.0, this value must be set to 1264 or smaller.</p>
+ </td>
+ </tr>
+ <tr style='mso-yfti-irow:27;height:151.75pt'>
+ <td width=590 valign=top style='width:6.15in;padding:0in 5.4pt 0in 5.4pt;
+ height:151.75pt'>
+ <h5><a name="_Toc191662205"></a><a name="_Toc152605168"></a><a
+ name="_Toc115416226"></a><a name="_Toc126872295"></a><a name="_Toc139993218"></a>
+ <span style='mso-fareast-font-family:"Times New Roman"; mso-bookmark:_Toc115416226'>Value:
+ RxNoJumbo</span><span style='mso-fareast-font-family:
+ "Times New Roman"'><o:p></o:p></span></h5>
+ <p class=MsoBodyText>Type: DWORD {0,1}<br>
+ Default: 0<br>
+ Variable: rx_nojumbo</p>
+ <p class=MsoBodyText>If enabled, does not send or indicate that we are able
+ to send or receive RX jumbograms.</p>
</td>
</tr>
<tr style='mso-yfti-irow:27;height:151.75pt'>
initiated is dump file is generated with the "fs.exe minidump"
command.</p>
<p class=MsoBodyText>Valid values are dependent on the version of DbgHelp.dll
- installed on the machine. See the Microsoft Developer Library for
+ installed on the machine. The best version to use is not the version
+ that comes with the operating system but the version that is included in the
+ most recent release of "<a href="http://www.microsoft.com/whdc/devtools/debugging/default.mspx">Microsoft
+ Debugging Tools for Windows</a>". See the Microsoft Developer Library for
further information.</p>
<p class=MsoBodyText>MiniDumpNormal = 0x00000000,<br>
MiniDumpWithDataSegs = 0x00000001,<br>
projects / packages / o / openafs.git / commitdiff