History log of /freebsd-10.1-release/sbin/ifconfig/ifconfig.8
Revision Date Author Comments
(<<< Hide modified files)
(Show modified files >>>)
# 272461 02-Oct-2014 gjb

Copy stable/10@r272459 to releng/10.1 as part of
the 10.1-RELEASE process.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

# 257321 29-Oct-2013 glebius

Merge r256824 from head:
Provide a working example line for an interface with 1 address running
with CARP.

Currently, we've got a problem that interface isn't IFF_UP at the time
we assign it a redundant address, and the latter gets stuck in INIT state.
Additional SIOCSIFFLAGS from ifconfig(8) kicks it to a working state.

A proper fix is kernel side and appeared to be non-trivial, not to be
checked in before 10.0-RELEASE.

Submitted by: Ole Myhre <ole.myhre dataoppdrag.no>

Approved by: re (kib)


# 256281 10-Oct-2013 gjb

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation


# 250604 13-May-2013 joel

mdoc sweep


# 245230 09-Jan-2013 ume

Add no_prefer_iface option.
It stops treating the address on the interface as special by source
address selection rule even when the interface is outgoing interface.
This is desired in some situation.

Requested by: hrs
Reviewed by: IHANet folks including hrs
MFC after: 1 week


# 242705 07-Nov-2012 wblock

Actually change "silent" to "silence" this time (reviewed by adri@).

MFC after: 1 week


# 242704 07-Nov-2012 wblock

Remove fifteen-year-old notes on media selection (suggested by simon@).
Add commas after "e.g." and "i.e.". Change "silent" to "silence" in
wireless create section (reviewed by adri@).

MFC after: 1 week


# 242697 07-Nov-2012 wblock

Add devd.conf(5) and devd(8) to SEE ALSO xrefs. Give users a pointer to
seemingly mysterious actions that are not done by ifconfig itself, but
by devd triggering on events caused by ifconfig.

PR: docs/173405
Submitted by: Mateusz Kwiatkowski <mateusz.kwiatkowski@atlashost.eu>
MFC after: 1 week


# 238273 09-Jul-2012 hrs

Remove "prefer_source" address selection option. FreeBSD has had an
implementation of RFC 3484 for this purpose for a long time and "prefer_source"
was never implemented actually. ND6_IFF_PREFER_SOURCE macro is left intact.


# 236626 05-Jun-2012 joel

Remove repeated words.


# 236170 28-May-2012 bz

It turns out that too many drivers are not only parsing the L2/3/4
headers for TSO but also for generic checksum offloading. Ideally we
would only have one common function shared amongst all drivers, and
perhaps when updating them for IPv6 we should introduce that.
Eventually we should provide the meta information along with mbufs to
avoid (re-)parsing entirely.

To not break IPv6 (checksums and offload) and to be able to MFC the
changes without risking to hurt 3rd party drivers, duplicate the v4
framework, as other OSes have done as well.

Introduce interface capability flags for TX/RX checksum offload with
IPv6, to allow independent toggling (where possible). Add CSUM_*_IPV6
flags for UDP/TCP over IPv6, and reserve further for SCTP, and IPv6
fragmentation. Define CSUM_DELAY_DATA_IPV6 as we do for legacy IP and
add an alias for CSUM_DATA_VALID_IPV6.

This pretty much brings IPv6 handling in line with IPv4.
TSO is still handled in a different way and not via if_hwassist.

Update ifconfig to allow (un)setting of the new capability flags.
Update loopback to announce the new capabilities and if_hwassist flags.

Individual driver updates will have to follow, as will SCTP.

Reported by: gallatin, dim, ..
Reviewed by: gallatin (glanced at?)
MFC after: 3 days
X-MFC with: r235961,235959,235958


# 235671 19-May-2012 bz

MFp4 bz_ipv6_fast:

Allow tso4 and tso6 be set individually given we have the bits.
This will help with drivers not working as expected during the
transition time and later.

Sponsored by: The FreeBSD Foundation
Sponsored by: iXsystems

Reviewed by: gnn
MFC After: 1 week


# 234933 02-May-2012 monthadar

Update man page date to the date of the last commit.

Approved by: adrian


# 234893 01-May-2012 monthadar

* Added new command to ifconfig to activate Mesh Gate Announcement called
meshgate with corresponding explanation;

Approved by: adrian


# 233993 07-Apr-2012 joel

Remove end of line whitespace introduced in previous commit.


# 233848 03-Apr-2012 glebius

Document syncdev, syncpeer and defer keywords for
pfsync(4) interfaces.


# 233648 29-Mar-2012 eadler

Remove trailing whitespace per mdoc lint warning

Disussed with: gavin
No objection from: doc
Approved by: joel
MFC after: 3 days


# 232638 07-Mar-2012 thompsa

Fix typo and bump the document date which I also forgot.

Spotted by: Andrey Zonov


# 232629 06-Mar-2012 thompsa

Add the ability to set which packet layers are used for the load balance hash
calculation.


# 232316 29-Feb-2012 brueffer

Update bridge(4) default values.

PR: 164564
Submitted by: "Rudy (bulk)" <crapsh@monkeybrains.net>
MFC after: 2 weeks


# 232250 28-Feb-2012 gavin

Correct capitalization of "Hz" in user-visible text (manpages, printf(),
etc).

MFC after: 3 days


# 229518 04-Jan-2012 rwatson

Adjust the VLAN section of the ifconfig(8) man page to better reflect
reality:

1. Only 12-bit VLAN Identifiers, not full 16-bit VLAN tags can be set using
ifconfig vlan.

2. When we mean VLAN Identifiers, spell it that way, rather than as VLAN tag.

MFC after: 3 days
Sponsored by: Adara Networks, Inc.


# 228641 17-Dec-2011 bz

