Udev

関連記事

• udisks

Wikipedia の記事より:

"udev とは、Linuxカーネル 用のデバイス管理ツールである。主に /dev ディレクトリ以下のデバイスノードを管理するために利用する。以前 /dev ディレクトリの管理を担っていた devfs と、ホットスワップやファームウェアのロードなどユーザー空間におけるデバイスのアクション全てを担っていた hotplug の後継ツールである。"

udev は hotplug と hwdetect 両方の機能を置き換えます。

Udev は並列処理を利用してカーネルモジュールをロードするため順番にモジュールをロードするのと比べ良いパフォーマンスが得られます。従ってモジュールは非同期に読み込まれます。この方法の欠点として、起動した時 udev はいつも同じ順番ではモジュールをロードしません。マシンに複数のブロックデバイスがある場合、デバイスノードの名称がランダムに変化する可能性があります。例えば、マシンに2つハードドライブが接続されている場合、ランダムで /dev/sda が /dev/sdb になるかもしれません。これについては下で詳しく説明しています。

インストール

現在 Udev は systemd に含まれているため Arch Linux ではデフォルトでインストールされています。詳しくは systemd-udevd.service(8) man ページを見て下さい。

AUR には独立したフォークが存在します: eudev。

udev ルールについて

Udev ルールは管理者によって書かれます。/etc/udev/rules.d/ を見て下さい、ファイルの名前は .rules で終わる必要があります。様々なパッケージに udev ルールが含まれており /usr/lib/udev/rules.d/ に保存されます。同じ名前のファイルが /usr/lib と /etc に存在する場合は、/etc 内のファイルが優先されます。

udev ルールを記述する

警告: リムーバルドライブをマウントするのに、udev ルールから mount を呼ばないで下さい。FUSE ファイルシステムの場合、Transport endpoint not connected エラーが起こります。代わりに自動マウントを適切に処理する udisks を使って下さい。

• udev ルールの書き方を学ぶには Writing udev rules を見て下さい。
• udev ルールのサンプルを見るには Improved Udev Rule For Arch Linux を見て下さい。

以下はウェブカメラが接続されたときにシンボリックリンク /dev/video-cam1 を作るルールの例です。まず、カメラが接続されたときデバイス /dev/video2 にロードされていることを見つけたとします。このルールを書く理由は次のブート時にデバイスが /dev/video0 など他の名前で表示される可能性があるからです。

# udevadm info -a -p $(udevadm info -q path -n /dev/video2)

Udevadm info starts with the device specified by the devpath and then walks up the chain of parent devices. It prints for every device found, all possible attributes in the udev rules key format. A rule to match, can be composed by the attributes of the device and the attributes from one single parent device.

  looking at device '/devices/pci0000:00/0000:00:04.1/usb3/3-2/3-2:1.0/video4linux/video2':
    KERNEL=="video2"
    SUBSYSTEM=="video4linux"
    ...
  looking at parent device '/devices/pci0000:00/0000:00:04.1/usb3/3-2/3-2:1.0':
    KERNELS=="3-2:1.0"
    SUBSYSTEMS=="usb"
    ...
  looking at parent device '/devices/pci0000:00/0000:00:04.1/usb3/3-2':
    KERNELS=="3-2"
    SUBSYSTEMS=="usb"
    ...
    ATTRS{idVendor}=="05a9"
    ...
    ATTRS{manufacturer}=="OmniVision Technologies, Inc."
    ATTRS{removable}=="unknown"
    ATTRS{idProduct}=="4519"
    ATTRS{bDeviceClass}=="00"
    ATTRS{product}=="USB Camera"
    ...

video4linux デバイスから KERNEL=="video2" と SUBSYSTEM=="video4linux" を使います、そして usb parent SUBSYSTEMS=="usb", ATTRS{idVendor}=="05a9", ATTRS{idProduct}=="4519" から製造者・製品 ID を使ってウェブカメラをマッチさせます。

/etc/udev/rules.d/83-webcam.rules

KERNEL=="video[0-9]*", SUBSYSTEM=="video4linux", SUBSYSTEMS=="usb", \
        ATTRS{idVendor}=="05a9", ATTRS{idProduct}=="4519", SYMLINK+="video-cam1"

