Wed Nov 4 15:24:56 2020 UTC ()
Allow line breaks inside author names in prose paragraphs


(kim)
diff -r1.3 -r1.4 src/share/man/man4/ixl.4
diff -r1.5 -r1.6 src/share/man/man4/ure.4
diff -r1.2 -r1.3 src/share/man/man4/viornd.4
diff -r1.16 -r1.17 src/share/man/man4/wpi.4
cvs diff -r1.3 -r1.4 src/share/man/man4/ixl.4 (switch to unified diff)

--- src/share/man/man4/ixl.4 2019/12/20 14:09:23 1.3
+++ src/share/man/man4/ixl.4 2020/11/04 15:24:56 1.4
@@ -1,70 +1,71 @@ @@ -1,70 +1,71 @@
1.\" $NetBSD: ixl.4,v 1.3 2019/12/20 14:09:23 wiz Exp $ 1.\" $NetBSD: ixl.4,v 1.4 2020/11/04 15:24:56 kim Exp $
2.\" 2.\"
3.\" Copyright (c) 2019 Internet Initiative Japan, Inc. 3.\" Copyright (c) 2019 Internet Initiative Japan, Inc.
4.\" All rights reserved. 4.\" 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.\" 14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 18.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25.\" POSSIBILITY OF SUCH DAMAGE. 25.\" POSSIBILITY OF SUCH DAMAGE.
26.\" 26.\"
27.Dd December 10, 2019 27.Dd December 10, 2019
28.Dt IXL 4 28.Dt IXL 4
29.Os 29.Os
30.Sh NAME 30.Sh NAME
31.Nm ixl 31.Nm ixl
32.Nd Intel Ethernet 700 Series driver 32.Nd Intel Ethernet 700 Series driver
33.Sh SYNOPSIS 33.Sh SYNOPSIS
34.Cd "ixl* at pci? dev ? function ?" 34.Cd "ixl* at pci? dev ? function ?"
35.Sh DESCRIPTION 35.Sh DESCRIPTION
36The 36The
37.Nm 37.Nm
38driver supports Intel Ethernet 700 series controllers based on the 38driver supports Intel Ethernet 700 series controllers based on the
39Intel X710, XXV710, XL710, and X722 Ethernet chipsets. 39Intel X710, XXV710, XL710, and X722 Ethernet chipsets.
40.Sh SEE ALSO 40.Sh SEE ALSO
41.Xr arp 4 , 41.Xr arp 4 ,
42.Xr ifmedia 4 , 42.Xr ifmedia 4 ,
43.Xr netintro 4 , 43.Xr netintro 4 ,
44.Xr pci 4 , 44.Xr pci 4 ,
45.Xr ifconfig 8 45.Xr ifconfig 8
46.Sh HISTORY 46.Sh HISTORY
47The 47The
48.Nm 48.Nm
49driver comes from 49driver comes from
50.Ox . 50.Ox .
51It first appeared in 51It first appeared in
52.Nx 10.0 . 52.Nx 10.0 .
53.Sh AUTHORS 53.Sh AUTHORS
 54.An -nosplit
54The 55The
55.Nm 56.Nm
56driver was written by 57driver was written by
57.An David Gwynne Aq Mt dlg@openbsd.org 58.An David Gwynne Aq Mt dlg@openbsd.org
58and 59and
59.An Jonathan Matthew Aq Mt jmatthew@openbsd.org . 60.An Jonathan Matthew Aq Mt jmatthew@openbsd.org .
60It was imported from 61It was imported from
61.Ox 62.Ox
62into 63into
63.Nx 64.Nx
64by 65by
65.An Shoichi Yamaguchi Aq Mt yamaguchi@NetBSD.org . 66.An Shoichi Yamaguchi Aq Mt yamaguchi@NetBSD.org .
66.Sh BUGS 67.Sh BUGS
67The VLAN hardware filter doesn't work while the interface is in 68The VLAN hardware filter doesn't work while the interface is in
68promiscuous mode. 69promiscuous mode.
69If registering a VLAN tag fails due to lack of resources, the 70If registering a VLAN tag fails due to lack of resources, the
70interface doesn't send and receive packets containing the tag. 71interface doesn't send and receive packets containing the tag.
cvs diff -r1.5 -r1.6 src/share/man/man4/ure.4 (switch to unified diff)

