← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/ifupdown/oneiric

« back to all changes in this revision

Viewing changes to _darcs/current/ifup.8

  • Committer: Bazaar Package Importer
  • Author(s): Colin Watson
  • Date: 2011-08-09 14:41:00 UTC
  • mfrom: (2.2.3 experimental)
  • Revision ID: james.westby@ubuntu.com-20110809144100-9uuzizry9u4cvr5z
Tags: 0.7~alpha5.1ubuntu1
https://launchpad.net/bugs/733547
* Resynchronise with Debian experimental.  Remaining changes:
  - ifupdown.nw: Use 100 as default route metric unless an explicit metric
    parameter is set in /etc/network/interface.
  - ifupdown.nw: Add 'ipv4ll' method which uses avahi-autoipd to bring up
    an interface with an IPv4 link-layer address from 169.254.0.0/16 (aka
    'Zeroconf').
  - Add iniparser3.0b sources (dictionary.c, dictionary.h, iniparser.c,
    iniparser.h), to let ifupdown avoid auto-up/down of interfaces if
    network-manager's ifupdown plugin is in managed=true mode.
  - Add a new query interface, 'ifquery', that can be used by upstart
    hooks to ask for the list of possible interfaces that they might need
    to bring up.
  - debian/ifupdown.network-interface.upstart: Replace the init scripts
    with a per-interface Upstart job.
  - debian/ifupdown.networking.upstart: Add a "networking" job that
    partially replaces the networking init script from netbase.
  - debian/control: Bump build-dependency on debhelper for Upstart-aware
    dh_installinit.
  - debian/rules: Due to debhelper always adding /etc/init.d symlinks, we
    must manually remove /etc/init.d/networking for as long as netbase
    still provides it.
  - Add if-up and if-down scripts to emit Upstart events when interfaces
    come up and go down.
  - debian/ifupdown.network-interface-security.upstart: Ensure apport is
    started before interfaces are brought up by either ifupdown or
    network-manager.
  - debian/postinst: If the loopback interface is missing from the config
    in /etc/network/interfaces, add it on upgrade.
  - debian/ifupdown.preinst: Since files in /etc were not conffiles in
    lucid, and /etc/network/if-up.d/upstart and
    /etc/init/network-interface.conf changed between lucid final and
    maverick, add extra handling to avoid spurious conffile prompts.
