Penguin
Recent Changes
Annotated edit history of ifconfig(8) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 IFCONFIG
2 !!!IFCONFIG
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 Address Families
7 OPTIONS
8 NOTES
9 FILES
10 BUGS
11 SEE ALSO
12 AUTHORS
13 ----
14 !!NAME
15
16
17 ifconfig - configure a network interface
18 !!SYNOPSIS
19
20
21 __ifconfig [[interface]
22 ifconfig interface [[aftype] options | address
23 ...__
24 !!DESCRIPTION
25
26
27 __Ifconfig__ is used to configure the kernel-resident
28 network interfaces. It is used at boot time to set up
29 interfaces as necessary. After that, it is usually only
30 needed when debugging or when system tuning is
31 needed.
32
33
34 If no arguments are given, __ifconfig__ displays the
35 status of the currently active interfaces. If a single
36 __interface__ argument is given, it displays the status
37 of the given interface only; if a single __-a__ argument
38 is given, it displays the status of all interfaces, even
39 those that are down. Otherwise, it configures an
40 interface.
41 !!Address Families
42
43
44 If the first argument after the interface name is recognized
45 as the name of a supported address family, that address
46 family is used for decoding and displaying all protocol
47 addresses. Currently supported address families include
48 __inet__ (TCP/IP, default), __inet6__ (IPv6),
49 __ax25__ (AMPR Packet Radio), __ddp__ (Appletalk Phase
50 2), __ipx__ (Novell IPX) and __netrom__ (AMPR Packet
51 radio).
52 !!OPTIONS
53
54
55 __interface__
56
57
58 The name of the interface. This is usually a driver name
59 followed by a unit number, for example __eth0__ for the
60 first Ethernet interface.
61
62
63 __up__
64
65
66 This flag causes the interface to be activated. It is
67 implicitly specified if an address is assigned to the
68 interface.
69
70
71 __down__
72
73
74 This flag causes the driver for this interface to be shut
75 down.
76
77
78 __[[-]arp__
79
80
81 Enable or disable the use of the ARP protocol on this
82 interface.
83
84
85 __[[-]promisc__
86
87
88 Enable or disable the __promiscuous__ mode of the
89 interface. If selected, all packets on the network will be
90 received by the interface.
91
92
93 __[[-]allmulti__
94
95
96 Enable or disable __all-multicast__ mode. If selected,
97 all multicast packets on the network will be received by the
98 interface.
99
100
101 __metric N__
102
103
104 This parameter sets the interface metric.
105
106
107 __mtu N__
108
109
110 This parameter sets the Maximum Transfer Unit (MTU) of an
111 interface.
112
113
114 __dstaddr addr__
115
116
117 Set the remote IP address for a point-to-point link (such as
118 PPP). This keyword is now obsolete; use the
119 __pointopoint__ keyword instead.
120
121
122 __netmask addr__
123
124
125 Set the IP network mask for this interface. This value
126 defaults to the usual class A, B or C network mask (as
127 derived from the interface IP address), but it can be set to
128 any value.
129
130
131 __add addr/prefixlen__
132
133
134 Add an IPv6 address to an interface.
135
136
137 __del addr/prefixlen__
138
139
140 Remove an IPv6 address from an interface.
141
142
143 __tunnel aa.bb.cc.dd__
144
145
146 Create a new SIT (IPv6-in-IPv4) device, tunnelling to the
147 given destination.
148
149
150 __irq addr__
151
152
153 Set the interrupt line used by this device. Not all devices
154 can dynamically change their IRQ setting.
155
156
157 __io_addr addr__
158
159
160 Set the start address in I/O space for this
161 device.
162
163
164 __mem_start addr__
165
166
167 Set the start address for shared memory used by this device.
168 Only a few devices need this.
169
170
171 __media type__
172
173
174 Set the physical port or medium type to be used by the
175 device. Not all devices can change this setting, and those
176 that can vary in what values they support. Typical values
177 for __type__ are __10base2__ (thin Ethernet),
178 __10baseT__ (twisted-pair 10Mbps Ethernet), __AUI__
179 (external transceiver) and so on. The special medium type of
180 __auto__ can be used to tell the driver to auto-sense the
181 media. Again, not all drivers can do this.
182
183
184 __[[-]broadcast [[addr]__
185
186
187 If the address argument is given, set the protocol broadcast
188 address for this interface. Otherwise, set (or clear) the
189 __IFF_BROADCAST__ flag for the interface.
190
191
192 __[[-]pointopoint [[addr]__
193
194
195 This keyword enables the __point-to-point__ mode of an
196 interface, meaning that it is a direct link between two
197 machines with nobody else listening on it.
198 If the address argument is also given, set the protocol
199 address of the other side of the link, just like the
200 obsolete __dstaddr__ keyword does. Otherwise, set or
201 clear the __IFF_POINTOPOINT__ flag for the
202 interface.
203
204
205 __hw class address__
206
207
208 Set the hardware address of this interface, if the device
209 driver supports this operation. The keyword must be followed
210 by the name of the hardware class and the printable ASCII
211 equivalent of the hardware address. Hardware classes
212 currently supported include __ether__ (Ethernet),
213 __ax25__ (AMPR AX.25), __ARCnet__ and __netrom__
214 (AMPR NET/ROM).
215
216
217 __multicast__
218
219
220 Set the multicast flag on the interface. This should not
221 normally be needed as the drivers set the flag correctly
222 themselves.
223
224
225 __address__
226
227
228 The IP address to be assigned to this
229 interface.
230
231
232 __txqueuelen length__
233
234
235 Set the length of the transmit queue of the device. It is
236 useful to set this to small values for slower devices with a
237 high latency (modem links, ISDN) to prevent fast bulk
238 transfers from disturbing interactive traffic like telnet
239 too much.
240 !!NOTES
241
242
243 Since kernel release 2.2 there are no explicit interface
244 statistics for alias interfaces anymore. The statistics
245 printed for the original address are shared with all alias
246 addresses on the same device. If you want per-address
247 statistics you should add explicit accounting rules for the
248 address using the __ipchains(8)__ command.
249
250
251 Since net-tools 1.60-4 ifconfig is printing byte counters
252 with SI units. So 1 KiB are 2^10 byte. Note, the numbers are
253 truncated to one decimal (which can by quite a large error
254 if you consider 0.1 PiB is 112.589.990.684.262 bytes
255 :)
256
257
258 Interrupt problems with Ethernet device drivers fail with
259 EAGAIN ''(SIOCSIIFLAGS: Resource temporarily
260 unavailable)'' it is most likely a interrupt conflict. See
261 ''http://www.scyld.com/expert/irq-conflict.html'' for
262 more information.
263 !!FILES
264
265
266 ''/proc/net/socket
267 /proc/net/dev
268 /proc/net/if_inet6''
269 !!BUGS
270
271
272 While appletalk DDP and IPX addresses will be displayed they
273 cannot be altered by this command.
274 !!SEE ALSO
275
276
277 route(8), netstat(8), arp(8), rarp(8), ipchains(8)
278 http://physics.nist.gov/cuu/Units/binary.html - Prefixes for
279 binary multiples
280 !!AUTHORS
281
282
283 Fred N. van Kempen,
284 Alan Cox,
285 Phil Blundell,
286 Andi Kleen;
287 Bernd Eckenfels,
288 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.