Allow toggling of IFCAP_VLAN_HWCSUM for hardware that supports checksum
offloading on vlans and document the new option.

MFC after: 2 weeks
Sponsored by: The FreeBSD Foundation


# 228571 16-Dec-2011 glebius

A major overhaul of the CARP implementation. The ip_carp.c was started
from scratch, copying needed functionality from the old implemenation
on demand, with a thorough review of all code. The main change is that
interface layer has been removed from the CARP. Now redundant addresses
are configured exactly on the interfaces, they run on.

The CARP configuration itself is, as before, configured and read via
SIOCSVH/SIOCGVH ioctls. A new prefix created with SIOCAIFADDR or
SIOCAIFADDR_IN6 may now be configured to a particular virtual host id,
which makes the prefix redundant.

ifconfig(8) semantics has been changed too: now one doesn't need
to clone carpXX interface, he/she should directly configure a vhid
on a Ethernet interface.

To supply vhid data from the kernel to an application the getifaddrs(8)
function had been changed to pass ifam_data with each address. [1]

The new implementation definitely closes all PRs related to carp(4)
being an interface, and may close several others. It also allows
to run a single redundant IP per interface.

Big thanks to Bjoern Zeeb for his help with inet6 part of patch, for
idea on using ifam_data and for several rounds of reviewing!

PR: kern/117000, kern/126945, kern/126714, kern/120130, kern/117448
Reviewed by: bz
Submitted by: bz [1]


# 227479 12-Nov-2011 adrian

Bump date.


# 227477 12-Nov-2011 adrian

Add documentation for the new quiet time IE options.

Submitted by: Himali Patel <himali.patel@sibridgetech.com>
Sponsored by: Sibridge Technologies


# 225672 19-Sep-2011 hrs

- Document inet6 no_radr flag.
- Add descriptions of sysctl(8) variables which can control the default
configuration of the inet6 flags.

Approved by: re (kib)


# 223735 03-Jul-2011 bz

Add infrastructure to allow all frames/packets received on an interface
to be assigned to a non-default FIB instance.

You may need to recompile world or ports due to the change of struct ifnet.

Submitted by: cjsp
Submitted by: Alexander V. Chernikov (melifaro ipfw.ru)
(original versions)
Reviewed by: julian
Reviewed by: Alexander V. Chernikov (melifaro ipfw.ru)
MFC after: 2 weeks
X-MFC: use spare in struct ifnet


# 222527 31-May-2011 bz

Conditionally compile in the af_inet and af_inet6, af_nd6 modules.
If compiled in for dual-stack use, test with feature_present(3)
to see if we should register the IPv4/IPv6 address family related
options.

In case there is no "inet" support we would love to go with the
usage() and make the address family mandatory (as it is for anything
but inet in theory). Unfortunately people are used to
ifconfig IF up/down
etc. as well, so use a fallback of "link". Adjust the man page
to reflect these minor details.

Improve error handling printing a warning in addition to the usage
telling that we do not know the given address family in two places.

Reviewed by: hrs, rwatson
Sponsored by: The FreeBSD Foundation
Sponsored by: iXsystems
MFC after: 2 weeks


# 220382 06-Apr-2011 gjb

Correct 'list scan' description in the examples. The previous description
was incorrect - 'list scan' does not actually do a scan, but instead lists
the results of the background 'scan' cache.

Submitted by: Fabian Keil (freebsd-listen of fabiankeil de) (via email)
Discussed with: bschmidt
MFC after: 3 days


# 219834 21-Mar-2011 gjb

Bump date from previous commit.


# 219805 20-Mar-2011 gjb

Use 'list scan' in favor of 'scan', as 'scan' has a different purpose.

Pointed out by: bschmidt
MFC after: 1 day


# 219575 12-Mar-2011 gjb

Remove unneeded newline.

MFC after: 1 week


# 219574 12-Mar-2011 gjb

Add example of using 'scan' for wireless networks, similarly to
OpenBSD's ifconfig(8).

PR: 151952
Submitted by: Jared (rhyous of yahoo com)
MFC after: 1 week


# 211397 16-Aug-2010 joel

Fix typos, spelling, formatting and mdoc mistakes found by Nobuyuki while
translating these manual pages. Minor corrections by me.

Submitted by: Nobuyuki Koganemaru <n-kogane@syd.odn.ne.jp>


# 210933 06-Aug-2010 joel

Fix typos and spelling mistakes.


# 210702 31-Jul-2010 joel

Spelling fixes.


# 208077 14-May-2010 bz

Document the 'short preamble' capability for 802.11bg.

Reviewed by: sam
MFC after: 4 days


# 207321 28-Apr-2010 rpaulo

Bump man page date.


# 207320 28-Apr-2010 rpaulo

Fix typos.

Obtained from: DragonFlyBSD


# 204150 20-Feb-2010 yongari

Add TSO support on VLAN in fconfig(8).

Reviewed by: thompsa


# 203052 26-Jan-2010 delphij

Revised revision 199201 (add interface description capability as inspired
by OpenBSD), based on comments from many, including rwatson, jhb, brooks
and others.

Sponsored by: iXsystems, Inc.
MFC after: 1 month


# 199231 12-Nov-2009 delphij

Revert revision 199201 for now as it has introduced a kernel vulnerability
and requires more polishing.


# 199201 11-Nov-2009 delphij

Add interface description capability as inspired by OpenBSD.

MFC after: 3 months


# 197526 26-Sep-2009 hrs

Fix several logic bugs in the previous IPv6 variable change and
re-add $ipv6_enable support for backward compatibility. From
UPDATING:

1. To use IPv6, simply define $ifconfig_IF_ipv6 like $ifconfig_IF
for IPv4. For aliases, $ifconfig_IF_aliasN should be used.
Note that both variables need the "inet6" keyword at the head.

