+2009-05-14 Corinna Vinschen <corinna@vinschen.de>
+
+ * faq-setup.xml (faq.setup.upgrade-mountpoints): New entry.
+ * faq-using.xml (faq.using.directory-structure): Align example to
+ latest mount output.
+ * pathnames.sgml (mount-table): Add note about upgrade helper scripts
+ to create /etc/fstab and /etc/fstab.f/${USER}.
+
2009-05-14 Corinna Vinschen <corinna@vinschen.de>
* new-features.sgml: Add automounting of /, /usr/bin, and /usr/lib.
</para>
</answer></qandaentry>
+<qandaentry id="faq.setup.upgrade-mountpoints">
+<question><para>After upgrading from Cygwin 1.5 to Cygwin 1.7 my user mount points disappeared! How can I get them back?</para></question>
+<answer>
+
+<para>
+When you upgrade an existing older Cygwin installation to Cygwin 1.7, your old
+system mount points (stored in the HKEY_LOCAL_MACHINE branch of your registry)
+are read by a script and the /etc/fstab file is generated from these entries.
+No such automatism exists for the user mount points formerly stored in the
+HKEY_CURRENT_USER branch of the registry. There's a bash script for your
+convenience, which creates a user-specific /etc/fstab/${USER} file for you,
+called /bin/copy-user-registry-fstab. For more information on the new fstab
+files see the User's Guide at
+<ulink url="http://cygwin.com/1.7/cygwin-ug-net/using.html#mount-table">http://cygwin.com/1.7/cygwin-ug-net/using.html#mount-table</ulink>
+</para>
+</answer></qandaentry>
+
<qandaentry id="faq.setup.virus">
<question><para>Is Cygwin Setup, or one of the packages, infected with a virus?</para></question>
<answer>
</para>
<screen>
bash$ mount
- C:\cygwin\bin on /usr/bin type system (binmode)
- C:\cygwin\lib on /usr/lib type system (binmode)
- C:\cygwin on / type system (binmode)
+ C:\cygwin\bin on /usr/bin type ntfs (binary,auto)
+ C:\cygwin\lib on /usr/lib type ntfs (binary,auto)
+ C:\cygwin on / type ntfs (binary,auto)
+ C: on /cygdrive/c type ntfs (binary,posix=0,user,noumount,auto)
</screen>
-<para>(Exactly what you see depends on what options you gave to <literal>setup.exe</literal>.)
-</para>
<para>Note that /bin and /usr/bin point to the same location, as do /lib and
/usr/lib. This is intentional, and you should not undo these mounts
unless you <emphasis>really</emphasis> know what you are doing.
See <xref linkend="mount"></xref> and <xref linkend="umount"></xref> for more
information.</para>
+<note><para>
+When you upgrade an existing older Cygwin installation to Cygwin 1.7,
+your old system mount points (stored in the HKEY_LOCAL_MACHINE branch
+of your registry) are read by a script and the <filename>/etc/fstab</filename>
+file is generated from these entries. Note that entries for
+<filename>/</filename>, <filename>/usr/bin</filename>, and
+<filename>/usr/lib</filename> are <emphasis>never</emphasis> generated.
+</para>
+
+<para>
+The old user mount points in your HKEY_CURRENT_USER branch of the registry
+are not used to generate <filename>/etc/fstab</filename>. If you want
+to create a user specific <filename>/etc/fstab.d/${USER}</filename> file
+from your old entries, there's a script available which does exactly
+that for you, <filename>bin/copy-user-registry-fstab</filename>. Just
+start the script and it will create your user specific fstab file. Stop
+all your Cygwin processes and restart them, and you can simply use your
+old user mount points as before.
+</para></note>
+
</sect2>
<sect2 id="cygdrive"><title>The cygdrive path prefix</title>