Mini-HOWTO: psaní UDEV pravidel.

4.1.2008 16:28 | Přečteno: 3634× | Linux | | poslední úprava: 4.1.2008 19:00

Jak jsem se mohl v poslední době párkrát přesvědčit, spousta linuxových uživatelů sice ví, co to je UDEV; ten však na první pohled zřejmě působí příliš krypticky (třeba narozdíl od jiných „konfiguráků“), takže je pro mnohé těžké do něj proniknout. Přiznám se, že jsem byl donedávna ve stejné situaci. Pak jsem ale byl donucen pár pravidel napsat a zjistil, jak je to vše vlastně poměrně jednoduché. Takže přináším malý „manuálník“ - ovšem bez zbytečného vysvětlování a bez jakéhokoliv nároku na úplnost. Kdo chce podrobnější návod, či dokumentaci, ten jistě něco najde.

(UPDATE: upraveno podle připomínek z diskuze a mírně rozšířeno...)

co je UDEV

Stručně: systém (v uživatelském prostoru), umožňující nastavit, jak se která systémová zařízení budou v /dev (či jinde) jmenovat, jaká budou mít přístupová práva, případně, jaké akce se mají při jejich přidání do systému provést.

obecně

Pravidla UDEV zpravidla nalezneme v /etc/udev/rules.d/. Syntaxe: co řádek, to pravidlo; pravidlo: několik výrazů oddělených čárkou. Výraz může buď a) rozhodovat o tom, k jakému jadernému objektu se pravidlo bude vztahovat, nebo b) říkat, co má být s objektem provedeno.

a) výběr

Základní syntaxe: PARAMETR=="hodnota", případně PARAMETR!="hodnota" (jako v c-čku). Parametry:

• KERNEL ⇒ jméno zařízení tak, jak by si je přálo mít jádro. Např. "null", "ttyS*", "sda*", ...
• SUBSYTEM ⇒ subsystém jádra, např. "usb_device", "scsi", "tty", "sound", "mmc"...
• BUS ⇒ sběrnice, na které zařízení visí, př: "usb", "ide", "scsi", "pcmcia"... (POZOR; např.: pravidlo: SUBSYSTEM=="tty*", BUS=="pcmcia" znamená výběr všech znakových zařízení „visících“ na PCMCIA sběrnici...)
• DRIVER ⇒ jaderný ovladač přiřazený zařízení; např. "sd", "ide-cdrom", ...
• ACTION ⇒ "add"/"remove" (u hotplug zařízení)
• PROGRAM ⇒ spustí program a podle jeho návratové hodnoty se rozhodne, co dál... [Hledá v /lib/udev]
• RESULT ⇒ test na řetězec vrácený posledním výskytem "PROGRAM"
• ENV{PROMENNA} ⇒ testuje proměnnou prostředí "PROMENNA" (Př.: ENV{BLBOST}=="kravina").
• SYSFS{PARAMETR} ⇒ testuje hodnotu parametru přiřazeného objekty v SYSF (/sys/). Užitečné hodnoty (více viz /sys/...):
  • SYSFS{idVendor} a SYSFS{idProduct} [usb] → identifikační čísla daného zařízení (zobrazuje např. "lsusb").
  • SYSFS{manufacturer} a SYSFS{manufacturer} [usb] → identifikační řetězce výrobce a zařízení.
  • SYSFS{serial} [usb] → sériové číslo zařízení.
  • SYSFS{size} [bloková zař.] → velikost zařízení
  • SYSFS{model} a SYSFS{rev} [scsi disky] → typ disku.

b) „akce“

Syntaxe, buď: AKCE="hodnota", AKCE+="hodnota", nebo AKCE:="hodnota". Jejich význam:

• „=“: byla-li dříve nadefinovaná akce stejného jména, předefinje ji (nevztahuje se na „NAME“)
• „+=“: byla-li dříve nadefinovaná akce stejného jména, provedou se obě
• „:=“: způsobí, že jakýkoliv další pokus předefinovat danou akci nebude úspěšný

Jednotlivé akce:

• MODE, OWNER, GROUP → nastaví přístupová práva.
• NAME → jméno zaříení, jaké nakonec UDEV nastaví...
• SYMLINK → vytvoří k danému zařízení symlink.
• RUN → spustí program.
• PROGRAM → spustí program k dalšímu zpracování, ale netestuje jeho návratovou hodnotu. Pokud chceme čistě vykonat s objektem nějakou akci jako výsledek UDEV pravidel, je nutné použít RUN. [Spouštěno z /lib/udev/]
• LABEL a GOTO → větvení.

syntax "hodnot"

• "*","?","[" a "]" fungují jako v shell-syntaxi
• "%k" - nahradí jaderným názvem zařízení (v.v. „KERNEL“)
• "%s{xyz}" - nahradí hodnotou SYSFS parametru (v.v. „SYSFS{xyz}“)
• "%e{xyz}" - nahradí proměnnou prostředí xyz (v.v. „ENV{xyz}“)
• "%c" - nahradí řetězcem vráceným při posledním volání PROGRAM (v.v.)

---

příklady

(Doporučuji též projít /dev/udev/rules.d/.)

# nebude se jmenovat "ttyS4", ale "ttyModem2"
KERNEL=="ttyS4", NAME="ttyModem2"

# na sériový port přes USB, který odpovídá VID/PID 0x1234/0x5678 bude vytvořen symlink "/dev/modem"
KERNEL=="ttyUSB*", SYSFS{idVendor}=="0x1234", SYSFS{idProduct}=="0x5678", SYMLINK+="/dev/modem"