Do not set $ipv6_network_interfaces manually if you do not
understand what you are doing. It is not needed in most cases.

$ipv6_ifconfig_IF and $ipv6_ifconfig_IF_aliasN still work, but
they are obsolete.

2. $ipv6_enable is obsolete. Use $ipv6_prefer and/or
"inet6 accept_rtadv" keyword in ifconfig(8) instead.

If you define $ipv6_enable=YES, it means $ipv6_prefer=YES and
all configured interfaces have "inet6 accept_rtadv" in the
$ifconfig_IF_ipv6. These are for backward compatibility.

3. A new variable $ipv6_prefer has been added. If NO, IPv6
functionality of interfaces with no corresponding
$ifconfig_IF_ipv6 is disabled by using "inet6 ifdisabled" flag,
and the default address selection policy of ip6addrctl(8)
is the IPv4-preferred one (see rc.d/ip6addrctl for more details).
Note that if you want to configure IPv6 functionality on the
disabled interfaces after boot, first you need to clear the flag by
using ifconfig(8) like:

ifconfig em0 inet6 -ifdisabled

If YES, the default address selection policy is set as
IPv6-preferred.

The default value of $ipv6_prefer is NO.

4. If your system need to receive Router Advertisement messages,
define "inet6 accept_rtadv" in $ifconfig_IF_ipv6. The rc(8)
scripts automatically invoke rtsol(8) when the interface becomes
UP. The Router Advertisement messages are used for SLAAC
(State-Less Address AutoConfiguration).


# 197142 12-Sep-2009 hrs

Document accept_rev_ethip_ver and send_rev_ethip_ver flags of
EtherIP (gif(4) + if_bridge(8)).

MFC after: 3 days


# 197138 12-Sep-2009 hrs

Improve flexibility of receiving Router Advertisement and
automatic link-local address configuration:

- Convert a sysctl net.inet6.ip6.accept_rtadv to one for the
default value of a per-IF flag ND6_IFF_ACCEPT_RTADV, not a
global knob. The default value of the sysctl is 0.

- Add a new per-IF flag ND6_IFF_AUTO_LINKLOCAL and convert a
sysctl net.inet6.ip6.auto_linklocal to one for its default
value. The default value of the sysctl is 1.

- Make ND6_IFF_IFDISABLED more robust. It can be used to disable
IPv6 functionality of an interface now.

- Receiving RA is allowed if ip6_forwarding==0 *and*
ND6_IFF_ACCEPT_RTADV is set on that interface. The former
condition will be revisited later to support a "host + router" box
like IPv6 CPE router. The current behavior is compatible with
the older releases of FreeBSD.

- The ifconfig(8) now supports these ND6 flags as well as "nud",
"prefer_source", and "disabled" in ndp(8). The ndp(8) now
supports "auto_linklocal".

Discussed with: bz and jinmei
Reviewed by: bz
MFC after: 3 days


# 195618 11-Jul-2009 rpaulo

Implementation of the upcoming Wireless Mesh standard, 802.11s, on the
net80211 wireless stack. This work is based on the March 2009 D3.0 draft
standard. This standard is expected to become final next year.
This includes two main net80211 modules, ieee80211_mesh.c
which deals with peer link management, link metric calculation,
routing table control and mesh configuration and ieee80211_hwmp.c
which deals with the actually routing process on the mesh network.
HWMP is the mandatory routing protocol on by the mesh standard, but
others, such as RA-OLSR, can be implemented.

Authentication and encryption are not implemented.

There are several scripts under tools/tools/net80211/scripts that can be
used to test different mesh network topologies and they also teach you
how to setup a mesh vap (for the impatient: ifconfig wlan0 create
wlandev ... wlanmode mesh).

A new build option is available: IEEE80211_SUPPORT_MESH and it's enabled
by default on GENERIC kernels for i386, amd64, sparc64 and pc98.

Drivers that support mesh networks right now are: ath, ral and mwl.

More information at: http://wiki.freebsd.org/WifiMesh

Please note that this work is experimental. Also, please note that
bridging a mesh vap with another network interface is not yet supported.

Many thanks to the FreeBSD Foundation for sponsoring this project and to
Sam Leffler for his support.
Also, I would like to thank Gateworks Corporation for sending me a
Cambria board which was used during the development of this project.

Reviewed by: sam
Approved by: re (kensmith)
Obtained from: projects/mesh11s


# 194871 24-Jun-2009 jamie

Add the "vnet" and "-vnet" options, to allow moving interfaces between
jails with VIMAGE.

Approved by: bz (mentor)


# 186904 08-Jan-2009 sam

TDMA support for long distance point-to-point links using ath devices:
o add net80211 support for a tdma vap that is built on top of the
existing adhoc-demo support
o add tdma scheduling of frame transmission to the ath driver; it's
conceivable other devices might be capable of this too in which case
they can make use of the 802.11 protocol additions etc.
o add minor bits to user tools that need to know: ifconfig to setup and
configure, new statistics in athstats, and new debug mask bits

While the architecture can support >2 slots in a TDMA BSS the current
design is intended (and tested) for only 2 slots.

Sponsored by: Intel


# 184057 19-Oct-2008 keramida

Tiny wording nits.

MFC after: 1 week


# 183616 05-Oct-2008 maxim

o Typo fixes.

PR: docs/127866
Submitted by: Marius Korsmo


# 183261 21-Sep-2008 sam

MIMO power save and RIFS; while here also update per-node state/flags for ampdu


# 182414 28-Aug-2008 jfv

Add support in ifconfig to control the vlan hardware filter feature.

Reviewed by: EvilSam and moi
MFC after:1 week


# 182263 27-Aug-2008 rpaulo

Fix typo.


