]> git.ipfire.org Git - thirdparty/systemd.git/blame - rules.d/60-persistent-storage.rules.in
udev: even if a device is a zac device, scsi-$ID_SERIAL will be reserved for it ...
[thirdparty/systemd.git] / rules.d / 60-persistent-storage.rules.in
CommitLineData
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 6ACTION=="remove", GOTO="persistent_storage_end"
542127ea 7ENV{UDEV_DISABLE_PERSISTENT_STORAGE_RULES_FLAG}=="1", GOTO="persistent_storage_end"
c6e20ceb 8
21ac7884 9SUBSYSTEM!="block|ubi", GOTO="persistent_storage_end"
a71eb567 10KERNEL!="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 13TEST=="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.
27ENV{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
32ENV{DEVTYPE}=="partition", ENV{.PART_SUFFIX}="-part%n"
33ENV{DEVTYPE}!="partition", ENV{.PART_SUFFIX}=""
34
427a28ec 35# NVMe
998db587
YW
36KERNEL!="nvme*[0-9]n*[0-9]|nvme*[0-9]n*[0-9]p*[0-9]", GOTO="nvme_end"
37
38ATTRS{serial}=="?*", ENV{ID_SERIAL_SHORT}="$attr{serial}"
39ATTRS{wwid}=="?*", ENV{ID_WWN}="$attr{wwid}"
40ATTRS{model}=="?*", ENV{ID_MODEL}="$attr{model}"
41ATTRS{firmware_rev}=="?*", ENV{ID_REVISION}="$attr{firmware_rev}"
42ATTRS{nsid}=="?*", ENV{ID_NSID}="$attr{nsid}"
43
44ENV{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
47ENV{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
50ENV{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}"
52ENV{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
55LABEL="nvme_end"
a5110c90 56
2d000ed9 57# virtio-blk
998db587 58KERNEL=="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 61KERNEL=="sd*[!0-9]|sr*", ENV{ID_SERIAL}!="?*", SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", IMPORT{program}="ata_id --export $devnode"
8a86e15f 62KERNEL=="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 66KERNEL=="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 69KERNEL=="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
72KERNEL=="sd*[!0-9]|sr*", SUBSYSTEMS=="usb", IMPORT{builtin}="usb_id"
42b9482a 73
52346b5f 74# SCSI devices
6fdc9fbc
YW
75KERNEL=="sd*[!0-9]|sr*", ENV{ID_SERIAL}!="?*", IMPORT{program}="scsi_id --export --allowlisted -d $devnode", ENV{ID_BUS}="scsi"
76KERNEL=="cciss*", ENV{DEVTYPE}=="disk", ENV{ID_SERIAL}!="?*", IMPORT{program}="scsi_id --export --allowlisted -d $devnode", ENV{ID_BUS}="cciss"
998db587
YW
77
78KERNEL=="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 83KERNEL=="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 86KERNEL=="pmem*", ATTRS{uuid}=="?*", SYMLINK+="disk/by-id/pmem-$attr{uuid}$env{.PART_SUFFIX}"
9eb0fc32 87
52346b5f 88# FireWire
998db587 89KERNEL=="sd*|sr*", ATTRS{ieee1394_id}=="?*", SYMLINK+="disk/by-id/ieee1394-$attr{ieee1394_id}$env{.PART_SUFFIX}"
333b736f 90
1aff2068 91# MMC
074d9092
YW
92KERNEL=="mmcblk[0-9]|mmcblk[0-9]p[0-9]*", SUBSYSTEMS=="mmc", GOTO="mmc_start"
93GOTO="mmc_end"
94LABEL="mmc_start"
998db587
YW
95ATTRS{name}=="?*", ENV{ID_NAME}="$attr{name}"
96ATTRS{serial}=="?*", ENV{ID_SERIAL}="$attr{serial}"
97ENV{ID_NAME}=="?*", ENV{ID_SERIAL}=="?*", SYMLINK+="disk/by-id/mmc-$env{ID_NAME}_$env{ID_SERIAL}$env{.PART_SUFFIX}"
98LABEL="mmc_end"
1aff2068
KS
99
100# Memstick
074d9092
YW
101KERNEL=="msblk[0-9]|mspblk[0-9]|msblk[0-9]p[0-9]|mspblk[0-9]p[0-9]", SUBSYSTEMS=="memstick", GOTO="memstick_start"
102GOTO="memstick_end"
103LABEL="memstick_start"
998db587
YW
104ATTRS{name}=="?*", ENV{ID_NAME}="$attr{name}"
105ATTRS{serial}=="?*", ENV{ID_SERIAL}="$attr{serial}"
106ENV{ID_NAME}=="?*", ENV{ID_SERIAL}=="?*", SYMLINK+="disk/by-id/memstick-$env{ID_NAME}_$env{ID_SERIAL}$env{.PART_SUFFIX}"
107LABEL="memstick_end"
15b3df55 108
1aff2068 109# by-path
d7867b31 110ENV{DEVTYPE}=="disk", DEVPATH!="*/virtual/*", IMPORT{builtin}="path_id"
67c3e1f6 111ENV{DEVTYPE}=="disk", SUBSYSTEMS=="nvme-subsystem", IMPORT{builtin}="path_id"
873be895
YW
112KERNEL=="mmcblk[0-9]boot[0-9]", ENV{DEVTYPE}=="disk", ENV{ID_PATH}=="?*", SYMLINK+="disk/by-path/$env{ID_PATH}-boot%n"
113KERNEL=="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
114KERNEL!="mmcblk[0-9]boot[0-9]", ENV{ID_PATH}=="?*", SYMLINK+="disk/by-path/$env{ID_PATH}$env{.PART_SUFFIX}"
115KERNEL!="mmcblk[0-9]boot[0-9]", ENV{ID_PATH_ATA_COMPAT}=="?*", SYMLINK+="disk/by-path/$env{ID_PATH_ATA_COMPAT}$env{.PART_SUFFIX}"
116KERNEL!="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
119KERNEL=="vd*", ENV{ID_PATH}=="pci-*", SYMLINK+="disk/by-path/virtio-$env{ID_PATH}$env{.PART_SUFFIX}"
120KERNEL=="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
124ENV{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 127KERNEL=="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
130KERNEL=="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 134KERNEL!="sr*|mmcblk[0-9]boot[0-9]", IMPORT{builtin}="blkid"
88ec7bb7 135
b5e17d7f 136LABEL="persistent_storage_blkid_probe_end"
f94e9529 137{% endif %}
b5e17d7f 138
41677cf5 139# by-label/by-uuid links (filesystem metadata)
9e23328e 140ENV{ID_FS_USAGE}=="filesystem|other|crypto", ENV{ID_FS_UUID_ENC}=="?*", SYMLINK+="disk/by-uuid/$env{ID_FS_UUID_ENC}"
f2bd7522 141ENV{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 144ENV{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 147ENV{ID_PART_ENTRY_UUID}=="?*", SYMLINK+="disk/by-partuuid/$env{ID_PART_ENTRY_UUID}"
693b6344
K
148ENV{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)
151ENV{ID_PATH}=="", GOTO="persistent_storage_by-path_parts_end"
152ENV{DEVTYPE}!="partition", GOTO="persistent_storage_by-path_parts_end"
153
154SYMLINK+="disk/by-path/$env{ID_PATH}-part/by-partnum/%n"
155ENV{ID_PART_ENTRY_UUID}=="?*", SYMLINK+="disk/by-path/$env{ID_PATH}-part/by-partuuid/$env{ID_PART_ENTRY_UUID}"
156ENV{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
158ENV{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}"
159ENV{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
161LABEL="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 166ENV{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
169ENV{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)
175ENV{ID_LOOP_BACKING_FILENAME_ENC}!="", SYMLINK+="disk/by-loop-ref/$env{ID_LOOP_BACKING_FILENAME_ENC}$env{.PART_SUFFIX}"
176
ad9deeeb 177LABEL="persistent_storage_end"