Windows: 1.7.23 Release Notes

Add explanation of Win 7 Explorer Shell Read-Only Volume vs Network Drive
Letter Mapping bug.

Change-Id: I7cf1300c9ec91cbbd347030d0bb9642c78607398
Reviewed-on: http://gerrit.openafs.org/9634
Tested-by: BuildBot <buildbot@rampaginggeek.com>
Reviewed-by: Jeffrey Altman <jaltman@your-file-system.com>
This commit is contained in:
Jeffrey Altman 2013-03-18 22:43:09 -04:00
parent 9cfd7f768c
commit 46a61f61c2

View File

@ -6,7 +6,7 @@
<bookinfo>
<title>OpenAFS for Windows Release Notes</title>
<copyright>
<year>2003-2012</year>
<year>2003-2013</year>
<holder>Secure Endpoints Inc. and Your File System Inc.</holder>
</copyright>
<legalnotice>
@ -1885,6 +1885,37 @@ network paths are inaccessible when Protected Mode is on.
The OpenAFS file system has followed suit and is disabling automatic generation of 8.3 compatible names on Windows 8 and Server 2012.
</para>
</section>
<section>
<title id="explorer_read_only_volume_bug">3.57. The Explorer Shell, Drive Letter Mappings, and Read Only Volumes</title>
<indexterm significance="normal">
<primary>explorer shell</primary>
</indexterm>
<indexterm significance="normal">
<primary>drive letter mappings</primary>
</indexterm>
<indexterm significance="normal">
<primary>.readonly volumes</primary>
</indexterm>
<para>File systems can expose a variety of information about the underlying volumes they serve
to applications. All AFS volumes are described as supporting Case Preservation, Hard Links,
Reparse Points and Unicode characters. For .readonly volumes the file system can indicate
that the volume is a Read Only Volume. The benefit of doing so is that applications such as
the Explorer Shell can alter their behavior to improve the user experience. For example,
when the volume is reported as read-only the Explorer Shell can remove the Rename, Delete,
and other file modifying operations from the user interface. Unfortunately, the Windows 7
Explorer Shell is broken with regards to Volume Information queries when issued on Network
Mapped Drive Letters. Instead of performing a volume information query on the current
directory, the Explorer Shell only queries the root directory of the mapped drive letter.
As a result, if the drive letter is mapped to a .readonly volume, all paths accessed via the
drive letter are considered to be read-only even when they are not. This behavior is fixed
in Windows 8 and Server 2012.</para>
<para>Due to this bug, OpenAFS on Windows 7 and below does not report the
<ulink url="http://msdn.microsoft.com/en-us/library/windows/desktop/aa964920%28v=vs.85%29.aspx">FILE_READ_ONLY_VOLUME</ulink>
flag as part of the volume information. The Explorer Shell properly
queries the volume information for UNC paths. If network mapped drive letters are not used,
it is often convenient if the FILE_READ_ONLY_VOLUME flag is reported. This can be
configured using the <link linkend="Regkey_TransarcAFSDaemon_Parameters_VolumeInfoReadOnlyFlag">VolumeInfoReadOnlyFlag</link> registry value.</para>
</section>
</chapter>
<chapter id="chap_4">