--- src/share/man/man4/ure.4 2019/08/30 09:22:17 1.5
+++ src/share/man/man4/ure.4 2020/11/04 15:24:56 1.6
@@ -1,95 +1,96 @@ @@ -1,95 +1,96 @@
1.\" $NetBSD: ure.4,v 1.5 2019/08/30 09:22:17 wiz Exp $ 1.\" $NetBSD: ure.4,v 1.6 2020/11/04 15:24:56 kim Exp $
2.\" $OpenBSD: ure.4,v 1.5 2017/04/16 20:26:34 jmc Exp $ 2.\" $OpenBSD: ure.4,v 1.5 2017/04/16 20:26:34 jmc Exp $
3.\" 3.\"
4.\" Copyright (c) 2015 Kevin Lo <kevlo@FreeBSD.org> 4.\" Copyright (c) 2015 Kevin Lo <kevlo@FreeBSD.org>
5.\" All rights reserved. 5.\" All rights reserved.
6.\" 6.\"
7.\" Redistribution and use in source and binary forms, with or without 7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions 8.\" modification, are permitted provided that the following conditions
9.\" are met: 9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright 10.\" 1. Redistributions of source code must retain the above copyright
11.\" notice, this list of conditions and the following disclaimer. 11.\" notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\" notice, this list of conditions and the following disclaimer in the 13.\" notice, this list of conditions and the following disclaimer in the
14.\" documentation and/or other materials provided with the distribution. 14.\" documentation and/or other materials provided with the distribution.
15.\" 15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 19.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 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 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 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 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE. 26.\" SUCH DAMAGE.
27.\" 27.\"
28.\" $FreeBSD: head/share/man/man4/ure.4 291557 2015-12-01 05:12:13Z kevlo $ 28.\" $FreeBSD: head/share/man/man4/ure.4 291557 2015-12-01 05:12:13Z kevlo $
29.\" 29.\"
30.Dd August 24, 2019 30.Dd August 24, 2019
31.Dt URE 4 31.Dt URE 4
32.Os 32.Os
33.Sh NAME 33.Sh NAME
34.Nm ure 34.Nm ure
35.Nd RealTek RTL8152/RTL8153 10/100/Gigabit USB Ethernet device 35.Nd RealTek RTL8152/RTL8153 10/100/Gigabit USB Ethernet device
36.Sh SYNOPSIS 36.Sh SYNOPSIS
37.Cd "ure* at uhub?" 37.Cd "ure* at uhub?"
38.Cd "rgephy* at mii?" 38.Cd "rgephy* at mii?"
39.Cd "rlphy* at mii?" 39.Cd "rlphy* at mii?"
40.Sh DESCRIPTION 40.Sh DESCRIPTION
41The 41The
42.Nm 42.Nm
43driver provides support for USB Ethernet adapters based on the RealTek 43driver provides support for USB Ethernet adapters based on the RealTek
44RTL8152 USB Fast Ethernet devices including: 44RTL8152 USB Fast Ethernet devices including:
45.Pp 45.Pp
46.Bl -tag -width Ds -offset indent -compact 46.Bl -tag -width Ds -offset indent -compact
47.It Cable Matters 202023 USB 2.0 to 10/100 Fast Ethernet Network Adapter 47.It Cable Matters 202023 USB 2.0 to 10/100 Fast Ethernet Network Adapter
48.El 48.El
49.Pp 49.Pp
50and RTL8153 USB Gigabit Ethernet devices including: 50and RTL8153 USB Gigabit Ethernet devices including:
51.Pp 51.Pp
52.Bl -tag -width Ds -offset indent -compact 52.Bl -tag -width Ds -offset indent -compact
53.It Anker A7611 Aluminum USB 3.0 to Ethernet Adapter 53.It Anker A7611 Aluminum USB 3.0 to Ethernet Adapter
54.El 54.El
55.Pp 55.Pp
56The RTL8152 contains an integrated Fast Ethernet MAC, which supports 56The RTL8152 contains an integrated Fast Ethernet MAC, which supports
57both 10 and 100Mbps speeds in either full or half duplex. 57both 10 and 100Mbps speeds in either full or half duplex.
58The RTL8153 has a Gigabit Ethernet MAC and additionally supports 58The RTL8153 has a Gigabit Ethernet MAC and additionally supports
591000Mbps speeds. 591000Mbps speeds.
60.Pp 60.Pp
61For more information on configuring this device, see 61For more information on configuring this device, see
62.Xr ifconfig 8 . 62.Xr ifconfig 8 .
63.Sh DIAGNOSTICS 63.Sh DIAGNOSTICS
64See 64See
65.Xr usbnet 4 65.Xr usbnet 4
66for diagnostics. 66for diagnostics.
67.Sh SEE ALSO 67.Sh SEE ALSO
68.Xr arp 4 , 68.Xr arp 4 ,
69.Xr ifmedia 4 , 69.Xr ifmedia 4 ,
70.Xr mii 4 , 70.Xr mii 4 ,
71.Xr netintro 4 , 71.Xr netintro 4 ,
72.Xr rgephy 4 , 72.Xr rgephy 4 ,
73.Xr rlphy 4 , 73.Xr rlphy 4 ,
74.Xr uhub 4 , 74.Xr uhub 4 ,
75.Xr usb 4 , 75.Xr usb 4 ,
76.Xr usbnet 4 , 76.Xr usbnet 4 ,
77.Xr ifconfig 8 77.Xr ifconfig 8
78.Sh HISTORY 78.Sh HISTORY
79The 79The
80.Nm 80.Nm
81device driver first appeared in 81device driver first appeared in
82.Ox 6.0 82.Ox 6.0
83and 83and
84.Nx 9.0 . 84.Nx 9.0 .
85.Sh AUTHORS 85.Sh AUTHORS
 86.An -nosplit
