CVS log for src/sbin/ifconfig/ifconfig.8

Up to [cvs.NetBSD.org] / src / sbin / ifconfig

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

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

Pull up following revision(s) (requested by rin in ticket #902):

	sbin/ifconfig/carp.c: revision 1.15
	sbin/ifconfig/ifconfig.8: revision 1.125
	tests/net/carp/t_basic.sh: revision 1.9
	sys/netinet/ip_carp.c: revision 1.118
	sys/netinet/ip_carp.c: revision 1.119

Fix parser for carp state.

The state values are uppercase words INIT, BACKUP and MASTER.

Use backing device to send advertisements. Otherwise the packets originate
from the virtual MAC address, which confuses switches.

Select virtual address as sender if backing interface is anonymous.

Use correct scope for IPv6.

Don't expect the net/carp/t_basic/carp_handover_ipv6_halt_nocarpdevip
and carp_handover_ipv6_ifdown_nocarpdevip test cases to fail.  At
least on the TNF i386 and amd64 testbeds, they pass more often than
not since the commit of src/sys/netinet/ip_carp.c 1.119 by mlelstv on
2023.04.07.06.44.08.

Pull up following revision(s) (requested by ozaki-r in ticket #811):

	tests/net/if_shmif/t_shmif.sh: revision 1.1
	sbin/ifconfig/ifconfig.c: revision 1.251
	sbin/ifconfig/ifconfig.8: revision 1.130
	sys/rump/net/lib/libshmif/if_shmem.c: revision 1.85
	sys/rump/net/lib/libshmif/if_shmem.c: revision 1.86
	sys/rump/net/lib/libshmif/if_shmem.c: revision 1.87
	etc/mtree/NetBSD.dist.tests: revision 1.206
	distrib/sets/lists/tests/mi: revision 1.1333
	tests/net/if_shmif/Makefile: revision 1.1
	tests/net/Makefile: revision 1.42

shmif: change behaviors about link states

- Change the link state to UP on ifconfig linkstr
  - This behavior emulates physical devices
- Change the link state to UNKNOWN on ifconfig -linkstr just in case
- Reject sending/receiving packets if the link state is DOWN
  - Permit to send/receive packets on UNKNOWN, which is required
    to unbreak some ATF tests written in C

shmif: support media

It enables to link-down shmif by ifconfig media none and link-up
again by media auto.

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.
tests: add tests for shmif

The test file is placed under tests/net, not tests/rump/rumpnet,
to leverage utility functions provided for tests in there.
shmem(4): Fix typo in comment: AFT -> ATF.

Also fix grammar (if I understood correctly what this meant: rump
servers written in C, rather than set up via shell scripts around
rump_server invoking ifconfig).

No functional change intended.

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.

Pull up following revision(s) (requested by andvar in ticket #660):

	sbin/ifconfig/ifconfig.8: revision 1.126
	sbin/ifconfig/ifconfig.8: revision 1.127
	sbin/ifconfig/ifconfig.8: revision 1.128
	sbin/ifconfig/ifconfig.8: revision 1.129

Added documents about parameters related to lagg(4)
PR misc/58125

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

ifconfig(8): move laggportpri next to laggport

Update the date of the documentation to reflect recent changes.

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.

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.

Mostly merge changes from HEAD upto 20200411

 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

Sync with HEAD

Sync with HEAD, resolve a couple of conflicts

Fix the format of ifconfig linkstr; it takes an argument

Sync with HEAD

Resolve a couple of conflicts (result of the uimin/uimax changes)

Remove ISO & XNS references which are now long gone.

Sync with HEAD

Sync with HEAD

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.

Replace contractions & abbreviation.

-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.

Pull up following revision(s) (requested by ozaki-r in ticket #1156):
	sbin/ifconfig/vlan.c: revision 1.14
	sbin/ifconfig/ifconfig.8: revision 1.108
	sys/net/if_vlan.c: revision 1.71
	sys/net/if_vlan.c: revision 1.73
	sys/net/if_vlan.c: revision 1.74
- PR#49114: Write about -vlanif in ifconfig.8.
  Add -vlanif to the help message of ifconfig.
- PR#49196: Leave promiscuous mode when detaching a parent (ifconfig -vlanif)
  We have to call ifpromisc(ifp, 0) for both a VLAN interface
  and its parent when they are in promiscuous mode.
- PR#49197: Delete link local addresses of a vlan interface when detaching its
  parent.
- PR#49112: Restore vlan_ioctl overwritten by ether_ifdetach in vlan_unconfig

Pull up following revision(s) (requested by roy in ticket #160):
	sbin/ifconfig/af_inet6.c: revision 1.30
	sbin/ifconfig/ifconfig.8: revision 1.109
	sys/netinet6/in6.c: revision 1.177
Remove the ability for userland to toggle IN6_IFF_TENTATIVE.
Preserve IN6_IFF_TENTATIVE when updating address flags.

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

Pull up following revision(s) (requested by ozaki-r in ticket #108):
	sbin/ifconfig/vlan.c: revision 1.14
	sbin/ifconfig/ifconfig.8: revision 1.108
	sys/net/if_vlan.c: revision 1.71-1.74

Document -vlanif in ifconfig.8 and in usage measseg (PR 49114).
Leave promiscuous mode when detaching a parent (PR 49196) and
delete link local addresses (49197).
Restore vlan_ioctl overwritten by ether_ifdetach in vlan_unconfig
(PR 49112).
Call if_input of vlan interface itself, not parent one.
This allows bridging vlan interfaces again.

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@

Rebase to HEAD as of a few days ago.

sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs.  ("Protocol error: too many arguments")

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

sync with head

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.)

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

Implement ifconfig linkstr as proposed on tech-net.

sync to netbsd-5

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.

backout previous - wrong branch, thanks veego

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).

Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html

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).

Sync with HEAD.

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.

imported Mobile IPv6 code developed by the SHISA project
(http://www.mobileip.jp/).

sync with HEAD

Sync with HEAD.

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

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

Pull up following revision(s) (requested by rpaulo in ticket #1219):
	sbin/ifconfig/ifconfig.8: revision 1.79
Explained the '-h' option.

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.

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.

Pull up revision 1.49 (requested by itojun):
  Make ``-A'' the default, so that IPv4 aliases are printed.
  Always print mac address.

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.

Pull up revision 1.43 (requested by bouyer):
	Add support for 802.1Q virtual LANs.

Pull up revision 1.34, 1.38 (requested by bouyer):
  Support cloning of network pseudo-interfaces.

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>.

Pull up 1.41 -> 1.42 (approved by thorpej):
	add two letters in strategically important places, and replace
	one ifconfig by .Nm

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

Pullup 802.11 stuff (approved by jhawk)
- clarify the restriction for nwid/nwkey, add supported hardwares.
	basesrc/sbin/ifconfig/ifconfig.8		1.40-1.41
	saresrc/share/man/man4/awi.4			1.9
	saresrc/share/man/man4/wi.4			1.11

Pullup 802.11 stuff (approved by jhawk)
- add support for nwkey to ifconfig
	basesrc/sbin/ifconfig/ifconfig.c		1.88
	basesrc/sbin/ifconfig/ifconfig.8		1.39
	syssrc/sys/dev/ic/awi.c				1.26
	syssrc/sys/dev/ic/awi_wep.c			1.3
	syssrc/sys/dev/ic/awivar.h			1.12
	syssrc/sys/dev/pcmcia/if_wi.c			1.26
	syssrc/sys/net/if.c				1.69
	syssrc/sys/net/if_ieee80211.h			1.5

Pullups 802.11 stuff (approved by jhawk)
- allow non-string nwid settings
	basesrc/sbin/ifconfig/ifconfig.c		1.82-1.86
	basesrc/sbin/ifconfig/ifconfig.8		1.37
	syssrc/sys/dev/ic/awi.c				1.21
	syssrc/sys/dev/pcmcia/if_ray.c			1.21
	syssrc/sys/dev/pcmcia/if_wi.c			1.23
	syssrc/sys/dev/pcmcia/if_wivar.h		1.10
	syssrc/sys/net/if_ieee80211.h			1.4

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.

Pull up rev. 1.36:
- 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.

Pull up rev. 1.35:
Sort the SEE ALSO list first by section and kill the comma at the
end of the list.

- 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.

Rationale for pulling into netbsd-1-5 branch: While this looks like
a feature enhancement, it actually fixes a bug -- without this change
or a change in rc.d's network bring-up, it is not possible to configure
IP tunnels as a normal part of bringing up the network.

- 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.

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

Pull up to last week's -current.

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

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.

imported from 44lite2

convert to new RCS Id conventions; reduce my headache

Merge with 4.4-Lite version.

Import original 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

initial import of 386bsd-0.1 sources

Initial revision