# po připojení usb hodin nastavíme přístup skupině "io" a spustíme program, který hodiny sesynchronizuje (reálný příklad ;)
SYSFS{idVendor}=="16c0",SYSFS{idProduct}=="05dc",SYSFS{manufacturer}=="butrus@evangnet.cz",SYSFS{product}=="UsbClock", MODE="0660",GROUP="io",RUN+="/usr/bin/led-usb-clock synchro"

# pokud vložíme 1G flash "Kingston" / "DataTraveler xyz", spustit na ni automaticky zalohu
ACTION=="add", SYSFS{vendor}=="Kingston", SYSFS{model}=="DataTraveler xyz", SYSFS{size}=="1001472", SYMLINK+="/dev/kingston_zaloha", RUN+="/local/bin/kingston_zaloha.sh"

       

Komentáře

[Ondřej Kuda]

Vyborny zapis, moc diky. Uz delsi dobu se odhodlavam k pravidlu pro fotak. Btw je tu uz clanek o pravidlech udevu? Jinak toto by byl vhodny kandidat.

[Murry]

Toto by mě také zajímalo...
PS: Neexistuje nějaký démon, který by automaticky připojil nakýkovil foťák?
Některé distra to dělají automaticky, některé ne-e....

[Michal Kubeček]

Zkuste se podívat na ivman.

[Murry]

Díky moc. Já používám dbus, hal, ..... ale o tomto jsem ani nevěděl.
Už se kompiluje........:)

[Michal Kubeček]

Jen bych doplnil pár věcí, které je dobré vědět, než člověk začne:

Co s čím porovnávat, se nejlépe zjistí pomocí udevinfo, např.

  udevinfo -a -n /dev/sdb
  udevinfo -a -p /class/net/eth0

Ve druhém případě se zadává tzv. devpath, tj. vlastně cesta v sysfs filesystému (bez počátečního /sys). Je ale nutné kombinovat hodnoty "ze stejné sekce".

Stejnému klíči může být přiřazeno postupně několik hodnot, platí poslední (pravidla se zpracovávají postupně, jednotlivé soubory podle abecedy). Výjimkou je NAME, přiřazení jména je vždy finální, tj. jakmile ho jednou nastavíme, další pravidla už ho nezmění. Stejného chování lze u ostatních klíčů docílit použitím operátoru ':=' místo normálního '='.

PROGRAM nelze přímo použít jako akci, místo toho lze použít např. NAME="%c" (substituuje se výstup příkazu volaného pomocí PROGRAM).

Pozor na akci RUN, zpracování probíhá sériově, takže dokud příkaz neskončí, nezpracovávají se další pravidla ani události.

Z dokumentace bych doporučil zejména udev(7) a Writing udev Rules. Ten článek je sice lépe srozumitelný, ale v mnoha bodech zastaralý, doporučuji proto konzultovat detaily s tou manuálovou stránkou.

[filo]

Děkuju za článek, měl bych jeden začátečnický dotaz: nepravidelně se mi v distru po vložení nepřimountují různá USB zařízení (čtečky, klíčenky), dalo by se toto vyřešit právě přes UDEV ?

[Michal Kubeček]

Automatické mountování se sice dá řešit přes udev, ale není to příliš vhodné. Většinou se o to starají vyšší vrstvy, např. nějaký démon, který je součástí desktopového prostředí. Ale podle toho, zda udev vytvořil příslušná bloková zařízení, můžete poznat, jestli je problém v nich nebo někde hlouběji (např. v jádře).

[filo]

Díky za info, mrknu na to. Znát příčinu taky není k zahození.

[David Watzke]

Automatické mountování se sice dá řešit přes udev, ale není to příliš vhodné.

Proč? Jednou jsem to zkoušel a nešlo to. Resp. připojilo to mechaniku jen jednou, pokud vevnitř bylo při spuštění udevstart nějaký médium.

[Michal Kubeček]

Hlavně kvůli té serializaci při zpracování událostí a jednotlivých pravidel.

[filo]

Joj, stačilo by přijít o 5 minut později a nemusel jsem se ptát ;)
To Michal Kubeček: díky za odkaz v příspěvku výše, to by mohlo být pro mě to pravé ořechové.

[Michal Kubeček]

Na ten článek pozor, je trochu staršího data, takže některé věci lze dnes řešit jednodušeji a syntaxe se v některých bodech trochu změnila. Ale pro pochopení principů je pořád výborný.

[Michal Kubeček]

Ještě jedna praktická poznámka. udev používá inotify, takže se o změnách v souborech s pravidly dozví okamžitě a vezme je ihned na vědomí, není potřeba ho restartovat nebo mu posílat nějaký signál. Změna pravidel se ale dotkne pouze po ní následujících událostí (přidání/odebrání zařízení), ne těch, která už v systému jsou. Aplikaci nových pravidel na ně je možné vynutit příkazem udevtrigger.

[miso]

Sorry, ze len strucne a bez prikladov, ale na sledovanie udalosti udevu sa pouziva udevmonitor a pri vytvoreni/zeditovani nejakeho pravidla mozme otestovat akciu pomocou udevtest

[pools]

Díky za článeček. Moc mi pomohl, ale měl bych jeden dotaz - proč v tomhle:

ATTRS{idVendor}=="03f0", ATTRS{idProduct}=="8704", GROUP="lp", MODE="0777"

ignoruje to Group? Připojí to takhle:
crwxrwxrwx 1 root plugdev 189, 258 2008-01-08 21:35 /dev/bus/usb/003/003

Když měním MODE tak se to opravdu změní, takže tuhle část neignoruje...

[Petr Tomášek]

Nevím, jediné, co mě napadá, že to změní jiné pravidlo...

[m_ax]

Skus tam pridat OPTIONS="last_rule" a uvidis... m_ax