]>
Commit | Line | Data |
---|---|---|
4beaed36 KS |
1 | # do not edit this file, it will be overwritten on update |
2 | ||
31150fbb | 3 | # persistent storage links: /dev/disk/{by-id,by-uuid,by-label,by-path} |
a3f129d0 KS |
4 | # scheme based on "Linux persistent device names", 2004, Hannes Reinecke <hare@suse.de> |
5 | ||
c6e20ceb | 6 | ACTION=="remove", GOTO="persistent_storage_end" |
542127ea | 7 | ENV{UDEV_DISABLE_PERSISTENT_STORAGE_RULES_FLAG}=="1", GOTO="persistent_storage_end" |
c6e20ceb | 8 | |
21ac7884 | 9 | SUBSYSTEM!="block|ubi", GOTO="persistent_storage_end" |
a71eb567 | 10 | KERNEL!="loop*|mmcblk*[0-9]|msblk*[0-9]|mspblk*[0-9]|nvme*|sd*|sr*|vd*|xvd*|bcache*|cciss*|dasd*|ubd*|ubi*|scm*|pmem*|nbd*|zd*", GOTO="persistent_storage_end" |
a3f129d0 | 11 | |
51b5c5f8 | 12 | # ignore partitions that span the entire disk |
1ed38f41 | 13 | TEST=="whole_disk", GOTO="persistent_storage_end" |
f809fdff | 14 | |
19212f27 TS |
15 | # For partitions import parent disk ID_* information, except ID_FS_*. |
16 | # | |
17 | # This is particularly important on media where a filesystem superblock and | |
18 | # partition table are found on the same level, e.g. common Linux distro ISO | |
19 | # installation media. | |
20 | # | |
21 | # In the case where a partition device points to the same filesystem that | |
22 | # was detected on the parent disk, the ID_FS_* information is already | |
23 | # present on the partition devices as well as the parent, so no need to | |
24 | # propagate it. In the case where the partition device points to a different | |
25 | # filesystem, merging the parent ID_FS_ properties would lead to | |
26 | # inconsistencies, so we avoid doing so. | |
27 | ENV{DEVTYPE}=="partition", \ | |
28 | IMPORT{parent}="ID_[!F]*", IMPORT{parent}="ID_", \ | |
29 | IMPORT{parent}="ID_F[!S]*", IMPORT{parent}="ID_F", \ | |
30 | IMPORT{parent}="ID_FS[!_]*", IMPORT{parent}="ID_FS" | |
a3f129d0 | 31 | |
998db587 YW |
32 | ENV{DEVTYPE}=="partition", ENV{.PART_SUFFIX}="-part%n" |
33 | ENV{DEVTYPE}!="partition", ENV{.PART_SUFFIX}="" | |
34 | ||
427a28ec | 35 | # NVMe |
998db587 YW |
36 | KERNEL!="nvme*[0-9]n*[0-9]|nvme*[0-9]n*[0-9]p*[0-9]", GOTO="nvme_end" |
37 | ||
38 | ATTRS{serial}=="?*", ENV{ID_SERIAL_SHORT}="$attr{serial}" | |
39 | ATTRS{wwid}=="?*", ENV{ID_WWN}="$attr{wwid}" | |
40 | ATTRS{model}=="?*", ENV{ID_MODEL}="$attr{model}" | |
41 | ATTRS{firmware_rev}=="?*", ENV{ID_REVISION}="$attr{firmware_rev}" | |
42 | ATTRS{nsid}=="?*", ENV{ID_NSID}="$attr{nsid}" | |
43 | ||
44 | ENV{ID_WWN}=="?*", SYMLINK+="disk/by-id/nvme-$env{ID_WWN}$env{.PART_SUFFIX}" | |
45 | ||
94d82b59 | 46 | # obsolete symlink with non-escaped characters, kept for backward compatibility |
998db587 YW |
47 | ENV{ID_MODEL}=="?*", ENV{ID_SERIAL_SHORT}=="?*", ENV{ID_MODEL}!="*/*", ENV{ID_SERIAL_SHORT}!="*/*", \ |
48 | ENV{ID_SERIAL}="$env{ID_MODEL}_$env{ID_SERIAL_SHORT}", SYMLINK+="disk/by-id/nvme-$env{ID_SERIAL}$env{.PART_SUFFIX}" | |
c5ba7a2a | 49 | # obsolete symlink that might get overridden on adding a new nvme controller, kept for backward compatibility |
998db587 YW |
50 | ENV{ID_MODEL}=="?*", ENV{ID_SERIAL_SHORT}=="?*", OPTIONS="string_escape=replace", \ |
51 | ENV{ID_SERIAL}="$env{ID_MODEL}_$env{ID_SERIAL_SHORT}", SYMLINK+="disk/by-id/nvme-$env{ID_SERIAL}$env{.PART_SUFFIX}" | |
52 | ENV{ID_MODEL}=="?*", ENV{ID_SERIAL_SHORT}=="?*", ENV{ID_NSID}=="?*", OPTIONS="string_escape=replace", \ | |
53 | ENV{ID_SERIAL}="$env{ID_MODEL}_$env{ID_SERIAL_SHORT}_$env{ID_NSID}", SYMLINK+="disk/by-id/nvme-$env{ID_SERIAL}$env{.PART_SUFFIX}" | |
54 | ||
55 | LABEL="nvme_end" | |
a5110c90 | 56 | |
2d000ed9 | 57 | # virtio-blk |
998db587 | 58 | KERNEL=="vd*", ATTRS{serial}=="?*", ENV{ID_SERIAL}="$attr{serial}", SYMLINK+="disk/by-id/virtio-$env{ID_SERIAL}$env{.PART_SUFFIX}" |
2d000ed9 | 59 | |
1aff2068 | 60 | # ATA |
220893b3 | 61 | KERNEL=="sd*[!0-9]|sr*", ENV{ID_SERIAL}!="?*", SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", IMPORT{program}="ata_id --export $devnode" |
8a86e15f | 62 | KERNEL=="sd*[!0-9]|sr*", ENV{ID_BUS}=="ata", ENV{ID_ATA_PERIPHERAL_DEVICE_TYPE}=="20", PROGRAM="scsi_id -u -g $devnode", \ |
63 | SYMLINK+="disk/by-id/scsi-$result$env{.PART_SUFFIX}" | |
1aff2068 KS |
64 | |
65 | # ATAPI devices (SPC-3 or later) | |
220893b3 | 66 | KERNEL=="sd*[!0-9]|sr*", ENV{ID_SERIAL}!="?*", SUBSYSTEMS=="scsi", ATTRS{type}=="5", ATTRS{scsi_level}=="[6-9]*", IMPORT{program}="ata_id --export $devnode" |
42b9482a DZ |
67 | |
68 | # Run ata_id on non-removable USB Mass Storage (SATA/PATA disks in enclosures) | |
220893b3 | 69 | KERNEL=="sd*[!0-9]|sr*", ENV{ID_SERIAL}!="?*", ATTR{removable}=="0", SUBSYSTEMS=="usb", IMPORT{program}="ata_id --export $devnode" |
1aff2068 | 70 | |
479da110 YW |
71 | # Also import properties from usb_id for USB devices |
72 | KERNEL=="sd*[!0-9]|sr*", SUBSYSTEMS=="usb", IMPORT{builtin}="usb_id" | |
42b9482a | 73 | |
52346b5f | 74 | # SCSI devices |
6fdc9fbc YW |
75 | KERNEL=="sd*[!0-9]|sr*", ENV{ID_SERIAL}!="?*", IMPORT{program}="scsi_id --export --allowlisted -d $devnode", ENV{ID_BUS}="scsi" |
76 | KERNEL=="cciss*", ENV{DEVTYPE}=="disk", ENV{ID_SERIAL}!="?*", IMPORT{program}="scsi_id --export --allowlisted -d $devnode", ENV{ID_BUS}="cciss" | |
998db587 YW |
77 | |
78 | KERNEL=="sd*|sr*|cciss*", ENV{ID_SERIAL}=="?*", SYMLINK+="disk/by-id/$env{ID_BUS}-$env{ID_SERIAL}$env{.PART_SUFFIX}" | |
479da110 YW |
79 | # Previously, ata_id in the above might not be able to retrieve attributes correctly, |
80 | # and properties from usb_id were used as a fallback. See issue #24921 and PR #24923. | |
81 | # To keep backward compatibility, still we need to create symlinks based on USB serial. | |
82 | # See issue #25179. | |
998db587 | 83 | KERNEL=="sd*|sr*|cciss*", ENV{ID_USB_SERIAL}=="?*", SYMLINK+="disk/by-id/usb-$env{ID_USB_SERIAL}$env{.PART_SUFFIX}" |
a3f129d0 | 84 | |
9eb0fc32 | 85 | # PMEM devices |
998db587 | 86 | KERNEL=="pmem*", ATTRS{uuid}=="?*", SYMLINK+="disk/by-id/pmem-$attr{uuid}$env{.PART_SUFFIX}" |
9eb0fc32 | 87 | |
52346b5f | 88 | # FireWire |
998db587 | 89 | KERNEL=="sd*|sr*", ATTRS{ieee1394_id}=="?*", SYMLINK+="disk/by-id/ieee1394-$attr{ieee1394_id}$env{.PART_SUFFIX}" |
333b736f | 90 | |
1aff2068 | 91 | # MMC |
074d9092 YW |
92 | KERNEL=="mmcblk[0-9]|mmcblk[0-9]p[0-9]*", SUBSYSTEMS=="mmc", GOTO="mmc_start" |
93 | GOTO="mmc_end" | |
94 | LABEL="mmc_start" | |
998db587 YW |
95 | ATTRS{name}=="?*", ENV{ID_NAME}="$attr{name}" |
96 | ATTRS{serial}=="?*", ENV{ID_SERIAL}="$attr{serial}" | |
97 | ENV{ID_NAME}=="?*", ENV{ID_SERIAL}=="?*", SYMLINK+="disk/by-id/mmc-$env{ID_NAME}_$env{ID_SERIAL}$env{.PART_SUFFIX}" | |
98 | LABEL="mmc_end" | |
1aff2068 KS |
99 | |
100 | # Memstick | |
074d9092 YW |
101 | KERNEL=="msblk[0-9]|mspblk[0-9]|msblk[0-9]p[0-9]|mspblk[0-9]p[0-9]", SUBSYSTEMS=="memstick", GOTO="memstick_start" |
102 | GOTO="memstick_end" | |
103 | LABEL="memstick_start" | |
998db587 YW |
104 | ATTRS{name}=="?*", ENV{ID_NAME}="$attr{name}" |
105 | ATTRS{serial}=="?*", ENV{ID_SERIAL}="$attr{serial}" | |
106 | ENV{ID_NAME}=="?*", ENV{ID_SERIAL}=="?*", SYMLINK+="disk/by-id/memstick-$env{ID_NAME}_$env{ID_SERIAL}$env{.PART_SUFFIX}" | |
107 | LABEL="memstick_end" | |
15b3df55 | 108 | |
1aff2068 | 109 | # by-path |
d7867b31 | 110 | ENV{DEVTYPE}=="disk", DEVPATH!="*/virtual/*", IMPORT{builtin}="path_id" |
67c3e1f6 | 111 | ENV{DEVTYPE}=="disk", SUBSYSTEMS=="nvme-subsystem", IMPORT{builtin}="path_id" |
873be895 YW |
112 | KERNEL=="mmcblk[0-9]boot[0-9]", ENV{DEVTYPE}=="disk", ENV{ID_PATH}=="?*", SYMLINK+="disk/by-path/$env{ID_PATH}-boot%n" |
113 | KERNEL=="mmcblk[0-9]boot[0-9]", ENV{DEVTYPE}=="disk", ENV{ID_PATH_WITH_USB_REVISION}=="?*", SYMLINK+="disk/by-path/$env{ID_PATH_WITH_USB_REVISION}-boot%n" | |
998db587 YW |
114 | KERNEL!="mmcblk[0-9]boot[0-9]", ENV{ID_PATH}=="?*", SYMLINK+="disk/by-path/$env{ID_PATH}$env{.PART_SUFFIX}" |
115 | KERNEL!="mmcblk[0-9]boot[0-9]", ENV{ID_PATH_ATA_COMPAT}=="?*", SYMLINK+="disk/by-path/$env{ID_PATH_ATA_COMPAT}$env{.PART_SUFFIX}" | |
116 | KERNEL!="mmcblk[0-9]boot[0-9]", ENV{ID_PATH_WITH_USB_REVISION}=="?*", SYMLINK+="disk/by-path/$env{ID_PATH_WITH_USB_REVISION}$env{.PART_SUFFIX}" | |
f809fdff | 117 | |
fb92fbb1 | 118 | # legacy virtio-pci by-path links (deprecated) |
998db587 YW |
119 | KERNEL=="vd*", ENV{ID_PATH}=="pci-*", SYMLINK+="disk/by-path/virtio-$env{ID_PATH}$env{.PART_SUFFIX}" |
120 | KERNEL=="vd*", ENV{ID_PATH_WITH_USB_REVISION}=="pci-*", SYMLINK+="disk/by-path/virtio-$env{ID_PATH_WITH_USB_REVISION}$env{.PART_SUFFIX}" | |
fb92fbb1 | 121 | |
f94e9529 | 122 | {% if HAVE_BLKID %} |
b5e17d7f DL |
123 | # allow admin to disable probing the filesystem for slow devices like floppy disk drives |
124 | ENV{UDEV_DISABLE_PERSISTENT_STORAGE_BLKID_FLAG}=="1", GOTO="persistent_storage_blkid_probe_end" | |
125 | ||
8eb4ab83 | 126 | # probe filesystem metadata of optical drives which have a media inserted |
7c2dee4a | 127 | KERNEL=="sr*", ENV{DISK_EJECT_REQUEST}!="?*", ENV{ID_CDROM_MEDIA_TRACK_COUNT_DATA}=="?*", ENV{ID_CDROM_MEDIA_SESSION_LAST_OFFSET}=="?*", \ |
4fcc033b | 128 | IMPORT{builtin}="blkid --hint=session_offset=$env{ID_CDROM_MEDIA_SESSION_LAST_OFFSET}" |
ce096702 | 129 | # single-session CDs do not have ID_CDROM_MEDIA_SESSION_LAST_OFFSET |
7c2dee4a KS |
130 | KERNEL=="sr*", ENV{DISK_EJECT_REQUEST}!="?*", ENV{ID_CDROM_MEDIA_TRACK_COUNT_DATA}=="?*", ENV{ID_CDROM_MEDIA_SESSION_LAST_OFFSET}=="", \ |
131 | IMPORT{builtin}="blkid --noraid" | |
8eb4ab83 | 132 | |
88ec7bb7 | 133 | # probe filesystem metadata of disks |
8db704b2 | 134 | KERNEL!="sr*|mmcblk[0-9]boot[0-9]", IMPORT{builtin}="blkid" |
88ec7bb7 | 135 | |
b5e17d7f | 136 | LABEL="persistent_storage_blkid_probe_end" |
f94e9529 | 137 | {% endif %} |
b5e17d7f | 138 | |
41677cf5 | 139 | # by-label/by-uuid links (filesystem metadata) |
9e23328e | 140 | ENV{ID_FS_USAGE}=="filesystem|other|crypto", ENV{ID_FS_UUID_ENC}=="?*", SYMLINK+="disk/by-uuid/$env{ID_FS_UUID_ENC}" |
f2bd7522 | 141 | ENV{ID_FS_USAGE}=="filesystem|other|crypto", ENV{ID_FS_LABEL_ENC}=="?*", SYMLINK+="disk/by-label/$env{ID_FS_LABEL_ENC}" |
a3f129d0 | 142 | |
28c74639 | 143 | # by-id (World Wide Name) |
998db587 | 144 | ENV{ID_WWN_WITH_EXTENSION}=="?*", SYMLINK+="disk/by-id/wwn-$env{ID_WWN_WITH_EXTENSION}$env{.PART_SUFFIX}" |
28c74639 | 145 | |
693b6344 | 146 | # by-partlabel/by-partuuid links (partition metadata) |
cf1d3efc | 147 | ENV{ID_PART_ENTRY_UUID}=="?*", SYMLINK+="disk/by-partuuid/$env{ID_PART_ENTRY_UUID}" |
693b6344 K |
148 | ENV{ID_PART_ENTRY_SCHEME}=="gpt", ENV{ID_PART_ENTRY_NAME}=="?*", SYMLINK+="disk/by-partlabel/$env{ID_PART_ENTRY_NAME}" |
149 | ||
3af66c08 RH |
150 | # by-path/<path>/by-* links (path + partition/filesystem metadata) |
151 | ENV{ID_PATH}=="", GOTO="persistent_storage_by-path_parts_end" | |
152 | ENV{DEVTYPE}!="partition", GOTO="persistent_storage_by-path_parts_end" | |
153 | ||
154 | SYMLINK+="disk/by-path/$env{ID_PATH}-part/by-partnum/%n" | |
155 | ENV{ID_PART_ENTRY_UUID}=="?*", SYMLINK+="disk/by-path/$env{ID_PATH}-part/by-partuuid/$env{ID_PART_ENTRY_UUID}" | |
156 | ENV{ID_PART_ENTRY_SCHEME}=="gpt", ENV{ID_PART_ENTRY_NAME}=="?*", SYMLINK+="disk/by-path/$env{ID_PATH}-part/by-partlabel/$env{ID_PART_ENTRY_NAME}" | |
157 | ||
158 | ENV{ID_FS_USAGE}=="filesystem|other|crypto", ENV{ID_FS_UUID_ENC}=="?*", SYMLINK+="disk/by-path/$env{ID_PATH}-part/by-uuid/$env{ID_FS_UUID_ENC}" | |
159 | ENV{ID_FS_USAGE}=="filesystem|other|crypto", ENV{ID_FS_LABEL_ENC}=="?*", SYMLINK+="disk/by-path/$env{ID_PATH}-part/by-label/$env{ID_FS_LABEL_ENC}" | |
160 | ||
161 | LABEL="persistent_storage_by-path_parts_end" | |
162 | ||
0d08db7f LP |
163 | # by-diskseq link (if an app is told to open a path like this, they may parse |
164 | # the diskseq number from the path, then issue BLKGETDISKSEQ to verify they really got | |
165 | # the right device, to access specific disks in a race-free fashion) | |
998db587 | 166 | ENV{DISKSEQ}=="?*", ENV{ID_IGNORE_DISKSEQ}!="1", SYMLINK+="disk/by-diskseq/$env{DISKSEQ}$env{.PART_SUFFIX}" |
0d08db7f | 167 | |
7a05926f YW |
168 | # Create symlinks that allow referencing loopback devices by their backing file's inode number |
169 | ENV{ID_LOOP_BACKING_DEVICE}!="", ENV{ID_LOOP_BACKING_INODE}!="", SYMLINK+="disk/by-loop-inode/$env{ID_LOOP_BACKING_DEVICE}-$env{ID_LOOP_BACKING_INODE}$env{.PART_SUFFIX}" | |
170 | ||
171 | # Similar, but uses the .lo_file_name field of the loopback device (note that | |
172 | # this is basically just a free-form string passed from userspace to the kernel | |
173 | # when the device is created, it is not necessarily a file system path like the | |
174 | # "loop/backing_file" sysfs attribute, which is always an absolute path) | |
175 | ENV{ID_LOOP_BACKING_FILENAME_ENC}!="", SYMLINK+="disk/by-loop-ref/$env{ID_LOOP_BACKING_FILENAME_ENC}$env{.PART_SUFFIX}" | |
176 | ||
ad9deeeb | 177 | LABEL="persistent_storage_end" |