ifconfig.8: -s only looks at interface link state

ifconfig: show link state on -v

We could guess it through "media" or "status" output, however, we
sometimes want to know it directly for debugging or testing.

It is shown only if the -v option is specified.

branches: 1.129.2;
Update the date of the documentation to reflect recent changes.

ifconfig(8): move laggportpri next to laggport

Correct a very minor typo (s/id/is/)

Added documents about parameters related to lagg(4)

PR misc/58125

Fix parser for carp state.
The state values are uppercase words INIT, BACKUP and MASTER.

branches: 1.124.2;
ifconfig(8) support unnumbered flag.

mention ifmcstat(8) in SEE ALSO.

PR/50933: Uwe Toenjes: Document hardware limitations

Add [-]eee and [-]vlan-hwfilter.

ifconfig: teach carrier test about ifi_link_state from SIOCGIFDATA

Because not all interfaces support media.

Add "ifconfig [-]vlan-hwtagging" to enable/disable VLAN hardware tagging
offload function. It's useful to see Ethernet frame's VLAN tag by
disabling with "ifconfig fooX -vlan-hwtagging" and "tcpdump -e -i fooX".

Formatting nit.

Add descr,description/-descr,-description commands to ifconfig(8) to handle a description.

From t-kusaba@IIJ

Fix the format of ifconfig linkstr; it takes an argument

Remove ISO & XNS references which are now long gone.

branches: 1.114.10; 1.114.12;
New sentence, new line.
Remove superfluous Oc and merge line to make it less likely to happen again.
Fix typo.

add man for l2tp(4).

Fix typo: s/forwared/forwarded
Also remove full stop from the date.

branches: 1.111.2;
Replace contractions & abbreviation.

branches: 1.110.2;
-W seconds will wait for the detached flag to clear on addresses on
interfaces marked up to allow time for the carrier to appear on the
interface.

This does not extend the -w option duration.

Remove the ability for userland to toggle IN6_IFF_TENTATIVE.
Preserve IN6_IFF_TENTATIVE when updating address flags.

Write about -vlanif in ifconfig.8

PR 49114

Remove rtsol(8) and rtsold(8) as their functionality is in dhcpcd(8).
Remove rtsol(8) from rc.d/network.
Add -w seconds command to ifconfig to wait for N seconds for until DAD
has finished on all addresses.
Use ifconfig -w in rc.d/network instead of a forced sleep.

As discussed on tech-net@

branches: 1.106.4;
Before scanning, check if the card is up. If it is not the case, exit
with some useful error message. Add some note about this fact in the man
page too.

Bring tunnel src_addr and dst_addr on the same line

branches: 1.104.2; 1.104.6;
When ifconfig is invoked without any arguments, display the list of
all network interfaces (equivalent to ifconfig -a), instead of displaying
the usage. (This is consistent with the behaviour on FreeBSD and OpenBSD.)

