Gentoo Archives: gentoo-doc-cvs

From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-net-functions.xml
Date: Fri, 14 May 2010 22:13:01
Message-Id: 20100514221257.6648D2C4F8@corvid.gentoo.org
1 nightmorph 10/05/14 22:12:57
2
3 Modified: hb-net-functions.xml
4 Log:
5 Clarify network function hooks, bug 317675
6
7 Revision Changes Path
8 1.12 xml/htdocs/doc/en/handbook/hb-net-functions.xml
9
10 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-functions.xml?rev=1.12&view=markup
11 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-functions.xml?rev=1.12&content-type=text/plain
12 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-functions.xml?r1=1.11&r2=1.12
13
14 Index: hb-net-functions.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-functions.xml,v
17 retrieving revision 1.11
18 retrieving revision 1.12
19 diff -u -r1.11 -r1.12
20 --- hb-net-functions.xml 7 May 2007 18:11:41 -0000 1.11
21 +++ hb-net-functions.xml 14 May 2010 22:12:57 -0000 1.12
22 @@ -4,7 +4,7 @@
23 <!-- The content of this document is licensed under the CC-BY-SA license -->
24 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25
26 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-functions.xml,v 1.11 2007/05/07 18:11:41 nightmorph Exp $ -->
27 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-functions.xml,v 1.12 2010/05/14 22:12:57 nightmorph Exp $ -->
28
29 <sections>
30
31 @@ -12,17 +12,18 @@
32 If you're feeling adventurous, you can add your own functions to networking.
33 </abstract>
34
35 -<version>8.0</version>
36 -<date>2007-05-07</date>
37 +<version>8.1</version>
38 +<date>2010-05-14</date>
39
40 <section>
41 <title>Standard function hooks</title>
42 <body>
43
44 <p>
45 -Four functions can be defined which will be called surrounding the
46 -<c>start</c>/<c>stop</c> operations. The functions are called with the
47 -interface name first so that one function can control multiple adapters.
48 +Four functions can be defined in <path>/etc/conf.d/net</path> which will be
49 +called surrounding the <c>start</c>/<c>stop</c> operations. The functions are
50 +called with the interface name first so that one function can control multiple
51 +adapters.
52 </p>
53
54 <p>
55 @@ -43,7 +44,7 @@
56 is <c>${IFACE}</c> converted to variable name bash allows.
57 </p>
58
59 -<pre caption="pre/post up/down function examples">
60 +<pre caption="pre/post up/down function examples in /etc/conf.d/net">
61 preup() {
62 <comment># Test for link on the interface prior to bringing it up. This
63 # only works on some network adapters and requires the ethtool
64 @@ -85,6 +86,11 @@
65 }
66 </pre>
67
68 +<note>
69 +For more information on writing your own functions, please read
70 +<path>/etc/conf.d/net.example</path>.
71 +</note>
72 +
73 </body>
74 </section>
75 <section>
76 @@ -97,9 +103,9 @@
77 </note>
78
79 <p>
80 -Two functions can be defined which will be called surrounding the associate
81 -function. The functions are called with the interface name first so that one
82 -function can control multiple adapters.
83 +Two functions can be defined in <path>/etc/conf.d/net</path> which will be
84 +called surrounding the associate function. The functions are called with the
85 +interface name first so that one function can control multiple adapters.
86 </p>
87
88 <p>
89 @@ -116,10 +122,10 @@
90
91 <p>
92 <c>${ESSID}</c> is set to the exact ESSID of the AP you're connecting to.
93 -<c>${ESSIDVAR}</c> is <c>${ESSID}</c> converted to variable name bash allows.
94 +<c>${ESSIDVAR}</c> is <c>${ESSID}</c> converted to a variable name bash allows.
95 </p>
96
97 -<pre caption="pre/post association functions">
98 +<pre caption="pre/post association functions in /etc/conf.d/net">
99 preassociate() {
100 <comment># The below adds two configuration variables leap_user_ESSID
101 # and leap_pass_ESSID. When they are both configured for the ESSID
102 @@ -157,6 +163,11 @@
103 <c>postdown()</c> functions.
104 </note>
105
106 +<note>
107 +For more information on writing your own functions, please read
108 +<path>/etc/conf.d/net.example</path>.
109 +</note>
110 +
111 </body>
112 </section>