86The 87The
87.Nm 88.Nm
88driver was written by 89driver was written by
89.An Kevin Lo Aq Mt kevlo@FreeBSD.org 90.An Kevin Lo Aq Mt kevlo@FreeBSD.org
90for 91for
91.Ox 92.Ox
92and ported to 93and ported to
93.Nx 94.Nx
94by 95by
95.An Rin Okuyama Aq Mt rin@NetBSD.org . 96.An Rin Okuyama Aq Mt rin@NetBSD.org .
cvs diff -r1.2 -r1.3 src/share/man/man4/viornd.4 (switch to unified diff)

--- src/share/man/man4/viornd.4 2014/10/26 22:07:47 1.2
+++ src/share/man/man4/viornd.4 2020/11/04 15:24:56 1.3
@@ -1,63 +1,64 @@ @@ -1,63 +1,64 @@
1.\" $NetBSD: viornd.4,v 1.2 2014/10/26 22:07:47 wiz Exp $ 1.\" $NetBSD: viornd.4,v 1.3 2020/11/04 15:24:56 kim Exp $
2.\" 2.\"
3.\" Copyright (c) 2014 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2014 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Thor Lancelot Simon. 7.\" by Thor Lancelot Simon.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\" notice, this list of conditions and the following disclaimer in the 15.\" notice, this list of conditions and the following disclaimer in the
16.\" documentation and/or other materials provided with the distribution. 16.\" documentation and/or other materials provided with the distribution.
17.\" 17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE. 28.\" POSSIBILITY OF SUCH DAMAGE.
29.\" 29.\"
30.Dd October 26, 2014 30.Dd October 26, 2014
31.Dt VIORND 4 31.Dt VIORND 4
32.Os 32.Os
33.Sh NAME 33.Sh NAME
34.Nm viornd 34.Nm viornd
35.Nd VirtIO entropy source 35.Nd VirtIO entropy source
36.Sh SYNOPSIS 36.Sh SYNOPSIS
37.Cd "viornd* at virtio?" 37.Cd "viornd* at virtio?"
38.Sh DESCRIPTION 38.Sh DESCRIPTION
39When the system has entropy demand, 39When the system has entropy demand,
40the 40the
41.Nm 41.Nm
42driver, used with a compatible hypervisor such as QEMU, KVM, or Google 42driver, used with a compatible hypervisor such as QEMU, KVM, or Google
43Compute Engine, requests entropy using the VirtIO random number interface 43Compute Engine, requests entropy using the VirtIO random number interface
44and feeds it into the system entropy pool. 44and feeds it into the system entropy pool.
45.Sh SEE ALSO 45.Sh SEE ALSO
46.Xr rnd 4 , 46.Xr rnd 4 ,
47.Xr virtio 4 47.Xr virtio 4
48.Sh HISTORY 48.Sh HISTORY
49The 49The
50.Nm 50.Nm
51driver appeared in 51driver appeared in
52.Ox 5.5 . 52.Ox 5.5 .
53.Sh AUTHORS 53.Sh AUTHORS
 54.An -nosplit