# 181454 09-Aug-2008 sam

recognize WPS ie's

Submitted by: "Chuck Tuffli" <chuck@tuffli.net>
MFC after: 1 week


# 181199 02-Aug-2008 sam

change list wme to only print the channel parameters; to
get channel+bss use -v


# 180999 30-Jul-2008 sam

correct description of how to clear a desired channel

Pointed out by: Chris Buechler
MFC after: 1 week


# 179894 20-Jun-2008 thompsa

Add support for the optional key in the GRE header.

PR: kern/114714
Submitted by: Cristian KLEIN


# 178354 20-Apr-2008 sam

Multi-bss (aka vap) support for 802.11 devices.

Note this includes changes to all drivers and moves some device firmware
loading to use firmware(9) and a separate module (e.g. ral). Also there
no longer are separate wlan_scan* modules; this functionality is now
bundled into the wlan module.

Supported by: Hobnob and Marvell
Reviewed by: many
Obtained from: Atheros (some bits)


# 176666 29-Feb-2008 sam

explain that you must set a default transmit key for WEP

Submitted by: Jeremie Le Hen <jeremie@le-hen.org>
MFC after: 1 week


# 174505 10-Dec-2007 sam

Wake On Lan (WOL) infrastructure

Submitted by: Stefan Sperling <stsp@stsp.name>
Reviewed by: brooks


# 173320 04-Nov-2007 thompsa

Add an option to limit the number of source MACs that can be behind a bridge
interface. Once the limit is reached packets with unknown source addresses are
dropped until an existing host cache entry expires or is removed. Useful to
use with the STICKY cache option.

Sponsored by: miniSuperHappyDevHouse NZ


# 173274 02-Nov-2007 sam

minor wireless-related corrections

MFC after: 1 week


# 171678 31-Jul-2007 thompsa

Add a bridge interface flag called PRIVATE where any private port can not
communicate with another private port.

All unicast/broadcast/multicast layer2 traffic is blocked so it works much the
same way as using firewall rules but scales better and is generally easier as
firewall packages usually do not allow ARP blocking.

An example usage would be having a number of customers on separate vlans
bridged with a server network. All the vlans are marked private, they can all
communicate with the server network unhindered, but can not exchange any
traffic whatsoever with each other.

Approved by: re (rwatson)


# 171319 09-Jul-2007 sam

updates for 802.11-related parameters

Reviewed by: thompsa
Approved by: re (hrs)


# 170578 11-Jun-2007 andre

Add reporting and toggling of TCP LRO (large receive offload) support to
ifconfig(8).


# 170531 11-Jun-2007 sam

Update for revised 802.11 support:
o revised channel handling support; ifconfig now queries the kernel to
find the list of available channels and handles channel promotion;
channel attributes can be specified as part of the channel; e.g. 36:a
for channel 36 in 11a (as opposed to turbo A or HT A)
o use channel list to map between freq and IEEE channel #; this eliminates
all knowledge of how the mapping is done and fixes handling of cases
where channels overlap in the IEEE channel # space but are distinct in
the frequency+attributes space (e.g. PSB)
o add new knobs: bgscan, ff (Atheors fast frames), dturbo (Atheros
Dynamic Turbo mode), bgscanidle, bgscanintvl, scanvalid, roam:rssi11a,
roam:rssi11b, roam:rssi11g, roam:rate11a, roam:rate11b, roam:rate11g
(roaming parameters), burst, doth (forthcoming 11h support)
o print contents of WME, ATH, WPA, RSN, information elements with -v option
o print signal strength in dBm
o print noise floor in dBm
o add list txpow to print tx power caps/channel
o change default channel display in status to be more informative


# 169873 22-May-2007 thompsa

Add the -n flag for disabling automatic module loading, this will be used by
rc.d to stop it reloading the network module on unload.


# 168793 16-Apr-2007 thompsa

Rename the trunk(4) driver to lagg(4) as it is too similar to vlan trunking.

The name trunk is misused as the networking term trunk means carrying multiple
VLANs over a single connection. The IEEE standard for link aggregation (802.3
section 3) does not talk about 'trunk' at all while it is used throughout IEEE
802.1Q in describing vlans.

The lagg(4) driver provides link aggregation, failover and fault tolerance.

Discussed on: current@


# 168568 10-Apr-2007 thompsa

Bump document date for new trunk commands.


# 168563 09-Apr-2007 thompsa

Hook trunk(4) up to the build.


# 168031 29-Mar-2007 thompsa

Correct the name of the 'proto' command.

MFC after: 3 days


# 166498 04-Feb-2007 bms

Be explicit in examples about the correct grammar for 'alias' and
'-alias', and that 'add' and 'delete are in fact synonyms for these
in the ifconfig(8) grammar.

Use network prefixes explicitly specified in IETF RFCs for
documentation purposes. (bz)

PR: 102701
MFC after: 1 day
See also: RFC 3330, RFC 3849
Submitted by: bz


# 166445 03-Feb-2007 bms

Add an EXAMPLES section to ifconfig(8), clearly showing how to configure
IPv6 addresses in FreeBSD.

See also: http://www.telscom.ch/index.php/downloads/configure_ipv6_features

MFC after: 1 week
PR: 102701
Obtained from: OpenBSD (partly, with edits)


# 166113 19-Jan-2007 marius

- Display the media instance numbers and allow the user to set the active
one. This is based on NetBSD but unlike NetBSD this implementation prints
the instance number for all media instances and doesn't skip it for the
first one as I don't see a reason to suppress it except for the vague
reason to preserve the output for single-instance configurations.
- Fix some whitespace nits.


# 165105 11-Dec-2006 thompsa

These days P2P means peer-2-peer (also well known from serveral filesharing
protocols) while PointToPoint has been PtP links. Change the variables
accordingly while the code is still fresh and undocumented.

