nightmorph 10/05/14 22:12:57 Modified: hb-net-functions.xml Log: Clarify network function hooks, bug 317675
Revision Changes Path 1.12 xml/htdocs/doc/en/handbook/hb-net-functions.xml file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-functions.xml?rev=1.12&view=markup plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-functions.xml?rev=1.12&content-type=text/plain diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-functions.xml?r1=1.11&r2=1.12 Index: hb-net-functions.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-functions.xml,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- hb-net-functions.xml 7 May 2007 18:11:41 -0000 1.11 +++ hb-net-functions.xml 14 May 2010 22:12:57 -0000 1.12 @@ -4,7 +4,7 @@ <!-- The content of this document is licensed under the CC-BY-SA license --> <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-functions.xml,v 1.11 2007/05/07 18:11:41 nightmorph Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-functions.xml,v 1.12 2010/05/14 22:12:57 nightmorph Exp $ --> <sections> @@ -12,17 +12,18 @@ If you're feeling adventurous, you can add your own functions to networking. </abstract> -<version>8.0</version> -<date>2007-05-07</date> +<version>8.1</version> +<date>2010-05-14</date> <section> <title>Standard function hooks</title> <body> <p> -Four functions can be defined which will be called surrounding the -<c>start</c>/<c>stop</c> operations. The functions are called with the -interface name first so that one function can control multiple adapters. +Four functions can be defined in <path>/etc/conf.d/net</path> which will be +called surrounding the <c>start</c>/<c>stop</c> operations. The functions are +called with the interface name first so that one function can control multiple +adapters. </p> <p> @@ -43,7 +44,7 @@ is <c>${IFACE}</c> converted to variable name bash allows. </p> -<pre caption="pre/post up/down function examples"> +<pre caption="pre/post up/down function examples in /etc/conf.d/net"> preup() { <comment># Test for link on the interface prior to bringing it up. This # only works on some network adapters and requires the ethtool @@ -85,6 +86,11 @@ } </pre> +<note> +For more information on writing your own functions, please read +<path>/etc/conf.d/net.example</path>. +</note> + </body> </section> <section> @@ -97,9 +103,9 @@ </note> <p> -Two functions can be defined which will be called surrounding the associate -function. The functions are called with the interface name first so that one -function can control multiple adapters. +Two functions can be defined in <path>/etc/conf.d/net</path> which will be +called surrounding the associate function. The functions are called with the +interface name first so that one function can control multiple adapters. </p> <p> @@ -116,10 +122,10 @@ <p> <c>${ESSID}</c> is set to the exact ESSID of the AP you're connecting to. -<c>${ESSIDVAR}</c> is <c>${ESSID}</c> converted to variable name bash allows. +<c>${ESSIDVAR}</c> is <c>${ESSID}</c> converted to a variable name bash allows. </p> -<pre caption="pre/post association functions"> +<pre caption="pre/post association functions in /etc/conf.d/net"> preassociate() { <comment># The below adds two configuration variables leap_user_ESSID # and leap_pass_ESSID. When they are both configured for the ESSID @@ -157,6 +163,11 @@ <c>postdown()</c> functions. </note> +<note> +For more information on writing your own functions, please read +<path>/etc/conf.d/net.example</path>. +</note> + </body> </section>