上の例では SYMLINK+="video-cam1" を使ってシンボリックリンクを作成していますが OWNER="john" や GROUP="video" を使ってユーザーやグループを設定したり MODE="0660" を使ってパーミッションを設定することも簡単にできます。

ただし、デバイスが取り除かれた時に何かを実行するルールを書く時は、デバイスの属性にアクセス出来ないことに注意してください。この場合、プリセットのデバイス環境変数を使う必要があります。これらの環境変数を監視するには、デバイスを抜いた時に次のコマンドを実行してください:

# udevadm monitor --environment --udev

このコマンドの出力の中に、ID_VENDOR_ID や ID_MODEL_ID などの、前に使っていた属性 "idVendor" と "idProduct" に一致する値があるはずです。デバイスの環境変数を使うルールは以下のようになります:

/etc/udev/rules.d/83-webcam-removed.rules

ACTION=="remove", SUBSYSTEM=="usb", ENV{ID_VENDOR_ID}=="05a9", ENV{ID_MODEL_ID}=="4519", RUN+="/path/to/your/script"

デバイスの属性を一覧する

ルールを書くときに使えるデバイスの属性全てのリストを表示するには、次のコマンドを実行してください:

# udevadm info -a -n [device name]

[device name] は /dev/sda や /dev/ttyUSB0 などシステム上のデバイスに置き換えてください。

デバイスの名前がわからない場合は特定のシステムパスの全ての属性をリストアップすることもできます:

# udevadm info -a -p /sys/class/backlight/acpi_video0

ロードする前にルールをテストする

# udevadm test $(udevadm info -q path -n [device name]) 2>&1

このコマンドは新しいルールの全てのアクションを実行はしませんが、既存のデバイスのシンボリックリンクのルールは処理します。ロードできないときに役に立つかもしれません。また、テストしたい udev ルールのデバイスのパスを直接指定することも可能です:

# udevadm test /sys/class/backlight/acpi_video0/

新しいルールをロードする

Udev はルールファイルの変更を自動で検知するため、変更をすぐ反映させるのに udev の再起動は必要ありません。しかしながら、既に存在するデバイスでルールの自動再始動は行われません。USB デバイスなどの、ホットプラグ可能なデバイスはおそらく、新しいルールを適用するために再接続したり、少なくとも ohci-hcd と ehci-hcd カーネルモジュールをアンロード・再ロードして全ての USB ドライバーを再ロードする必要があります。

自動的にルールがリロードされない場合:

# udevadm control --reload

udev に手動で強制的にルールを適用させるには:

# udevadm trigger

Udisks

Udisks を見て下さい。

Tips and tricks

ファームウェアプログラマや USB 仮想 comm デバイスにアクセス

以下のルールセットは ("users" グループに入っている) 通常のユーザーが AVR マイクロコントローラの USBtinyISP USB プログラマと一般的な (SiLabs CP2102) USB を UART アダブター, Atmel AVR Dragon プログラマ, Atmel AVR ISP mkII にアクセスできるようにします。必要に応じてパーミッションは調整してください。2012年10月31日確認。

/etc/udev/rules.d/50-embedded_devices.rules

# USBtinyISP Programmer rules
SUBSYSTEMS=="usb", ATTRS{idVendor}=="1781", ATTRS{idProduct}=="0c9f", GROUP="users", MODE="0666"
SUBSYSTEMS=="usb", ATTRS{idVendor}=="16c0", ATTRS{idProduct}=="0479", GROUP="users", MODE="0666"
# USBasp Programmer rules http://www.fischl.de/usbasp/
SUBSYSTEMS=="usb", ATTRS{idVendor}=="16c0", ATTRS{idProduct}=="05dc", GROUP="users", MODE="0666"

# Mdfly.com Generic (SiLabs CP2102) 3.3v/5v USB VComm adapter
SUBSYSTEMS=="usb", ATTRS{idVendor}=="10c4", ATTRS{idProduct}=="ea60", GROUP="users", MODE="0666"