Requested by: bz


# 164698 27-Nov-2006 thompsa

Add descriptions for p2p and autop2p.


# 164697 27-Nov-2006 ceri

Bump .Dd for r1.127.


# 164688 27-Nov-2006 thompsa

Keep the command name the same as the values display name in ifconfig.


# 164112 09-Nov-2006 thompsa

Add a new address cache type called sticky. On an interface marked sticky any
address learned by the bridge is made permanent, the address will not age out
and most importantly will not migrate to another interface.

This can be used to stop mac address poisoning or clients roaming in much the
same way as static entries without the hassle of preloading the table.


# 163863 01-Nov-2006 thompsa

Bring in support for the Rapid Spanning Tree Protocol (802.1w).

RSTP provides faster spanning tree convergence, the protocol will exchange
information with neighboring switches to quickly transition to forwarding
without creating loops. The code will default to RSTP mode but will downgrade
any port connected to a legacy STP network so is fully backward compatible.

Reviewed by: syrinx
Tested by: syrinx


# 163195 10-Oct-2006 ru

Fix markup botched in previous commit.


# 163189 10-Oct-2006 trhodes

Note that the -v option may be used to expand long SSIDs.

PR: 102118
Reviewed by: sam


# 162948 02-Oct-2006 schweikh

Correct some grammos.


# 162395 18-Sep-2006 ru

Markup fixes.


# 162088 06-Sep-2006 andre

Make TSO (TCP segmentation offload) capabilities visible and accessible with
'ifconfig em0 tso' and 'ifconfig em0 -tso'. TSO for IPv4 and IPv6 is always
enabled or disabled together. The driver may enable only one if it doesn't
support both.

Document 'tso' and '-tso' in the ifconfig(8) man pages.

Sponsored by: TCP/IP Optimization Fundraise 2005


# 160687 26-Jul-2006 sam

add beacon miss threshold control

Submitted by: Henrik Brix Andersen <henrik@brixandersen.dk>
MFC after: 2 weeks


# 159885 23-Jun-2006 sam

remove display of the ERP ie from the list sta output (it's always
zero); replace it with station capabilities

MFC after: 1 month


# 159781 19-Jun-2006 mlaier

Import interface groups from OpenBSD. This allows to group interfaces in
order to - for example - apply firewall rules to a whole group of
interfaces. This is required for importing pf from OpenBSD 3.9

Obtained from: OpenBSD (with changes)
Discussed on: -net (back in April)


# 157595 08-Apr-2006 scottl

Document the rest of the 802.11 capability flags.


# 156079 27-Feb-2006 sam

explain what list chan displays

MFC after: 1 week


# 155740 15-Feb-2006 sam

add miss args to mac:del and mac:kick

Submitted by: Anders Hanssen
MFC after: 3 days


# 155254 03-Feb-2006 jcamou

Document carp(4) arguments.

PR: docs/92653
Submitted by: Jeremy C. Reed <reed@reedmedia.net>
Reviewed by: ru
Approved by: trhodes (mentor)
MFC after: 5 days


# 153736 26-Dec-2005 sam

document deftxkey


# 153475 16-Dec-2005 ceri

Document the pfsync(4) specific maxupd parameter, with text mostly taken
from OpenBSD's manpage.

PR: docs/89256
Submitted by: Pim van Pelt <pim at ipng dot nl>
MFC after: 3 days


# 153422 14-Dec-2005 sam

add control for packet bursting


# 153408 14-Dec-2005 thompsa

Add support for creating span ports so that one can snoop bridged traffic
from another interface/machine/network.

Obtained from: OpenBSD
MFC after: 2 weeks


# 153354 12-Dec-2005 sam

add mcastrate support

MFC after: 1 week


# 152568 18-Nov-2005 ru

-mdoc sweep.


# 150792 01-Oct-2005 glebius

Now ifconfig is the one right way to turn polling on. Thus, remove
the "if" clauses.


# 150740 29-Sep-2005 yar

For the sake of consistency and easier typing,
introduce "-tunnel" as an alias for "deletetunnel".
The latter is overly long and prone to typos, but
keep it for POLA since it costs nothing.

MFC after: 5 days


# 150737 29-Sep-2005 yar

Forgot to touch .Dd in the previous commit.


# 150736 29-Sep-2005 yar

Deprecate the useless argument to -vlandev.

Submitted by: Fredrik Lindberg <fli+freebsd-current at shapeshifter.se> (implementation)
Reviewed by: brooks
MFC after: 5 days


# 150465 22-Sep-2005 yar

Since special interface types get their own subsections
(not in mdoc(7) sense yet) in ifconfig(8) manpage, create such
subsections for gif(4) and vlan(4) so that their specific
options are not mixed up with general options.


# 149043 14-Aug-2005 thompsa

Document two missed if_bridge commands 'addr' and 'static'.

Noticed by: Michal Mertl
Approved by: mlaier (mentor)
MFC after: 3 days


# 149029 13-Aug-2005 sam

add list mac and mac:kick support

Submitted by: Michal Mertl (original version)
MFC after: 2 weeks


# 148643 02-Aug-2005 sam

Wireless suport fixups: add a bunch of stuff that's been in the
code but not documented (e.g. wme, mac acl) and correct some
information, etc.

Reviewed by: brueffer


# 148001 14-Jul-2005 rwatson

Add a new flag '-k' to ifconfig(8), indicating that it is alright to
print potentially sensitive keying material to stdout. With the new
802.11 support, ifconfig(8) is now capable of printing 802.11 keys,
and did by default for the root user, which is undesirable in some
environments. Now it will not print keying material unless requested
(and available to the user).

MFC after: 1 week


# 147948 13-Jul-2005 brueffer

