1 .\" Copyright (c) 2013 Apple Inc. All rights reserved.
3 .\" @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5 .\" This file contains Original Code and/or Modifications of Original Code
6 .\" as defined in and that are subject to the Apple Public Source License
7 .\" Version 2.0 (the 'License'). You may not use this file except in
8 .\" compliance with the License. The rights granted to you under the License
9 .\" may not be used to create, or enable the creation or redistribution of,
10 .\" unlawful or unlicensed copies of an Apple operating system, or to
11 .\" circumvent, violate, or enable the circumvention or violation of, any
12 .\" terms of an Apple operating system software license agreement.
14 .\" Please obtain a copy of the License at
15 .\" http://www.opensource.apple.com/apsl/ and read it before using this file.
17 .\" The Original Code and all software distributed under the License are
18 .\" distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
19 .\" EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
20 .\" INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
21 .\" FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
22 .\" Please see the License for the specific language governing rights and
23 .\" limitations under the License.
25 .\" @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27 .\" Copyright (c) 1983, 1991, 1993
28 .\" The Regents of the University of California. All rights reserved.
30 .\" Redistribution and use in source and binary forms, with or without
31 .\" modification, are permitted provided that the following conditions
33 .\" 1. Redistributions of source code must retain the above copyright
34 .\" notice, this list of conditions and the following disclaimer.
35 .\" 2. Redistributions in binary form must reproduce the above copyright
36 .\" notice, this list of conditions and the following disclaimer in the
37 .\" documentation and/or other materials provided with the distribution.
38 .\" 4. Neither the name of the University nor the names of its contributors
39 .\" may be used to endorse or promote products derived from this software
40 .\" without specific prior written permission.
42 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
43 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
44 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
45 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
46 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
47 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
48 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
49 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
50 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
51 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
54 .\" From: @(#)ifconfig.8 8.3 (Berkeley) 1/5/94
55 .\" $FreeBSD: src/sbin/ifconfig/ifconfig.8,v 1.142.2.6.2.1 2008/11/25 02:59:29 kensmith Exp $
62 .Nd configure network interface parameters
126 utility is used to assign an address
127 to a network interface and/or configure
128 network interface parameters.
130 The following options are available:
131 .Bl -tag -width indent
134 .Tn DARPA Ns -Internet
136 the address is either a host name present in the host name data
141 Internet address expressed in the Internet standard
144 It is also possible to use the CIDR notation (also known as the
145 slash notation) to include the netmask.
146 That is, one can specify an address like
151 family, it is also possible to specify the prefix length using the slash
156 parameter below for more information.
157 .\" For the Xerox Network Systems(tm) family,
159 .\" .Ar net:a.b.c.d.e.f ,
162 .\" is the assigned network number (in decimal),
163 .\" and each of the six bytes of the host number,
167 .\" are specified in hexadecimal.
168 .\" The host number may be omitted on IEEE 802 protocol
169 .\" (Ethernet, FDDI, and Token Ring) interfaces,
170 .\" which use the hardware physical address,
171 .\" and on interfaces other than the first.
174 .\" family, addresses are specified as a long hexadecimal string,
175 .\" as in the Xerox family.
176 .\" However, two consecutive dots imply a zero
177 .\" byte, and the dots are optional, if the user wishes to (carefully)
178 .\" count out long strings of digits in network byte order.
183 is specified as a series of colon-separated hex digits.
185 e.g.\& set a new MAC address on an ethernet interface, though the
186 mechanism used is not ethernet-specific.
187 If the interface is already
188 up when this option is used, it will be briefly brought down and
189 then brought back up again in order to ensure that the receive
190 filter in the underlying ethernet hardware is properly reprogrammed.
191 .It Ar address_family
194 which affects interpretation of the remaining parameters.
195 Since an interface can receive transmissions in differing protocols
196 with different naming schemes, specifying the address family is recommended.
197 The address or protocol families currently
216 Specify the address of the correspondent on the other end
217 of a point to point link.
220 parameter is a string of the form
226 The following parameters may be set with
228 .Bl -tag -width indent
233 Introduced for compatibility
237 Establish an additional network address for this interface.
238 This is sometimes useful when changing network numbers, and
239 one wishes to accept packets addressed to the old interface.
240 If the address is on the same subnet as the first network address
241 for this interface, a non-conflicting netmask must be given.
246 Remove the network address specified.
247 This would be used if you incorrectly specified an alias, or it
248 was no longer needed.
249 If you have incorrectly set an NS address having the side effect
250 of specifying the host portion, removing all NS addresses will
251 allow you to respecify the host portion.
254 Specify that the address configured is an anycast address.
255 Based on the current specification,
256 only routers may configure anycast addresses.
257 Anycast address will not be used as source address of any of outgoing
260 Enable the use of the Address Resolution Protocol
263 between network level addresses and link level addresses (default).
264 This is currently implemented for mapping between
269 802 48-bit MAC addresses (Ethernet, FDDI, and Token Ring addresses).
271 Disable the use of the Address Resolution Protocol
275 Specify the address to use to represent broadcasts to the
277 The default broadcast address is the address with a host part of all 1's.
279 Enable driver dependent debugging code; usually, this turns on
280 extra console error logging.
282 Disable driver dependent debugging code.
290 When an interface is marked
292 the system will not attempt to
293 transmit messages through that interface.
294 If possible, the interface will be reset to disable reception as well.
300 .\" This is used to specify an Internet host who is willing to receive
301 .\" ip packets encapsulating NS packets bound for a remote network.
302 .\" An apparent point to point link is constructed, and
303 .\" the address specified will be taken as the NS address and network
304 .\" of the destination.
305 .\" IP encapsulation of
307 .\" packets is done differently.
308 .It Cm lladdr Ar addr
309 Set the link-level address on an interface.
311 e.g. set a new MAC address on an ethernet interface, though the
312 mechanism used is not ethernet-specific.
315 is specified as a series of colon-separated hex digits.
316 If the interface is already
317 up when this option is used, it will be briefly brought down and
318 then brought back up again in order to ensure that the receive
319 filter in the underlying ethernet hardware is properly reprogrammed.
321 If the driver supports the media selection system, set the media type
324 Some interfaces support the mutually exclusive use of one of several
325 different physical media connectors.
326 For example, a 10Mbit/s Ethernet
327 interface might support the use of either
329 or twisted pair connectors.
330 Setting the media type to
332 would change the currently active connector to the AUI port.
335 would activate twisted pair.
336 Refer to the interfaces' driver
337 specific documentation or man page for a complete list of the
339 .It Cm mediaopt Ar opts
340 If the driver supports the media selection system, set the specified
341 media options on the interface.
345 is a comma delimited list of options to apply to the interface.
346 Refer to the interfaces' driver specific man page for a complete
347 list of available options.
348 .It Fl mediaopt Ar opts
349 If the driver supports the media selection system, disable the
350 specified media options on the interface.
351 .It Cm rxcsum , txcsum
352 If the driver supports user-configurable checksum offloading,
353 enable receive (or transmit) checksum offloading on the interface.
354 Some drivers may not be able to enable these flags independently
355 of each other, so setting one may also set the other.
356 The driver will offload as much checksum work as it can reliably
357 support, the exact level of offloading varies between drivers.
358 .It Fl rxcsum , txcsum
359 If the driver supports user-configurable checksum offloading,
360 disable receive (or transmit) checksum offloading on the interface.
361 These settings may not always be independent of each other.
363 If the driver supports
365 segmentation offloading, enable TSO on the interface.
366 Some drivers may not be able to support TSO for
370 packets, so they may enable only one of them.
372 If the driver supports
374 segmentation offloading, disable TSO on the interface.
375 It will always disable TSO for
380 If the driver supports
382 large receive offloading, enable LRO on the interface.
384 If the driver supports
386 large receive offloading, disable LRO on the interface.
388 If supported by the driver, enable 802.1 AVB on the interface.
390 If supported by the driver, disable 802.1 AVB on the interface.
391 .It Cm vlanmtu , vlanhwtag
392 If the driver offers user-configurable VLAN support, enable
393 reception of extended frames or tag processing in hardware,
395 Note that this must be issued on a physical interface associated with
400 .It Fl vlanmtu , vlanhwtag
401 If the driver offers user-configurable VLAN support, disable
402 reception of extended frames or tag processing in hardware,
405 Create the specified network pseudo-device.
406 If the interface is given without a unit number, try to create a new
407 device with an arbitrary unit number.
408 If creation of an arbitrary device is successful, the new device name is
409 printed to standard output unless the interface is renamed or destroyed
414 Destroy the specified network pseudo-device.
430 Set the routing metric of the interface to
433 The routing metric is used by the routing protocol
435 Higher metrics have the effect of making a route
436 less favorable; metrics are counted as additional hops
437 to the destination network or host.
439 Set the maximum transmission unit of the interface to
441 default is interface specific.
442 The MTU is used to limit the size of packets that are transmitted on an
444 Not all interfaces support setting the MTU, and some interfaces have
446 .It Cm netmask Ar mask
449 Specify how much of the address to reserve for subdividing
450 networks into sub-networks.
451 The mask includes the network part of the local address
452 and the subnet part, which is taken from the host field of the address.
453 The mask can be specified as a single hexadecimal number
456 with a dot-notation Internet address,
457 or with a pseudo-network name listed in the network table
459 The mask contains 1's for the bit positions in the 32-bit address
460 which are to be used for the network and subnet parts,
461 and 0's for the host part.
462 The mask should contain at least the standard network portion,
463 and the subnet field should be contiguous with the network
466 The netmask can also be specified in CIDR notation after the address.
469 option above for more information.
470 .It Cm prefixlen Ar len
474 bits are reserved for subdividing networks into sub-networks.
477 must be integer, and for syntactical reason it must be between 0 to 128.
478 It is almost always 64 under the current IPv6 assignment rule.
479 If the parameter is omitted, 64 is used.
481 The prefix can also be specified using the slash notation after the address.
484 option above for more information.
487 .\" .It Cm nsellength Ar n
490 .\" This specifies a trailing number of bytes for a received
492 .\" used for local identification, the remaining leading part of which is
495 .\" (Network Entity Title).
496 .\" The default value is 1, which is conformant to US
498 .\" When an ISO address is set in an ifconfig command,
501 .\" which is being specified.
504 .\" 20 hex digits should be
507 .\" to be assigned to the interface.
508 .\" There is some evidence that a number different from 1 may be useful
511 .\" 37 type addresses.
516 Introduced for compatibility
520 .It Cm link Op Cm 0 No - Cm 2
522 Enable special processing of the link level of the interface.
523 These three options are interface specific in actual effect, however,
524 they are in general used to select special modes of operation.
526 of this is to enable SLIP compression, or to select the connector type
527 for some Ethernet cards.
528 Refer to the man page for the specific driver
529 for more information.
531 .It Fl link Op Cm 0 No - Cm 2
533 Disable special processing at the link level with the specified interface.
537 This may be used to enable an interface after an
539 It happens automatically when setting the first address on an interface.
540 If the interface was reset when previously marked down,
541 the hardware will be re-initialized.
544 The following parameters are for ICMPv6 Neighbor Discovery Protocol.
545 Note that the address family keyword
548 .Bl -tag -width indent
550 Perform network unreachability detection (NUD).
552 Do not perform network unreachability detection (NUD).
554 Disable all IPv6 communication on the interface.
556 Do not disable all IPv6 communication on the interface.
558 Disable the processing of Secure Neighbor Discovery (SEND).
560 Do not disabled the processing of Secure Neighbor Discovery (SEND).
562 Perform duplicate address detection (DAD).
564 Do not perform duplicate address detection (DAD).
566 Modify duplicate address detection (DAD) protocol to expect that interface
567 configuration is replicated at a network sleep proxy. Ignores certain NA
568 messages and disables optimistic DAD.
570 Do not use modified duplicated address detection (DAD) protocol.
573 The following parameters are specific to link aggregate interfaces:
574 .Bl -tag -width indent
575 .It Cm bonddev Ar iface
576 If the interface is a bond pseudo device, associate physical interface
578 with it. By default, the bond pseudo device is in LACP
579 (Link Aggregation Control Protocol) mode (see \fBbondmode\fR below). In
580 this mode, the device conforms to the IEEE 802.3ad Link Aggregation
583 If this is the first physical interface to be associated with the bond
584 interface, the bond interface inherits the ethernet address from the
585 physical interface. Physical interfaces that are added to the bond have
586 their ethernet address re-programmed so that all members of the bond have
587 the same ethernet address. If the physical interface is subsequently
588 removed from the bond using
590 a new ethernet address is chosen from the remaining interfaces, and all
591 interfaces are re-programmed again with the new ethernet address. If no
592 remaining interfaces exist, the bond interface's ethernet address is cleared.
594 If the specified physical interface
596 is not capable of having its ethernet address re-programmed, the
600 Once the physical interface
602 is successfully associated with the bond interface, all received packets
603 are diverted to the bond interface. The physical interface is no longer
604 useable on its own, and remains that way until it is removed from the bond using
607 It is possible that the specified interface
609 is not capable of aggregating, and may remain unused until the operating
612 The link status of the bond interface depends on the state of link aggregation.
613 If no active partner is detected, the link status will remain inactive.
615 To monitor the 802.3ad Link Aggregation state, use the
619 A physical interface that is associated with a vlan pseudo device cannot
620 at the same time be associated with a bond pseudo device. A physical interface
621 cannot be associated with more than one bond pseudo device at the same time.
623 It is not possible to associate a bond with pseudo interfaces such as vlan.
624 Only physical ethernet interfaces may be associated with a bond.
625 .It Fl bonddev Ar iface
626 If the interface is a bond pseudo device, disassociate the physical interface
628 from it. Before the interface is removed from the bond, the bond device
629 announces to the link partner that the interface is now individual and
630 no longer aggregatable.
633 is the last interface in the bond, the bond interface clears its link address.
634 .It Cm bondmode Ar lacp | static
635 If the interface is a bond pseudo device, this option will set the \fImode\fR
636 on the bond interface. The two currently supported modes are
643 To enable static mode (and turn off LACP), specify
645 In static mode, a member interface is made an active part of the
646 link aggregate as long as the link status is active.
648 To re-enable LACP mode, specify
652 The following parameters are specific to IP tunnel interfaces,
654 .Bl -tag -width indent
655 .It Cm tunnel Ar src_addr dest_addr
656 Configure the physical source and destination address for IP tunnel
662 are interpreted as the outer source/destination for the encapsulating
665 Unconfigure the physical source and destination address for IP tunnel
666 interfaces previously configured with
674 The following parameters are specific to bridge interfaces:
675 .Bl -tag -width indent
676 .It Cm addm Ar interface
677 Add the interface named by
679 as a member of the bridge.
680 The interface is put into promiscuous mode
681 so that it can receive every packet sent on the network.
682 .It Cm deletem Ar interface
683 Remove the interface named by
686 Promiscuous mode is disabled on the interface when
687 it is removed from the bridge.
688 .It Cm maxaddr Ar size
689 Set the size of the bridge address cache to
691 The default is 100 entries.
692 .It Cm timeout Ar seconds
693 Set the timeout of address cache entries to
698 is zero, then address cache entries will not be expired.
699 The default is 240 seconds.
701 Display the addresses that have been learned by the bridge.
702 .It Cm static Ar interface-name Ar address
703 Add a static entry into the address cache pointing to
705 Static entries are never aged out of the cache or re-placed, even if the
706 address is seen on a different interface.
707 .It Cm deladdr Ar address
710 from the address cache.
712 Delete all dynamically-learned addresses from the address cache.
714 Delete all addresses, including static addresses, from the address cache.
715 .It Cm discover Ar interface
716 Mark an interface as a
719 When the bridge has no address cache entry
720 (either dynamic or static)
721 for the destination address of a packet,
722 the bridge will forward the packet to all
723 member interfaces marked as
725 This is the default for all interfaces added to a bridge.
726 .It Cm -discover Ar interface
729 attribute on a member interface.
730 For packets without the
732 attribute, the only packets forwarded on the interface are broadcast
733 or multicast packets and packets for which the destination address
734 is known to be on the interface's segment.
735 .It Cm learn Ar interface
736 Mark an interface as a
739 When a packet arrives on such an interface, the source
740 address of the packet is entered into the address cache as being a
741 destination address on the interface's segment.
742 This is the default for all interfaces added to a bridge.
743 .It Cm -learn Ar interface
746 attribute on a member interface.
747 .\".It Cm sticky Ar interface
748 .\"Mark an interface as a
751 .\"Dynamically learned address entries are treated at static once entered into
753 .\"Sticky entries are never aged out of the cache or replaced, even if the
754 .\"address is seen on a different interface.
755 .\".It Cm -sticky Ar interface
758 .\"attribute on a member interface.
759 .\".It Cm private Ar interface
760 .\"Mark an interface as a
763 .\"A private interface does not forward any traffic to any other port that is also
764 .\"a private interface.
765 .\".It Cm -private Ar interface
768 .\"attribute on a member interface.
769 .\".It Cm span Ar interface
770 .\"Add the interface named by
772 .\"as a span port on the bridge.
773 .\"Span ports transmit a copy of every frame received by the bridge.
774 .\"This is most useful for snooping a bridged network passively on
775 .\"another host connected to one of the span ports of the bridge.
776 .\".It Cm -span Ar interface
777 .\"Delete the interface named by
779 .\"from the list of span ports of the bridge.
780 .It Cm stp Ar interface
781 Enable Spanning Tree protocol on
785 driver has support for the IEEE 802.1D Spanning Tree protocol (STP).
786 Spanning Tree is used to detect and remove loops in a network topology.
787 .It Cm -stp Ar interface
788 Disable Spanning Tree protocol on
790 This is the default for all interfaces added to a bridge.
791 .\".It Cm edge Ar interface
795 .\"An edge port connects directly to end stations cannot create bridging
796 .\"loops in the network, this allows it to transition straight to forwarding.
797 .\".It Cm -edge Ar interface
798 .\"Disable edge status on
800 .\".It Cm autoedge Ar interface
803 .\"to automatically detect edge status.
804 .\"This is the default for all interfaces added to a bridge.
805 .\".It Cm -autoedge Ar interface
806 .\"Disable automatic edge status on
808 .\".It Cm ptp Ar interface
811 .\"as a point to point link.
812 .\"This is required for straight transitions to forwarding and
813 .\"should be enabled on a direct link to another RSTP capable switch.
814 .\".It Cm -ptp Ar interface
815 .\"Disable point to point link status on
817 .\"This should be disabled for a half duplex link and for an interface
818 .\"connected to a shared network segment,
819 .\"like a hub or a wireless network.
820 .\".It Cm autoptp Ar interface
821 .\"Automatically detect the point to point status on
823 .\"by checking the full duplex link status.
824 .\"This is the default for interfaces added to the bridge.
825 .\".It Cm -autoptp Ar interface
826 .\"Disable automatic point to point link detection on
828 .It Cm maxage Ar seconds
829 Set the time that a Spanning Tree protocol configuration is valid.
830 The default is 20 seconds.
831 The minimum is 6 seconds and the maximum is 40 seconds.
832 .It Cm fwddelay Ar seconds
833 Set the time that must pass before an interface begins forwarding
834 packets when Spanning Tree is enabled.
835 The default is 15 seconds.
836 The minimum is 4 seconds and the maximum is 30 seconds.
837 .It Cm hellotime Ar seconds
838 Set the time between broadcasting of Spanning Tree protocol
839 configuration messages.
840 The hello time may only be changed when operating in legacy stp mode.
841 The default is 2 seconds.
842 The minimum is 1 second and the maximum is 2 seconds.
843 .It Cm priority Ar value
844 Set the bridge priority for Spanning Tree.
845 The default is 32768.
846 The minimum is 0 and the maximum is 61440.
847 .\".It Cm proto Ar value
848 .\"Set the Spanning Tree protocol.
849 .\"The default is rstp.
850 .\"The available options are stp and rstp.
851 .\".It Cm holdcnt Ar value
852 .\"Set the transmit hold count for Spanning Tree.
853 .\"This is the number of packets transmitted before being rate limited.
855 .\"The minimum is 1 and the maximum is 10.
856 .It Cm ifpriority Ar interface Ar value
857 Set the Spanning Tree priority of
862 The minimum is 0 and the maximum is 240.
863 .It Cm ifpathcost Ar interface Ar value
864 Set the Spanning Tree path cost of
868 The default is calculated from the link speed.
869 To change a previously selected path cost back to automatic, set the
871 The minimum is 1 and the maximum is 200000000.
872 .It Cm ifmaxaddr Ar interface Ar size
873 Set the maximum number of hosts allowed from an interface, packets with unknown
874 source addresses are dropped until an existing host cache entry expires or is
877 .It Cm hostfilter Ar interface Ar address
878 Configure the bridge to accept incoming packet on the interface
879 only if they match the given MAC address and IP address
880 -- use the command twice to set both type of addresses.
881 Other filtering restrictions apply.
882 .It Cm -hostfilter Ar interface
883 Allow traffic from any host on that interface.
886 The following parameters are specific to vlan interfaces:
887 .Bl -tag -width indent
888 .It Cm vlan Ar vlan_tag
889 Set the VLAN tag value to
891 This value is a 16-bit number which is used to create an 802.1Q
892 VLAN header for packets sent from the
899 must both be set at the same time.
900 .It Cm vlandev Ar iface
901 Associate the physical interface
906 Packets transmitted through the
909 diverted to the specified physical interface
911 with 802.1Q VLAN encapsulation.
912 Packets with 802.1Q encapsulation received
913 by the parent interface with the correct VLAN tag will be diverted to
919 interface is assigned a
920 copy of the parent interface's flags and the parent's ethernet address.
925 must both be set at the same time.
928 interface already has
929 a physical interface associated with it, this command will fail.
931 change the association to another physical interface, the existing
932 association must be cleared first.
934 Note: if the hardware tagging capability
935 is set on the parent interface, the
938 interface's behavior changes:
941 interface recognizes that the
942 parent interface supports insertion and extraction of VLAN tags on its
943 own (usually in firmware) and that it should pass packets to and from
944 the parent unaltered.
945 .It Fl vlandev Op Ar iface
948 pseudo device, disassociate the parent interface from it.
949 This breaks the link between the
951 interface and its parent,
952 clears its VLAN tag, flags and its link address and shuts the interface down.
955 argument is useless and hence deprecated.
960 utility displays the current configuration for a network interface
961 when no optional parameters are supplied.
962 If a protocol family is specified,
964 will report only the details specific to that protocol family.
968 flag is passed before an interface name,
970 will display the capability list and all
971 of the supported media for the specified interface.
975 flag is supplied, address lifetime is displayed for IPv6 addresses,
976 as time offset string.
980 flag may be used instead of an interface name.
983 to display information about all interfaces in the system.
986 flag limits this to interfaces that are down, and
988 limits this to interfaces that are up.
989 When no arguments are given,
995 flag may be used to list all available interfaces on the system, with
996 no other additional information.
997 Use of this flag is mutually exclusive
998 with all other flags and commands, except for
1000 (only list interfaces that are down)
1003 (only list interfaces that are up).
1007 flag may be used to get more verbose status for an interface.
1011 flag may be used to list all of the interface cloners available on
1012 the system, with no additional information.
1013 Use of this flag is mutually exclusive with all other flags and commands.
1017 flag may be used to show additional information related to the count of route references on the network interface.
1019 For bridge interfaces, the list of addresses learned by the bridge is not shown when displaying information about
1020 all interfaces except when the
1024 Only the super-user may modify the configuration of a network interface.
1026 The media selection system is relatively new and only some drivers support
1027 it (or have need for it).
1029 Assign the IPv4 address
1031 with a network mask of
1035 .Dl # ifconfig en0 inet 192.0.2.10 netmask 255.255.255.0
1037 Add the IPv4 address
1039 with the CIDR network prefix
1045 as a synonym for the canonical form of the option
1047 .Dl # ifconfig en0 inet 192.0.2.45/28 add
1049 Remove the IPv4 address
1053 .Dl # ifconfig en0 inet 192.0.2.45 -alias
1055 Add the IPv6 address
1056 .Li 2001:DB8:DBDB::123/48
1059 .Dl # ifconfig en0 inet6 2001:db8:bdbd::123 prefixlen 48 alias
1060 Note that lower case hexadecimal IPv6 addresses are acceptable.
1062 Remove the IPv6 address added in the above example,
1065 character as shorthand for the network prefix,
1068 as a synonym for the canonical form of the option
1070 .Dl # ifconfig en0 inet6 2001:db8:bdbd::123/48 delete
1072 Configure the interface
1074 to use 100baseTX, full duplex Ethernet media options:
1075 .Dl # ifconfig en1 media 100baseTX mediaopt full-duplex
1077 Create the software network interface
1079 .Dl # ifconfig gif1 create
1081 Destroy the software network interface
1083 .Dl # ifconfig gif1 destroy
1085 Messages indicating the specified interface does not exist, the
1086 requested address is unknown, or the user is not privileged and
1087 tried to alter an interface's configuration.
1098 Basic IPv6 node operation requires a link-local address on each
1099 interface configured for IPv6.
1100 Normally, such an address is automatically configured by the
1101 kernel on each interface added to the system; this behaviour may
1102 be disabled by setting the sysctl MIB variable
1103 .Va net.inet6.ip6.auto_linklocal
1106 If you delete such an address using
1108 the kernel may act very odd.
1109 Do this at your own risk.
projects / apple / network_cmds.git / blob