[newlib-cygwin/main] Cygwin: Document /dev/disk/by-id and /dev/disk/by-partuuid

[newlib-cygwin/main] Cygwin: Document /dev/disk/by-id and /dev/disk/by-partuuid

[Corinna Vinschen]

https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;h=7236f22f713a923759ec7a98b4572c1910beb730

commit 7236f22f713a923759ec7a98b4572c1910beb730
Author:     Christian Franke <christian.franke@t-online.de>
AuthorDate: Tue Nov 7 15:25:54 2023 +0100
Commit:     Corinna Vinschen <corinna@vinschen.de>
CommitDate: Tue Nov 7 16:15:12 2023 +0100

    Cygwin: Document /dev/disk/by-id and /dev/disk/by-partuuid
    
    Signed-off-by: Christian Franke <christian.franke@t-online.de>

Diff:
---
 winsup/cygwin/release/3.5.0 |  6 ++++++
 winsup/doc/new-features.xml | 14 ++++++++++++++
 2 files changed, 20 insertions(+)

diff --git a/winsup/cygwin/release/3.5.0 b/winsup/cygwin/release/3.5.0
index dbbf8009d4a1..2d59818b58a8 100644
--- a/winsup/cygwin/release/3.5.0
+++ b/winsup/cygwin/release/3.5.0
@@ -17,6 +17,12 @@ What's new:
   class expressions, and collating symbols in the search pattern, i.e.,
   [:alnum:], [=a=], [.aa.].
 
+- Introduce /dev/disk directory with subdirectories by-id and by-partuuid.
+  The by-id directory provides symlinks for each disk and its partitions:
+  BUSTYPE-[VENDOR_]PRODUCT_[SERIAL|HASH][-partN] -> ../../sdX[N].
+  The by-partuuid directory provides symlinks for each MBR and GPT disk
+  partition: MBR_SERIAL-OFFSET -> ../../sdXN, GPT_GUID -> ../../sdXN.
+
 - Introduce /proc/codesets and /proc/locales with information on
   supported codesets and locales for all interested parties.  Locale(1)
   opens these files and uses the info for printing locale info like any
diff --git a/winsup/doc/new-features.xml b/winsup/doc/new-features.xml
index 78b2dbafdc2e..a8e8a7991fcb 100644
--- a/winsup/doc/new-features.xml
+++ b/winsup/doc/new-features.xml
@@ -34,6 +34,20 @@ class expressions, and collating symbols in the search pattern, i.e.,
 [:alnum:], [=a=], [.aa.].
 </para></listitem>
 
+<listitem><para>
+Introduce /dev/disk directory with subdirectories by-id and by-partuuid.
+The by-id directory provides symlinks for each disk and its partitions:
+  <screen>
+  BUSTYPE-[VENDOR_]PRODUCT_[SERIAL|0xHASH][-partN] -> ../../sdX[N]
+  </screen>
+The by-partuuid directory provides symlinks for each MBR and GPT disk
+partition:
+  <screen>
+  MBR_SERIAL-OFFSET -> ../../sdXN
+  GPT_GUID -> ../../sdXN
+  </screen>
+</para></listitem>
+
 <listitem><para>
 Introduce /proc/codesets and /proc/locales with information on supported
 codesets and locales for all interested parties.  Locale(1) opens these