X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=src%2Fudev%2Fudev-builtin-path_id.c;h=720f616da5b28b1e26ee1112f93b95a5e1fe8524;hb=84168d8068bb67dcd5468ab3b376535d81643aef;hp=8eac991d3c2f6784c1e688e8d6c78cca34f2b22b;hpb=2a3fe9a75951cb085b81569939f6af3ce2eb2b02;p=elogind.git

diff --git a/src/udev/udev-builtin-path_id.c b/src/udev/udev-builtin-path_id.c
index 8eac991d3..720f616da 100644
--- a/src/udev/udev-builtin-path_id.c
+++ b/src/udev/udev-builtin-path_id.c
@@ -236,7 +236,23 @@ static struct udev_device *handle_scsi_default(struct udev_device *parent, char
         if (sscanf(name, "%d:%d:%d:%d", &host, &bus, &target, &lun) != 4)
                 return NULL;
 
-        /* rebase host offset to get the local relative number */
+        /*
+         * Rebase host offset to get the local relative number
+         *
+         * Note: This is by definition racy, unreliable and too simple.
+         * Please do not copy this model anywhere. It's just a left-over
+         * from the time we had no idea how things should look like in
+         * the end.
+         *
+         * Making assumptions about a global in-kernel counter and use
+         * that to calculate a local offset is a very broken concept. It
+         * can only work as long as things are in strict order.
+         *
+         * The kernel needs to export the instance/port number of a
+         * controller directly, without the need for rebase magic like
+         * this. Manual driver unbind/bind, parallel hotplug/unplug will
+         * get into the way of this "I hope it works" logic.
+         */
         basenum = -1;
         base = strdup(udev_device_get_syspath(hostdev));
         if (base == NULL)