Mdev: Difference between revisions

Latest revision as of 04:05, 27 March 2024

mdev is the default device manager on Alpine Linux. It is provided by busybox as alternative to systemd's udev. mdev is not a drop in replacement for udev. See eudev for that instead. mdev lacks some features which makes it not recommended for a full blown desktop enviroment.

Installation

The easy way to setup mdev is throught the setup script. For custom installation see the manually section. Note that a manual installation is only recommended for advanced users.

Setup Script

The alpine-conf package privides setup-devd to easily install and setup device managers.

Install alpine-conf if it is not already installed.

# apk add alpine-conf

Setup mdev.

# setup-devd mdev

Manually

Mdev is provided by the busybox package which is pre installed on any alpine installation. To run mdev the OpenRC init scripts are required too. If it isn't already installed install it:

# apk add busybox-mdev-openrc

If you already have a device manager installed you need to stop it before you start mdev.

Enable the mdev service.

# rc-update add mdev sysinit

# rc-update add hwdrivers sysinit

If you are not running in a chroot you will also want to start mdev.

# rc-service mdev start

# rc-service hwdrivers start

You might also want to take a look at libudev replacement if programms you want to use depend on udev.

Remove

Warning: Disabling mdev without setting up a different device manager may cause unexpected issues. If you install a different device manager with the setup script this step is not needed.

First stop the service. This step can be skipped when you are running in a chroot.

# rc-service mdev stop

Then disable it.

# rc-update delete mdev sysinit

You might also want to uninstall the init scripts since they are not used anymore.

# apk del busybox-mdev-openrc

The mdev binary is part of the busybox package and therefor can't be uninstalled.

libudev replacement

libudev-zero provides udev apis but is independent from the device manager used. When installed it will make some udev reliant programms work with mdev. See What doesn't work.

Configuration

@@ Line 1: / Line 1: @@
-{{Draft|This is almost complete but needs testing that it works when followed as a step by step guide.}}
+{{DISPLAYTITLE:mdev}}
+mdev is the default [[Device_Manager|device manager]] on Alpine Linux. It is provided by busybox as alternative to [https://man.archlinux.org/man/udev.7 systemd's udev].
-== mdev ==
+mdev is '''not''' a drop in replacement for udev. See [[eudev]] for that instead. mdev lacks some features which makes it not recommended for a full blown desktop enviroment.
-Mdev is the default [[:Category:Device_Manager|device manager]] on Alpine Linux. It is provided by busybox as alternative to [https://man.archlinux.org/man/udev.7 systemd's udev].
-Mdev is '''not''' a drop in replacement for udev. See [[eudev]] for that instead. Mdev lacks some features which makes it not recommended for a full blown desktop enviroment.
 == Installation ==
-The easy way to setup mdev is throught the [[#Setup_Script|setup script]]. For custom installation see the [[#Manually|manually section]]. Note that this is only recommended for advanced users.
+The easy way to setup mdev is throught the [[#Setup_Script|setup script]]. For custom installation see the [[#Manually|manually section]]. Note that a manual installation is only recommended for advanced users.
 === Setup Script ===
@@ Line 14: / Line 11: @@
 The {{pkg|alpine-conf}} package privides [https://git.alpinelinux.org/alpine-conf/tree/setup-devd.in setup-devd] to easily install and setup device managers.
-Install {{pkg|alpine-conf}} if not already.
+Install {{pkg|alpine-conf}} if it is not already installed.
 {{cmd|# apk add {{pkg|alpine-conf}}}}
 Setup mdev.
@@ Line 22: / Line 19: @@
 Mdev is provided by the {{pkg|busybox}} package which is pre installed on any alpine installation. To run mdev the [[OpenRC]] init scripts are required too. If it isn't already installed install it:
-{{cmd|# apk install {{pkg|busybox-mdev-openrc}}}}
+{{cmd|# apk add {{pkg|busybox-mdev-openrc}}}}
-Before starting mdev you need to [[eudev#Disable|disable eudev]].
+If you already have a device manager installed you need to stop it before you start mdev.
-{{Note|I have no idea what happens if you don't}}
 Enable the mdev service.
 {{cmd|# rc-update add mdev sysinit}}
-{{cmd|# rc-update add hwdrivers sysinit}} {{todo|verify need of the hwdrivers service}}
+{{cmd|# rc-update add hwdrivers sysinit}}
 If you are not running in a chroot you will also want to start mdev.
 {{cmd|# rc-service mdev start}}
 {{cmd|# rc-service hwdrivers start}}
-== Disable ==
+You might also want to take a look at [[#libudev replacement|libudev replacement]] if programms you want to use depend on udev.
+== Remove ==
-{{warning|Disabling mdev without setting up a different device manager may cause programms to break}}
+{{warning|Disabling mdev without setting up a different device manager may cause unexpected issues. If you install a different device manager with the setup script this step is not needed.}}
-To disable mdev when using a different device manager like [[eudev]] you need to stop and remove the service. If you are running in a chroot you don't need to stop the service.
+First stop the service. This step can be skipped when you are running in a chroot.
 {{cmd|# rc-service mdev stop}}
+Then disable it.
 {{cmd|# rc-update delete mdev sysinit}}
@@ Line 47: / Line 46: @@
 You might also want to uninstall the init scripts since they are not used anymore.
 {{cmd|# apk del {{pkg|busybox-mdev-openrc}}}}
+The mdev binary is part of the {{pkg|busybox}} package and therefor can't be uninstalled.
+== libudev replacement ==
+{{pkg|libudev-zero}} provides udev apis but is independent from the device manager used. When installed it will make '''some''' udev reliant programms work with mdev. See <code>[https://github.com/illiliti/libudev-zero/#what-doesnt-work What doesn't work]</code>.
+== Configuration ==
-== Custom network interfaces ==
+=== Custom network interfaces ===
 See [[Custom network interface names]]
-== USB Printer ==
+=== USB Printer ===
-See [[Printer_Setup#mdev_hacks_for_USB_printers|mdev hacks for USB printers]]
+See [[Printer_Setup#configure_mdev_for_USB_printers|configure mdev for USB printers]]
-== Raspberry Pi Bluetooth Speaker ==
+=== Raspberry Pi Bluetooth Speaker ===
 See [[Raspberry_Pi_Bluetooth_Speaker#Bluetooth|Raspberry Pi Bluetooth Speaker]]
 == See Also ==
-* [[eudev]]
+* [[:Category:Device_Manager|Device Managers]]
 * [https://wiki.gentoo.org/wiki/Mdev Gentoo wiki Mdev]
 * [https://git.busybox.net/busybox/plain/docs/mdev.txt mdev doc]
+* [https://github.com/slashbeast/mdev-like-a-boss mdev like a boss]
 [[Category:Device_Manager]]