* Backport from upstream Mercurial repository:
  - Add initial DHCPv6 support (LP: #733547).

Show diffs side-by-side

added added

removed removed

Lines of Context:
_darcs/current/ifup.8
1
 
.TH ifup 8 "22 May 2004" IFUPDOWN ""
2
 
.SH NAME
3
 
ifup \- bring a network interface up
4
 
.PP
5
 
ifdown \- take a network interface down
6
 
.SH SYNOPSIS
7
 
.B ifup 
8
 
[\fB\-nv\fR]
9
 
[\fB\-\-no\-act\fR]
10
 
[\fB\-\-verbose\fR]
11
 
[\fB\-i\fR \fIFILE\fR|\fB\-\-interfaces=\fR\fIFILE\fR]
12
 
[\fB\-\-allow\fR \fICLASS\fR]
13
 
\fB\-a\fR|\fIIFACE\fR...
14
 
.br
15
 
.B ifup 
16
 
\fB\-h\fR|\fB\-\-help\fR
17
 
.br
18
 
.B ifup 
19
 
\fB\-V\fR|\fB\-\-version\fR
20
 
.PP
21
 
.B ifdown
22
 
[\fB\-nv\fR]
23
 
[\fB\-\-no\-act\fR]
24
 
[\fB\-\-verbose\fR]
25
 
[\fB\-i\fR \fIFILE\fR|\fB\-\-interfaces=\fR\fIFILE\fR]
26
 
[\fB\-\-allow\fR \fICLASS\fR]
27
 
\fB\-a\fR|\fIIFACE\fR...
28
 
.SH DESCRIPTION
29
 
The
30
 
.BR ifup " and " ifdown
31
 
commands may be used to configure (or, respectively, deconfigure) network
32
 
interfaces based on interface definitions in the file
33
 
.IR /etc/network/interfaces .
34
 
.SH OPTIONS
35
 
A summary of options is included below.
36
 
.TP
37
 
.BR \-a ", " \-\-all
38
 
If given to \fBifup\fP, affect all interfaces marked \fBauto\fP.
39
 
Interfaces are brought up in the order in which they are defined
40
 
in /etc/network/interfaces.
41
 
If given to \fBifdown\fP, affect all defined interfaces.
42
 
Interfaces are brought down in the order in which they are
43
 
currently listed in the state file. Only interfaces defined
44
 
in /etc/network/interfaces will be brought down.
45
 
.TP
46
 
.B \-\-force
47
 
Force configuration or deconfiguration of the interface.
48
 
.TP
49
 
.BR \-h ", " \-\-help
50
 
Show summary of options.
51
 
.TP
52
 
\fB\-\-allow=\fR\fICLASS\fR
53
 
Only allow interfaces listed in an
54
 
.I allow\-CLASS
55
 
line in /etc/network/interfaces to be acted upon.
56
 
.TP
57
 
\fB\-i\fR \fIFILE\fR, \fB\-\-interfaces=\fR\fIFILE\fR
58
 
Read interface definitions from 
59
 
.I FILE
60
 
instead of from /etc/network/interfaces.
61
 
.TP
62
 
.BR \-n ", " \-\-no\-act
63
 
Don't configure any interfaces or run any "up" or "down" commands.
64
 
.TP
65
 
.B \-\-no\-mappings
66
 
Don't run any mappings.  See
67
 
.BR interfaces (5)
68
 
for more information about the mapping feature.
69
 
.TP
70
 
.BR \-V ", " \-\-version
71
 
Show copyright and version information.
72
 
.TP
73
 
.BR \-v ", " \-\-verbose
74
 
Show commands as they are executed.
75
 
.SH EXAMPLES
76
 
.TP
77
 
.B ifup -a
78
 
Bring up all the interfaces defined with
79
 
.I auto
80
 
in 
81
 
.I /etc/network/interfaces
82
 
.TP
83
 
.B ifup eth0
84
 
Bring up interface
85
 
.B eth0
86
 
.TP
87
 
.B ifup eth0=home
88
 
Bring up interface
89
 
.B eth0
90
 
as logical interface
91
 
.B home
92
 
.TP
93
 
.B ifdown -a
94
 
Bring down all interfaces that are currently up.
95
 
.SH NOTES
96
 
.BR ifup " and " ifdown
97
 
are actually the same program called by different names.
98
 
.P
99
 
The program does not configure network interfaces directly;
100
 
it runs low level utilities such as
101
 
.BR ifconfig " and " route
102
 
to do its dirty work.
103
 
.SH FILES
104
 
.TP
105
 
.I /etc/network/interfaces
106
 
definitions of network interfaces
107
 
See
108
 
.BR interfaces (5)
109
 
for more information.
110
 
.TP
111
 
.I /etc/network/run/ifstate
112
 
current state of network interfaces
113
 
.SH KNOWN BUGS/LIMITATIONS
114
 
The program keeps records of whether network interfaces are up or down.
115
 
Under exceptional circumstances these records can become
116
 
inconsistent with the real states of the interfaces.
117
 
For example, an interface that was brought up using
118
 
.B ifup
119
 
and later deconfigured using
120
 
.B ifconfig
121
 
will still be recorded as up.
122
 
To fix this you can use the
123
 
.B \-\-force
124
 
option to force
125
 
.B ifup
126
 
or
127
 
.B ifdown
128
 
to run configuration or deconfiguration commands despite what
129
 
it considers the current state of the interface to be.
130
 
.P
131
 
The file
132
 
.I /etc/network/run/ifstate
133
 
must be writable for
134
 
.B ifup
135
 
or
136
 
.B ifdown
137
 
to work properly.
138
 
If that location is not writable
139
 
(for example, because the root filesystem is mounted read-only
140
 
for system recovery)
141
 
then
142
 
.I /etc/network/run/ifstate
143
 
should be made a symbolic link to a writable location.
144
 
If that is not possible then you can use the
145
 
.B \-\-force
146
 
option to run configuration or deconfiguration commands
147
 
without updating the file.
148
 
.P
149
 
Note that the program does not run automatically:
150
 
.B ifup
151
 
alone does not bring up interfaces
152
 
that appear as a result of hardware being installed and 
153
 
.B ifdown
154
 
alone does not bring down interfaces
155
 
that disappear as a result of hardware being removed.
156
 
To automate the configuration of network interfaces you need to
157
 
install other packages such as
158
 
.BR hotplug (8)
159
 
or
160
 
.BR ifplugd (8).
161
 
.SH AUTHOR
162
 
The ifupdown suite was written by Anthony Towns <aj@azure.humbug.org.au>.
163
 
.SH SEE ALSO
164
 
.BR interfaces (5),
165
 
.BR ifconfig (8).