mdoc cleanup and whitespace removal after the last commit.

Submitted by: ru


# 147943 12-Jul-2005 brueffer

Information about the capability flags in 'ifconfig foo0 scan' output.

Most content by: avatar
Reviewed by: sam
Approved by: re (hrs)
MFC after: 3 days


# 147795 06-Jul-2005 sam

add pureg/-pureg parameter for controlling pureg ap mode support

Reviewed by: avatar
Approved by: re (scottl)


# 147369 14-Jun-2005 ru

Markup fixes.

Approved by: re (blanket)


# 147337 13-Jun-2005 brueffer

It's spelled 'preceded' of course.

Submitted by: David Adam <zanchey@ucc.gu.uwa.edu.au>
Pointy hat to: brueffer


# 147333 13-Jun-2005 brueffer

Hex strings are _pre_ceeded by 0x, not _pro_ceeded.

PR: 82187
Submitted by: Anthony Rogers <anthony.j.rogers@gmail.com>
Approved by: re (blanket)
MFC after: 3 days


# 146987 05-Jun-2005 thompsa

Connect if_bridge to the build.

Approved by: mlaier (mentor)


# 143846 19-Mar-2005 brueffer

Xref carp(4) and polling(4).

MFC after: 3 days


# 140415 18-Jan-2005 ru

Sort sections.


# 139987 10-Jan-2005 ru

Scheduled mdoc(7) sweep.


# 138593 08-Dec-2004 sam

Overhaul to cleanup some of the tangled logic that's grown over the years.

o break per-address family support out into separate files
o modularize per-address family and functional operations using
a registration mechanism; this permits configuration according
to which files you include (but beware that order of the files
is important to insure backwards compatibility)
o many cleanups to eliminate incestuous behaviour, global variables,
and poor coding practices (still much more to fix)

The original motivation of this work was to support dynamic addition
of functionality based on the interface so we can eliminate the various
little control programs and so that vendors can distribute ifconfig
plugins that support their in-kernel code. That work is still to be
completed.

o Update 802.11 support for all the new net80211 functionality; some
of these operations (e.g. list *) may be better suited in a different
program


# 137313 06-Nov-2004 ru

First there was an -m option.
Then Peter killed it and made it the default.
Then Brooks and Poul-Henning added it again.
Then Ruslan fixed the manpage...


# 132690 27-Jul-2004 yar

Bump the date, .Dd, since the document content has been changed
in the previous commit.

Pointed out by: ru


# 132658 26-Jul-2004 yar

Add two knobs to ifconfig(8), `vlanmtu' and `vlanhwtag',
that provide control over the respective capabilities
of an interface, reception of extended frames and hardware
VLAN multiplexor.


# 131488 02-Jul-2004 ru

Mechanically kill hard sentence breaks.


# 130488 14-Jun-2004 bms

mdoc(7) police

Submitted by: ru


# 130474 14-Jun-2004 bms

Wordsmith the BUGS section re: IPv6 link-local addresses.

PR: docs/66541
Submitted by: Michel Lavondes (with some cleanups/additions)


# 129327 17-May-2004 ru

Assorted markup, grammar, and spelling fixes.


# 128114 11-Apr-2004 ru

Document that -m also causes the capability list to be displayed.


# 128113 11-Apr-2004 ru

Added the new interface capability option for drivers that implement
user-configurable polling(4) support. Make ifconfig(8) aware of it.

Suggested by: luigi


# 128073 09-Apr-2004 markm

Remove advertising clause from University of California Regent's license,
per letter dated July 22, 1999.

Approved by: core, imp


# 127649 30-Mar-2004 sam

add support for setting 802.11 rtsthreshold, transmit power,
and 11g protection mode

Reviewed by: imp (just code)


# 126068 21-Feb-2004 yar

We can cross-reference to vlan(4) as long as
the corresponding manpage has been committed.
The rest of "vlan" words, which are refering
to the technology itself, should be capitalized.

MFC after: 1 week


# 126067 21-Feb-2004 yar

The hardware tagging capability is set on the physical
interface that is parent to a vlan(4) interface,
not on the vlan(4) interface itself.


# 125412 04-Feb-2004 brooks

Add ifconfig support for network interface renaming. In the process,
reorganize the printing of the interface name when using wildcard
cloning so it is not printed if it we either immediately rename or
destroy the interface.

Reviewed by: ru


# 120626 01-Oct-2003 ru

By popular demand, added the "static ARP" per-interface option.


# 114999 14-May-2003 ru

mdoc(7) police: fix more breakages from rev. 1.69.


# 114970 13-May-2003 sheldonh

Fix broken comment line introduced in rev 1.69.

Found with: nroff -mandoc ifconfig.8 > /dev/null


# 114165 28-Apr-2003 sam

document mode directive


# 111996 08-Mar-2003 tjr

Uncomment the description of the ipdst parameter, but refer to IPX
instead of NS.


# 111649 27-Feb-2003 ru

Document the rxcsum and txcsum commands.

Submitted by: jlemon


# 107233 25-Nov-2002 ru

mdoc(7) police: markup, spelling.

Also fixed a critical bug made in revision 1.62 by phk@.


# 106942 14-Nov-2002 sam

update vlandev description; vlan code now auto-recognizes devices that
support h/w tagging


# 106071 28-Oct-2002 chris

Remove a line that reflected behavior that does not actually exist.

Obtained from: TrustedBSD Project
Sponsored by: DARPA, NAI Labs


# 105967 25-Oct-2002 chris

