| ifconfig.8 (227479) | ifconfig.8 (228571) |
|---|---|
| 1.\" Copyright (c) 1983, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 12 unchanged lines hidden (view full) --- 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" 28.\" From: @(#)ifconfig.8 8.3 (Berkeley) 1/5/94 | 1.\" Copyright (c) 1983, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 12 unchanged lines hidden (view full) --- 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" 28.\" From: @(#)ifconfig.8 8.3 (Berkeley) 1/5/94 |
| 29.\" $FreeBSD: head/sbin/ifconfig/ifconfig.8 227479 2011-11-12 23:30:57Z adrian $ | 29.\" $FreeBSD: head/sbin/ifconfig/ifconfig.8 228571 2011-12-16 12:16:56Z glebius $ |
| 30.\" | 30.\" |
| 31.Dd November 12, 2011 | 31.Dd December 16, 2011 |
| 32.Dt IFCONFIG 8 33.Os 34.Sh NAME 35.Nm ifconfig 36.Nd configure network interface parameters 37.Sh SYNOPSIS 38.Nm 39.Op Fl L --- 2400 unchanged lines hidden (view full) --- 2440.Xr vlan 4 2441interface and its parent, 2442clears its VLAN tag, flags and its link address and shuts the interface down. 2443The 2444.Ar iface 2445argument is useless and hence deprecated. 2446.El 2447.Pp | 32.Dt IFCONFIG 8 33.Os 34.Sh NAME 35.Nm ifconfig 36.Nd configure network interface parameters 37.Sh SYNOPSIS 38.Nm 39.Op Fl L --- 2400 unchanged lines hidden (view full) --- 2440.Xr vlan 4 2441interface and its parent, 2442clears its VLAN tag, flags and its link address and shuts the interface down. 2443The 2444.Ar iface 2445argument is useless and hence deprecated. 2446.El 2447.Pp |
| 2448The following parameters are specific to | 2448The following parameters are used to configure |
| 2449.Xr carp 4 | 2449.Xr carp 4 |
| 2450interfaces: | 2450protocol on an interface: |
| 2451.Bl -tag -width indent | 2451.Bl -tag -width indent |
| 2452.It Cm vhid Ar n 2453Set the virtual host ID. 2454This is a required setting to initiate 2455.Xr carp 4 . 2456If the virtual host ID doesn't exist yet, it is created and attached to the 2457interface, otherwise configuration of an existing vhid is adjusted. 2458If the 2459.Cm vhid 2460keyword is supplied along with an 2461.Dq inet6 2462or 2463.Dq inet 2464address, then this address is configured to be run under control of the 2465specified vhid. 2466Whenever a last address that refers to a particular vhid is removed from an 2467interface, the vhid is automatically removed from interface and destroyed. 2468Any other configuration parameters for the 2469.Xr carp 4 2470protocol should be supplied along with the 2471.Cm vhid 2472keyword. 2473Acceptable values for vhid are 1 to 255. |
|
| 2452.It Cm advbase Ar seconds 2453Specifies the base of the advertisement interval in seconds. 2454The acceptable values are 1 to 255. 2455The default value is 1. | 2474.It Cm advbase Ar seconds 2475Specifies the base of the advertisement interval in seconds. 2476The acceptable values are 1 to 255. 2477The default value is 1. |
| 2456.\" The default value is 2457.\" .Dv CARP_DFLTINTV . | |
| 2458.It Cm advskew Ar interval 2459Specifies the skew to add to the base advertisement interval to 2460make one host advertise slower than another host. 2461It is specified in 1/256 of seconds. 2462The acceptable values are 1 to 254. 2463The default value is 0. 2464.It Cm pass Ar phrase 2465Set the authentication key to 2466.Ar phrase . | 2478.It Cm advskew Ar interval 2479Specifies the skew to add to the base advertisement interval to 2480make one host advertise slower than another host. 2481It is specified in 1/256 of seconds. 2482The acceptable values are 1 to 254. 2483The default value is 0. 2484.It Cm pass Ar phrase 2485Set the authentication key to 2486.Ar phrase . |
| 2467.It Cm vhid Ar n 2468Set the virtual host ID. 2469This is a required setting. 2470Acceptable values are 1 to 255. | 2487.It Cm state Ar MASTER|BACKUP 2488Forcibly change state of a given vhid. |
| 2471.El 2472.Pp 2473The 2474.Nm 2475utility displays the current configuration for a network interface 2476when no optional parameters are supplied. 2477If a protocol family is specified, 2478.Nm --- 46 unchanged lines hidden (view full) --- 2525flag may be used to list all of the interface cloners available on 2526the system, with no additional information. 2527Use of this flag is mutually exclusive with all other flags and commands. 2528.Pp 2529The 2530.Fl k 2531flag causes keying information for the interface, if available, to be 2532printed. | 2489.El 2490.Pp 2491The 2492.Nm 2493utility displays the current configuration for a network interface 2494when no optional parameters are supplied. 2495If a protocol family is specified, 2496.Nm --- 46 unchanged lines hidden (view full) --- 2543flag may be used to list all of the interface cloners available on 2544the system, with no additional information. 2545Use of this flag is mutually exclusive with all other flags and commands. 2546.Pp 2547The 2548.Fl k 2549flag causes keying information for the interface, if available, to be 2550printed. |
| 2533For example, the values of 802.11 WEP keys will be printed, if accessible to 2534the current user. | 2551For example, the values of 802.11 WEP keys and 2552.Xr carp 4 2553passphrases will be printed, if accessible to the current user. |
| 2535This information is not printed by default, as it may be considered 2536sensitive. 2537.Pp 2538If the network interface driver is not present in the kernel then 2539.Nm 2540will attempt to load it. 2541The 2542.Fl n --- 45 unchanged lines hidden (view full) --- 2588.Li / 2589character as shorthand for the network prefix, 2590and using 2591.Cm delete 2592as a synonym for the canonical form of the option 2593.Fl alias : 2594.Dl # ifconfig em0 inet6 2001:db8:bdbd::123/48 delete 2595.Pp | 2554This information is not printed by default, as it may be considered 2555sensitive. 2556.Pp 2557If the network interface driver is not present in the kernel then 2558.Nm 2559will attempt to load it. 2560The 2561.Fl n --- 45 unchanged lines hidden (view full) --- 2607.Li / 2608character as shorthand for the network prefix, 2609and using 2610.Cm delete 2611as a synonym for the canonical form of the option 2612.Fl alias : 2613.Dl # ifconfig em0 inet6 2001:db8:bdbd::123/48 delete 2614.Pp |
| 2615Configure a single CARP redundant address on igb0, and then switch it 2616to be master: 2617.Dl # ifconfig igb0 vhid 1 10.0.0.1/24 pass foobar 2618.Dl # ifconfig igb0 vhid 1 state master 2619.Pp |
|
| 2596Configure the interface 2597.Li xl0 , 2598to use 100baseTX, full duplex Ethernet media options: 2599.Dl # ifconfig xl0 media 100baseTX mediaopt full-duplex 2600.Pp 2601Label the em0 interface as an uplink: 2602.Dl # ifconfig em0 description \&"Uplink to Gigabit Switch 2\&" 2603.Pp --- 47 unchanged lines hidden --- | 2620Configure the interface 2621.Li xl0 , 2622to use 100baseTX, full duplex Ethernet media options: 2623.Dl # ifconfig xl0 media 100baseTX mediaopt full-duplex 2624.Pp 2625Label the em0 interface as an uplink: 2626.Dl # ifconfig em0 description \&"Uplink to Gigabit Switch 2\&" 2627.Pp --- 47 unchanged lines hidden --- |