From ac00934ecd5d9f13e44d27dafe3ac470fc7a5f18 Mon Sep 17 00:00:00 2001 From: William Hubbs Date: Tue, 7 May 2013 13:17:40 -0500 Subject: [PATCH] Document busybox applet incompatibilities Reported-by: slong@rathaus.eclipse.co.uk X-Gentoo-Bug: 468396 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=468396 --- README.busybox | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 README.busybox diff --git a/README.busybox b/README.busybox new file mode 100644 index 00000000..61b5ffdf --- /dev/null +++ b/README.busybox @@ -0,0 +1,28 @@ +Using Busybox as your Default Shell +----------------------------------- + + +If you have/bin/sh linked to busybox, you need to be aware of several +incompatibilities between busybox's applets and the standalone +counterparts. Since it is possible to configure busybox to not include +these applets or to prefer the standalone counterparts, OpenRC does not +attempt to support the busybox applets. + +All of these apply to busybox 1.20.2, which is the current version of +busybox as of this writing. + +1. The start-stop-daemon applet is not compatible with start-stop-daemon +in OpenRC. Please make sure CONFIG_START_STOP_DAEMON is not set to y in +the configuration file you use to build busybox. + +2. The -O option for the mount applet does not support the [no]_netdev +options from util-linux for handling network file systems. + +3. The umount applet does not support the -O option from util-linux. + +4. The swapon applet does not support the -e option from util-linux. + +5. the setfont applet does not support the -u option from kbd. + +There is work to get most of these supported by busybox, so this file +will be updated as things change.