summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorWilliam Hubbs <williamh@gentoo.org>2011-12-28 11:17:58 -0600
committerWilliam Hubbs <williamh@gentoo.org>2011-12-28 11:17:58 -0600
commit1875db4ff6cdbed45f4375a2cc04f2fe55f25a32 (patch)
tree5fdc9ea267e720f06e57404bbdae31d84ea41c84
parent26ceddae5e48bac07c82d754bd005df01492fa4f (diff)
downloadopenrc-1875db4ff6cdbed45f4375a2cc04f2fe55f25a32.tar.gz
openrc-1875db4ff6cdbed45f4375a2cc04f2fe55f25a32.tar.bz2
openrc-1875db4ff6cdbed45f4375a2cc04f2fe55f25a32.tar.xz
net: document up_before_preup for BSD
-rw-r--r--doc/net.example.BSD.in11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/net.example.BSD.in b/doc/net.example.BSD.in
index 2329fa2..585f73d 100644
--- a/doc/net.example.BSD.in
+++ b/doc/net.example.BSD.in
@@ -388,6 +388,17 @@
#
# ${IFACE} is set to the interface being brought up/down
# ${IFVAR} is ${IFACE} converted to variable name bash allows
+#
+# For historical and compatibility reasons, preup is actually normally called
+# in the following sequence: up ; preup ; up.
+# The first up causes the kernel to initialize the device, so
+# that it is available for use in the preup function. However, for some
+# hardware, e.g. CAN devices, some configuration is needed before trying to up
+# the interface will actually work. For such hardware, the
+# up_before_preup variables will allow skipping the first up call if set
+# to yes.
+#up_before_preup_IFVAR="NO"
+#up_before_preup="NO"
#preup() {
# # Remember to return 0 on success