udev rulesでLinuxのデバイス名を固定する方法｜udevadm infoで属性確認からデバイス接続スクリプトまで

この記事のポイント

・udevはカーネルのueventを受けて/dev/を管理するデーモン
・rulesは/etc/udev/rules.d/に配置し番号順に評価される
・udevadm infoでATTR名を特定してから条件式を書く
・ACTION=="add", RUN+="スクリプト"でデバイス接続時に自動実行できる

# 書式
MATCH_KEY=="値",  MATCH_KEY=="値",  ...,  ACTION_KEY="値"

# 例：ラベル名でUSBドライブを特定してシンボリックリンクを張る
SUBSYSTEM=="block", ENV{ID_FS_LABEL}=="BACKUP_USB", SYMLINK+="backup-disk"

# /dev/sdb の属性一覧を取得する
udevadm info --query=all --name=/dev/sdb

P: /devices/pci0000:00/0000:00:14.0/usb1/1-2/1-2:1.0/host3/target3:0:0/3:0:0:0/block/sdb
N: sdb
L: 0
S: disk/by-id/usb-BUFFALO_Portable_HDD_XXXXXXXX-0:0
E: DEVPATH=/devices/pci0000:00/0000:00:14.0/usb1/1-2/1-2:1.0/host3/target3:0:0/3:0:0:0/block/sdb
E: DEVNAME=/dev/sdb
E: DEVTYPE=disk
E: SUBSYSTEM=block
E: ID_VENDOR=BUFFALO
E: ID_MODEL=Portable_HDD
E: ID_SERIAL=BUFFALO_Portable_HDD_XXXXXXXX
E: ID_SERIAL_SHORT=XXXXXXXX
E: ID_TYPE=disk
E: ID_BUS=usb
E: ID_USB_DRIVER=usb-storage
E: ID_FS_TYPE=ext4
E: ID_FS_LABEL=BACKUP_USB
E: MAJOR=8
E: MINOR=16

# 親デバイスの属性まで再帰的に表示する
udevadm info -a -n /dev/sdb | head -60

  looking at device '/devices/.../block/sdb':
    KERNEL=="sdb"
    SUBSYSTEM=="block"

  looking at parent device '/devices/.../target3:0:0/3:0:0:0':
    KERNELS=="3:0:0:0"
    SUBSYSTEMS=="scsi"
    ATTRS{vendor}=="BUFFALO "
    ATTRS{model}=="Portable_HDD"
    ATTRS{serial}=="XXXXXXXX"

  looking at parent device '/devices/.../usb1/1-2':
    KERNELS=="1-2"
    SUBSYSTEMS=="usb"
    ATTRS{idVendor}=="0411"
    ATTRS{idProduct}=="01ce"
    ATTRS{serial}=="XXXXXXXX"

# /etc/udev/rules.d/99-backup-disk.rules を作成する
# BUFFALO Portable HDD（シリアル: XXXXXXXX）を /dev/backup-disk として固定する
SUBSYSTEM=="block", ENV{ID_SERIAL}=="BUFFALO_Portable_HDD_XXXXXXXX", SYMLINK+="backup-disk", GROUP="disk", MODE="0660"

# ルールを再読み込みする
udevadm control --reload-rules

# 現在接続済みのデバイスに対してルールを再評価する
udevadm trigger --subsystem-match=block

# シンボリックリンクが作成されたか確認する
ls -la /dev/backup-disk

lrwxrwxrwx 1 root root 3 Sep 10 12:34 /dev/backup-disk -> sdb

# /etc/udev/rules.d/99-backup-disk.rules
SUBSYSTEM=="block", ACTION=="add", ENV{ID_SERIAL}=="BUFFALO_Portable_HDD_XXXXXXXX",
  SYMLINK+="backup-disk", GROUP="disk", MODE="0660",
  RUN+="/usr/local/bin/usb-backup.sh"

# udev rulesでsystemdサービスを起動する
SUBSYSTEM=="block", ACTION=="add", ENV{ID_SERIAL}=="BUFFALO_Portable_HDD_XXXXXXXX",
  SYMLINK+="backup-disk",
  RUN+="/usr/bin/systemctl start usb-rsync-backup.service"

[Unit]
Description=USB Backup via rsync

[Service]
Type=oneshot
ExecStart=/usr/local/bin/usb-backup.sh
StandardOutput=journal
StandardError=journal

# /dev/sdb のデバイスパスを確認する
udevadm info --query=path --name=/dev/sdb
# 出力例: /devices/pci0000:00/0000:00:14.0/usb1/1-2/1-2:1.0/host3/target3:0:0/3:0:0:0/block/sdb

# シミュレーションを実行する（実際のデバイスファイルは変更しない）
udevadm test /devices/pci0000:00/0000:00:14.0/usb1/1-2/1-2:1.0/host3/target3:0:0/3:0:0:0/block/sdb

calling: test
...
Reading rules file: /etc/udev/rules.d/99-backup-disk.rules
...
LINK 'backup-disk' /etc/udev/rules.d/99-backup-disk.rules:2
...
creating symlink '/dev/backup-disk' to 'sdb'
...
run: '/usr/local/bin/usb-backup.sh'

# 別ターミナルで実行しておく
udevadm monitor --udev --subsystem-match=block

UDEV  [12345.678901] add      /devices/.../block/sdb (block)
UDEV  [12345.679012] add      /devices/.../block/sdb/sdb1 (block)

# udevdのログを直近50行確認する
journalctl -u systemd-udevd -n 50