#Atmel AVR Dragon (dragon_isp) rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2107", GROUP="users", MODE="0666"

#Atmel AVR JTAGICEMKII rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2103", GROUP="users", MODE="0666"

#Atmel Corp. AVR ISP mkII
SUBSYSTEM=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2104", GROUP="users", MODE="0666"

USB 挿入で実行

Udisks または devmon ラッパースクリプト を参照してください。

VGA ケーブル接続時に実行

VGA モニターケーブルが接続されたときに arandr を起動するには以下の内容の /etc/udev/rules.d/95-monitor-hotplug.rules ルールを作成します:

KERNEL=="card0", SUBSYSTEM=="drm", ENV{DISPLAY}=":0", ENV{XAUTHORITY}="/home/username/.Xauthority", RUN+="/usr/bin/arandr"

新しい eSATA ドライブの検知

eSATA ドライブを挿入しても検知されない場合、いくつか試せることがあります。eSATA を挿入したまま再起動してください。もしくは次を実行してください:

# echo 0 0 0 | tee /sys/class/scsi_host/host*/scan

または (AUR から) scsiadd^AUR をインストールして次を実行してください:

# scsiadd -s

うまくいけば、あなたのドライブが /dev にあります。ドライブがない場合、次を実行しながら上のコマンドを試して何が起こっているのか確認してください:

# udevadm monitor

内部 SATA ポートを eSATA とする

eSATA ベイや他の eSATA アダブタを接続するとシステムはディスクを内部 SATA ドライブとして認識します。GNOME や KDE はその度に root パスワードを尋ねることになります。以下の udev ルールは指定した SATA ポートを外部 eSATA ポートとして表示させます。これで、USB ドライブと同じように通常の GNOME ユーザーで eSATA ドライブを root パスワードなしでポートに接続することができるようになります。

/etc/udev/rules.d/10-esata.rules

DEVPATH=="/devices/pci0000:00/0000:00:1f.2/host4/*", ENV{UDISKS_SYSTEM}="0"

ノート: eSATA ドライブを接続した後、以下のコマンドを使うことで DEVPATH がわかります (sdb は適宜置き換えてください):

# udevadm info -q path -n /dev/sdb
/devices/pci0000:00/0000:00:1f.2/host4/target4:0:0/4:0:0:0/block/sdb

# find /sys/devices/ -name sdb
/sys/devices/pci0000:00/0000:00:1f.2/host4/target4:0:0/4:0:0:0/block/sdb

固定デバイス名の設定

udev は全てのモジュールを非同期にロードするので、初期化される順番は異なってしまいます。この結果デバイスの名前がランダムで変わる可能性があります。udev ルールを追加すれば固定デバイス名を使えます:

• ブロックデバイスは永続的なブロックデバイスの命名を見て下さい。
• ネットワークデバイスはネットワーク設定#デバイス名を見て下さい。

iscsi デバイス

scsi_id からの出力をテストしてください:

# /usr/lib/udev/scsi_id --whitelisted --replace-whitespace --device=/dev/sdb
3600601607db11e0013ab5a8e371ce111

/etc/udev/rules.d/75-iscsi.rules

#The iscsi device rules.
#This will create an iscsi device for each of the targets.
KERNEL=="sd*", SUBSYSTEM=="block", \
     PROGRAM="/usr/lib/udev/scsi_id --whitelisted --replace-whitespace /dev/$name", \ RESULT=="3600601607db11e0013ab5a8e371ce111", \
     NAME="isda"

ビデオドライバー

ウェブカメラをセットアップするなら、まずウェブカメラ設定を参照してください。

複数のウェブカメラを使うと、例えば motion (video4linux デバイスやウェブカメラから画像を取得するソフトウェアモーション検知プログラム) を使う場合、起動時にビデオデバイスはランダムで /dev/video0..n と割り当てられます。推奨される方法は udev ルールを使って (udev ルールの記述にある例のようにして) シンボリックリンクを作成する方法です。

/etc/udev/rules.d/83-webcam.rules