Document the `maclabel' command.

Obtained from: TrustedBSD Project
Sponsored by: Network Associates Laboratories


# 104044 27-Sep-2002 phk

Add the "Monitor" interface flag.

Setting this flag on an ethernet interface blocks transmission of packets
and discards incoming packets after BPF processing.

This is useful if you want to monitor network trafic but not interact
with the network in question.

Sponsored by: http://www.babeltech.dk


# 102100 19-Aug-2002 sobomax

Previous deltas (promisc mode) were a subject of:

MFC after: 1 week


# 102099 19-Aug-2002 sobomax

Implement user-setable promiscuous mode (a new `promisc' flag for ifconfig(8)).
Also, for all interfaces in this mode pass all ethernet frames to upper layer,
even those not addressed to our own MAC, which allows packets encapsulated
in those frames be processed with packet filters (ipfw(8) et al).

Emphatically requested by: Anton Turygin <pa3op@ukr-link.net>
Valuable suggestions by: fenner


# 101792 13-Aug-2002 ru

mdoc(7) police: KAMEism in rev. 1.56, nits in rev. 1.58.


# 101714 12-Aug-2002 imp

Warn that hex keys are the most portable.

Submitted by: Gregory Bond <gnb@itga.com.au>
Pr: 40872


# 99501 06-Jul-2002 charnier

The .Nm utility


# 98258 15-Jun-2002 ume

Add eui64 option which fills interface index (lowermost 64bit of
an IPv6 address) automatically.
This should obsolete prefix(8).

Obtained from: NetBSD
MFC after: 2 weeks


# 96403 11-May-2002 brian

Reword the ``alias'' description slightly. We must specify a non-conflicting
netmask - not necessarily 0xffffffff.

MFC after: 3 days


# 93281 27-Mar-2002 ru

Turn "ether" address family into a generic "link" family
that could be used to set/get arbitrary length link level
addresses. Alias "lladdr" parameter and "ether" family
to the new "link" family for backward compatibility.

PR: bin/31476
MFC after: 1 week


# 92335 15-Mar-2002 ru

mdoc(7) police: kill whitespace at eol.


# 90508 11-Feb-2002 dd

Note what the default address_family is.

PR: 32463
Submitted by: Gary W. Swearingen


# 89146 09-Jan-2002 ru

mdoc(7) police:

Restore (sorta) a useful piece of information that got lost in the
previous delta -- an ability to specify /prefixlength after an IPv6
address.


# 88989 07-Jan-2002 dd

In the words of the submitter:

The first "synopsis" example has a "[/prefixlength]" which shouldn't
be there, since that stuff is part of the preceeding "address" as is
explained in the description of "address".

(The way it is now, 192.168.0.1/16/prefixlength would be a proper
operand. Note that "prefixlength" is not mentioned by name anywhere.)

PR: 32462
Submitted by: Gary W. Swearingen <swear@blarg.net>


# 86881 24-Nov-2001 dd

Spelling police: sucessful -> successful.

Submitted by: Anders Andersson <anders@codefactory.se>


# 86875 24-Nov-2001 dd

Spelling police: "more then" - "more than" where appropriate.


# 82145 22-Aug-2001 yar

``create'' and ``destroy'' are command modifiers (.Cm), not flags (.Fl).


# 81774 16-Aug-2001 ru

mdoc(7) police: restore markup bit that got accidentally lost in rev. 1.44.


# 81229 07-Aug-2001 mckay

Spelling.


# 79319 05-Jul-2001 ru

mdoc(7) police: fix markup.


# 79105 02-Jul-2001 brooks

Support network device cloning via create and destroy options.

Reviewed by: ru, ume
Obtained from: NetBSD
MFC after: 1 week


# 78064 11-Jun-2001 ume

Sync with recent KAME.
This work was based on kame-20010528-freebsd43-snap.tgz and some
critical problem after the snap was out were fixed.
There are many many changes since last KAME merge.

TODO:
- The definitions of SADB_* in sys/net/pfkeyv2.h are still different
from RFC2407/IANA assignment because of binary compatibility
issue. It should be fixed under 5-CURRENT.
- ip6po_m member of struct ip6_pktopts is no longer used. But, it
is still there because of binary compatibility issue. It should
be removed under 5-CURRENT.

Reviewed by: itojun
Obtained from: KAME
MFC after: 3 weeks


# 77611 02-Jun-2001 dd

ARP works on networks other than Ethernet.

PR: 22062
Submitted by: Christian Weisgerber <naddy@mips.inka.de>,
Brooks Davis <brooks@one-eyed-alien.net>


# 77610 02-Jun-2001 dd

Mention the 'ether' parameter.

PR: 23767
Submitted by: Maxime Henrion <mux@qualys.com>,
Brooks Davis <brooks@one-eyed-alien.net>


# 77385 29-May-2001 phk

When using interfaces that support if_media, the supported media list is
printed on a single, very long, and generally unreadable line. This
isn't very useful. It's also really ugly and most of the time you don't
care what media is supported anyway.

PR: 27701
Submitted by: Brooks Davis <brooks@one-eyed-alien.net>


# 77217 26-May-2001 phk

Currently, each wireless networking driver has it's own control program
despite the fact that most people want to set exactly the same settings
regardless of which card they have. It has been repeatidly suggested
that this configuration should be done via ifconfig. This patch
implements the required functionality in ifconfig and add support to the
wi and an drivers. It also provides partial, untested support for the
awi driver.

PR: 25577
Submitted by: Brooks Davis <brooks@one-eyed-alien.net>


# 76326 07-May-2001 ru

Cosmetics: .Dl -> .Li.


# 76295 05-May-2001 jesper

Let ifconfig(8) catch up with the new functionality where
one can specify addresses and netmask in CIDR notation.

Submitted by: Dima Dorfman <dima@unixfreak.org>


# 71895 01-Feb-2001 ru

mdoc(7) police: split punctuation characters + misc fixes.


# 71386 22-Jan-2001 ben

mdoc police.

Submitted by: ru


# 71303 20-Jan-2001 ben

