~ubuntu-branches/ubuntu/intrepid/ifupdown/intrepid-201308281004

« back to all changes in this revision

Viewing changes to interfaces.5.pre

  • Committer: Bazaar Package Importer
  • Author(s): Adam Conrad
  • Date: 2005-04-05 10:29:07 UTC
  • Revision ID: james.westby@ubuntu.com-20050405102907-i55swxa6xujotstt
Tags: 0.6.4-4.10ubuntu3
Add a dependency on initscripts (>= 2.85-12) to make sure we get
a working /lib/init/readlink for our scripts (Ubuntu bug #8605)

Show diffs side-by-side

added added

removed removed

Lines of Context:
78
78
is normally given a physical interface name as its first non\-option argument.
79
79
.B ifup
80
80
also uses this name as the initial logical name for the interface 
81
 
unless it is accompanied by a  suffix of the form \fI"=LIFACE"\fR, in 
 
81
unless it is accompanied by a  suffix of the form \fI=LIFACE\fR, in 
82
82
which case ifup chooses LIFACE as the initial logical name for the interface.
83
83
It then maps this name, possibly more than once according to successive
84
84
mapping specifications,  until no further mappings are possible.
109
109
options prefixed with "wireless\-" which can be used to configure the
110
110
interface using
111
111
.BR iwconfig (8) .
 
112
(See
 
113
.BR wireless (7)
 
114
for details.)
112
115
.P
113
116
Options are usually indented for clarity (as in the example above)
114
117
but are not required to be.
149
152
All of these commands have access to the following environment variables.
150
153
.TP
151
154
.B
 
155
VERBOSITY
 
156
verbosity:
 
157
.I 1
 
158
if \fB\-\-verbose\fR option active,
 
159
.I 0
 
160
otherwise
 
161
.TP
 
162
.B
152
163
IFACE
153
164
physical name of the interface being processed
154
165
.TP
158
169
.TP
159
170
.B
160
171
METHOD
161
 
method of the interface (e.g., "static")
 
172
method of the interface (e.g.,
 
173
.IR static )
162
174
.TP
163
 
.B
164
 
MODE
165
 
either
166
 
.IR start " or " stop ,
167
 
depending on whether the script is called by
168
 
.BR ifup " or " ifdown .
 
175
.B MODE
 
176
.IR start " if run from ifup, " stop " if run from ifdown"
169
177
.TP
170
178
.B
171
179
PATH
212
220
.BR iwconfig (8),
213
221
.BR run\-parts (8).
214
222
.P
215
 
You can find a number of examples on how to setup interfaces using the
216
 
different methods available at 
217
 
.B /usr/share/doc/ifupdown/examples/network-interfaces
218
 
and the
 
223
For advice on configuring this package read the
219
224
.B Network Configuration
220
 
chapter of the \fIDebian reference manual\fR (available at
221
 
\fIhttp://www.debian.org/doc/manuals/reference/ch-gateway.en.html\fR or in
222
 
the \fBdebian-reference\fR package)
 
225
chapter of the \fIDebian Reference\fR manual,
 
226
available at
 
227
\fIhttp://www.debian.org/doc/manuals/reference/ch-gateway.en.html\fR
 
228
or in the \fBdebian-reference-en\fR package.
 
229
.P
 
230
Examples of how to set up interfaces can be found in
 
231
.BR /usr/share/doc/ifupdown/examples/network-interfaces .