branches: 1.103.4;
Fix typo: `symbolically' takes three l's, not two.

Implement ifconfig linkstr as proposed on tech-net.

Import pfsync support from OpenBSD 4.2

Pfsync interface exposes change in the pf(4) over a pseudo-interface, and can
be used to synchronise different pf.

This work was part of my 2009 GSoC

No objection on tech-net@

Describe the -N flag.

Add "MAC" keyword to the corresponding example.

Use the keyword 'MAC' so that people looking for a way to change
their MAC address can find the example.

Deprecate wiconfig's -r, -g, -m options. Note that equivalent
options are available in ifconfig(8).

Remove physical markup. Remove incorrect keep, .Bk is not callable, but
used as such. It doesn't seem to serve any purpose at the point either.

Point to ifmedia(4) more. And refer to -m flag to (for media).

branches: 1.94.2; 1.94.4; 1.94.8;
Bump date for previous. Remove trailing whitespace.
New sentence, new line. Capitalize Ethernet.

Do not mention the 'ns' address family any longer, since that
support was removed quite a while ago.

Mention the 'link' address family. Describe the 'active' keyword.
Add examples for adding and activating a link-layer address.

branches: 1.92.2; 1.92.4;
Add support for the command list scan in ifconfig (this command permits to scan
access point in the neighbourhood).

Complete list of channel attributes and list of management information element
payload.

While here, use estrlcpy instead of strncpy.

From FreeBSD ifconfig and net80211

branches: 1.91.4; 1.91.6;
Our VLAN implementation (as it correctly expected) is not allowed
to modify the whole VLAN tags, but it is permitted to change 12-bit
VLAN identificators only. Reflect this fact on the appropriate man
pages.

Antti Kantee and Mihai Chelaru from #netbsd-code were helpful in
better understanding of VLAN stuff. Thank you!

Let us adjust the 802.11 fragmentation threshold with ifconfig ath0
frag 256, for example.

Punctuation nit, sort SEE ALSO.

Remove a troff command that added some empty lines to the man(1) output.

implement ipv6 TSO.
partly from Matthias Scheler. tested by him.

Fix typo, noted by Nino Dehne <ndehne@gmail.com>

Add a mode to gre(4) that sends GRE tunnel packets in UDP datagrams.
Fix MOBILE encapsulation. Add many debugging printfs (mainly
concerning UDP mode). Clean up the gre(4) code a bit. Add the
capability to setup UDP tunnels to ifconfig. Update documentation.

In UDP mode, gre(4) puts a GRE header onto transmitted packets,
and hands them to a UDP socket for transmission. That is, the
encapsulation looks like this: IP+UDP+GRE+encapsulated packet.

There are two ways to set up a UDP tunnel. One way is to tell the
source and destination IP+port to gre(4), and let gre(4) create
the socket. The other way to create a UDP tunnel is for userland
to "delegate" a UDP socket to the kernel.

fix an Xref

Integrate Common Address Redundancy Procotol (CARP) from OpenBSD

'pseudo-device carp'

Thanks to: joerg@ christos@ riz@ and others who tested
Ok: core@

Remove trailing whitespace.

Add two new options from FreeBSD:
hidessid | -hidessid: SSID broadcast control
apbridge | -apbridge: how to pass packets between wifi clients

Argument is address_family, not "address family". From YOMURA Masanori in private mail.

Explained the '-h' option.

bump date for the previous.

split IFCAP_CSUM_xxx to IFCAP_CSUM_xxx_Rx and IFCAP_CSUM_xxx_Tx.

Link to vlan(4) too, suggested by yamt.

Bump date for agr; add agr(4) to SEE ALSO.

add agr(4), a pseudo network device driver for link aggregation.

branches: 1.73.2;
Add ifconfig support for TCP Segment Offload

Add an article.

Change "nwid" to "ssid", list "nwid" as a synonym for "ssid", and
clean up the ssid explanation a bit (including mentioning that if you
want to use a hex ssid, you precede it with a 0x, which really needed
documenting.)

Drop trailing whitespace (hi perry! :) ).

update man page date. (hi wiz!)

document that if you are using a hex wep key, you need to put 0x in
front of it.

document "mode" -- taken from FreeBSD

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22308, verified by myself.

Combine no-argument options in SYNOPSIS.

Document the -v and -z flags.

.Nm does not need a dummy argument ("") before punctuation or
for correct formatting of the SYNOPSIS any longer.

New sentence, new line.

Fix the option name 'channel' to 'chan' to be consistent with the source.
Add documents for '-chan' to unset the desired channel to associate.

Grammar fixes. Bump Dd for recent additions.

New commands:
* bssid xx:xx:xx:xx:xx:xx -- set the desired BSSID of an 802.11
interface.
* -bssid -- unset the desired BSSID of an 802.11 interface, so
the interface will choose automatically (default).
* channel x -- set the channel (radio frequency) of an 802.11 interface.

Current BSSID and channel are now reported in the 802.11 status
display, if supported by the interface.

Above changes from David Young <dyoung@ojctech.com>, with some slight
changes by me (use ethers(3) functions rather than hand-parsing/printing
the 802.11 address).

Document bssid/-bssid/channel, and clean up markup of parentheticals
in the manual page.

xref ifconfig.if(5)

Fix mandoc glitch in description of `eui64' command.

support "eui64" option (grab interface ID from link-local addr).
from: ww@styx.org

now "ifconfig tunnel" is usable for gre too, change wording slightly

Whitespace nits

Add tcp4csum-rx and udp4csum-rx commands for interfaces that only
support TCP/UDP checksums on the in-bound direction.

Add support of persistent key of IEEE 802.11 wireless LAN card.
Currently, only Aironet ("an") driver/card can be used.
nwkey persist (IEEE 802.11 devices only) Enable WEP encryption for IEEE
802.11-based wireless network interfaces with the persis-
tent key written in the network card.
nwkey persist:key
(IEEE 802.11 devices only) Write the key to the persis-
tent memory of the network card, and enable WEP encryp-
tion for IEEE 802.11-based wireless network interfaces
with the key.

Drop arguments of .Os.

Implement support for IP/TCP/UDP checksum offloading provided by
network interfaces. This works by pre-computing the pseudo-header
checksum and caching it, delaying the actual checksum to ip_output()
if the hardware cannot perform the sum for us. In-bound checksums
can either be fully-checked by hardware, or summed up for final
verification by software. This method was modeled after how this
is done in FreeBSD, although the code is significantly different in
most places.

We don't delay checksums for IPv6/TCP, but we do take advantage of the
cached pseudo-header checksum.

Note: hardware-assisted checksumming defaults to "off". It is
enabled with ifconfig(8). See the manual page for details.

