# udev (日本語)

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

Wikipedia の記事より:

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

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

## インストール

現在 Udev は systemd に含まれているため Arch Linux ではデフォルトでインストールされています。

## udev ルールについて

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

### udev ルールを記述する

- 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-rules

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

    # udevadm trigger

## Udisks

リムーバルドライブをマウントしたい場合 udev ルールから 'mount' を呼び出さないで下さい。fuse ファイルシステム (例: ntfs-3g) の場合 "Transport endpoint not connected" エラーが表示されます。代わりに自動マウントを適切に扱う udisks を使って下さい。

互換性のない2つのバージョン、udisks と udisks2 が存在します。あなたの DE によって、以下のバージョンのひとつが必要になります (依存パッケージとして既にインストールされているはずです):

- GNOME と KDE 4.10+ では、udisks2 をインストールしてください
- Xfce (Thunar) では、gvfs をインストールしてください、udisks2 もインストールされます

どれでも、追加のルールの必要はありません。自動マウントのためだけに HAL を使っている場合、HAL を削除することができます。

### 自動マウント udisks ラッパー

udisks ラッパーにはインストールが簡単で設定が必要ない（もしくは最小限の設定でよい）という利点があります。ラッパーは CD やフラッシュドライブなどを自動でマウントします。

- udevil - udevil は"パスワードなしでリムーバルデバイスをマウント・アンマウントし、デバイスの情報を表示、デバイスの変更を監視します"。C で書かれており UDisks を置き換えることができます。devmon が含まれておりデバイスの自動的なマウントに使えます。マウント後の選択的なアプリケーションの自動起動・コマンドの実行や、特定のデバイス・ボリュームラベルの無視、リムーバルドライブのアンマウントもできます。
- ldm - usb ドライブ, cd, dvd, フロッピーを自動でマウントする軽量なデーモン。 [1]
- udiskie - Python で書かれています。全てのユーザーによる自動マウント・アンマウントを有効にします。
- udisksevt - Haskell で書かれています。全てのユーザーによる自動マウントを有効にします。traydevice と統合するように作られています。
- udisksvm - udisks2 の dbus インターフェイスを使っている GUI の UDisks ラッパー。gobject introspection approach を使って python で書かれています。どのファイルマネージャからも独立しています。右クリックでメニューが出るシステムトレイアイコンとアクションの結果の通知を表示します。詳しい説明は udisksvm community forum thread を見て下さい。
- pmount, udisks2, spacefm を組み合わせることでリムーバルデバイスを簡単に自動マウント・エジェクトできます。自動マウントをするために、スタートアップスクリプト (`~/.xinitrc` もしくは `~/.xsession`) の中で spacefm をデーモンモードで起動 (`spacefm -d &`) する必要があります。また、`/etc/pmount.allow` に追加することで内部ディスクのマウントも可能です。

### Udisks シェル関数

udisks にはコマンドラインでデバイスを（アン）マウントするシンプルなメソッドがありますが、毎回コマンドを打つのが面倒かもしれません。以下のシェル関数は一般的なコマンドラインの使用を簡単にします。

- udisks_functions - Bash 用に書かれています
- bashmount - bashmount はメニュー形式の Bash スクリプトです、設定・拡張が簡単な設定ファイルを使います

### udisks2 - /media にマウントする

デフォルトで、udisks2 はリムーバルドライブを `/media/` ではなく `/run/media/$USER/` にマウントします。この挙動が気に入らない場合、このルールを使って下さい:

    /etc/udev/rules.d/99-udisks2.rules

    ENV{ID_FS_USAGE}=="filesystem|other|crypto", ENV{UDISKS_FILESYSTEM_SHARED}="1"

## 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 挿入で実行

Execute on USB insert または devmon wrapper script を参照してください。

### 新しい eSATA ドライブの検知

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

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

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

    # 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"

Note: 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 ルールを追加すれば固定デバイス名を使えます:

- ブロックデバイスは Persistent block device naming を見て下さい。
- ネットワークデバイスは Network Configuration (日本語)#デバイス名 を見て下さい。

#### 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"

Note: Using names other than "/dev/video*" will break preloading of v4l1compat.so and perhaps v4l2convert.so.

#### プリンター

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

Persistent block device naming と同じように `/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 と hal-info からインストールできます。

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"

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

## トラブルシューティング

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

稀に、udev が間違って誤ったモジュールをロードすることがあります。これを止めさせるために、モジュールをブラックリストに入れることができます。ブラックリスト化すれば、udev は二度とそのモジュールをロードしません。Kernel modules (日本語)#ブラックリスト を見て下さい。起動時と 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` 内の古いエントリによって問題が起こる場合があります。このファイルを手入れして、それから再度試して下さい。

Note: `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 Homepage
- An Introduction to Udev
- Udev mailing list information

Category:

- Hardware detection and troubleshooting (日本語)