KERNEL=="video[0-9]*", SUBSYSTEM=="video4linux", SUBSYSTEMS=="usb", ATTRS{idVendor}=="05a9", ATTRS{idProduct}=="4519", SYMLINK+="video-cam1"
KERNEL=="video[0-9]*", SUBSYSTEM=="video4linux", SUBSYSTEMS=="usb", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="08f6", SYMLINK+="video-cam2"
KERNEL=="video[0-9]*", SUBSYSTEM=="video4linux", SUBSYSTEMS=="usb", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="0840", SYMLINK+="video-cam3"

ノート: /dev/video* 以外の名前を使うと v4l1compat.so や v4l2convert.so のプリロードが破壊されます。

プリンター

複数のプリンターを使っている場合、起動時にランダムで /dev/lp[0-9] のデバイスが割り当てられ、CUPS の設定などを破壊してしまいます。

永続的なブロックデバイスの命名と同じように /dev/lp/by-id と /dev/lp/by-path の下にシンボリックリンクを作成する、以下のルールを作成することが可能です:

/etc/udev/rules.d/60-persistent-printer.rules

ACTION=="remove", GOTO="persistent_printer_end"

# This should not be necessary
#KERNEL!="lp*", GOTO="persistent_printer_end"

SUBSYSTEMS=="usb", IMPORT{builtin}="usb_id"
ENV{ID_TYPE}!="printer", GOTO="persistent_printer_end"

ENV{ID_SERIAL}=="?*", SYMLINK+="lp/by-id/$env{ID_BUS}-$env{ID_SERIAL}"

IMPORT{builtin}="path_id"
ENV{ID_PATH}=="?*", SYMLINK+="lp/by-path/$env{ID_PATH}"

LABEL="persistent_printer_end"

HAL の実行

(Flash DRM コンテンツなど) プログラムによってはいまだ HAL が必要なものがあります。Hal は hal^AUR と hal-info^AUR からインストールできます。

Systemd を使う: 以下の systemd のコマンドで hal サービスを起動・停止できます:

HAL を起動する: # systemctl start hal.service

HAL を停止する: # systemctl stop hal.service

または、以下のスクリプトを使うこともできます:

#!/bin/bash

## written by Mark Lee <bluerider>
## using information from <https://wiki.archlinux.org/index.php/Chromium#Google_Play_.26_Flash>

## Start and stop Hal service on command for Google Play Movie service

function main () {  ## run the main insertion function
     clear-cache;  ## remove adobe cache
     start-hal;  ## start the hal daemon
     read -p "Press 'enter' to stop hal";  ## pause the command line with a read line
     stop-hal;  ## stop the hal daemon
}

function clear-cache () {  ## remove adobe cache
     cd ~/.adobe/Flash_Player;  ## go to Flash player user directory
     rm -rf NativeCache AssetCache APSPrivateData2;  ## remove cache
}

function start-hal () {  ## start the hal daemon
     sudo systemctl start hal.service && ( ## systemd : start hal daemon
          echo "Started hal service..."
) || (
          echo "Failed to start hal service!") 
}

function stop-hal () {  ## stop the hal daemon
sudo systemctl stop hal.service && (  ## systemd : stop hal daemon
          echo "Stopped hal service..."
     ) || (
          echo "Failed to stop hal service!"
     )
}

main;  ## run the main insertion function

USB デバイスでサスペンドから復帰

最初に、あなたのデバイスの製造者・製品 ID を見つけて下さい、例えば:

# lsusb | grep Logitech

Bus 007 Device 002: ID 046d:c52b Logitech, Inc. Unifying Receiver

デバイスと接続している USB コントローラの power/wakeup 属性を変更してください、ここでは driver/usb7/power/wakeup になります。以下のルールを使って下さい:

/etc/udev/rules.d/50-wake-on-device.rules

ACTION=="add", SUBSYSTEM=="usb", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c52b", ATTR{power/wakeup}="enabled", ATTR{driver/usb7/power/wakeup}="enabled"

ノート: /proc/acpi/wakeup で USB コントローラが有効にされていることも確認してください。

トラブルシューティング

モジュールのブラックリスト