Implement hardware-assisted checksumming on the DP83820 Gigabit Ethernet,
3c90xB/3c90xC 10/100 Ethernet, and Alteon Tigon/Tigon2 Gigabit Ethernet.

make -A a default. present MAC adderss on all ifconfig operations.

allow ifconfig to take "deprecated" and "-deprecated" for IPv6. sync with kame

sync usage() with reality. take "up" and "down" outside of "[af ...],
as "up" and "down" are independent from interface address configuration.

support "prefixlen n" for IPv4 too.

powersavesleep requires argument

Add powersave, -powersave, and powersavesleep to manipulate 802.11
power management parameters.

Don't make references to _10Mb/s_ Ethernet where not appropriate; from
Christian Weisgerber.

Add vlan(4) support. From Andy Doran <ad@netbsd.org>.

add two letters in strategically important places, and replace one
ifconfig by .Nm

also note that the WaveLAN/IEEE Gold cards accept the 104 bits key.
pointed out by jhawk.
XXX this doesn't match to wiconfig(8), which is probably wrong.

Clarify the restrictions in length for argument of the nwid and nwkey.

Add nwkey and -nwkey keywords, to enable/disable WEP,
and to set WEP encryption key for IEEE802.11 wireless network interfaces.

Add a -C flag, to list all available network interface cloners.

hexadecimal digits for nwid.

- Remove description about trailers/-trailers since they are no longer
a meaningful option.
- Don't captialize the word address or interface when it refers an arugment.
- Use .Ar macro for dest_address since it is not a keyword.

Sort the SEE ALSO list first by section and kill the comma at the
end of the list.

Add `create' and `destroy' commands.

- Add `tunnel' and `deletetunnel' commands, which issue the ioctls
that gifconfig(8) would issue to configure tunnel endpoints. This
allows IP tunnel interfaces (`gif' right now, and `gre' later) to
be configured with ifconfig(8), and via /etc/ifconfig.<interface>.
Partially taken from similar changes in OpenBSD.
- Const poison the command functions a bit. We really need to clean
up the command function interface.

branches: 1.32.4;
Fix typo.

note that ifconfig delete does not work for IPv6
this is intentional - IPv6 assumes multiple addresses on an interface,
and it is not very safe to "delete" arbitrary one. -alias with
explicit IPv6 address works fine.

add "nwid" directive.
XXX there are too many flags that are not listed in usage().
what should we do?

implement netmask slash notation for IP and IPv6 addresses

add reference to "inet6" family.
document -alias.

branches: 1.27.4;
Add a new -s option to make it easier to test the link-level status
(i.e., 10baseT carrier/no carrier) of an interface from scripts

ifconfig -s <interface> will exit with a false status if the interface
reports its unconnected.

-s also works in conjunction with -l and -a, filtering out interfaces
which are reporting down.

Also, add -b (which shows only broadcast interfaces with -l and -a).

I find these options useful in network autoconfig scripts for mobile
systems.

write up IPv6 operations (prefixlen and others)

make ifconfig IPv6-ready.
TODO: update manpage for new options.

Add support for displaying interface alias information. Based on PR/6109 by
Phil Nelson.

Cross-reference ifmedia(4).

Document "instance".

- Use .Nm "" instead of .Nm ifconfig in SYNOPSIS.
- Delete space at the end of line.

all but the first .Nm in SYNOPSIS need to be spelt out. [bin/4256]

* cleanup for WARNS=1
* deprecate register
* use .Nm correctly

Add "mask" argument to description of "broadcast".
From Thorsten Frueauf <frueauf@ira.uka.de> in [misc/3657]

Implemented two modifier flags for -a and -l: -d (only show "down" interfaces)
and -u (only show "up" interfaces)

Add mtu n parameter. Part of code by Matthias Pfaller (PR 1648).

Fix typo in media selector example. (from frueauf@ira.uka.de)
Fixes half of PR#3470.

- netatalk additions
- KNF
- prototype fixes
- ifconfig -a now prints all the address family parameters for all configured
interfaces.

Add a "-l" flag, which lists available network interfaces, with no
additional information.

Add support for BSD/OS-style media selection:
- new "media" keyword specified media to select:
ifconfig de0 media utp
- new "mediaopt/-mediaopt" keywords for setting/clearing
media options (such as full-duplex)
- new "-m" flag to display all supported media types for
a given interface.
Also, some generial cleanup of argument parsing while I was there.
Manual page updates from Jeremy Cooper <jeremy@netbsd.org>.

Merge with lite-2.

convert to new RCS Id conventions; reduce my headache

Merge with 4.4-Lite version.

fix a botch

Fix spelling errors

LLC -> LINK, documentation

Add RCS indentifiers.

Added another sunos-ism: ifconfig -a

changed "Id" to "Header" for rcsids

added rcs ids to all files

branches: 1.1.1;
Initial revision