View source for Udev

{{Short description|Device manager for the Linux kernel}}
{{Lowercase title}}
{{Lead too short|date=November 2014}}
{{Infobox software
| name                 = systemd
| title                = udev
| logo                 = 
| screenshot           = 
| caption              = 
| collapsible          = 
| author               = 
| developer            = [[Greg Kroah-Hartman]] and [[Kay Sievers]]
| released             = {{Start date and age|2003|11}}
| latest release version = {{wikidata|property|reference|P348}}
| latest release date    = {{start date and age|{{wikidata|qualifier|P348|P577}}}}
| programming language = [[C (programming language)|C]]
| operating system     = [[Linux]]
| platform             = 
| size                 = 
| language             = 
| genre                = [[Device node]]
| license              = [[GNU General Public License|GPLv2]]
| website              = {{Official website|https://systemd.io/}}
}}

'''udev''' (userspace {{mono|[[devfs|/dev]]}}) is a device manager for the [[Linux kernel]]. As the successor of [[devfsd]] and hotplug, udev primarily manages [[device node]]s in the {{mono|[[devfs|/dev]]}} directory. At the same time, udev also handles all [[user space]] events raised when hardware devices are added into the system or removed from it, including [[firmware]] loading as required by certain devices.

==Rationale==
It is an [[operating system]]'s [[Kernel (operating system)|kernel]] that is responsible for providing an abstract interface of the hardware to the rest of the software. Being a [[monolithic kernel]], the [[Linux kernel]] does exactly that: [[device driver]]s are part of the Linux kernel, and make up more than half of its source code.<ref>{{cite web |last1=Marti |first1=Don |title=Are top Linux developers losing the will to code? |url=http://www.computerworlduk.com/applications/are-top-linux-developers-losing-the-will-to-code-604/ |website=ComputerworldUK |access-date=2 June 2024 |archive-url=https://web.archive.org/web/20160719164322/http://www.computerworlduk.com/applications/are-top-linux-developers-losing-the-will-to-code-604/ |archive-date=19 July 2016 |language=en-GB |date=2 July 2007 |url-status=dead}}</ref> Hardware can be accessed through [[system call]]s or over their [[device node]]s.

To be able to deal with peripheral devices that are [[hotplug]]-capable in a user-friendly way, a part of handling all of these hotplug-capable hardware devices was handed over from the kernel to a [[daemon (computing)|daemon]] running in user-space. Running in user space serves security and stability purposes.

==Design==
[[Device driver]]s are part of the Linux kernel, in which their primary functions include device discovery, detecting device state changes, and similar low-level hardware functions. After loading a device driver into memory from the kernel, detected events are sent out to the userspace daemon udevd. It is the device manager, {{Mono|udevd}}, that catches all of these events and then decides what shall happen next. For this, {{Mono|udevd}} has a very comprehensive set of configuration files, which can all be adjusted by the computer administrator, according to their needs.

* In case a new storage device is connected over USB, {{Mono|udevd}} is notified by the kernel and itself notifies the udisksd-daemon. That daemon could then mount the file systems.
* In case a new Ethernet cable is plugged into the Ethernet NIC, {{Mono|udevd}} is notified by the kernel and itself notifies the NetworkManager-daemon. The NetworkManager-daemon could start dhclient for that NIC, or configure according to some manual configuration.

The complexity of doing so forced application authors to re-implement hardware support logic. Some hardware devices also required privileged helper programs to prepare them for use. These often have to be invoked in ways that could be awkward to express with the Unix permissions model (for example, allowing users to join [[wireless network]]s only if they are logged into the video console). Application authors resorted to using [[setuid]] binaries or run service [[Daemon (computing)|daemons]] to provide their own access control and privilege separation, potentially introducing security holes each time.<ref name="pennington">{{citation|title = Making Hardware Just Work|date = 2003-07-10|first = Havoc|last = Pennington|url = http://ometer.com/hardware.html}}</ref>

[[HAL (software)|HAL]] was created to deal with these challenges, but is now deprecated in most Linux distributions, its functionality being replaced by udevd.

==Overview==
Unlike traditional [[Unix]] systems, where the [[device node]]s in the {{mono|/dev}} directory have been a static set of files, the Linux udev device manager dynamically provides only the nodes for the devices actually present on a system. Although [[devfs]] used to provide similar functionality, [[Greg Kroah-Hartman]] cited a number of reasons<ref>{{cite web
 | url         = http://kernel.org/pub/linux/utils/kernel/hotplug/udev_vs_devfs
 | title       = udev and devfs - The final word
 | access-date  = 2008-01-24
 | format      = [[Plain text]]
 | author      = Greg Kroah-Hartman
 | author-link      = Greg Kroah-Hartman
 | archive-url  = https://web.archive.org/web/20110709174547/http://kernel.org/pub/linux/utils/kernel/hotplug/udev_vs_devfs
 | archive-date = 2011-07-09}}</ref> for preferring udev over devfs:
* udev supports persistent device naming, which does not depend on, for example, the order in which the devices are plugged into the system. The default udev setup provides persistent names for storage devices. Any hard disk is recognized by its unique filesystem id, the name of the disk and the physical location on the hardware it is connected to.
* udev executes entirely in [[user space]], as opposed to devfs's [[kernel space]]. One consequence is that udev moved the naming policy out of the kernel and can run arbitrary programs to compose a name for the device from the device's properties, before the node is created; there, the whole process is also interruptible and it runs with a lower priority.

The udev, as a whole, is divided into three parts:
* [[Library (computing)|Library]] ''libudev'' that allows access to device information; it was incorporated into the [[systemd]] 183 software bundle.<ref name=":0">{{Cite web|url=https://github.com/systemd/systemd/blob/v183/NEWS|title=systemd/systemd|website=GitHub|access-date=2016-08-21}}</ref>
* User space [[Daemon (computing)|daemon]] {{Mono|udevd}} that manages the virtual {{Mono|/dev}}.
* Administrative [[command-line utility]] {{Mono|udevadm}} for diagnostics.

The system gets calls from the kernel via [[netlink]] socket. Earlier versions used [[Hotplug (software)|hotplug]], adding a link to themselves in {{mono|/etc/hotplug.d/default}} with this purpose.

==Operation==
[[File:Free and open-source-software display servers and UI toolkits.svg|thumb|350px|udev has been incorporated into [[systemd]] 183<ref name=":0"/> ]]

udev is a generic device manager running as a [[Daemon (computer software)|daemon]] on a Linux system and listening (via a [[netlink]] socket) to uevents the kernel sends out if a new device is initialized or a device is removed from the system. The udev package comes with an extensive set of rules that match against exported values of the event and properties of the discovered device. A matching rule will possibly name and create a device node and run configured programs to set up and configure the device.

udev rules can match on properties like the kernel subsystem, the kernel device name, the physical location of the device, or properties like the device's serial number. Rules can also request information from external programs to name a device or specify a custom name that will always be the same, regardless of the order devices are discovered by the system.

In the past a common way to use udev on Linux systems was to let it send events through a socket to [[HAL (software)|HAL]], which would perform further device-specific actions. For example, HAL would notify other software running on the system that the new hardware had arrived by issuing a broadcast message on the [[D-Bus]] [[Inter-process communication|IPC]] system to all interested [[process (computing)|processes]]. In this way, desktops such as [[GNOME]] or [[K Desktop Environment 3]] could start the [[file browser]] to browse the file systems of newly attached [[USB flash drive]]s and [[Secure Digital|SD cards]].<ref>{{cite web
 |url         = http://w3.linux-magazine.com/issue/71/Dynamic_Device_Management_in_Udev.pdf
 |title       = Dynamic Device Management in Udev
 |publisher   = Linux Magazine
 |date        = 2006-10-01
 |access-date = 2008-07-14
}}{{Dead link|date=March 2023 |bot=InternetArchiveBot |fix-attempted=yes }}</ref>

By the middle of 2011 HAL had been deprecated by most Linux distributions as well as by the KDE, GNOME<ref>{{cite web|url=http://wiki.debian.org/HALRemoval|title=HALRemoval|date=2011-06-28|access-date=2011-09-13}}</ref> and [[Xfce]]<ref>{{cite web|url=http://gezeiten.org/pre-2014/post/2010/01/Thunar-volman-and-the-deprecation-of-HAL|title=Thunar-volman and the deprecation of HAL in Xfce|date=2010-01-17|access-date=2017-12-25|archive-date=2017-12-26|archive-url=https://web.archive.org/web/20171226020945/http://gezeiten.org/pre-2014/post/2010/01/Thunar-volman-and-the-deprecation-of-HAL|url-status=dead}}</ref> desktop environments, among others. The functionality previously embodied in HAL has been integrated into udev itself, or moved to separate software such as udisks and [[upower]].

* udev provides low-level access to the linux device tree. Allows programs to enumerate devices and their properties and get notifications when devices come and go.
* dbus is a framework to allow programs to communicate with each other, securely, reliably, and with a high-level object-oriented programming interface.
* udisks (formerly known as DeviceKit-disks) is a daemon that sits on top of libudev and other kernel interfaces and provides a high-level interface to storage devices and is accessible via dbus to applications.
* upower (formerly known as DeviceKit-power) is a daemon that sits on top of libudev and other kernel interfaces and provides a high-level interface to power management and is accessible via dbus to applications.
* [[NetworkManager]] is a daemon that sits on top of libudev and other kernel interfaces (and a couple of other daemons) and provides a high-level interface to network configuration and setup and is accessible via dbus to apps.<ref>{{cite web |url=http://lists.freedesktop.org/archives/dbus/2010-April/012545.html |title=Relationship between udev, hal, Dbus and DeviceKit? |date=2010-04-25 |author=Lennart Poettering}}</ref>

udev receives messages from the kernel, and passes them on to subsystem daemons such as Network Manager. Applications talk to Network Manager over D-Bus.

:<chem>Kernel -> udev -> Network Manager <=> D-Bus <=> Firefox</chem>

HAL is obsolete and only used by legacy code. Ubuntu 10.04 shipped without HAL. Initially a new daemon DeviceKit was planned to replace certain aspects of HAL, but in March 2009, DeviceKit was deprecated in favor of adding the same code to udev as a package: udev-extras, and some functions have now moved to udev proper.

==History==
udev was introduced in [[Linux kernel version history|Linux 2.5]]. The Linux kernel version 2.6.13 introduced or updated a new version of the [[uevent]] interface. A system using a new version of udev will not boot with kernels older than 2.6.13 unless udev is disabled and a traditional {{mono|/dev}} directory is used for device access.

In April 2012, udev's [[codebase]] was merged into the [[systemd]] source tree, making systemd 183 the first version to include udev.<ref name=":0" /><ref>{{cite mailing list |last=Sievers |first=Kay |title=The future of the udev source tree |url=http://article.gmane.org/gmane.linux.hotplug.devel/17392 |mailing-list=linux-hotplug|date=2012-04-03|access-date=2013-05-22}}</ref><ref>{{citation |last=Sievers |first=Kay |title=Commit importing udev into systemd |url=http://cgit.freedesktop.org/systemd/systemd/commit/?id=19c5f19d69bb5f520fa7213239490c55de06d99d |work=systemd |access-date=2013-05-22}}</ref> In October 2012, [[Linus Torvalds]] criticized [[Kay Sievers]]'s approach to udev maintenance and bug fixing related to [[firmware]] loading, stating:<ref>{{cite mailing list|url=https://lkml.org/lkml/2012/10/3/484|title=Re: udev breakages|author=Linus Torvalds|mailing-list=linux-kernel|date=2012-10-03|access-date=2014-10-28}}</ref>

{{quote|Yes, doing it in the kernel is "more robust". But don't play games, and stop the lying. It's more robust because we have maintainers that care, and because we know that regressions are not something we can play fast and loose with. If something breaks, and we don't know what the right fix for that breakage is, we ''revert'' the thing that broke. So yes, we're clearly better off doing it in the kernel. Not because firmware loading cannot be done in user space. But simply because udev maintenance since Greg gave it up has gone downhill.}}

In 2012, the [[Gentoo Linux]] project created a [[fork (software development)|fork]] of systemd's udev codebase in order to avoid dependency on the systemd architecture. The resulting fork is called ''[[eudev]]'' and it makes udev functionality available without systemd. A stated goal of the project is to keep eudev independent of any [[Linux distribution]] or [[init]] system.<ref>{{cite web|url=https://github.com/gentoo/eudev/blob/master/README.md|title=gentoo/eudev – README.md|website=[[GitHub]] |access-date=2017-12-25}}</ref> The Gentoo project describes eudev as follows:<ref>{{cite web|url=https://wiki.gentoo.org/wiki/Project:Eudev|title=Gentoo Linux Projects – Gentoo eudev project|access-date=2017-12-25|archive-date=2015-09-04|archive-url=https://web.archive.org/web/20150904074508/https://wiki.gentoo.org/wiki/Project:Eudev|url-status=dead}}</ref>

{{quote|eudev is a fork of systemd-udev with the goal of obtaining better compatibility with existing software such as [[OpenRC]] and [[Upstart (software)|Upstart]], older kernels, various toolchains and anything else required by users and various distributions.}}

On May 29, 2014, support for firmware loading through udev was dropped from systemd, as it has been decided that it is the kernel's task to load firmware.<ref>{{cite web |url=http://lists.freedesktop.org/archives/systemd-devel/2014-May/019587.html |title=[systemd-devel] [PATCH] Drop the udev firmware loader |date=2014-05-29}}</ref> Two days later, [[Lennart Poettering]] suggested this patch be postponed until [[kdbus]] starts to be utilized by udev; at that point, the plan was to switch udev to use kdbus as the underlying messaging system, and to get rid of the userspace-to-userspace netlink-based transport.<ref>{{cite web |url=http://lists.freedesktop.org/archives/systemd-devel/2014-May/019657.html |title=[systemd-devel] [PATCH] Drop the udev firmware loader |date=2014-05-31}}</ref>

==Authors==
udev was developed by [[Greg Kroah-Hartman]] and [[Kay Sievers]], with much help from [[Dan Stekloff]], among others.

==References==
{{Reflist|30em}}

==External links==
{{Portal|Linux|Free and open-source software}}

* {{Official website|https://www.freedesktop.org/wiki/Software/systemd}}

{{Linux kernel}}

[[Category:Computer configuration]]
[[Category:Interfaces of the Linux kernel]]
[[Category:Linux file system-related software]]
[[Category:Linux kernel features]]
[[Category:Unix file system-related software]]