xref: /freebsd/sbin/ifconfig/ifconfig.8 (revision 8fbad60d0a78a9df34b8af795d73b984f9d53cd4)
18fae3551SRodney W. Grimes.\" Copyright (c) 1983, 1991, 1993
28fae3551SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
38fae3551SRodney W. Grimes.\"
48fae3551SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
58fae3551SRodney W. Grimes.\" modification, are permitted provided that the following conditions
68fae3551SRodney W. Grimes.\" are met:
78fae3551SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
88fae3551SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
98fae3551SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
108fae3551SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
118fae3551SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
128fae3551SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software
13e333b944SPhilippe Charnier.\"    must display the following acknowledgment:
148fae3551SRodney W. Grimes.\"	This product includes software developed by the University of
158fae3551SRodney W. Grimes.\"	California, Berkeley and its contributors.
168fae3551SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors
178fae3551SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
188fae3551SRodney W. Grimes.\"    without specific prior written permission.
198fae3551SRodney W. Grimes.\"
208fae3551SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
218fae3551SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
228fae3551SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
238fae3551SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
248fae3551SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
258fae3551SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
268fae3551SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
278fae3551SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
288fae3551SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
298fae3551SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
308fae3551SRodney W. Grimes.\" SUCH DAMAGE.
318fae3551SRodney W. Grimes.\"
320761cb29SGarrett Wollman.\"     From: @(#)ifconfig.8	8.3 (Berkeley) 1/5/94
337f3dea24SPeter Wemm.\" $FreeBSD$
348fae3551SRodney W. Grimes.\"
35b09b4efbSRuslan Ermilov.Dd July 2, 2001
368fae3551SRodney W. Grimes.Dt IFCONFIG 8
37b09b4efbSRuslan Ermilov.Os
388fae3551SRodney W. Grimes.Sh NAME
398fae3551SRodney W. Grimes.Nm ifconfig
408fae3551SRodney W. Grimes.Nd configure network interface parameters
418fae3551SRodney W. Grimes.Sh SYNOPSIS
427c7fb079SRuslan Ermilov.Nm
43abc3361aSArchie Cobbs.Op Fl L
44ca299b1fSPoul-Henning Kamp.Op Fl m
45abc3361aSArchie Cobbs.Ar interface
463e61dca0SBrooks Davis.Op Cm create
47abc3361aSArchie Cobbs.Op Ar address_family
488fae3551SRodney W. Grimes.Oo
49eb2a1701SDima Dorfman.Ar address
508fae3551SRodney W. Grimes.Op Ar dest_address
518fae3551SRodney W. Grimes.Oc
528fae3551SRodney W. Grimes.Op Ar parameters
537c7fb079SRuslan Ermilov.Nm
543e61dca0SBrooks Davis.Ar interface
553e61dca0SBrooks Davis.Cm destroy
563e61dca0SBrooks Davis.Nm
57b5436146SPeter Wemm.Fl a
58abc3361aSArchie Cobbs.Op Fl L
59b5436146SPeter Wemm.Op Fl d
60ca299b1fSPoul-Henning Kamp.Op Fl m
61b5436146SPeter Wemm.Op Fl u
62e333b944SPhilippe Charnier.Op Ar address_family
637c7fb079SRuslan Ermilov.Nm
64b5436146SPeter Wemm.Fl l
65b5436146SPeter Wemm.Op Fl d
66b5436146SPeter Wemm.Op Fl u
67e333b944SPhilippe Charnier.Op Ar address_family
687c7fb079SRuslan Ermilov.Nm
69abc3361aSArchie Cobbs.Op Fl L
70abc3361aSArchie Cobbs.Op Fl d
71ca299b1fSPoul-Henning Kamp.Op Fl m
72abc3361aSArchie Cobbs.Op Fl u
733e61dca0SBrooks Davis.Op Fl C
748fae3551SRodney W. Grimes.Sh DESCRIPTION
75e1205e80SPhilippe CharnierThe
76e1205e80SPhilippe Charnier.Nm
77e1205e80SPhilippe Charnierutility is used to assign an address
788fae3551SRodney W. Grimesto a network interface and/or configure
798fae3551SRodney W. Grimesnetwork interface parameters.
80e1205e80SPhilippe CharnierThe
81e1205e80SPhilippe Charnier.Nm
82e1205e80SPhilippe Charnierutility must be used at boot time to define the network address
838fae3551SRodney W. Grimesof each interface present on a machine; it may also be used at
848fae3551SRodney W. Grimesa later time to redefine an interface's address
858fae3551SRodney W. Grimesor other operating parameters.
868fae3551SRodney W. Grimes.Pp
87e333b944SPhilippe CharnierThe following options are available:
88e333b944SPhilippe Charnier.Bl -tag -width indent
89e333b944SPhilippe Charnier.It Ar address
908fae3551SRodney W. GrimesFor the
91e333b944SPhilippe Charnier.Tn DARPA Ns -Internet
928fae3551SRodney W. Grimesfamily,
938fae3551SRodney W. Grimesthe address is either a host name present in the host name data
948fae3551SRodney W. Grimesbase,
958fae3551SRodney W. Grimes.Xr hosts 5 ,
968fae3551SRodney W. Grimesor a
978fae3551SRodney W. Grimes.Tn DARPA
988fae3551SRodney W. GrimesInternet address expressed in the Internet standard
998fae3551SRodney W. Grimes.Dq dot notation .
10012813062SJesper Skriver.Pp
10112813062SJesper SkriverIt is also possible to use the CIDR notation (also known as the
10212813062SJesper Skriverslash notation) to include the netmask.
10312813062SJesper SkriverThat is, one can specify an address like
10419fe4826SRuslan Ermilov.Li 192.168.0.1/16 .
1059f1741caSRuslan Ermilov.Pp
1069f1741caSRuslan ErmilovFor
1079f1741caSRuslan Ermilov.Dq inet6
1089f1741caSRuslan Ermilovfamily, it is also possible to specify the prefix length using the slash
1099f1741caSRuslan Ermilovnotation, like
1109f1741caSRuslan Ermilov.Li ::1/128 .
1119f1741caSRuslan ErmilovSee the
1129f1741caSRuslan Ermilov.Cm prefixlen
1139f1741caSRuslan Ermilovparameter below for more information.
114cbc17e71SGarrett Wollman.\" For the Xerox Network Systems(tm) family,
115cbc17e71SGarrett Wollman.\" addresses are
116cbc17e71SGarrett Wollman.\" .Ar net:a.b.c.d.e.f ,
117cbc17e71SGarrett Wollman.\" where
118cbc17e71SGarrett Wollman.\" .Ar net
119cbc17e71SGarrett Wollman.\" is the assigned network number (in decimal),
120cbc17e71SGarrett Wollman.\" and each of the six bytes of the host number,
121cbc17e71SGarrett Wollman.\" .Ar a
122cbc17e71SGarrett Wollman.\" through
123cbc17e71SGarrett Wollman.\" .Ar f ,
124cbc17e71SGarrett Wollman.\" are specified in hexadecimal.
125b80875bcSDima Dorfman.\" The host number may be omitted on IEEE 802 protocol
126b80875bcSDima Dorfman.\" (Ethernet, FDDI, and Token Ring) interfaces,
127cbc17e71SGarrett Wollman.\" which use the hardware physical address,
128cbc17e71SGarrett Wollman.\" and on interfaces other than the first.
1290761cb29SGarrett Wollman.\" For the
1300761cb29SGarrett Wollman.\" .Tn ISO
1310761cb29SGarrett Wollman.\" family, addresses are specified as a long hexadecimal string,
132b09b4efbSRuslan Ermilov.\" as in the Xerox family.
133b09b4efbSRuslan Ermilov.\" However, two consecutive dots imply a zero
1340761cb29SGarrett Wollman.\" byte, and the dots are optional, if the user wishes to (carefully)
1350761cb29SGarrett Wollman.\" count out long strings of digits in network byte order.
1361876df83SRuslan Ermilov.Pp
1371876df83SRuslan ErmilovThe link-level
1381876df83SRuslan Ermilov.Pq Dq link
1391876df83SRuslan Ermilovaddress
1401876df83SRuslan Ermilovis specified as a series of colon-separated hex digits.
1411876df83SRuslan ErmilovThis can be used to
1421876df83SRuslan Ermilove.g. set a new MAC address on an ethernet interface, though the
1431876df83SRuslan Ermilovmechanism used is not ethernet-specific.
1441876df83SRuslan ErmilovIf the interface is already
1451876df83SRuslan Ermilovup when this option is used, it will be briefly brought down and
1461876df83SRuslan Ermilovthen brought back up again in order to ensure that the receive
1471876df83SRuslan Ermilovfilter in the underlying ethernet hardware is properly reprogrammed.
1488fae3551SRodney W. Grimes.It Ar address_family
149e333b944SPhilippe CharnierSpecify the
150b09b4efbSRuslan Ermilovaddress family
1518fae3551SRodney W. Grimeswhich affects interpretation of the remaining parameters.
1528fae3551SRodney W. GrimesSince an interface can receive transmissions in differing protocols
153e71057d8SMike Pritchardwith different naming schemes, specifying the address family is recommended.
1548fae3551SRodney W. GrimesThe address or protocol families currently
1558fae3551SRodney W. Grimessupported are
156e05f2836SJulian Elischer.Dq inet ,
157cfa1ca9dSYoshinobu Inoue.Dq inet6 ,
158e05f2836SJulian Elischer.Dq atalk ,
1591876df83SRuslan Ermilov.Dq ipx ,
1600761cb29SGarrett Wollman.\" .Dq iso ,
1618fae3551SRodney W. Grimesand
1621876df83SRuslan Ermilov.Dq link .
163cbc17e71SGarrett Wollman.\" and
164cbc17e71SGarrett Wollman.\" .Dq ns .
165d29a2061SDima DorfmanThe default is
166d29a2061SDima Dorfman.Dq inet .
1671876df83SRuslan Ermilov.Dq ether
1681876df83SRuslan Ermilovand
1691876df83SRuslan Ermilov.Dq lladdr
1701876df83SRuslan Ermilovare synonyms for
1711876df83SRuslan Ermilov.Dq link .
172e333b944SPhilippe Charnier.It Ar dest_address
173e333b944SPhilippe CharnierSpecify the address of the correspondent on the other end
174e333b944SPhilippe Charnierof a point to point link.
175e333b944SPhilippe Charnier.It Ar interface
176e333b944SPhilippe CharnierThis
1778fae3551SRodney W. Grimesparameter is a string of the form
1788fae3551SRodney W. Grimes.Dq name unit ,
1798fae3551SRodney W. Grimesfor example,
180b09b4efbSRuslan Ermilov.Dq Li ed0 .
1818fae3551SRodney W. Grimes.El
1828fae3551SRodney W. Grimes.Pp
1838fae3551SRodney W. GrimesThe following parameters may be set with
1847c7fb079SRuslan Ermilov.Nm :
185e333b944SPhilippe Charnier.Bl -tag -width indent
186d6d1cb48SRobert Watson.It Cm add
187d0353b83SRuslan ErmilovAnother name for the
188d0353b83SRuslan Ermilov.Cm alias
189d0353b83SRuslan Ermilovparameter.
190d0353b83SRuslan ErmilovIntroduced for compatibility
191b09b4efbSRuslan Ermilovwith
192b09b4efbSRuslan Ermilov.Bsx .
1938fae3551SRodney W. Grimes.It Cm alias
1948fae3551SRodney W. GrimesEstablish an additional network address for this interface.
1958fae3551SRodney W. GrimesThis is sometimes useful when changing network numbers, and
1968fae3551SRodney W. Grimesone wishes to accept packets addressed to the old interface.
19799aa831bSChris CostelloIf the address is on the same subnet as the first network address
198aaa34889SBrian Somersfor this interface, a non-conflicting netmask must be given.
199aaa34889SBrian SomersUsually
200b09b4efbSRuslan Ermilov.Li 0xffffffff
201aaa34889SBrian Somersis most appropriate.
202fac3d981SDavid E. O'Brien.It Fl alias
203fac3d981SDavid E. O'BrienRemove the network address specified.
204fac3d981SDavid E. O'BrienThis would be used if you incorrectly specified an alias, or it
205fac3d981SDavid E. O'Brienwas no longer needed.
206fac3d981SDavid E. O'BrienIf you have incorrectly set an NS address having the side effect
207fac3d981SDavid E. O'Brienof specifying the host portion, removing all NS addresses will
208fac3d981SDavid E. O'Brienallow you to respecify the host portion.
209cfa1ca9dSYoshinobu Inoue.It Cm anycast
210b09b4efbSRuslan Ermilov(Inet6 only.)
211cfa1ca9dSYoshinobu InoueSpecify that the address configured is an anycast address.
212cfa1ca9dSYoshinobu InoueBased on the current specification,
213cfa1ca9dSYoshinobu Inoueonly routers may configure anycast addresses.
214cfa1ca9dSYoshinobu InoueAnycast address will not be used as source address of any of outgoing
215cfa1ca9dSYoshinobu InoueIPv6 packets.
2168fae3551SRodney W. Grimes.It Cm arp
217b09b4efbSRuslan ErmilovEnable the use of the Address Resolution Protocol
218b09b4efbSRuslan Ermilov.Pq Xr arp 4
219b09b4efbSRuslan Ermilovin mapping
2208fae3551SRodney W. Grimesbetween network level addresses and link level addresses (default).
2218fae3551SRodney W. GrimesThis is currently implemented for mapping between
2228fae3551SRodney W. Grimes.Tn DARPA
2238fae3551SRodney W. GrimesInternet
224b80875bcSDima Dorfmanaddresses and
225b80875bcSDima Dorfman.Tn IEEE
226b80875bcSDima Dorfman802 48-bit MAC addresses (Ethernet, FDDI, and Token Ring addresses).
2278fae3551SRodney W. Grimes.It Fl arp
228b09b4efbSRuslan ErmilovDisable the use of the Address Resolution Protocol
229b09b4efbSRuslan Ermilov.Pq Xr arp 4 .
2308fae3551SRodney W. Grimes.It Cm broadcast
231b09b4efbSRuslan Ermilov(Inet only.)
2328fae3551SRodney W. GrimesSpecify the address to use to represent broadcasts to the
2338fae3551SRodney W. Grimesnetwork.
2348fae3551SRodney W. GrimesThe default broadcast address is the address with a host part of all 1's.
2358fae3551SRodney W. Grimes.It Cm debug
2368fae3551SRodney W. GrimesEnable driver dependent debugging code; usually, this turns on
2378fae3551SRodney W. Grimesextra console error logging.
2388fae3551SRodney W. Grimes.It Fl debug
2398fae3551SRodney W. GrimesDisable driver dependent debugging code.
240ffb079beSMaxim Sobolev.It Cm promisc
241ffb079beSMaxim SobolevPut interface into permanently promiscuous mode.
242ffb079beSMaxim Sobolev.It Fl promisc
243ffb079beSMaxim SobolevDisable permanently promiscuous mode.
2448fae3551SRodney W. Grimes.It Cm delete
245d0353b83SRuslan ErmilovAnother name for the
246d0353b83SRuslan Ermilov.Fl alias
247d0353b83SRuslan Ermilovparameter.
2488fae3551SRodney W. Grimes.It Cm down
249d0353b83SRuslan ErmilovMark an interface
250d0353b83SRuslan Ermilov.Dq down .
251d0353b83SRuslan ErmilovWhen an interface is marked
252d0353b83SRuslan Ermilov.Dq down ,
253d0353b83SRuslan Ermilovthe system will not attempt to
2548fae3551SRodney W. Grimestransmit messages through that interface.
2558fae3551SRodney W. GrimesIf possible, the interface will be reset to disable reception as well.
2568fae3551SRodney W. GrimesThis action does not automatically disable routes using the interface.
257331a2db8SHajimu UMEMOTO.It Cm eui64
258331a2db8SHajimu UMEMOTO(Inet6 only.)
259331a2db8SHajimu UMEMOTOFill interface index
260a61d9c47SRuslan Ermilov(lowermost 64bit of an IPv6 address)
261331a2db8SHajimu UMEMOTOautomatically.
262cbc17e71SGarrett Wollman.\" .It Cm ipdst
263cbc17e71SGarrett Wollman.\" This is used to specify an Internet host who is willing to receive
264cbc17e71SGarrett Wollman.\" ip packets encapsulating NS packets bound for a remote network.
265cbc17e71SGarrett Wollman.\" An apparent point to point link is constructed, and
266cbc17e71SGarrett Wollman.\" the address specified will be taken as the NS address and network
267cbc17e71SGarrett Wollman.\" of the destination.
268cbc17e71SGarrett Wollman.\" IP encapsulation of
269cbc17e71SGarrett Wollman.\" .Tn CLNP
270cbc17e71SGarrett Wollman.\" packets is done differently.
27176b4b15fSChris Costello.It Cm maclabel Ar label
27276b4b15fSChris CostelloIf Mandatory Access Control support is enabled in the kernel,
27376b4b15fSChris Costelloset the MAC label to
27476b4b15fSChris Costello.Ar label .
27576b4b15fSChris Costello.\" (see
27676b4b15fSChris Costello.\" .Xr maclabel 7 ) .
277b5436146SPeter Wemm.It Cm media Ar type
278920de530SPeter WemmIf the driver supports the media selection system, set the media type
279920de530SPeter Wemmof the interface to
280b5436146SPeter Wemm.Ar type .
281b5436146SPeter WemmSome interfaces support the mutually exclusive use of one of several
282b09b4efbSRuslan Ermilovdifferent physical media connectors.
283b09b4efbSRuslan ErmilovFor example, a 10Mb/s Ethernet
284b5436146SPeter Wemminterface might support the use of either
285b5436146SPeter Wemm.Tn AUI
286b09b4efbSRuslan Ermilovor twisted pair connectors.
287b09b4efbSRuslan ErmilovSetting the media type to
288b5436146SPeter Wemm.Dq 10base5/AUI
289b5436146SPeter Wemmwould change the currently active connector to the AUI port.
290b5436146SPeter WemmSetting it to
291b5436146SPeter Wemm.Dq 10baseT/UTP
292b09b4efbSRuslan Ermilovwould activate twisted pair.
293b09b4efbSRuslan ErmilovRefer to the interfaces' driver
294920de530SPeter Wemmspecific documentation or man page for a complete list of the
295920de530SPeter Wemmavailable types.
296b5436146SPeter Wemm.It Cm mediaopt Ar opts
297920de530SPeter WemmIf the driver supports the media selection system, set the specified
298920de530SPeter Wemmmedia options on the interface.
299b09b4efbSRuslan ErmilovThe
300b09b4efbSRuslan Ermilov.Ar opts
301b09b4efbSRuslan Ermilovargument
302b5436146SPeter Wemmis a comma delimited list of options to apply to the interface.
303b5436146SPeter WemmRefer to the interfaces' driver specific man page for a complete
304b5436146SPeter Wemmlist of available options.
305b5436146SPeter Wemm.It Fl mediaopt Ar opts
306920de530SPeter WemmIf the driver supports the media selection system, disable the
307920de530SPeter Wemmspecified media options on the interface.
3088fbad60dSRuslan Ermilov.It Cm rxcsum , txcsum
3098fbad60dSRuslan ErmilovIf the driver supports user-configurable checksum offloading,
3108fbad60dSRuslan Ermilovenable receive (or transmit) checksum offloading on the interface.
3118fbad60dSRuslan ErmilovSome drivers may not be able to enable these flags independently
3128fbad60dSRuslan Ermilovof each other, so setting one may also set the other.
3138fbad60dSRuslan ErmilovThe driver will offload as much checksum work as it can reliably
3148fbad60dSRuslan Ermilovsupport, the exact level of offloading varies between drivers.
3158fbad60dSRuslan Ermilov.It Fl rxcsum , Fl txcsum
3168fbad60dSRuslan ErmilovIf the driver supports user-configurable checksum offloading,
3178fbad60dSRuslan Ermilovdisable receive (or transmit) checksum offloading on the interface.
3188fbad60dSRuslan ErmilovThese settings may not always be independent of each other.
319b09b4efbSRuslan Ermilov.It Cm tunnel Ar src_addr dest_addr
320b09b4efbSRuslan Ermilov(IP tunnel devices only.)
32133841545SHajimu UMEMOTOConfigure the physical source and destination address for IP tunnel
322b09b4efbSRuslan Ermilovinterfaces
323b09b4efbSRuslan Ermilov.Pq Xr gif 4 .
324b09b4efbSRuslan ErmilovThe arguments
32533841545SHajimu UMEMOTO.Ar src_addr
32633841545SHajimu UMEMOTOand
32733841545SHajimu UMEMOTO.Ar dest_addr
32833841545SHajimu UMEMOTOare interpreted as the outer source/destination for the encapsulating
32933841545SHajimu UMEMOTOIPv4/IPv6 header.
33033841545SHajimu UMEMOTO.It Cm deletetunnel
33133841545SHajimu UMEMOTOUnconfigure the physical source and destination address for IP tunnel
33233841545SHajimu UMEMOTOinterfaces previously configured with
33333841545SHajimu UMEMOTO.Cm tunnel .
3343e61dca0SBrooks Davis.It Cm create
3353e61dca0SBrooks DavisCreate the specified network pseudo-device.
3363e61dca0SBrooks DavisIf the interface is given without a unit number, try to create a new
3373e61dca0SBrooks Davisdevice with an arbitrary unit number.
338525d500eSDima DorfmanIf creation of an arbitrary device is successful, the new device name is
339b09b4efbSRuslan Ermilovprinted to standard output.
3403e61dca0SBrooks Davis.It Cm destroy
3413e61dca0SBrooks DavisDestroy the specified network pseudo-device.
3423e61dca0SBrooks Davis.It Cm plumb
3433e61dca0SBrooks DavisAnother name for the
344b8a7fd3fSYaroslav Tykhiy.Cm create
3453e61dca0SBrooks Davisparameter.
346b09b4efbSRuslan ErmilovIncluded for
347b09b4efbSRuslan Ermilov.Tn Solaris
348b09b4efbSRuslan Ermilovcompatibility.
3493e61dca0SBrooks Davis.It Cm unplumb
3503e61dca0SBrooks DavisAnother name for the
351b8a7fd3fSYaroslav Tykhiy.Cm destroy
3523e61dca0SBrooks Davisparameter.
353b09b4efbSRuslan ErmilovIncluded for
354b09b4efbSRuslan Ermilov.Tn Solaris
355b09b4efbSRuslan Ermilovcompatibility.
35697ed1257SBill Paul.It Cm vlan Ar vlan_tag
35797ed1257SBill PaulIf the interface is a vlan pseudo interface, set the vlan tag value
35897ed1257SBill Paulto
35997ed1257SBill Paul.Ar vlan_tag .
36097ed1257SBill PaulThis value is a 16-bit number which is used to create an 802.1Q
361ef8f7ac9SSheldon Hearnvlan header for packets sent from the vlan interface.
362ef8f7ac9SSheldon HearnNote that
36397ed1257SBill Paul.Cm vlan
36497ed1257SBill Pauland
36597ed1257SBill Paul.Cm vlandev
36697ed1257SBill Paulmust both be set at the same time.
36797ed1257SBill Paul.It Cm vlandev Ar iface
36897ed1257SBill PaulIf the interface is a vlan pseudo device, associate physical interface
36997ed1257SBill Paul.Ar iface
370ef8f7ac9SSheldon Hearnwith it.
371ef8f7ac9SSheldon HearnPackets transmitted through the vlan interface will be
37297ed1257SBill Pauldiverted to the specified physical interface
37397ed1257SBill Paul.Ar iface
374ef8f7ac9SSheldon Hearnwith 802.1Q vlan encapsulation.
375ef8f7ac9SSheldon HearnPackets with 802.1Q encapsulation received
37697ed1257SBill Paulby the parent interface with the correct vlan tag will be diverted to
377ef8f7ac9SSheldon Hearnthe associated vlan pseudo-interface.
378ef8f7ac9SSheldon HearnThe vlan interface is assigned a
37997ed1257SBill Paulcopy of the parent interface's flags and the parent's ethernet address.
38097ed1257SBill PaulThe
38197ed1257SBill Paul.Cm vlandev
38297ed1257SBill Pauland
38397ed1257SBill Paul.Cm vlan
384ef8f7ac9SSheldon Hearnmust both be set at the same time.
385ef8f7ac9SSheldon HearnIf the vlan interface already has
386ef8f7ac9SSheldon Hearna physical interface associated with it, this command will fail.
387ef8f7ac9SSheldon HearnTo
38897ed1257SBill Paulchange the association to another physical interface, the existing
38997ed1257SBill Paulassociation must be cleared first.
39097ed1257SBill Paul.Pp
3913706a3a8SRuslan ErmilovNote: if the hardware tagging capability
392ac244ef3SSam Leffleris set on the vlan interface, the vlan pseudo
393ac244ef3SSam Lefflerinterface's behavior changes:
394ac244ef3SSam Lefflerthe vlan interface recognizes that the
39597ed1257SBill Paulparent interface supports insertion and extraction of vlan tags on its
39697ed1257SBill Paulown (usually in firmware) and that it should pass packets to and from
39797ed1257SBill Paulthe parent unaltered.
39897ed1257SBill Paul.It Fl vlandev Ar iface
39997ed1257SBill PaulIf the driver is a vlan pseudo device, disassociate the physical interface
40097ed1257SBill Paul.Ar iface
401ef8f7ac9SSheldon Hearnfrom it.
402ef8f7ac9SSheldon HearnThis breaks the link between the vlan interface and its parent,
40397ed1257SBill Paulclears its vlan tag, flags and its link address and shuts the interface down.
4048fae3551SRodney W. Grimes.It Cm metric Ar n
4058fae3551SRodney W. GrimesSet the routing metric of the interface to
4068fae3551SRodney W. Grimes.Ar n ,
4078fae3551SRodney W. Grimesdefault 0.
4088fae3551SRodney W. GrimesThe routing metric is used by the routing protocol
4098fae3551SRodney W. Grimes.Pq Xr routed 8 .
4108fae3551SRodney W. GrimesHigher metrics have the effect of making a route
4118fae3551SRodney W. Grimesless favorable; metrics are counted as addition hops
4128fae3551SRodney W. Grimesto the destination network or host.
4134db32b03SDavid Greenman.It Cm mtu Ar n
4144db32b03SDavid GreenmanSet the maximum transmission unit of the interface to
4154db32b03SDavid Greenman.Ar n ,
4164db32b03SDavid Greenmandefault is interface specific.
417b09b4efbSRuslan ErmilovThe MTU is used to limit the size of packets that are transmitted on an
4184db32b03SDavid Greenmaninterface.
419b09b4efbSRuslan ErmilovNot all interfaces support setting the MTU, and some interfaces have
4204db32b03SDavid Greenmanrange restrictions.
4218fae3551SRodney W. Grimes.It Cm netmask Ar mask
422b09b4efbSRuslan Ermilov.\" (Inet and ISO.)
423b09b4efbSRuslan Ermilov(Inet only.)
4248fae3551SRodney W. GrimesSpecify how much of the address to reserve for subdividing
4258fae3551SRodney W. Grimesnetworks into sub-networks.
4268fae3551SRodney W. GrimesThe mask includes the network part of the local address
4278fae3551SRodney W. Grimesand the subnet part, which is taken from the host field of the address.
4288fae3551SRodney W. GrimesThe mask can be specified as a single hexadecimal number
429b09b4efbSRuslan Ermilovwith a leading
430b09b4efbSRuslan Ermilov.Ql 0x ,
431b09b4efbSRuslan Ermilovwith a dot-notation Internet address,
4328fae3551SRodney W. Grimesor with a pseudo-network name listed in the network table
4338fae3551SRodney W. Grimes.Xr networks 5 .
4348fae3551SRodney W. GrimesThe mask contains 1's for the bit positions in the 32-bit address
4358fae3551SRodney W. Grimeswhich are to be used for the network and subnet parts,
4368fae3551SRodney W. Grimesand 0's for the host part.
4378fae3551SRodney W. GrimesThe mask should contain at least the standard network portion,
4388fae3551SRodney W. Grimesand the subnet field should be contiguous with the network
4398fae3551SRodney W. Grimesportion.
44012813062SJesper Skriver.Pp
44112813062SJesper SkriverThe netmask can also be specified in CIDR notation after the address.
44212813062SJesper SkriverSee the
44312813062SJesper Skriver.Ar address
44412813062SJesper Skriveroption above for more information.
445cfa1ca9dSYoshinobu Inoue.It Cm prefixlen Ar len
446b09b4efbSRuslan Ermilov(Inet6 only.)
447cfa1ca9dSYoshinobu InoueSpecify that
448cfa1ca9dSYoshinobu Inoue.Ar len
449cfa1ca9dSYoshinobu Inouebits are reserved for subdividing networks into sub-networks.
450cfa1ca9dSYoshinobu InoueThe
451cfa1ca9dSYoshinobu Inoue.Ar len
452cfa1ca9dSYoshinobu Inouemust be integer, and for syntactical reason it must be between 0 to 128.
453cfa1ca9dSYoshinobu InoueIt is almost always 64 under the current IPv6 assignment rule.
454bfc03b18SStephen McKayIf the parameter is omitted, 64 is used.
4559f1741caSRuslan Ermilov.Pp
4569f1741caSRuslan ErmilovThe prefix can also be specified using the slash notation after the address.
4579f1741caSRuslan ErmilovSee the
4589f1741caSRuslan Ermilov.Ar address
4599f1741caSRuslan Ermilovoption above for more information.
4608fae3551SRodney W. Grimes.\" see
4618fae3551SRodney W. Grimes.\" Xr eon 5 .
4620761cb29SGarrett Wollman.\" .It Cm nsellength Ar n
4630761cb29SGarrett Wollman.\" .Pf ( Tn ISO
4640761cb29SGarrett Wollman.\" only)
4650761cb29SGarrett Wollman.\" This specifies a trailing number of bytes for a received
4660761cb29SGarrett Wollman.\" .Tn NSAP
4670761cb29SGarrett Wollman.\" used for local identification, the remaining leading part of which is
4680761cb29SGarrett Wollman.\" taken to be the
4690761cb29SGarrett Wollman.\" .Tn NET
4700761cb29SGarrett Wollman.\" (Network Entity Title).
4710761cb29SGarrett Wollman.\" The default value is 1, which is conformant to US
4720761cb29SGarrett Wollman.\" .Tn GOSIP .
4730761cb29SGarrett Wollman.\" When an ISO address is set in an ifconfig command,
4740761cb29SGarrett Wollman.\" it is really the
4750761cb29SGarrett Wollman.\" .Tn NSAP
4760761cb29SGarrett Wollman.\" which is being specified.
4770761cb29SGarrett Wollman.\" For example, in
4780761cb29SGarrett Wollman.\" .Tn US GOSIP ,
4790761cb29SGarrett Wollman.\" 20 hex digits should be
4800761cb29SGarrett Wollman.\" specified in the
4810761cb29SGarrett Wollman.\" .Tn ISO NSAP
4820761cb29SGarrett Wollman.\" to be assigned to the interface.
4830761cb29SGarrett Wollman.\" There is some evidence that a number different from 1 may be useful
4840761cb29SGarrett Wollman.\" for
4850761cb29SGarrett Wollman.\" .Tn AFI
4860761cb29SGarrett Wollman.\" 37 type addresses.
487b112c02bSBen Smithurst.It Cm range Ar netrange
48891badbbeSJulian ElischerUnder appletalk, set the interface to respond to a
48923dafeacSBen Smithurst.Ar netrange
49023dafeacSBen Smithurstof the form
49123dafeacSBen Smithurst.Ar startnet Ns - Ns Ar endnet .
492ef8f7ac9SSheldon HearnAppletalk uses this scheme instead of
493e333b944SPhilippe Charniernetmasks though
494f050f700SMike Pritchard.Fx
495e333b944SPhilippe Charnierimplements it internally as a set of netmasks.
496d6d1cb48SRobert Watson.It Cm remove
497d0353b83SRuslan ErmilovAnother name for the
498d0353b83SRuslan Ermilov.Fl alias
499d0353b83SRuslan Ermilovparameter.
500d0353b83SRuslan ErmilovIntroduced for compatibility
501b09b4efbSRuslan Ermilovwith
502b09b4efbSRuslan Ermilov.Bsx .
50391badbbeSJulian Elischer.It Cm phase
50491badbbeSJulian ElischerThe argument following this specifies the version (phase) of the
505ef8f7ac9SSheldon HearnAppletalk network attached to the interface.
506ef8f7ac9SSheldon HearnValues of 1 or 2 are permitted.
507b09b4efbSRuslan Ermilov.Sm off
508b09b4efbSRuslan Ermilov.It Cm link Op Cm 0 No - Cm 2
509b09b4efbSRuslan Ermilov.Sm on
5108fae3551SRodney W. GrimesEnable special processing of the link level of the interface.
5118fae3551SRodney W. GrimesThese three options are interface specific in actual effect, however,
512ef8f7ac9SSheldon Hearnthey are in general used to select special modes of operation.
513ef8f7ac9SSheldon HearnAn example
514b5436146SPeter Wemmof this is to enable SLIP compression, or to select the connector type
515b09b4efbSRuslan Ermilovfor some Ethernet cards.
516b09b4efbSRuslan ErmilovRefer to the man page for the specific driver
517b5436146SPeter Wemmfor more information.
518b09b4efbSRuslan Ermilov.Sm off
519b09b4efbSRuslan Ermilov.It Fl link Op Cm 0 No - Cm 2
520b09b4efbSRuslan Ermilov.Sm on
5218fae3551SRodney W. GrimesDisable special processing at the link level with the specified interface.
522afbe3a0fSPoul-Henning Kamp.It Cm monitor
523afbe3a0fSPoul-Henning KampPut the interface in monitor mode.
5243706a3a8SRuslan ErmilovNo packets are transmitted, and received packets are discarded after
525afbe3a0fSPoul-Henning Kamp.Xr bpf 4
526afbe3a0fSPoul-Henning Kampprocessing.
527afbe3a0fSPoul-Henning Kamp.It Fl monitor
528afbe3a0fSPoul-Henning KampTake the interface out of monitor mode.
5298fae3551SRodney W. Grimes.It Cm up
530e333b944SPhilippe CharnierMark an interface
531e333b944SPhilippe Charnier.Dq up .
532e333b944SPhilippe CharnierThis may be used to enable an interface after an
533b09b4efbSRuslan Ermilov.Dq Nm Cm down .
5348fae3551SRodney W. GrimesIt happens automatically when setting the first address on an interface.
5358fae3551SRodney W. GrimesIf the interface was reset when previously marked down,
5368fae3551SRodney W. Grimesthe hardware will be re-initialized.
537419d8080SPoul-Henning Kamp.It Cm ssid Ar ssid
538419d8080SPoul-Henning KampFor IEEE 802.11 wireless interfaces, set the desired Service Set
539b09b4efbSRuslan ErmilovIdentifier (aka network name).
540b09b4efbSRuslan ErmilovThe SSID is a string up to 32 characters
541419d8080SPoul-Henning Kampin length and may be specified as either a normal string or in
542419d8080SPoul-Henning Kamphexadecimal when proceeded by
543b09b4efbSRuslan Ermilov.Ql 0x .
544419d8080SPoul-Henning KampAdditionally, the SSID may be cleared by setting it to
545b09b4efbSRuslan Ermilov.Ql - .
546419d8080SPoul-Henning Kamp.It Cm nwid Ar ssid
547419d8080SPoul-Henning KampAnother name for the
548b09b4efbSRuslan Ermilov.Cm ssid
549b09b4efbSRuslan Ermilovparameter.
550b09b4efbSRuslan ErmilovIncluded for
551b09b4efbSRuslan Ermilov.Nx
552b09b4efbSRuslan Ermilovcompatibility.
553419d8080SPoul-Henning Kamp.It Cm stationname Ar name
554419d8080SPoul-Henning KampFor IEEE 802.11 wireless interfaces, set the name of this station.
555419d8080SPoul-Henning KampIt appears that the station name is not really part of the IEEE 802.11
556b09b4efbSRuslan Ermilovprotocol though all interfaces seem to support it.
557b09b4efbSRuslan ErmilovAs such it only
558419d8080SPoul-Henning Kampseems to be meaningful to identical or virtually identical equipment.
559419d8080SPoul-Henning KampSetting the station name is identical in syntax to setting the SSID.
560419d8080SPoul-Henning Kamp.It Cm station Ar name
561419d8080SPoul-Henning KampAnother name for the
562b09b4efbSRuslan Ermilov.Cm stationname
563b09b4efbSRuslan Ermilovparameter.
564b09b4efbSRuslan ErmilovIncluded for
565b09b4efbSRuslan Ermilov.Bsx
566b09b4efbSRuslan Ermilovcompatibility.
567419d8080SPoul-Henning Kamp.It Cm channel Ar number
568419d8080SPoul-Henning KampFor IEEE 802.11 wireless interfaces, set the desired channel.
569419d8080SPoul-Henning KampChannels range from 1 to 14, but the exact selection available
570b09b4efbSRuslan Ermilovdepends on the region your adaptor was manufactured for.
571b09b4efbSRuslan ErmilovSetting
572b09b4efbSRuslan Ermilovthe channel to 0 will give you the default for your adaptor.
573b09b4efbSRuslan ErmilovMany
574419d8080SPoul-Henning Kampadaptors ignore this setting unless you are in ad-hoc mode.
575419d8080SPoul-Henning Kamp.It Cm authmode Ar mode
576419d8080SPoul-Henning KampFor IEEE 802.11 wireless interfaces, set the desired authentication mode
577b09b4efbSRuslan Ermilovin infrastructure mode.
578b09b4efbSRuslan ErmilovNot all adaptors support all modes.
579b09b4efbSRuslan ErmilovThe set of
580419d8080SPoul-Henning Kampvalid modes is
581419d8080SPoul-Henning Kamp.Dq none ,
582419d8080SPoul-Henning Kamp.Dq open ,
583419d8080SPoul-Henning Kampand
584419d8080SPoul-Henning Kamp.Dq shared .
585419d8080SPoul-Henning KampModes are case insensitive.
586419d8080SPoul-Henning Kamp.It Cm powersave
587419d8080SPoul-Henning KampFor IEEE 802.11 wireless interfaces, enable powersave mode.
588b09b4efbSRuslan Ermilov.It Fl powersave
589419d8080SPoul-Henning KampFor IEEE 802.11 wireless interfaces, disable powersave mode.
590419d8080SPoul-Henning Kamp.It Cm powersavesleep Ar sleep
591419d8080SPoul-Henning KampFor IEEE 802.11 wireless interfaces, set the desired max powersave sleep
592419d8080SPoul-Henning Kamptime in milliseconds.
593419d8080SPoul-Henning Kamp.It Cm wepmode Ar mode
594b09b4efbSRuslan ErmilovFor IEEE 802.11 wireless interfaces, set the desired WEP mode.
595b09b4efbSRuslan ErmilovNot all adaptors support all modes.
596b09b4efbSRuslan ErmilovThe set of valid modes is
597419d8080SPoul-Henning Kamp.Dq off ,
598419d8080SPoul-Henning Kamp.Dq on ,
599419d8080SPoul-Henning Kampand
600419d8080SPoul-Henning Kamp.Dq mixed .
601419d8080SPoul-Henning Kamp.Dq Mixed
602419d8080SPoul-Henning Kampmode explicitly tells the adaptor to allow association with access
603b09b4efbSRuslan Ermilovpoints which allow both encrypted and unencrypted traffic.
604b09b4efbSRuslan ErmilovOn these adaptors,
605419d8080SPoul-Henning Kamp.Dq on
606b09b4efbSRuslan Ermilovmeans that the access point must only allow encrypted connections.
607b09b4efbSRuslan ErmilovOn other adaptors,
608419d8080SPoul-Henning Kamp.Dq on
609419d8080SPoul-Henning Kampis generally another name for
610419d8080SPoul-Henning Kamp.Dq mixed .
611419d8080SPoul-Henning KampModes are case insensitive.
612419d8080SPoul-Henning Kamp.It Cm weptxkey Ar index
613419d8080SPoul-Henning KampFor IEEE 802.11 wireless interfaces, set the WEP key to be used for
614419d8080SPoul-Henning Kamptransmission.
615b09b4efbSRuslan Ermilov.It Cm wepkey Ar key Ns | Ns Ar index : Ns Ar key
616b09b4efbSRuslan ErmilovFor IEEE 802.11 wireless interfaces, set the selected WEP key.
617b09b4efbSRuslan ErmilovIf an
618419d8080SPoul-Henning Kamp.Ar index
619b09b4efbSRuslan Ermilovis not given, key 1 is set.
620b09b4efbSRuslan ErmilovA WEP key will be either 5 or 13
621419d8080SPoul-Henning Kampcharacters (40 or 104 bits) depending of the local network and the
622b09b4efbSRuslan Ermilovcapabilities of the adaptor.
623b09b4efbSRuslan ErmilovIt may be specified either as a plain
624419d8080SPoul-Henning Kampstring or as a string of hexadecimal digits proceeded by
625b09b4efbSRuslan Ermilov.Ql 0x .
626d8f2e345SWarner LoshFor maximum portability, hex keys are recommended;
627d8f2e345SWarner Loshthe mapping of text keys to WEP encryption is usually driver-specific.
6283706a3a8SRuslan ErmilovIn particular, the
6293706a3a8SRuslan Ermilov.Tn Windows
6303706a3a8SRuslan Ermilovdrivers do this mapping differently to
631a61d9c47SRuslan Ermilov.Fx .
632419d8080SPoul-Henning KampA key may be cleared by setting it to
633b09b4efbSRuslan Ermilov.Ql - .
634b09b4efbSRuslan ErmilovIf WEP is supported then there are at least four keys.
635b94231daSDima DorfmanSome adaptors support more than four keys.
636b09b4efbSRuslan ErmilovIf that is the case, then the first four keys
637419d8080SPoul-Henning Kamp(1-4) will be the standard temporary keys and any others will be adaptor
638419d8080SPoul-Henning Kampspecific keys such as permanent keys stored in NVRAM.
639419d8080SPoul-Henning Kamp.It Cm wep
640419d8080SPoul-Henning KampAnother way of saying
641b09b4efbSRuslan Ermilov.Cm wepmode on .
642b09b4efbSRuslan ErmilovIncluded for
643b09b4efbSRuslan Ermilov.Bsx
644b09b4efbSRuslan Ermilovcompatibility.
645b09b4efbSRuslan Ermilov.It Fl wep
646419d8080SPoul-Henning KampAnother way of saying
647b09b4efbSRuslan Ermilov.Cm wepmode off .
648b09b4efbSRuslan ErmilovIncluded for
649b09b4efbSRuslan Ermilov.Bsx
650b09b4efbSRuslan Ermilovcompatibility.
651419d8080SPoul-Henning Kamp.It Cm nwkey key
652419d8080SPoul-Henning KampAnother way of saying:
653419d8080SPoul-Henning Kamp.Pp
654b09b4efbSRuslan Ermilov.Dq Li "wepmode on weptxkey 1 wepkey 1:key wepkey 2:- wepkey 3:- wepkey 4:-" .
655419d8080SPoul-Henning Kamp.Pp
656b09b4efbSRuslan ErmilovIncluded for
657b09b4efbSRuslan Ermilov.Nx
658b09b4efbSRuslan Ermilovcompatibility.
659b09b4efbSRuslan Ermilov.It Cm nwkey Xo
660b09b4efbSRuslan Ermilov.Sm off
661b09b4efbSRuslan Ermilov.Ar n : k1 , k2 , k3 , k4
662b09b4efbSRuslan Ermilov.Sm on
663b09b4efbSRuslan Ermilov.Xc
664419d8080SPoul-Henning KampAnother way of saying
665419d8080SPoul-Henning Kamp.Pp
666b09b4efbSRuslan Ermilov.Dq Li "wepmode on weptxkey n wepkey 1:k1 wepkey 2:k2 wepkey 3:k3 wepkey 4:k4" .
667419d8080SPoul-Henning Kamp.Pp
668b09b4efbSRuslan ErmilovIncluded for
669b09b4efbSRuslan Ermilov.Nx
670b09b4efbSRuslan Ermilovcompatibility.
671b09b4efbSRuslan Ermilov.It Fl nwkey
672419d8080SPoul-Henning KampAnother way of saying
673b09b4efbSRuslan Ermilov.Cm wepmode off .
674419d8080SPoul-Henning Kamp.Pp
675b09b4efbSRuslan ErmilovIncluded for
676b09b4efbSRuslan Ermilov.Nx
677b09b4efbSRuslan Ermilovcompatibility.
6788fae3551SRodney W. Grimes.El
6798fae3551SRodney W. Grimes.Pp
680e1205e80SPhilippe CharnierThe
681e1205e80SPhilippe Charnier.Nm
682e1205e80SPhilippe Charnierutility displays the current configuration for a network interface
6838fae3551SRodney W. Grimeswhen no optional parameters are supplied.
6848fae3551SRodney W. GrimesIf a protocol family is specified,
685e333b944SPhilippe Charnier.Nm
686e333b944SPhilippe Charnierwill report only the details specific to that protocol family.
687b5436146SPeter Wemm.Pp
68841cd75b7SPeter WemmIf the driver does supports the media selection system, the supported
68941cd75b7SPeter Wemmmedia list will be included in the output.
690b5436146SPeter Wemm.Pp
691ca299b1fSPoul-Henning KampIf the
692ca299b1fSPoul-Henning Kamp.Fl m
693b09b4efbSRuslan Ermilovflag is passed before an interface name,
694b09b4efbSRuslan Ermilov.Nm
695b09b4efbSRuslan Ermilovwill display all
696ca299b1fSPoul-Henning Kampof the supported media for the specified interface.
697cfa1ca9dSYoshinobu InoueIf
698cfa1ca9dSYoshinobu Inoue.Fl L
699b112c02bSBen Smithurstflag is supplied, address lifetime is displayed for IPv6 addresses,
700cfa1ca9dSYoshinobu Inoueas time offset string.
701cfa1ca9dSYoshinobu Inoue.Pp
702b5436146SPeter WemmOptionally, the
703b5436146SPeter Wemm.Fl a
704b09b4efbSRuslan Ermilovflag may be used instead of an interface name.
705b09b4efbSRuslan ErmilovThis flag instructs
706b5436146SPeter Wemm.Nm
707b5436146SPeter Wemmto display information about all interfaces in the system.
708e333b944SPhilippe CharnierThe
709b5436146SPeter Wemm.Fl d
710e333b944SPhilippe Charnierflag limits this to interfaces that are down, and
711b5436146SPeter Wemm.Fl u
712b5436146SPeter Wemmlimits this to interfaces that are up.
713abc3361aSArchie CobbsWhen no arguments are given,
714abc3361aSArchie Cobbs.Fl a
715abc3361aSArchie Cobbsis implied.
716b5436146SPeter Wemm.Pp
717b5436146SPeter WemmThe
718b5436146SPeter Wemm.Fl l
719b5436146SPeter Wemmflag may be used to list all available interfaces on the system, with
720b09b4efbSRuslan Ermilovno other additional information.
721b09b4efbSRuslan ErmilovUse of this flag is mutually exclusive
722b5436146SPeter Wemmwith all other flags and commands, except for
723b5436146SPeter Wemm.Fl d
724b5436146SPeter Wemm(only list interfaces that are down)
725b5436146SPeter Wemmand
726b5436146SPeter Wemm.Fl u
727b5436146SPeter Wemm(only list interfaces that are up).
7288fae3551SRodney W. Grimes.Pp
7293e61dca0SBrooks DavisThe
7303e61dca0SBrooks Davis.Fl C
7313e61dca0SBrooks Davisflag may be used to list all of the interface cloners available on
7323e61dca0SBrooks Davisthe system, with no additional information.
7333e61dca0SBrooks DavisUse of this flag is mutually exclusive with all other flags and commands.
7343e61dca0SBrooks Davis.Pp
7358fae3551SRodney W. GrimesOnly the super-user may modify the configuration of a network interface.
736920de530SPeter Wemm.Sh NOTES
737920de530SPeter WemmThe media selection system is relatively new and only some drivers support
738920de530SPeter Wemmit (or have need for it).
7398fae3551SRodney W. Grimes.Sh DIAGNOSTICS
74020d3783aSDaniel O'CallaghanMessages indicating the specified interface does not exist, the
7418fae3551SRodney W. Grimesrequested address is unknown, or the user is not privileged and
7428fae3551SRodney W. Grimestried to alter an interface's configuration.
743cfa1ca9dSYoshinobu Inoue.Sh BUGS
744cfa1ca9dSYoshinobu InoueIPv6 link-local addresses are required for several basic communication
745ef8f7ac9SSheldon Hearnbetween IPv6 node.
746ef8f7ac9SSheldon HearnIf they are deleted by
7477c7fb079SRuslan Ermilov.Nm
748cfa1ca9dSYoshinobu Inouemanually, the kernel might show very strange behavior.
749dfed87fcSBill FumerolaSo, such manual deletions are strongly discouraged.
7508fae3551SRodney W. Grimes.Sh SEE ALSO
7518fae3551SRodney W. Grimes.Xr netstat 1 ,
7528fae3551SRodney W. Grimes.Xr netintro 4 ,
753b09b4efbSRuslan Ermilov.\" .Xr eon 5 ,
7548fae3551SRodney W. Grimes.Xr rc 8 ,
755af202156SWolfram Schneider.Xr routed 8
7568fae3551SRodney W. Grimes.Sh HISTORY
7578fae3551SRodney W. GrimesThe
7588fae3551SRodney W. Grimes.Nm
759e1205e80SPhilippe Charnierutility appeared in
7608fae3551SRodney W. Grimes.Bx 4.2 .
761