rules.d/60-persistent-storage.rules.in

   1 # do not edit this file, it will be overwritten on update
   2
   3 # persistent storage links: /dev/disk/{by-id,by-uuid,by-label,by-path}
   4 # scheme based on "Linux persistent device names", 2004, Hannes Reinecke <hare@suse.de>
   5
   6 ACTION=="remove", GOTO="persistent_storage_end"
   7 ENV{UDEV_DISABLE_PERSISTENT_STORAGE_RULES_FLAG}=="1", GOTO="persistent_storage_end"
   8
   9 SUBSYSTEM!="block|ubi", GOTO="persistent_storage_end"
  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"
  11
  12 # ignore partitions that span the entire disk
  13 TEST=="whole_disk", GOTO="persistent_storage_end"
  14
  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"
  31
  32 ENV{DEVTYPE}=="partition", ENV{.PART_SUFFIX}="-part%n"
  33 ENV{DEVTYPE}!="partition", ENV{.PART_SUFFIX}=""
  34
  35 # NVMe
  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
  46 # obsolete symlink with non-escaped characters, kept for backward compatibility
  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}"
  49 # obsolete symlink that might get overridden on adding a new nvme controller, kept for backward compatibility
  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"
  56
  57 # virtio-blk
  58 KERNEL=="vd*", ATTRS{serial}=="?*", ENV{ID_SERIAL}="$attr{serial}", SYMLINK+="disk/by-id/virtio-$env{ID_SERIAL}$env{.PART_SUFFIX}"
  59
  60 # ATA
  61 KERNEL=="sd*[!0-9]|sr*", ENV{ID_SERIAL}!="?*", SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", IMPORT{program}="ata_id --export $devnode"
  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}"
  64
  65 # ATAPI devices (SPC-3 or later)
  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"
  67
  68 # Run ata_id on non-removable USB Mass Storage (SATA/PATA disks in enclosures)
  69 KERNEL=="sd*[!0-9]|sr*", ENV{ID_SERIAL}!="?*", ATTR{removable}=="0", SUBSYSTEMS=="usb", IMPORT{program}="ata_id --export $devnode"
  70
  71 # Also import properties from usb_id for USB devices
  72 KERNEL=="sd*[!0-9]|sr*", SUBSYSTEMS=="usb", IMPORT{builtin}="usb_id"
  73
  74 # SCSI devices
  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"
  77
  78 KERNEL=="sd*|sr*|cciss*", ENV{ID_SERIAL}=="?*", SYMLINK+="disk/by-id/$env{ID_BUS}-$env{ID_SERIAL}$env{.PART_SUFFIX}"
  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.
  83 KERNEL=="sd*|sr*|cciss*", ENV{ID_USB_SERIAL}=="?*", SYMLINK+="disk/by-id/usb-$env{ID_USB_SERIAL}$env{.PART_SUFFIX}"
  84
  85 # PMEM devices
  86 KERNEL=="pmem*", ATTRS{uuid}=="?*", SYMLINK+="disk/by-id/pmem-$attr{uuid}$env{.PART_SUFFIX}"
  87
  88 # FireWire
  89 KERNEL=="sd*|sr*", ATTRS{ieee1394_id}=="?*", SYMLINK+="disk/by-id/ieee1394-$attr{ieee1394_id}$env{.PART_SUFFIX}"
  90
  91 # MMC
  92 KERNEL=="mmcblk[0-9]|mmcblk[0-9]p[0-9]*", SUBSYSTEMS=="mmc", GOTO="mmc_start"
  93 GOTO="mmc_end"
  94 LABEL="mmc_start"
  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"
  99
 100 # Memstick
 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"
 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"
 108
 109 # by-path
 110 ENV{DEVTYPE}=="disk", DEVPATH!="*/virtual/*", IMPORT{builtin}="path_id"
 111 ENV{DEVTYPE}=="disk", SUBSYSTEMS=="nvme-subsystem", IMPORT{builtin}="path_id"
 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"
 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}"
 117
 118 # legacy virtio-pci by-path links (deprecated)
 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}"
 121
 122 {% if HAVE_BLKID %}
 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
 126 # probe filesystem metadata of optical drives which have a media inserted
 127 KERNEL=="sr*", ENV{DISK_EJECT_REQUEST}!="?*", ENV{ID_CDROM_MEDIA_TRACK_COUNT_DATA}=="?*", ENV{ID_CDROM_MEDIA_SESSION_LAST_OFFSET}=="?*", \
 128   IMPORT{builtin}="blkid --hint=session_offset=$env{ID_CDROM_MEDIA_SESSION_LAST_OFFSET}"
 129 # single-session CDs do not have ID_CDROM_MEDIA_SESSION_LAST_OFFSET
 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"
 132
 133 # probe filesystem metadata of disks
 134 KERNEL!="sr*|mmcblk[0-9]boot[0-9]", IMPORT{builtin}="blkid"
 135
 136 LABEL="persistent_storage_blkid_probe_end"
 137 {% endif %}
 138
 139 # by-label/by-uuid links (filesystem metadata)
 140 ENV{ID_FS_USAGE}=="filesystem|other|crypto", ENV{ID_FS_UUID_ENC}=="?*", SYMLINK+="disk/by-uuid/$env{ID_FS_UUID_ENC}"
 141 ENV{ID_FS_USAGE}=="filesystem|other|crypto", ENV{ID_FS_LABEL_ENC}=="?*", SYMLINK+="disk/by-label/$env{ID_FS_LABEL_ENC}"
 142
 143 # by-id (World Wide Name)
 144 ENV{ID_WWN_WITH_EXTENSION}=="?*", SYMLINK+="disk/by-id/wwn-$env{ID_WWN_WITH_EXTENSION}$env{.PART_SUFFIX}"
 145
 146 # by-partlabel/by-partuuid links (partition metadata)
 147 ENV{ID_PART_ENTRY_UUID}=="?*", SYMLINK+="disk/by-partuuid/$env{ID_PART_ENTRY_UUID}"
 148 ENV{ID_PART_ENTRY_SCHEME}=="gpt", ENV{ID_PART_ENTRY_NAME}=="?*", SYMLINK+="disk/by-partlabel/$env{ID_PART_ENTRY_NAME}"
 149
 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
 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)
 166 ENV{DISKSEQ}=="?*", ENV{ID_IGNORE_DISKSEQ}!="1", SYMLINK+="disk/by-diskseq/$env{DISKSEQ}$env{.PART_SUFFIX}"
 167
 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
 177 LABEL="persistent_storage_end"