Thu Apr 18 16:26:48 2024 UTC (21d)
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.


(martin)
diff -r1.124 -r1.124.2.1 src/sbin/ifconfig/ifconfig.8
cvs diff -r1.124 -r1.124.2.1 src/sbin/ifconfig/ifconfig.8 (expand / switch to unified diff)

--- src/sbin/ifconfig/ifconfig.8 2022/11/25 08:41:05 1.124
+++ src/sbin/ifconfig/ifconfig.8 2024/04/18 16:26:47 1.124.2.1
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: ifconfig.8,v 1.124 2022/11/25 08:41:05 knakahara Exp $ 1.\" $NetBSD: ifconfig.8,v 1.124.2.1 2024/04/18 16:26:47 martin Exp $
2.\" 2.\"
3.\" Copyright (c) 1983, 1991, 1993 3.\" Copyright (c) 1983, 1991, 1993
4.\" The Regents of the University of California. All rights reserved. 4.\" The Regents of the University of California. All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 3. Neither the name of the University nor the names of its contributors 14.\" 3. Neither the name of the University nor the names of its contributors
@@ -19,27 +19,27 @@ @@ -19,27 +19,27 @@
19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28.\" SUCH DAMAGE. 28.\" SUCH DAMAGE.
29.\" 29.\"
30.\" @(#)ifconfig.8 8.4 (Berkeley) 6/1/94 30.\" @(#)ifconfig.8 8.4 (Berkeley) 6/1/94
31.\" 31.\"
32.Dd November 25, 2022 32.Dd April 8, 2024
33.Dt IFCONFIG 8 33.Dt IFCONFIG 8
34.Os 34.Os
35.Sh NAME 35.Sh NAME
36.Nm ifconfig 36.Nm ifconfig
37.Nd configure network interface parameters 37.Nd configure network interface parameters
38.Sh SYNOPSIS 38.Sh SYNOPSIS
39.Nm 39.Nm
40.Op Fl N 40.Op Fl N
41.Ar interface address_family 41.Ar interface address_family
42.Oo 42.Oo
43.Ar address 43.Ar address
44.Op Ar dest_address 44.Op Ar dest_address
45.Oc 45.Oc
@@ -604,26 +604,60 @@ from the @@ -604,26 +604,60 @@ from the
604interface. 604interface.
605.It Cm agrport Ar iface 605.It Cm agrport Ar iface
606Add 606Add
607.Ar iface 607.Ar iface
608to the 608to the
609.Xr agr 4 609.Xr agr 4
610interface. 610interface.
611.It Cm -agrport Ar iface 611.It Cm -agrport Ar iface
612Remove 612Remove
613.Ar iface 613.Ar iface
614from the 614from the
615.Xr agr 4 615.Xr agr 4
616interface. 616interface.
 617.It Cm laggport Ar interface Oo Cm pri Ar n Oc
 618Add the interface named by
 619.Ar interface
 620as a port of the
 621.Xr lagg 4
 622interface,
 623and set the priority of
 624.Ar interface
 625to
 626.Ar n .
 627.It Cm -laggport Ar interface
 628Remove the interface named by
 629.Ar interface
 630from the
 631.Xr lagg 4
 632interface.
 633.It Cm laggportpri Ar interface Ar n
 634If the interface is a
 635.Xr lagg 4
 636pseudo-interface, set the priority of
 637.Ar interface
 638to
 639.Ar n
 640.It Cm laggproto Ar proto
 641Set the aggregation protocol of
 642.Xr lagg 4 .
 643The default is
 644.Li none .
 645The available options are
 646.Li failover ,
 647.Li lacp ,
 648.Li loadbalance ,
 649and
 650.Li none .
617.It Cm eee 651.It Cm eee
618Enable IEEE 802.3az Energy Efficiency Ethernet function. 652Enable IEEE 802.3az Energy Efficiency Ethernet function.
619.It Cm -eee 653.It Cm -eee
620Disable IEEE 802.3az Energy Efficiency Ethernet function. 654Disable IEEE 802.3az Energy Efficiency Ethernet function.
621.It Cm vltime Ar n 655.It Cm vltime Ar n
622.Pq inet6 only 656.Pq inet6 only
623Set valid lifetime for the address. 657Set valid lifetime for the address.
624.It Cm ip4csum 658.It Cm ip4csum
625Shorthand of 659Shorthand of
626.Dq ip4csum-tx ip4csum-rx 660.Dq ip4csum-tx ip4csum-rx
627.It Cm -ip4csum 661.It Cm -ip4csum
628Shorthand of 662Shorthand of
629.Dq -ip4csum-tx -ip4csum-rx 663.Dq -ip4csum-tx -ip4csum-rx
@@ -889,26 +923,27 @@ Add a link-layer (MAC) address to an Eth @@ -889,26 +923,27 @@ Add a link-layer (MAC) address to an Eth
889.Pp 923.Pp
890.Ic ifconfig sip0 link 00:11:22:33:44:55 924.Ic ifconfig sip0 link 00:11:22:33:44:55
891.Pp 925.Pp
892Add and activate a link-layer (MAC) address: 926Add and activate a link-layer (MAC) address:
893.Pp 927.Pp
894.Ic ifconfig sip0 link 00:11:22:33:44:55 active 928.Ic ifconfig sip0 link 00:11:22:33:44:55 active
895.Sh DIAGNOSTICS 929.Sh DIAGNOSTICS
896Messages indicating the specified interface does not exist, the 930Messages indicating the specified interface does not exist, the
897requested address is unknown, or the user is not privileged and 931requested address is unknown, or the user is not privileged and
898tried to alter an interface's configuration. 932tried to alter an interface's configuration.
899.Sh SEE ALSO 933.Sh SEE ALSO
900.Xr netstat 1 , 934.Xr netstat 1 ,
901.Xr agr 4 , 935.Xr agr 4 ,
 936.Xr lagg 4 ,
902.Xr carp 4 , 937.Xr carp 4 ,
903.Xr ifmedia 4 , 938.Xr ifmedia 4 ,
904.Xr netintro 4 , 939.Xr netintro 4 ,
905.Xr pfsync 4 , 940.Xr pfsync 4 ,
906.Xr vlan 4 , 941.Xr vlan 4 ,
907.Xr ifconfig.if 5 , 942.Xr ifconfig.if 5 ,
908.\" .Xr eon 5 , 943.\" .Xr eon 5 ,
909.Xr ifmcstat 8 , 944.Xr ifmcstat 8 ,
910.Xr rc 8 , 945.Xr rc 8 ,
911.Xr routed 8 946.Xr routed 8
912.Sh BUGS 947.Sh BUGS
913Due to hardware limitations some of the capabilities cannot be turned on 948Due to hardware limitations some of the capabilities cannot be turned on
914and off individually and need to be specified together. 949and off individually and need to be specified together.