54The 55The
55.Nm 56.Nm
56driver was written by 57driver was written by
57.An Stephan Fritsch Aq Mt sf@fritsch.de 58.An Stephan Fritsch Aq Mt sf@fritsch.de
58and reworked to request entropy upon demand by 59and reworked to request entropy upon demand by
59.An Thor Lancelot Simon Aq Mt tls@NetBSD.org . 60.An Thor Lancelot Simon Aq Mt tls@NetBSD.org .
60.Sh CAVEATS 61.Sh CAVEATS
61VirtIO appears to support at least 8 pending entropy requests, but 62VirtIO appears to support at least 8 pending entropy requests, but
62.Nm 63.Nm
63currently supports only one pending request at a time. 64currently supports only one pending request at a time.
cvs diff -r1.16 -r1.17 src/share/man/man4/wpi.4 (switch to unified diff)

--- src/share/man/man4/wpi.4 2014/03/18 18:20:39 1.16
+++ src/share/man/man4/wpi.4 2020/11/04 15:24:56 1.17
@@ -1,241 +1,242 @@ @@ -1,241 +1,242 @@
1.\" $NetBSD: wpi.4,v 1.16 2014/03/18 18:20:39 riastradh Exp $ 1.\" $NetBSD: wpi.4,v 1.17 2020/11/04 15:24:56 kim Exp $
2.\" 2.\"
3.\" Copyright (c) 2006 3.\" Copyright (c) 2006
4.\" Damien Bergamini <damien.bergamini@free.fr>. All rights reserved. 4.\" Damien Bergamini <damien.bergamini@free.fr>. 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 unmodified, this list of conditions, and the following 10.\" notice unmodified, this list of conditions, and the following
11.\" disclaimer. 11.\" disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\" notice, this list of conditions and the following disclaimer in the 13.\" notice, this list of conditions and the following disclaimer in the
14.\" documentation and/or other materials provided with the distribution. 14.\" documentation and/or other materials provided with the distribution.
15.\" 15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 19.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 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 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 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 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE. 26.\" SUCH DAMAGE.
27.\" 27.\"
28.Dd October 14, 2012 28.Dd October 14, 2012
29.Dt WPI 4 29.Dt WPI 4
30.Os 30.Os
31.Sh NAME 31.Sh NAME
32.Nm wpi 32.Nm wpi
33.Nd Intel PRO/Wireless 3945ABG IEEE 802.11a/b/g wireless network driver 33.Nd Intel PRO/Wireless 3945ABG IEEE 802.11a/b/g wireless network driver
34.Sh SYNOPSIS 34.Sh SYNOPSIS
35.Cd "wpi* at pci? dev ? function ?" 35.Cd "wpi* at pci? dev ? function ?"
36.Sh DESCRIPTION 36.Sh DESCRIPTION
37The 37The
38.Nm 38.Nm
39driver provides support for 39driver provides support for
40.Tn Intel 40.Tn Intel
41PRO/Wireless 3945ABG Mini PCI Express network adapters. 41PRO/Wireless 3945ABG Mini PCI Express network adapters.
42.Pp 42.Pp
43These are the modes the 43These are the modes the
44.Nm 44.Nm
45driver can operate in: 45driver can operate in:
46.Bl -tag -width Ds 46.Bl -tag -width Ds
47.It BSS mode 47.It BSS mode
48Also known as 48Also known as
49.Em infrastructure 49.Em infrastructure
50mode, this is used when associating with an access point, through 50mode, this is used when associating with an access point, through
51which all traffic passes. 51which all traffic passes.
52This mode is the default. 52This mode is the default.
53.It monitor mode 53.It monitor mode
54In this mode the driver is able to receive packets without 54In this mode the driver is able to receive packets without
55associating with an access point. 55associating with an access point.
56This disables the internal receive filter and enables the card to 56This disables the internal receive filter and enables the card to
57capture packets from networks to which it wouldn't normally have access, 57capture packets from networks to which it wouldn't normally have access,
58or to scan for access points. 58or to scan for access points.
59.El 59.El
60.Pp 60.Pp
61.Nm 61.Nm
62supports software WEP. 62supports software WEP.
63Wired Equivalent Privacy (WEP) is the de facto encryption standard 63Wired Equivalent Privacy (WEP) is the de facto encryption standard
64for wireless networks. 64for wireless networks.
65It can be typically configured in one of three modes: 65It can be typically configured in one of three modes:
66no encryption; 40-bit encryption; or 104-bit encryption. 66no encryption; 40-bit encryption; or 104-bit encryption.
67Unfortunately, due to serious weaknesses in the WEP protocol 67Unfortunately, due to serious weaknesses in the WEP protocol
68it is strongly recommended that it not be used as the 68it is strongly recommended that it not be used as the
69sole mechanism to secure wireless communication. 69sole mechanism to secure wireless communication.
70WEP is not enabled by default. 70WEP is not enabled by default.
71.Sh CONFIGURATION 71.Sh CONFIGURATION
72The 72The
73.Nm 73.Nm
74driver can be configured at runtime with 74driver can be configured at runtime with
75.Xr ifconfig 8 75.Xr ifconfig 8
76using the following parameters: 76using the following parameters:
77.Bl -tag -width Ds 77.Bl -tag -width Ds
78.It Cm bssid Ar bssid 78.It Cm bssid Ar bssid
79Set the desired BSSID. 79Set the desired BSSID.
80.It Fl bssid 80.It Fl bssid
81Unset the desired BSSID. 81Unset the desired BSSID.
82The interface will automatically select a BSSID in this mode, which is 82The interface will automatically select a BSSID in this mode, which is
83the default. 83the default.
84.It Cm chan Ar n 84.It Cm chan Ar n
85Set the channel (radio frequency) to be used by the driver based on 85Set the channel (radio frequency) to be used by the driver based on
86the given channel ID 86the given channel ID
87.Ar n . 87.Ar n .
88.It Fl chan 88.It Fl chan
89Unset the desired channel to be used by the driver. 89Unset the desired channel to be used by the driver.
90The driver will automatically select a channel in this mode, which is 90The driver will automatically select a channel in this mode, which is
91the default. 91the default.
92.It Cm media Ar media 92.It Cm media Ar media
93The 93The
94.Nm 94.Nm
95driver supports the following 95driver supports the following
96.Ar media 96.Ar media
97types: 97types:
98.Pp 98.Pp
99.Bl -tag -width autoselect -compact 99.Bl -tag -width autoselect -compact
100.It Cm autoselect 100.It Cm autoselect
101Enable autoselection of the media type and options. 101Enable autoselection of the media type and options.
102.El 102.El
103.It Cm mediaopt Ar opts 103.It Cm mediaopt Ar opts
104The 104The
105.Nm 105.Nm
106driver supports the following media options: 106driver supports the following media options:
107.Pp 107.Pp
108.Bl -tag -width monitor -compact 108.Bl -tag -width monitor -compact
109.It Cm monitor 109.It Cm monitor
110Select monitor mode. 110Select monitor mode.
111.El 111.El
112.It Fl mediaopt Ar opts 112.It Fl mediaopt Ar opts
113Disable the specified media options on the driver and return it to the 113Disable the specified media options on the driver and return it to the
114default mode of operation (BSS). 114default mode of operation (BSS).
115.It Cm mode Ar mode 115.It Cm mode Ar mode
116The 116The
117.Nm 117.Nm
118driver supports the following modes: 118driver supports the following modes:
119.Pp 119.Pp
120.Bl -tag -width 11b -compact 120.Bl -tag -width 11b -compact
121.It Cm 11a 121.It Cm 11a
122Force 802.11a operation. 122Force 802.11a operation.
123.It Cm 11b 123.It Cm 11b
124Force 802.11b operation. 124Force 802.11b operation.
125.It Cm 11g 125.It Cm 11g
126Force 802.11g operation. 126Force 802.11g operation.
127.El 127.El
128.It Cm nwid Ar id 128.It Cm nwid Ar id
129Set the network ID. 129Set the network ID.
130The 130The
131.Ar id 131.Ar id
132can either be any text string up to 32 characters in length, 132can either be any text string up to 32 characters in length,
133or a series of hexadecimal digits up to 64 digits. 133or a series of hexadecimal digits up to 64 digits.
134An empty 134An empty
135.Ar id 135.Ar id
136string allows the interface to connect to any available access points. 136string allows the interface to connect to any available access points.
137By default the 137By default the
138.Nm 138.Nm
139driver uses an empty string. 139driver uses an empty string.
140Note that network ID is synonymous with Extended Service Set ID (ESSID). 140Note that network ID is synonymous with Extended Service Set ID (ESSID).
141.It Cm nwkey Ar key 141.It Cm nwkey Ar key
142Enable WEP encryption using the specified 142Enable WEP encryption using the specified
143.Ar key . 143.Ar key .
144The 144The
145.Ar key 145.Ar key
146can either be a string, a series of hexadecimal digits (preceded by 146can either be a string, a series of hexadecimal digits (preceded by
147.Sq 0x ) , 147.Sq 0x ) ,
148or a set of keys of the form 148or a set of keys of the form
149.Dq n:k1,k2,k3,k4 , 149.Dq n:k1,k2,k3,k4 ,
150where 150where
151.Sq n 151.Sq n
152specifies which of the keys will be used for transmitted packets, 152specifies which of the keys will be used for transmitted packets,
153and the four keys, 153and the four keys,
154.Dq k1 154.Dq k1
155through 155through
156.Dq k4 , 156.Dq k4 ,
157are configured as WEP keys. 157are configured as WEP keys.
158If a set of keys is specified, a comma 158If a set of keys is specified, a comma
159.Pq Sq \&, 159.Pq Sq \&,
160within the key must be escaped with a backslash. 160within the key must be escaped with a backslash.
161Note that if multiple keys are used, their order must be the same within 161Note that if multiple keys are used, their order must be the same within
162the network. 162the network.
163.Nm 163.Nm
164is capable of using both 40-bit (5 characters or 10 hexadecimal digits) 164is capable of using both 40-bit (5 characters or 10 hexadecimal digits)
165or 104-bit (13 characters or 26 hexadecimal digits) keys. 165or 104-bit (13 characters or 26 hexadecimal digits) keys.
166.It Fl nwkey 166.It Fl nwkey
167Disable WEP encryption. 167Disable WEP encryption.
168This is the default mode of operation. 168This is the default mode of operation.
169.El 169.El
170.Sh FILES 170.Sh FILES
171The driver needs at least version 2.14.4 of the following firmware file, 171The driver needs at least version 2.14.4 of the following firmware file,
172which is loaded when an interface is brought up: 172which is loaded when an interface is brought up:
173.Pp 173.Pp
174.Bl -tag -width Ds -offset indent -compact 174.Bl -tag -width Ds -offset indent -compact
175.It Pa /libdata/firmware/if_wpi/iwlwifi-3945.ucode 175.It Pa /libdata/firmware/if_wpi/iwlwifi-3945.ucode
176.El 176.El
177.Sh EXAMPLES 177.Sh EXAMPLES
178.Bd -literal -offset indent 178.Bd -literal -offset indent
179# ifconfig wpi0 nwkey 0x1deadbeef1 179# ifconfig wpi0 nwkey 0x1deadbeef1
180.Ed 180.Ed
181.Pp 181.Pp
182Return wpi0 to its default settings: 182Return wpi0 to its default settings:
183.Bd -literal -offset indent 183.Bd -literal -offset indent
184# ifconfig wpi0 -bssid -chan media autoselect \e 184# ifconfig wpi0 -bssid -chan media autoselect \e
185 nwid "" -nwkey 185 nwid "" -nwkey
186.Ed 186.Ed
187.Pp 187.Pp
188Join an existing BSS network, 188Join an existing BSS network,
189.Dq my_net : 189.Dq my_net :
190.Bd -literal -offset indent 190.Bd -literal -offset indent
191# ifconfig wpi0 192.168.1.1 netmask 0xffffff00 nwid my_net 191# ifconfig wpi0 192.168.1.1 netmask 0xffffff00 nwid my_net
192.Ed 192.Ed
193.Sh DIAGNOSTICS 193.Sh DIAGNOSTICS
194.Bl -diag 194.Bl -diag
195.It "wpi%d: device timeout" 195.It "wpi%d: device timeout"
196A frame dispatched to the hardware for transmission did not complete in time. 196A frame dispatched to the hardware for transmission did not complete in time.
197The driver will reset the hardware. 197The driver will reset the hardware.
198This should not happen. 198This should not happen.
199.It "wpi%d: fatal firmware error" 199.It "wpi%d: fatal firmware error"
200For some reason, the firmware crashed. 200For some reason, the firmware crashed.
201The driver will reset the hardware. 201The driver will reset the hardware.
202This should not happen. 202This should not happen.
203.It "wpi%d: Radio transmitter is off" 203.It "wpi%d: Radio transmitter is off"
204The radio transmitter is off and thus no packet can go out. 204The radio transmitter is off and thus no packet can go out.
205The driver will reset the hardware. 205The driver will reset the hardware.
206Make sure the laptop radio switch is on. 206Make sure the laptop radio switch is on.
207.It "wpi%d: could not read firmware file" 207.It "wpi%d: could not read firmware file"
208For some reason, the driver was unable to read the firmware image from the 208For some reason, the driver was unable to read the firmware image from the
209filesystem. 209filesystem.
210The file might be missing or corrupted. 210The file might be missing or corrupted.
211.It "wpi%d: firmware file too short: %d bytes" 211.It "wpi%d: firmware file too short: %d bytes"
212The firmware image is corrupted and can't be loaded into the adapter. 212The firmware image is corrupted and can't be loaded into the adapter.
213.It "wpi%d: could not load firmware" 213.It "wpi%d: could not load firmware"
214An attempt to load the firmware into the adapter failed. 214An attempt to load the firmware into the adapter failed.
215The driver will reset the hardware. 215The driver will reset the hardware.
216.El 216.El
217.Sh NOTES 217.Sh NOTES
218On some laptops the radio transmitter button must be pushed twice 218On some laptops the radio transmitter button must be pushed twice
219to get the driver working, or you will get a 219to get the driver working, or you will get a
220.Pa "wpi%d: fatal firmware error" 220.Pa "wpi%d: fatal firmware error"
221when the interface will be set to up 221when the interface will be set to up
222.Sh SEE ALSO 222.Sh SEE ALSO
223.Xr arp 4 , 223.Xr arp 4 ,
224.Xr ifmedia 4 , 224.Xr ifmedia 4 ,
225.Xr intro 4 , 225.Xr intro 4 ,
226.Xr netintro 4 , 226.Xr netintro 4 ,
227.Xr pci 4 , 227.Xr pci 4 ,
228.Xr ifconfig 8 , 228.Xr ifconfig 8 ,
229.Xr firmload 9 229.Xr firmload 9
230.Rs 230.Rs
231.%T The IPW Web Page 231.%T The IPW Web Page
232.%U http://damien.bergamini.free.fr/ipw/ 232.%U http://damien.bergamini.free.fr/ipw/
233.Re 233.Re
234.Sh AUTHORS 234.Sh AUTHORS
 235.An -nosplit
235The 236The
236.Nm 237.Nm
237driver was originally written by 238driver was originally written by
238.An Damien Bergamini Aq Mt damien@openbsd.org . 239.An Damien Bergamini Aq Mt damien@openbsd.org .
239.Nx 240.Nx
240porting was done by 241porting was done by
241.An Jean-Baptiste Campesato Aq Mt camjelemon@gmail.com . 242.An Jean-Baptiste Campesato Aq Mt camjelemon@gmail.com .