~ubuntu-branches/ubuntu/hoary/ifupdown/hoary

« back to all changes in this revision

Viewing changes to ifup.8

  • Committer: Bazaar Package Importer
  • Author(s): Anthony Towns
  • Date: 2001-06-19 00:04:30 UTC
  • Revision ID: james.westby@ubuntu.com-20010619000430-ivxncx51i5i5dpk0
Tags: upstream-0.6.4
ImportĀ upstreamĀ versionĀ 0.6.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH ifupdown 8 "February 13, 2000"
 
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
.BI "[-sinv] [--interfaces=" file "] [--no-act]"
 
9
.BI "[--verbose] [-a|" ifaces "]"
 
10
.PP
 
11
.B ifdown
 
12
.BI "[-sinv] [--interfaces=" file "] [--no-act]"
 
13
.BI "[--verbose] [-a|" ifaces "]"
 
14
.SH DESCRIPTION
 
15
The
 
16
.BR ifup " and " ifdown
 
17
commands may be used to configure (or, respectively, deconfigure) network
 
18
interfaces, based on descriptions of the interfaces entered into the file
 
19
.IR /etc/network/interfaces .
 
20
.SH OPTIONS
 
21
These programs follow the usual GNU command line syntax, with long
 
22
options starting with two dashes (`-').
 
23
A summary of options is included below.
 
24
.TP
 
25
.B "-h, --help"
 
26
Show summary of options.
 
27
.TP
 
28
.B "-V, --version"
 
29
Show copyright and version information.
 
30
.TP
 
31
.B \-a, \-\-all
 
32
Affect all interfaces marked \fBauto\fP.
 
33
.TP
 
34
.BR "-i" " file" ", --interfaces" " file"
 
35
Read interface definitions from a different file.
 
36
.TP
 
37
.B "-v, --verbose"
 
38
Show commands being executed.
 
39
.TP
 
40
.B "-n, --no-act"
 
41
Don't actually execute the commands (this doesn't disable mappings, however)
 
42
.TP
 
43
.B \-\-no\-mappings
 
44
Don't run any mappings.
 
45
.TP
 
46
.B \-\-force
 
47
Force de/configuration of interface.
 
48
.SH NOTES
 
49
The
 
50
.BR ifup " and " ifdown
 
51
programs don't actually know anything about configuring interfaces themselves
 
52
but instead invoke lower-level utilities such as
 
53
.BR ifconfig " and " route
 
54
to do the actual dirtywork. The main advantages to using
 
55
.BR ifup " and " ifdown
 
56
instead of calling the lower-level utilities directy is the ability to
 
57
keep all your interface specifications in a single (easily parsable) file,
 
58
and to not have to deal with the various idiosyncracies of the lower-level
 
59
commands.
 
60
.SH FILES
 
61
.TP
 
62
.B /etc/network/interfaces
 
63
Descriptions of all the network interfaces the system has.
 
64
.TP
 
65
.B /etc/network/ifstate
 
66
Current state of network interfaces.
 
67
.SH AUTHOR
 
68
The ifupdown suite written by Anthony Towns <aj@azure.humbug.org.au>.
 
69
.SH SEE ALSO
 
70
.BR interfaces (5),
 
71
.BR ifconfig (8),