| ifconfig.8 (232638) | ifconfig.8 (233648) |
|---|---|
| 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 232638 2012-03-07 06:25:17Z thompsa $ | 29.\" $FreeBSD: head/sbin/ifconfig/ifconfig.8 233648 2012-03-29 05:02:12Z eadler $ |
| 30.\" 31.Dd March 7, 2012 32.Dt IFCONFIG 8 33.Os 34.Sh NAME 35.Nm ifconfig 36.Nd configure network interface parameters 37.Sh SYNOPSIS --- 632 unchanged lines hidden (view full) --- 670Set a flag to disable all of IPv6 network communications on the 671specified interface. Note that if there are already configured IPv6 672addresses on that interface, all of them are marked as 673.Dq tentative 674and DAD will be performed when this flag is cleared. 675.It Cm -ifdisabled 676Clear a flag 677.Cm ifdisabled . | 30.\" 31.Dd March 7, 2012 32.Dt IFCONFIG 8 33.Os 34.Sh NAME 35.Nm ifconfig 36.Nd configure network interface parameters 37.Sh SYNOPSIS --- 632 unchanged lines hidden (view full) --- 670Set a flag to disable all of IPv6 network communications on the 671specified interface. Note that if there are already configured IPv6 672addresses on that interface, all of them are marked as 673.Dq tentative 674and DAD will be performed when this flag is cleared. 675.It Cm -ifdisabled 676Clear a flag 677.Cm ifdisabled . |
| 678When this flag is cleared and | 678When this flag is cleared and |
| 679.Cm auto_linklocal 680flag is enabled, automatic configuration of a link-local address is 681performed. 682.It Cm nud 683Set a flag to enable Neighbor Unreachability Detection. 684.It Cm -nud 685Clear a flag 686.Cm nud . --- 14 unchanged lines hidden (view full) --- 701Use 702.Ar device 703as the parent for the cloned device. 704.It Cm wlanmode Ar mode 705Specify the operating mode for this cloned device. 706.Ar mode 707is one of 708.Cm sta , | 679.Cm auto_linklocal 680flag is enabled, automatic configuration of a link-local address is 681performed. 682.It Cm nud 683Set a flag to enable Neighbor Unreachability Detection. 684.It Cm -nud 685Clear a flag 686.Cm nud . --- 14 unchanged lines hidden (view full) --- 701Use 702.Ar device 703as the parent for the cloned device. 704.It Cm wlanmode Ar mode 705Specify the operating mode for this cloned device. 706.Ar mode 707is one of 708.Cm sta , |
| 709.Cm ahdemo | 709.Cm ahdemo |
| 710(or 711.Cm adhoc-demo ), 712.Cm ibss , 713(or 714.Cm adhoc ), 715.Cm ap , 716(or 717.Cm hostap ), --- 21 unchanged lines hidden (view full) --- 739but if the 740.Cm bssid 741parameter is specified then the driver will craft a unique address for 742the device (if supported). 743.It Cm wdslegacy 744Mark a 745.Cm wds 746device as operating in ``legacy mode''. | 710(or 711.Cm adhoc-demo ), 712.Cm ibss , 713(or 714.Cm adhoc ), 715.Cm ap , 716(or 717.Cm hostap ), --- 21 unchanged lines hidden (view full) --- 739but if the 740.Cm bssid 741parameter is specified then the driver will craft a unique address for 742the device (if supported). 743.It Cm wdslegacy 744Mark a 745.Cm wds 746device as operating in ``legacy mode''. |
| 747Legacy | 747Legacy |
| 748.Cm wds 749devices have a fixed peer relationship and do not, for example, roam 750if their peer stops communicating. 751For completeness a Dynamic WDS (DWDS) interface may marked as 752.Fl wdslegacy . 753.It Cm bssid 754Request a unique local mac address for the cloned device. 755This is only possible if the device supports multiple mac addresses. 756To force use of the parent's mac address use 757.Fl bssid . 758.It Cm beacons 759Mark the cloned interface as depending on hardware support to 760track received beacons. 761To have beacons tracked in software use 762.Fl beacons . | 748.Cm wds 749devices have a fixed peer relationship and do not, for example, roam 750if their peer stops communicating. 751For completeness a Dynamic WDS (DWDS) interface may marked as 752.Fl wdslegacy . 753.It Cm bssid 754Request a unique local mac address for the cloned device. 755This is only possible if the device supports multiple mac addresses. 756To force use of the parent's mac address use 757.Fl bssid . 758.It Cm beacons 759Mark the cloned interface as depending on hardware support to 760track received beacons. 761To have beacons tracked in software use 762.Fl beacons . |
| 763For | 763For |
| 764.Cm hostap | 764.Cm hostap |
| 765mode | 765mode |
| 766.Fl beacons 767can also be used to indicate no beacons should 768be transmitted; this can be useful when creating a WDS configuration but 769.Cm wds 770interfaces can only be created as companions to an access point. 771.El 772.Pp 773The following parameters are specific to IEEE 802.11 wireless interfaces --- 118 unchanged lines hidden (view full) --- 892a background scan is initiated. 893The idle time may not be set to less than 100 milliseconds. 894.It Cm bgscanintvl Ar interval 895Set the interval at which background scanning is attempted. 896The 897.Ar interval 898parameter is specified in seconds. 899By default a background scan is considered every 300 seconds (5 minutes). | 766.Fl beacons 767can also be used to indicate no beacons should 768be transmitted; this can be useful when creating a WDS configuration but 769.Cm wds 770interfaces can only be created as companions to an access point. 771.El 772.Pp 773The following parameters are specific to IEEE 802.11 wireless interfaces --- 118 unchanged lines hidden (view full) --- 892a background scan is initiated. 893The idle time may not be set to less than 100 milliseconds. 894.It Cm bgscanintvl Ar interval 895Set the interval at which background scanning is attempted. 896The 897.Ar interval 898parameter is specified in seconds. 899By default a background scan is considered every 300 seconds (5 minutes). |
| 900The | 900The |
| 901.Ar interval 902may not be set to less than 15 seconds. 903.It Cm bintval Ar interval 904Set the interval at which beacon frames are sent when operating in 905ad-hoc or ap mode. 906The 907.Ar interval 908parameter is specified in TU's (1024 usecs). --- 84 unchanged lines hidden (view full) --- 993.Cm n 994(802.11n aka HT), 995.Cm s 996(Atheros Static Turbo mode), 997and 998.Cm t 999(Atheros Dynamic Turbo mode, or appended to ``st'' and ``dt''). 1000The full set of channel widths following a '/' are: | 901.Ar interval 902may not be set to less than 15 seconds. 903.It Cm bintval Ar interval 904Set the interval at which beacon frames are sent when operating in 905ad-hoc or ap mode. 906The 907.Ar interval 908parameter is specified in TU's (1024 usecs). --- 84 unchanged lines hidden (view full) --- 993.Cm n 994(802.11n aka HT), 995.Cm s 996(Atheros Static Turbo mode), 997and 998.Cm t 999(Atheros Dynamic Turbo mode, or appended to ``st'' and ``dt''). 1000The full set of channel widths following a '/' are: |
| 1001.Cm 5 | 1001.Cm 5 |
| 1002(5MHz aka quarter-rate channel), | 1002(5MHz aka quarter-rate channel), |
| 1003.Cm 10 | 1003.Cm 10 |
| 1004(10MHz aka half-rate channel), | 1004(10MHz aka half-rate channel), |
| 1005.Cm 20 | 1005.Cm 20 |
| 1006(20MHz mostly for use in specifying ht20), 1007and | 1006(20MHz mostly for use in specifying ht20), 1007and |
| 1008.Cm 40 | 1008.Cm 40 |
| 1009(40MHz mostly for use in specifying ht40). 1010In addition, 1011a 40MHz HT channel specification may include the location 1012of the extension channel by appending ``+'' or ``-'' for above and below, | 1009(40MHz mostly for use in specifying ht40). 1010In addition, 1011a 40MHz HT channel specification may include the location 1012of the extension channel by appending ``+'' or ``-'' for above and below, |
| 1013respectively; e.g. ``2437:ht/40+'' specifies 40MHz wide HT operation | 1013respectively; e.g. ``2437:ht/40+'' specifies 40MHz wide HT operation |
| 1014with the center channel at frequency 2437 and the extension channel above. 1015.It Cm country Ar name 1016Set the country code to use in calculating the regulatory constraints 1017for operation. 1018In particular the set of available channels, how the wireless device 1019will operation on the channels, and the maximum transmit power that 1020can be used on a channel are defined by this setting. 1021Country/Region codes are specified as a 2-character abbreviation --- 994 unchanged lines hidden (view full) --- 2016Send broadcast path requests every two seconds and every node must reply with 2017with a path reply even if it already has a path to this root mesh station. 2018.It Cm RANN 2019Send broadcast root announcement (RANN) frames. 2020Nodes on the mesh without a path to this root mesh station with try to 2021discover a path to us. 2022.El 2023By default | 1014with the center channel at frequency 2437 and the extension channel above. 1015.It Cm country Ar name 1016Set the country code to use in calculating the regulatory constraints 1017for operation. 1018In particular the set of available channels, how the wireless device 1019will operation on the channels, and the maximum transmit power that 1020can be used on a channel are defined by this setting. 1021Country/Region codes are specified as a 2-character abbreviation --- 994 unchanged lines hidden (view full) --- 2016Send broadcast path requests every two seconds and every node must reply with 2017with a path reply even if it already has a path to this root mesh station. 2018.It Cm RANN 2019Send broadcast root announcement (RANN) frames. 2020Nodes on the mesh without a path to this root mesh station with try to 2021discover a path to us. 2022.El 2023By default |
| 2024.Cm hwmprootmode | 2024.Cm hwmprootmode |
| 2025is set to 2026.Ar DISABLED . 2027.It Cm hwmpmaxhops Ar cnt 2028Set the maximum number of hops allowed in an HMWP path to 2029.Ar cnt . 2030The default setting for 2031.Cm hwmpmaxhops 2032is 31. --- 531 unchanged lines hidden (view full) --- 2564.Fl k 2565flag causes keying information for the interface, if available, to be 2566printed. 2567For example, the values of 802.11 WEP keys and 2568.Xr carp 4 2569passphrases will be printed, if accessible to the current user. 2570This information is not printed by default, as it may be considered 2571sensitive. | 2025is set to 2026.Ar DISABLED . 2027.It Cm hwmpmaxhops Ar cnt 2028Set the maximum number of hops allowed in an HMWP path to 2029.Ar cnt . 2030The default setting for 2031.Cm hwmpmaxhops 2032is 31. --- 531 unchanged lines hidden (view full) --- 2564.Fl k 2565flag causes keying information for the interface, if available, to be 2566printed. 2567For example, the values of 802.11 WEP keys and 2568.Xr carp 4 2569passphrases will be printed, if accessible to the current user. 2570This information is not printed by default, as it may be considered 2571sensitive. |
| 2572.Pp | 2572.Pp |
| 2573If the network interface driver is not present in the kernel then 2574.Nm 2575will attempt to load it. 2576The 2577.Fl n 2578flag disables this behavior. 2579.Pp 2580Only the super-user may modify the configuration of a network interface. --- 110 unchanged lines hidden --- | 2573If the network interface driver is not present in the kernel then 2574.Nm 2575will attempt to load it. 2576The 2577.Fl n 2578flag disables this behavior. 2579.Pp 2580Only the super-user may modify the configuration of a network interface. --- 110 unchanged lines hidden --- |