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