稀に、udev が間違って誤ったモジュールをロードすることがあります。これを止めさせるために、モジュールをブラックリストに入れることができます。ブラックリスト化すれば、udev は二度とそのモジュールをロードしません。カーネルモジュール#ブラックリストを見て下さい。起動時と hotplug のイベント時 (例: USB フラッシュドライブを入れた時) 両方です。

起動時に udevd が止まる

LDAP に移行したり LDAP を使っているシステムを更新した後 udevd が起動時 "Starting UDev Daemon" というメッセージを出したときに止まることがあります。これは通常 udevd が LDAP にある名前を検索しようとして、ネットワークがまだ立ち上がっておらず、失敗していることが原因です。解決方法は全てのシステムグループの名前をローカルで存在させることです。

udev ルールで記述されているグループ名とシステム上にあるグループ名を抽出してください:

# fgrep -r GROUP /etc/udev/rules.d/ /usr/lib/udev/rules.d | perl -nle '/GROUP\s*=\s*"(.*?)"/ && print $1;' | sort | uniq > udev_groups
# cut -f1 -d: /etc/gshadow /etc/group | sort | uniq > present_groups

違いを確認するために、side-by-side の diff を実行してください:

# diff -y present_groups udev_groups
...
network							      <
nobody							      <
ntp							      <
optical								optical
power							      |	pcscd
rfkill							      <
root								root
scanner								scanner
smmsp							      <
storage								storage
...

この場合、何らかの理由で pcscd グループがシステム上に存在しません。欠けているグループを追加してください:

# groupadd pcscd

また、LDAP に頼る前にローカルリソースが検索されるようにしてください。/etc/nsswitch.conf に次の行を含める必要があります:

group: files ldap

ハードウェアの既知の問題

BusLogic デバイスが壊れて起動中にフリーズする

これはカーネルのバグでありまだ修正されていません。

リムーバルとして扱われなくてはならないデバイスがそう扱われない

UDISKS_SYSTEM_INTERNAL=0 を設定するカスタム udev ルールを作成してください。詳しくは、udisks の man ページを見て下さい。

自動ロードの既知の問題

モジュールが自動でロードされないサウンドの問題

/etc/modprobe.d/sound.conf 内の古いエントリによって問題が起こる場合があります。このファイルを手入れして、それから再度試して下さい。

ノート: udev>=171 から、デフォルトで OSS エミュレーションモジュール (snd_seq_oss, snd_pcm_oss, snd_mixer_oss) は自動でロードされなくなりました。

カスタムカーネルの既知の問題

Udev が全く起動しない

あなたのカーネルバージョンが 2.6.32 以上であることを確認してください。それ以前のカーネルでは udev が自動ロードをするのに必要な uevent をサポートしていません。

IDE CD/DVD ドライブサポート

バージョン 170 から、udev は CD-ROM/DVD-ROM ドライブをサポートしておらず、伝統的な IDE ドライブとして ide_cd_mod モジュールを使ってロードされ /dev/hd* として表示します。cdparanoia など、ハードウェアに直接アクセスするツールでは問題なくドライブを使えますが、KDE などのより高い次元のユーザースペースのプログラムにはドライブが見えなくなります。

A cause for the loading of the ide_cd_mod module prior to others, like sr_mod, could be e.g. that you have for some reason the module piix loaded with your initramfs. In that case you can just replace it with ata_piix in your /etc/mkinitcpio.conf.

オプティカルドライブのグループ ID が "disk" に設定される

オプティカルドライブのグループ ID が disk に設定されていて、それを optical に設定したい場合、カスタム udev ルールを作成する必要があります:

/etc/udev/rules.d

# permissions for IDE CD devices
SUBSYSTEMS=="ide", KERNEL=="hd[a-z]", ATTR{removable}=="1", ATTRS{media}=="cdrom*", GROUP="optical"

# permissions for SCSI CD devices
SUBSYSTEMS=="scsi", KERNEL=="s[rg][0-9]*", ATTRS{type}=="5", GROUP="optical"

参照

• Udev ホームページ
• An Introduction to Udev
• Udev mailing list information
• Scripting with udev
• Writing udev rules