Add 'netrange' parameter to 'range' command and fix a couple of typos.

PR: 23984
Submitted by: Jimmy Olgeni <olgeni@uli.it>


# 68960 20-Nov-2000 ru

mdoc(7) police: use the new features of the Nm macro.


# 63542 19-Jul-2000 archie

Show the actual command line usage in the man page and usage error string.


# 63029 12-Jul-2000 jhb

Note that "ether" is a supported address family for setting addresses.


# 61734 16-Jun-2000 wpaul

Implement SIOCSIFLLADDR, which allows you to change the link-level
address on an interface. This basically allows you to do what my
little setmac module/utility does via ifconfig. This involves the
following changes:

socket.h: define SIOCSIFLLADDR
if.c: add support for SIOCSIFLLADDR, which resets the values in
the arpcom struct and sockaddr_dl for the specified interface.
Note that if the interface is already up, we need to down/up
it in order to program the underlying hardware's receive filter.
ifconfig.c: add lladdr command
ifconfig.8: document lladdr command

You can now force the MAC address on any ethernet interface to be
whatever you want. (The change is not sticky across reboots of course:
we don't actually reprogram the EEPROM or anything.) Actually, you
can reprogram the MAC address on other kinds of interfaces too; this
shouldn't be ethernet-specific (though at the moment it's limited to
6 bytes of address data).

Nobody ran up to me and said "this is the politically correct way to
do this!" so I don't want to hear any complaints from people who think
I could have done it more elegantly. Consider yourselves lucky I didn't
do it by having ifconfig tread all over /dev/kmem.


# 60736 20-May-2000 obrien

Document "-alias".


# 57668 01-Mar-2000 sheldonh

Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.


# 57521 26-Feb-2000 chris

Spelling: ``adress'' -> ``address''


# 57520 26-Feb-2000 rwatson

Introduce ``add'' and ``remove'' as alternatives to ``alias'' and ``delete''.
Improve compatibility with BSD/OS, and also more accurately reflect that
IP aliases aren't really any different than the primary IP address on an
interface.

Reviewed by: dcs
Approved by: jkh


# 56407 22-Jan-2000 mpp

Fix various man pages to stop abusing the .Bx macro to generate
the strings "FreeBSD" and "NetBSD". Use the .Fx or .Nx macro
instead.


# 54664 15-Dec-1999 billf

Spelling fix (manuall -> manual)

Submitted by: Jeroen C. van Gelderen <jeroen@vangelderen.org>


# 54263 07-Dec-1999 shin

udp IPv6 support, IPv6/IPv4 tunneling support in kernel,
packet divert at kernel for IPv6/IPv4 translater daemon

This includes queue related patch submitted by jburkhol@home.com.

Submitted by: queue related patch from jburkhol@home.com
Reviewed by: freebsd-arch, cvs-committers
Obtained from: KAME project


# 53505 21-Nov-1999 phk

Add comment about aliases on same subnet.

Submitted by: Martin Blapp <mbr@imp.ch>


# 50476 27-Aug-1999 peter

$Id$ -> $FreeBSD$


# 44764 14-Mar-1999 wpaul

Grrr... botched remote commit. Let's try this again: vlan updates,
take two.


# 37416 06-Jul-1998 charnier

Update man page to allow adding address_family when -l is used (this is a no op
for now). Correct use of .Nm. Short usage string (see man page for full list).
Spelling. Use err(3).


# 36743 08-Jun-1998 danny

Fix typo: exit -> exist


# 32968 01-Feb-1998 steve

Spell 'implements' correctly.

PR: 5614
Submitted by: Dag-Erling Coidan Smorgrav <dag-erli@ifi.uio.no>


# 30459 16-Oct-1997 peter

Make the supported media info output the default.
The -m switch is now accepted for backwards compatability.

Suggested by: davidg


# 29882 27-Sep-1997 peter

Spell out a few things for the media options.


# 25440 03-May-1997 peter

Grab some of the NetBSD text for describing the new options and the
media commands.


# 22990 22-Feb-1997 peter

Revert $FreeBSD$ to $Id$


# 21673 14-Jan-1997 jkh

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.


# 21635 12-Jan-1997 wosch

Sort cross references.


# 18033 04-Sep-1996 julian

Just realised the man page didn't mention the appletalk specific options
to ifconfig..
so I 've added them..


# 17022 09-Jul-1996 julian

Submitted by: Archie@whistle.com
Obtained from: Whistle Communications
patches to allow ifconfig to work with appletalk addresses etc.


# 14092 13-Feb-1996 wollman

XNS sort-of-support is no more.


# 13940 06-Feb-1996 wollman

Remove support for OSI networking in user-land (#ifdef OSI aor CCITT)
in preparation for its removal from the kernel source tree. NB: because
a function was deleted, libc is now at version 3.0 (was 2.2 previously).


# 13720 29-Jan-1996 mpp

Fix a bunch of spelling errors.


# 7039 12-Mar-1995 wpaul

Impliment -ad and -au flags in addition to -a and document the change
in the man page. ifconfig -au affects all interfaces marked as up,
and ifconfig -ad affects only the interfaces marked down. ifconfig -a
still handles everything. This change is purely for compatibility with
SunOS, for those who might be accustomed to the SunOS ifconfig's
behavior.


# 5299 30-Dec-1994 jkh

Tweak the man page too.


# 1940 08-Aug-1994 dg

Added support for setting the per-interface MTU.


# 1559 26-May-1994 rgrimes

This commit was generated by cvs2svn to compensate for changes in r1558,
which included commits to RCS files with non-trunk default branches.


# 1558 26-May-1994 rgrimes

BSD 4.4 Lite sbin Sources

Note: XNSrouted and routed NOT imported here, they shall be imported with
usr.sbin.