Re: [PATCH] Cygwin: Add /dev/disk/by-id symlinks

[Christian Franke <Christian.Franke@t-online.de>]

[-- Attachment #1: Type: text/plain, Size: 294 bytes --]

Corinna Vinschen wrote:
> ..
> Looking forward to it. We'll just need an entry for the release text
> in winsup/cygwin/release/3.5.0 and doc/new-features.xml in the end :)

Attached for now as implementing the remaining subdirs is not yet 
scheduled. Docbook formatting not tested.

Christian


[-- Attachment #2: 0001-Cygwin-Document-dev-disk-by-id-and-dev-disk-by-partu.patch --]
[-- Type: text/plain, Size: 2253 bytes --]

From b07de21461207a2b57465d3dd8f7db2b36d886c0 Mon Sep 17 00:00:00 2001
From: Christian Franke <christian.franke@t-online.de>
Date: Tue, 7 Nov 2023 15:25:54 +0100
Subject: [PATCH] Cygwin: Document /dev/disk/by-id and /dev/disk/by-partuuid

Signed-off-by: Christian Franke <christian.franke@t-online.de>
---
 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 dbbf8009d..2d59818b5 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 78b2dbafd..a8e8a7991 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
-- 
2.42.1