CVS commit: src/share/man/man4
Module Name:src Committed By: bad Date: Sun Sep 29 19:35:35 UTC 2024 Modified Files: src/share/man/man4: ipsecif.4 Log Message: s/associates/associations/ To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/share/man/man4/ipsecif.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/ipsecif.4 diff -u src/share/man/man4/ipsecif.4:1.5 src/share/man/man4/ipsecif.4:1.6 --- src/share/man/man4/ipsecif.4:1.5 Thu Jan 25 09:29:18 2018 +++ src/share/man/man4/ipsecif.4 Sun Sep 29 19:35:35 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ipsecif.4,v 1.5 2018/01/25 09:29:18 maxv Exp $ +.\" $NetBSD: ipsecif.4,v 1.6 2024/09/29 19:35:35 bad Exp $ .\" .\" Copyright (C) 2017 Internet Initiative Japan Inc. .\" All rights reserved. @@ -108,7 +108,7 @@ The configuration will fail if such security policies already exist, and vice versa. .Pp -The related security associates can be established by an IKE daemon such as +The related security associations can be established by an IKE daemon such as .Xr racoon 8 . They can also be manipulated manually by .Xr setkey 8 @@ -131,7 +131,7 @@ do ifconfig ipsec0 -link2 .Ed .Pp -to reduce security associates for IPv6 packets. +to reduce security associations for IPv6 packets. .Sh EXAMPLES Configuration example: .Bd -literal @@ -162,7 +162,7 @@ On NetBSD_A: # ifconfig ipsec0 create # ifconfig ipsec0 tunnel 192.168.0.1 192.168.0.2 # ifconfig ipsec0 inet 172.16.100.1/32 172.16.200.1 -start IKE daemon or set security associates manually. +start IKE daemon or set security associations manually. # ifconfig wm1 inet 10.100.0.1/24 # route add 10.200.0.1 172.16.100.1 .Ed @@ -173,7 +173,7 @@ On NetBSD_B: # ifconfig ipsec0 create # ifconfig ipsec0 tunnel 192.168.0.2 192.168.0.1 # ifconfig ipsec0 inet 172.16.200.1/32 172.16.100.1 -start IKE daemon or set security associates manually. +start IKE daemon or set security associations manually. # ifconfig wm1 inet 10.200.0.1/24 # route add 10.100.0.1 172.16.200.1 .Ed
CVS commit: src/share/man/man4
Module Name:src Committed By: bad Date: Sun Sep 29 19:35:35 UTC 2024 Modified Files: src/share/man/man4: ipsecif.4 Log Message: s/associates/associations/ To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/share/man/man4/ipsecif.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: nia Date: Fri Sep 27 12:49:41 UTC 2024 Modified Files: src/share/man/man4: cgd.4 Log Message: cgd.4: aes mode advice from riastradh@ To generate a diff of this commit: cvs rdiff -u -r1.24 -r1.25 src/share/man/man4/cgd.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: nia Date: Fri Sep 27 12:49:41 UTC 2024 Modified Files: src/share/man/man4: cgd.4 Log Message: cgd.4: aes mode advice from riastradh@ To generate a diff of this commit: cvs rdiff -u -r1.24 -r1.25 src/share/man/man4/cgd.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/cgd.4 diff -u src/share/man/man4/cgd.4:1.24 src/share/man/man4/cgd.4:1.25 --- src/share/man/man4/cgd.4:1.24 Mon Aug 17 17:18:02 2020 +++ src/share/man/man4/cgd.4 Fri Sep 27 12:49:41 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: cgd.4,v 1.24 2020/08/17 17:18:02 riastradh Exp $ +.\" $NetBSD: cgd.4,v 1.25 2024/09/27 12:49:41 nia Exp $ .\" .\" Copyright (c) 2002, 2003 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -27,7 +27,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd August 16, 2020 +.Dd September 27, 2024 .Dt CGD 4 .Os .Sh NAME @@ -83,6 +83,10 @@ encryption under .Tn AES of the little-endian encoding of the disk sector number. The default key length is 128 bits. +.Tn CBC +mode is expected to provide marginally better theoretical security than +.Tn XTS +mode. .It Li "aes-xts" (key sizes: 256 or 512 bits) .Tn AES in @@ -100,6 +104,10 @@ or keys. The default key length is 256, meaning .Tn AES-128. +.Tn XTS +mode is expected to provide marginally better theoretical performance than +.Tn CBC +mode. .El .Ss Obsolete Ciphers The following obsolete ciphers are supported for compatibility with
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Tue Sep 24 14:19:02 UTC 2024 Modified Files: src/share/man/man4: vether.4 Log Message: vether(4): prettify a bit To generate a diff of this commit: cvs rdiff -u -r1.3 -r1.4 src/share/man/man4/vether.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/vether.4 diff -u src/share/man/man4/vether.4:1.3 src/share/man/man4/vether.4:1.4 --- src/share/man/man4/vether.4:1.3 Tue Sep 24 13:03:30 2024 +++ src/share/man/man4/vether.4 Tue Sep 24 14:19:02 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: vether.4,v 1.3 2024/09/24 13:03:30 roy Exp $ +.\" $NetBSD: vether.4,v 1.4 2024/09/24 14:19:02 uwe Exp $ .\" .\" $OpenBSD: vether.4,v 1.5 2017/10/17 22:47:58 schwarze Exp $ .\" @@ -45,12 +45,15 @@ the frame will show up there. The .Nm link state can be controlled using -.Xr ifconfig 8 . -.Bl -tag -width ".Cm -link0" -compact +.Xr ifconfig 8 : +.Pp +.Bl -tag -offset indent -width Cm -compact .It Cm link0 -link state DOWN -.It Cm -link0 -link state UP +link state +.Dq down +.It Fl link0 +link state +.Dq up .El .Sh SEE ALSO .Xr bridge 4 ,
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Tue Sep 24 14:19:02 UTC 2024 Modified Files: src/share/man/man4: vether.4 Log Message: vether(4): prettify a bit To generate a diff of this commit: cvs rdiff -u -r1.3 -r1.4 src/share/man/man4/vether.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: rillig Date: Sat Sep 7 19:46:13 UTC 2024 Modified Files: src/share/man/man4: ehci.4 mpt.4 Log Message: man: fix month names To generate a diff of this commit: cvs rdiff -u -r1.16 -r1.17 src/share/man/man4/ehci.4 cvs rdiff -u -r1.6 -r1.7 src/share/man/man4/mpt.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/ehci.4 diff -u src/share/man/man4/ehci.4:1.16 src/share/man/man4/ehci.4:1.17 --- src/share/man/man4/ehci.4:1.16 Sun Aug 10 13:39:58 2008 +++ src/share/man/man4/ehci.4 Sat Sep 7 19:46:13 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ehci.4,v 1.16 2008/08/10 13:39:58 jmcneill Exp $ +.\" $NetBSD: ehci.4,v 1.17 2024/09/07 19:46:13 rillig Exp $ .\" .\" Copyright (c) 2001, 2004, 2005, 2008 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -27,7 +27,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd Aug 10, 2008 +.Dd August 10, 2008 .Dt EHCI 4 .Os .Sh NAME Index: src/share/man/man4/mpt.4 diff -u src/share/man/man4/mpt.4:1.6 src/share/man/man4/mpt.4:1.7 --- src/share/man/man4/mpt.4:1.6 Sat Sep 27 16:17:27 2014 +++ src/share/man/man4/mpt.4 Sat Sep 7 19:46:13 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: mpt.4,v 1.6 2014/09/27 16:17:27 jmcneill Exp $ +.\" $NetBSD: mpt.4,v 1.7 2024/09/07 19:46:13 rillig Exp $ .\" .\" Copyright (c) 2003 Wasabi Systems, Inc. .\" All rights reserved. @@ -33,7 +33,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd Sep 27, 2014 +.Dd September 27, 2014 .Dt MPT 4 .Os .Sh NAME
CVS commit: src/share/man/man4
Module Name:src Committed By: rillig Date: Sat Sep 7 19:46:13 UTC 2024 Modified Files: src/share/man/man4: ehci.4 mpt.4 Log Message: man: fix month names To generate a diff of this commit: cvs rdiff -u -r1.16 -r1.17 src/share/man/man4/ehci.4 cvs rdiff -u -r1.6 -r1.7 src/share/man/man4/mpt.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: rin Date: Wed Sep 4 02:36:56 UTC 2024 Modified Files: src/share/man/man4: ip6.4 Log Message: ip6(4): Fix copy-paste; ip6 is subnode of inet6, not inet Bump date. To generate a diff of this commit: cvs rdiff -u -r1.34 -r1.35 src/share/man/man4/ip6.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: rin Date: Wed Sep 4 02:36:56 UTC 2024 Modified Files: src/share/man/man4: ip6.4 Log Message: ip6(4): Fix copy-paste; ip6 is subnode of inet6, not inet Bump date. To generate a diff of this commit: cvs rdiff -u -r1.34 -r1.35 src/share/man/man4/ip6.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/ip6.4 diff -u src/share/man/man4/ip6.4:1.34 src/share/man/man4/ip6.4:1.35 --- src/share/man/man4/ip6.4:1.34 Tue Sep 8 17:30:10 2020 +++ src/share/man/man4/ip6.4 Wed Sep 4 02:36:56 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ip6.4,v 1.34 2020/09/08 17:30:10 wiz Exp $ +.\" $NetBSD: ip6.4,v 1.35 2024/09/04 02:36:56 rin Exp $ .\" $KAME: ip6.4,v 1.23 2005/01/11 05:56:25 itojun Exp $ .\" $OpenBSD: ip6.4,v 1.21 2005/01/06 03:50:46 itojun Exp $ .\" @@ -28,7 +28,7 @@ .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. -.Dd September 8, 2020 +.Dd September 4, 2024 .Dt IP6 4 .Os .Sh NAME @@ -250,9 +250,9 @@ The port selection can be also viewed an sockets using the following .Xr sysctl 7 variables: -.Dv net.inet.ip6.anonportalgo.available +.Dv net.inet6.ip6.anonportalgo.available and -.Dv net.inet.ip6.anonportalgo.selected . +.Dv net.inet6.ip6.anonportalgo.selected . .It Dv IPV6_PORTRANGE Fa "int *" Get or set the allocation policy of ephemeral ports for when the kernel automatically binds a local address to this socket.
CVS commit: src/share/man/man4
Module Name:src Committed By: andvar Date: Tue Sep 3 19:47:28 UTC 2024 Modified Files: src/share/man/man4: pci.4 Log Message: s/interaces/interfaces. To generate a diff of this commit: cvs rdiff -u -r1.124 -r1.125 src/share/man/man4/pci.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/pci.4 diff -u src/share/man/man4/pci.4:1.124 src/share/man/man4/pci.4:1.125 --- src/share/man/man4/pci.4:1.124 Wed Mar 6 22:18:56 2024 +++ src/share/man/man4/pci.4 Tue Sep 3 19:47:28 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: pci.4,v 1.124 2024/03/06 22:18:56 cnst Exp $ +.\" $NetBSD: pci.4,v 1.125 2024/09/03 19:47:28 andvar Exp $ .\" .\" Copyright (c) 1997 Jason R. Thorpe. All rights reserved. .\" Copyright (c) 1997 Jonathan Stone @@ -282,7 +282,7 @@ Intel i8254x Gigabit Ethernet driver. .It Xr an 4 Aironet 4500/4800 and Cisco 340 series 802.11 interfaces. .It Xr atw 4 -ADMtek ADM8211 IEEE 802.11b PCI/CardBus wireless network interaces. +ADMtek ADM8211 IEEE 802.11b PCI/CardBus wireless network interfaces. .It Xr ath 4 Atheros IEEE 802.11a/b/g wireless network interfaces. .It Xr athn 4
CVS commit: src/share/man/man4
Module Name:src Committed By: andvar Date: Tue Sep 3 19:47:28 UTC 2024 Modified Files: src/share/man/man4: pci.4 Log Message: s/interaces/interfaces. To generate a diff of this commit: cvs rdiff -u -r1.124 -r1.125 src/share/man/man4/pci.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: gutteridge Date: Mon Sep 2 13:41:33 UTC 2024 Modified Files: src/share/man/man4: wsdisplay.4 Log Message: wsdisplay.4: minor grammar fixes To generate a diff of this commit: cvs rdiff -u -r1.50 -r1.51 src/share/man/man4/wsdisplay.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/wsdisplay.4 diff -u src/share/man/man4/wsdisplay.4:1.50 src/share/man/man4/wsdisplay.4:1.51 --- src/share/man/man4/wsdisplay.4:1.50 Wed Dec 23 06:10:13 2020 +++ src/share/man/man4/wsdisplay.4 Mon Sep 2 13:41:33 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: wsdisplay.4,v 1.50 2020/12/23 06:10:13 uwe Exp $ +.\" $NetBSD: wsdisplay.4,v 1.51 2024/09/02 13:41:33 gutteridge Exp $ .\" .\" Copyright (c) 1999 Matthias Drochner. .\" Copyright (c) 2002 Ben Harris. @@ -97,7 +97,7 @@ locator in the configuration line refers that will be used to get keyboard events. If this locator is -1 no mux will be used. .Pp -The logical unit of an independent contents displayed on a display +The logical unit of independent contents displayed on a display (sometimes referred to as .Dq virtual terminal ) is called a @@ -648,5 +648,5 @@ and .Dq wsdisplay are not cleanly distinguished in the code and in manual pages. .Pp -.Dq non-emulating +.Dq Non-emulating display devices are not tested.
CVS commit: src/share/man/man4
Module Name:src Committed By: gutteridge Date: Mon Sep 2 13:41:33 UTC 2024 Modified Files: src/share/man/man4: wsdisplay.4 Log Message: wsdisplay.4: minor grammar fixes To generate a diff of this commit: cvs rdiff -u -r1.50 -r1.51 src/share/man/man4/wsdisplay.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Tue Aug 27 17:38:52 UTC 2024 Modified Files: src/share/man/man4: rnd.4 Log Message: rnd(4): tweak markup a bit, consistently use .Li for sysctl vars To generate a diff of this commit: cvs rdiff -u -r1.42 -r1.43 src/share/man/man4/rnd.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/rnd.4 diff -u src/share/man/man4/rnd.4:1.42 src/share/man/man4/rnd.4:1.43 --- src/share/man/man4/rnd.4:1.42 Tue Aug 27 11:21:02 2024 +++ src/share/man/man4/rnd.4 Tue Aug 27 17:38:52 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: rnd.4,v 1.42 2024/08/27 11:21:02 riastradh Exp $ +.\" $NetBSD: rnd.4,v 1.43 2024/08/27 17:38:52 uwe Exp $ .\" .\" Copyright (c) 2014-2020 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -42,14 +42,14 @@ and .Pa /dev/urandom devices generate bytes randomly with uniform distribution. Every read from them is independent. -.Bl -tag -width /dev/urandom -.It Pa /dev/urandom -Never blocks. -.It Pa /dev/random -Sometimes blocks. -Will block early at boot if the system's state is known to be +.Pp +.Pa /dev/urandom +never blocks. +.Pp +.Pa /dev/random +sometimes blocks. +It will block early at boot if the system's state is known to be predictable. -.El .Pp Applications should read from .Pa /dev/urandom , @@ -59,12 +59,10 @@ variable .Li kern.arandom , when they need randomly generated data, e.g. key material for cryptography or seeds for simulations. -(The -.Xr sysctl 7 -variable +The .Li kern.arandom -is limited to 256 bytes per read, but is otherwise equivalent to -reading from +variable is limited to 256 bytes per read, but is otherwise equivalent +to reading from .Pa /dev/urandom and always works even in a .Xr chroot 8 @@ -72,7 +70,7 @@ environment without requiring a populate .Pa /dev tree and without opening a file descriptor, so .Li kern.arandom -may be preferable to use in libraries.) +may be preferable to use in libraries. .Pp Systems should be engineered to judiciously read at least once from .Pa /dev/random @@ -105,12 +103,13 @@ the outputs to to guarantee your system is in a state that nobody but you and the bored security guard watching the surveillance camera in your office can guess: -.Bd -literal -offset abcd -% echo tththhhththttthtththttth... > /dev/random -.Ed .Pp -(Sequence generated from a genuine US quarter dollar, guaranteed -random.) +.Dl % echo tththhhththttthtththttth... > /dev/random +.Pp +.Po +Sequence generated from a genuine US quarter dollar, guaranteed +random. +.Pc .\" .Sh SECURITY MODEL The @@ -134,7 +133,7 @@ means a single read, no matter how short .Pp .Sq Cannot predict means it is conjectured of the cryptography in -.Fa /dev/random +.Pa /dev/random that any computationally bounded attacker who tries to distinguish outputs from uniform random cannot do more than negligibly better than uniform random guessing. @@ -161,7 +160,8 @@ or .Em entropy for short in cryptography. For example: -.Bl -bullet -offset abcd -compact +.Pp +.Bl -bullet -offset indent -compact .It A fair coin toss has one bit of entropy. .It @@ -173,9 +173,9 @@ The toss of a pair of fair coins that ar entropy. .It A uniform random distribution with -.Fa n +.Ar n possibilities has log_2 -.Fa n +.Ar n bits of entropy. .It An utterance from an accounting troll who always says @@ -222,7 +222,7 @@ kernel has started. For those that don't, the .Xr rndctl 8 command can do it once userland has started, for example by setting -.Dq Li random_seed=YES +.Ql random_seed=YES in .Pa /etc/rc.conf , which is enabled by default; see @@ -322,7 +322,7 @@ typedef struct { .Ed .Pp Fill the -.Fa sources +.Fa source array with information about up to .Fa count entropy sources, starting at @@ -345,7 +345,7 @@ Fill with information about the entropy source named .Fa name , or fail with -.Dv ENOENT +.Er ENOENT if there is none. .It Dv RNDCTL Pq Vt rndctl_t .Bd -literal @@ -413,7 +413,7 @@ variables provided by .Nm can be set by privileged users: .Bl -tag -width abcd -.It Dv kern.entropy.collection Pq Vt bool +.It Li kern.entropy.collection Pq Vt bool (Default on.) Enables entering data into the entropy pool. If disabled, no new data can be entered into the entropy pool, whether @@ -424,7 +424,7 @@ or or by the .Dv RNDADDDATA ioctl. -.It Dv kern.entropy.depletion Pq Vt bool +.It Li kern.entropy.depletion Pq Vt bool (Default off.) Enables .Sq entropy depletion , @@ -434,9 +434,11 @@ the system entropy. This is not justified by modern cryptography \(em an adversary will never guess the 256-bit secret in a Keccak sponge no matter how much output from the sponge they see \(em but may be useful for testing. -.It Dv kern.entropy.consolidate Pq Vt int +.It Li kern.entropy.consolidate Pq Vt int Trigger for
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Tue Aug 27 17:38:52 UTC 2024 Modified Files: src/share/man/man4: rnd.4 Log Message: rnd(4): tweak markup a bit, consistently use .Li for sysctl vars To generate a diff of this commit: cvs rdiff -u -r1.42 -r1.43 src/share/man/man4/rnd.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: riastradh Date: Tue Aug 27 11:21:02 UTC 2024 Modified Files: src/share/man/man4: rnd.4 Log Message: rnd(4): Document kern.entropy.epoch is unprivileged and elaborate. Cross-reference acpivmgenid(4). PR kern/58632: getentropy(2) and arc4random(3) do not reseed on VM fork To generate a diff of this commit: cvs rdiff -u -r1.41 -r1.42 src/share/man/man4/rnd.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/rnd.4 diff -u src/share/man/man4/rnd.4:1.41 src/share/man/man4/rnd.4:1.42 --- src/share/man/man4/rnd.4:1.41 Mon Aug 7 06:27:37 2023 +++ src/share/man/man4/rnd.4 Tue Aug 27 11:21:02 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: rnd.4,v 1.41 2023/08/07 06:27:37 riastradh Exp $ +.\" $NetBSD: rnd.4,v 1.42 2024/08/27 11:21:02 riastradh Exp $ .\" .\" Copyright (c) 2014-2020 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -457,18 +457,37 @@ Number of bits of entropy pending in per This is the amount of entropy that will be contributed to the global pool at the next consolidation, such as from triggering .Dv kern.entropy.consolidate . +.El +.Pp +The following read-only +.Xr sysctl 8 +variables provide information to any users, privileged or unprivileged: +.Bl -tag -width abcd .It Dv kern.entropy.epoch Pq Vt unsigned int -Number of times system has reached full entropy, or entropy has been -consolidated with -.Dv kern.entropy.consolidate , -as an unsigned 32-bit integer. -Consulted inside the kernel by subsystems such as -.Xr cprng 9 +An integer that changes whenever the system determines applications +should reseed from the system entropy pool. +This can happen for various reasons: +.Bl -dash -compact +.It +The system has reached full entropy for the first time. +.It +A virtual machine clone has been detected +.Pq e.g., by Xr acpivmgenid 4 . +.It +An operator has set +.Li kern.entropy.consolidate . +.El +.Pp +Consulted by +.Xr arc4random 3 , +and inside the kernel by subsystems such as +.Xr cprng 9 , to decide whether to reseed. +.Pp Initially set to 2^32 \- 1 .Pq i.e., Li "(unsigned)\-1" -meaning the system has never reached full entropy and the entropy has -never been consolidated; never again set to 2^32 \- 1. +meaning the system has never reached full entropy; never again set to +2^32 \- 1. Never zero, so applications can initialize a cache of the epoch to zero to ensure they reseed the next time they check whether it is different from the stored epoch. @@ -625,6 +644,7 @@ The system has full entropy for the firs .\" .Sh SEE ALSO .Xr arc4random 3 , +.Xr acpivmgenid 4 , .Xr entropy 7 , .Xr rndctl 8 , .Xr cprng 9 ,
CVS commit: src/share/man/man4
Module Name:src Committed By: riastradh Date: Tue Aug 27 11:21:02 UTC 2024 Modified Files: src/share/man/man4: rnd.4 Log Message: rnd(4): Document kern.entropy.epoch is unprivileged and elaborate. Cross-reference acpivmgenid(4). PR kern/58632: getentropy(2) and arc4random(3) do not reseed on VM fork To generate a diff of this commit: cvs rdiff -u -r1.41 -r1.42 src/share/man/man4/rnd.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: riastradh Date: Mon Aug 26 15:28:58 UTC 2024 Modified Files: src/share/man/man4: acpivmgenid.4 Log Message: acpivmgenid(4): Nix BUGS that have been squashed. Reference kern.entropy.epoch for the remaining bug (which is a performance issue, not a security issue). PR kern/58632: getentropy(2) and arc4random(3) do not reseed on VM fork To generate a diff of this commit: cvs rdiff -u -r1.1 -r1.2 src/share/man/man4/acpivmgenid.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/acpivmgenid.4 diff -u src/share/man/man4/acpivmgenid.4:1.1 src/share/man/man4/acpivmgenid.4:1.2 --- src/share/man/man4/acpivmgenid.4:1.1 Mon Aug 26 13:38:28 2024 +++ src/share/man/man4/acpivmgenid.4 Mon Aug 26 15:28:58 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: acpivmgenid.4,v 1.1 2024/08/26 13:38:28 riastradh Exp $ +.\" $NetBSD: acpivmgenid.4,v 1.2 2024/08/26 15:28:58 riastradh Exp $ .\" .\" Copyright (c) 2024 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -57,7 +57,12 @@ will reseed system random number generat .Pa /dev/urandom and .Xr getentropy 3 -will be independent in the two clones. +will be independent in the two clones, and the +.Xr sysctl 7 +variable +.Li kern.entropy.epoch +will advance to notify applications that they should reseed random +number generators from the system entropy pool. .\" .Sh SYSCTLS The following @@ -94,19 +99,10 @@ driver first appeared in .Nx 11.0 . .\" .Sh BUGS -Currently -.Nx -does not request fresh samples from all on-demand entropy sources when -the VM generation ID changes, so although the outputs of the system -entropy pool appear independent to an outside observer, disclosing the -kernel memory of one VM clone to an adversary may allow the adversary -to predict another VM clone's -.Pa /dev/urandom -outputs. -.Pp -Currently -.Xr arc4random 3 -is not reseeded when the VM generation ID changes. -.Pp Currently there is no cheaper way to detect VM generation ID changes than to query sysctl. +(Applications deciding whether to reseed random number generators +should generally query +.Li kern.entropy.epoch , +not +.Li "hw.acpivmgenid" Ns Va N Ns Li ".id" . )
CVS commit: src/share/man/man4
Module Name:src Committed By: riastradh Date: Mon Aug 26 15:28:58 UTC 2024 Modified Files: src/share/man/man4: acpivmgenid.4 Log Message: acpivmgenid(4): Nix BUGS that have been squashed. Reference kern.entropy.epoch for the remaining bug (which is a performance issue, not a security issue). PR kern/58632: getentropy(2) and arc4random(3) do not reseed on VM fork To generate a diff of this commit: cvs rdiff -u -r1.1 -r1.2 src/share/man/man4/acpivmgenid.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: wiz Date: Fri Aug 2 21:53:23 UTC 2024 Modified Files: src/share/man/man4: igc.4 Log Message: Fix typo in email. To generate a diff of this commit: cvs rdiff -u -r1.1 -r1.2 src/share/man/man4/igc.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: wiz Date: Fri Aug 2 21:53:23 UTC 2024 Modified Files: src/share/man/man4: igc.4 Log Message: Fix typo in email. To generate a diff of this commit: cvs rdiff -u -r1.1 -r1.2 src/share/man/man4/igc.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/igc.4 diff -u src/share/man/man4/igc.4:1.1 src/share/man/man4/igc.4:1.2 --- src/share/man/man4/igc.4:1.1 Wed Oct 4 07:51:36 2023 +++ src/share/man/man4/igc.4 Fri Aug 2 21:53:23 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: igc.4,v 1.1 2023/10/04 07:51:36 rin Exp $ +.\" $NetBSD: igc.4,v 1.2 2024/08/02 21:53:23 wiz Exp $ .\" $OpenBSD: igc.4,v 1.3 2023/03/31 13:48:34 jmc Exp $ .\" .\" Copyright (c) 2021 Patrick Wildt @@ -54,7 +54,7 @@ by It was ported to .Nx by -.An Kengo Nakahara Aq Mt knakar...@netbsd.org , +.An Kengo Nakahara Aq Mt knakah...@netbsd.org , .An Rin Okuyama Aq Mt r...@netbsd.org , and .An Masanobu SAITOH Aq Mt msai...@netbsd.org .
CVS commit: src/share/man/man4/man4.mac68k
Module Name:src Committed By: uwe Date: Thu Aug 1 14:59:38 UTC 2024 Modified Files: src/share/man/man4/man4.mac68k: ascaudio.4 Log Message: ascaudio(4): brush up markup To generate a diff of this commit: cvs rdiff -u -r1.1 -r1.2 src/share/man/man4/man4.mac68k/ascaudio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4/man4.mac68k
Module Name:src Committed By: uwe Date: Thu Aug 1 14:59:38 UTC 2024 Modified Files: src/share/man/man4/man4.mac68k: ascaudio.4 Log Message: ascaudio(4): brush up markup To generate a diff of this commit: cvs rdiff -u -r1.1 -r1.2 src/share/man/man4/man4.mac68k/ascaudio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/man4.mac68k/ascaudio.4 diff -u src/share/man/man4/man4.mac68k/ascaudio.4:1.1 src/share/man/man4/man4.mac68k/ascaudio.4:1.2 --- src/share/man/man4/man4.mac68k/ascaudio.4:1.1 Thu Aug 1 13:41:14 2024 +++ src/share/man/man4/man4.mac68k/ascaudio.4 Thu Aug 1 14:59:38 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ascaudio.4,v 1.1 2024/08/01 13:41:14 nat Exp $ +.\" $NetBSD: ascaudio.4,v 1.2 2024/08/01 14:59:38 uwe Exp $ .\" Copyright (c) 2024 Nathanial Sloss .\" All rights reserved. .\" @@ -28,12 +28,14 @@ .Os .Sh NAME .Nm ascaudio -.Nd MAC68K Apple Sound Chip (ASC) built-in audio. +.Nd MAC68K Apple Sound Chip +.Pq Tn ASC +built-in audio. .Sh SYNOPSIS -.Cd ascaudio* at obio? flags 0x00 -.Cd audio* at audiobus? -.Cd spkr* at audio? -.Cd wsbell* at spkr? +.Cd ascaudio* at obio? flags 0x00 +.Cd audio* at audiobus? +.Cd spkr* at audio? +.Cd wsbell* at spkr? .Sh DESCRIPTION .Nm provides an audio device for the (Enchanced) Apple Sound Chip. @@ -49,14 +51,15 @@ for use in .Xr config 1 files: .Pp -.Bl -tag -compact -width "quality:" -.It 0x0 (DEFQUALTY) : -22257Hz Monaural playback. -.It 0x1 (LOWQUALITY) : +.Bl -tag -offset indent -width Dv +.It Li 0x0 Pq Dv DEFQUALTY : +22257\^Hz Monaural playback. +.It Li 0x1 Pq Dv LOWQUALITY : Half playback rate. Monoaural, intended for machines with slower clock rates. -.It 0x2 (HIGHQUALITY) : -Best Quality supported by ASC. +.It Li 0x2 Pq Dv HIGHQUALITY : +Best Quality supported by +.Tn ASC . This would be stereo on equipped machines. .El .\"
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Thu Aug 1 09:38:50 UTC 2024 Modified Files: src/share/man/man4: virtio.4 Log Message: virtio(4): add viocon to yet another list of devices While here, add the reference to the VirtIO 1.0 spec. PR kern/58533 To generate a diff of this commit: cvs rdiff -u -r1.10 -r1.11 src/share/man/man4/virtio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/virtio.4 diff -u src/share/man/man4/virtio.4:1.10 src/share/man/man4/virtio.4:1.11 --- src/share/man/man4/virtio.4:1.10 Thu Aug 1 09:24:31 2024 +++ src/share/man/man4/virtio.4 Thu Aug 1 09:38:50 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: virtio.4,v 1.10 2024/08/01 09:24:31 uwe Exp $ +.\" $NetBSD: virtio.4,v 1.11 2024/08/01 09:38:50 uwe Exp $ .\" .\" Copyright (c) 2011 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -51,9 +51,12 @@ available to the virtual machine. .Nm driver itself provides the core infrastructure to communicate with the hypervisor (called virtqueues) and supports the following devices: -.Bl -tag -width x +.Pp +.Bl -tag -width Xr -compact .It Xr ld 4 A Disk device. +.It Xr viocon 4 +Console device. .It Xr vioif 4 An Ethernet device. .It Xr viomb 4 @@ -77,6 +80,10 @@ A SCSI adapter. .%T Virtio PCI Card Specification .%U http://ozlabs.org/~rusty/virtio-spec/ .Re +.Rs +.%T Virtual I/O Device (VIRTIO) Version 1.0 +.%U https://docs.oasis-open.org/virtio/virtio/v1.0/virtio-v1.0.html +.Re .Sh HISTORY The .Nm
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Thu Aug 1 09:38:50 UTC 2024 Modified Files: src/share/man/man4: virtio.4 Log Message: virtio(4): add viocon to yet another list of devices While here, add the reference to the VirtIO 1.0 spec. PR kern/58533 To generate a diff of this commit: cvs rdiff -u -r1.10 -r1.11 src/share/man/man4/virtio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Thu Aug 1 09:24:31 UTC 2024 Modified Files: src/share/man/man4: virtio.4 Log Message: virtio(4): add references to viocon (PR kern/58533) To generate a diff of this commit: cvs rdiff -u -r1.9 -r1.10 src/share/man/man4/virtio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/virtio.4 diff -u src/share/man/man4/virtio.4:1.9 src/share/man/man4/virtio.4:1.10 --- src/share/man/man4/virtio.4:1.9 Thu Jun 7 12:32:26 2018 +++ src/share/man/man4/virtio.4 Thu Aug 1 09:24:31 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: virtio.4,v 1.9 2018/06/07 12:32:26 jakllsch Exp $ +.\" $NetBSD: virtio.4,v 1.10 2024/08/01 09:24:31 uwe Exp $ .\" .\" Copyright (c) 2011 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -34,6 +34,7 @@ .Cd "virtio* at fdt?" .Cd "virtio* at pci? dev ? function ?" .Cd "ld* at virtio?" +.Cd "viocon* at virtio?" .Cd "vioif* at virtio?" .Cd "viomb* at virtio?" .Cd "viornd* at virtio?" @@ -65,6 +66,7 @@ A SCSI adapter. .Sh SEE ALSO .Xr ld 4 , .Xr pci 4 , +.Xr viocon 4 , .Xr vioif 4 , .Xr viomb 4 , .Xr viornd 4 ,
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Thu Aug 1 09:24:31 UTC 2024 Modified Files: src/share/man/man4: virtio.4 Log Message: virtio(4): add references to viocon (PR kern/58533) To generate a diff of this commit: cvs rdiff -u -r1.9 -r1.10 src/share/man/man4/virtio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: brad Date: Mon Jul 29 20:12:58 UTC 2024 Modified Files: src/share/man/man4: sht4xtemp.4 Log Message: Fix a typo in the man page. To generate a diff of this commit: cvs rdiff -u -r1.2 -r1.3 src/share/man/man4/sht4xtemp.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/sht4xtemp.4 diff -u src/share/man/man4/sht4xtemp.4:1.2 src/share/man/man4/sht4xtemp.4:1.3 --- src/share/man/man4/sht4xtemp.4:1.2 Sun Oct 3 18:20:13 2021 +++ src/share/man/man4/sht4xtemp.4 Mon Jul 29 20:12:58 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: sht4xtemp.4,v 1.2 2021/10/03 18:20:13 wiz Exp $ +.\" $NetBSD: sht4xtemp.4,v 1.3 2024/07/29 20:12:58 brad Exp $ .\" .\" Copyright (c) 2021 Brad Spencer .\" @@ -68,7 +68,7 @@ Use one of the strings listed in .Li hw.sht4xtemp.heaterpulses . .It Li hw.sht4xtemp0.debug If the driver is compiled with -.Dv SI70XX_DEBUG , +.Dv SHT4X_DEBUG , this node will appear and can be used to set the debugging level. .It Li hw.sht4xtemp0.readattempts To read %RH or temperature the chip requires that the command be sent,
CVS commit: src/share/man/man4
Module Name:src Committed By: brad Date: Mon Jul 29 20:12:58 UTC 2024 Modified Files: src/share/man/man4: sht4xtemp.4 Log Message: Fix a typo in the man page. To generate a diff of this commit: cvs rdiff -u -r1.2 -r1.3 src/share/man/man4/sht4xtemp.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Mon Jul 29 14:09:17 UTC 2024 Modified Files: src/share/man/man4: mainbus.4 Log Message: mainbus(4): brush up markup, sort SEE ALSO To generate a diff of this commit: cvs rdiff -u -r1.7 -r1.8 src/share/man/man4/mainbus.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/mainbus.4 diff -u src/share/man/man4/mainbus.4:1.7 src/share/man/man4/mainbus.4:1.8 --- src/share/man/man4/mainbus.4:1.7 Mon Jul 29 11:42:48 2024 +++ src/share/man/man4/mainbus.4 Mon Jul 29 14:09:16 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: mainbus.4,v 1.7 2024/07/29 11:42:48 bad Exp $ +.\" $NetBSD: mainbus.4,v 1.8 2024/07/29 14:09:16 uwe Exp $ .\" .\" Copyright (c) 2000 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -32,16 +32,17 @@ .Os .Sh NAME .Nm mainbus -.Nd pseudo top level "bus" +.Nd top level pseudo +.Dq bus .Sh SYNOPSIS -.Cd "mainbus0 at root" -.Cd "XX at mainbus0" +.Cd mainbus0 at root +.Ar instance Cd at mainbus0 .Sh DESCRIPTION The .Nm is not a real bus, but serves as the top level device to which other busses and drivers attach. .Sh SEE ALSO -.Xr config 1 , -.Xr autoconf 9 , -.Xr intro 4 +.Xr intro 4 , +.Xr config 5 , +.Xr autoconf 9 .
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Mon Jul 29 14:09:17 UTC 2024 Modified Files: src/share/man/man4: mainbus.4 Log Message: mainbus(4): brush up markup, sort SEE ALSO To generate a diff of this commit: cvs rdiff -u -r1.7 -r1.8 src/share/man/man4/mainbus.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: bad Date: Mon Jul 29 11:42:49 UTC 2024 Modified Files: src/share/man/man4: mainbus.4 Log Message: correctly reference mainbus(9) To generate a diff of this commit: cvs rdiff -u -r1.6 -r1.7 src/share/man/man4/mainbus.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/mainbus.4 diff -u src/share/man/man4/mainbus.4:1.6 src/share/man/man4/mainbus.4:1.7 --- src/share/man/man4/mainbus.4:1.6 Wed Apr 30 13:10:54 2008 +++ src/share/man/man4/mainbus.4 Mon Jul 29 11:42:48 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: mainbus.4,v 1.6 2008/04/30 13:10:54 martin Exp $ +.\" $NetBSD: mainbus.4,v 1.7 2024/07/29 11:42:48 bad Exp $ .\" .\" Copyright (c) 2000 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -43,5 +43,5 @@ is not a real bus, but serves as the top busses and drivers attach. .Sh SEE ALSO .Xr config 1 , -.Xr autoconf 4 , +.Xr autoconf 9 , .Xr intro 4
CVS commit: src/share/man/man4
Module Name:src Committed By: bad Date: Mon Jul 29 11:42:49 UTC 2024 Modified Files: src/share/man/man4: mainbus.4 Log Message: correctly reference mainbus(9) To generate a diff of this commit: cvs rdiff -u -r1.6 -r1.7 src/share/man/man4/mainbus.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Jul 27 13:14:04 UTC 2024 Modified Files: src/share/man/man4: ksyms.4 Log Message: ksyms(4): untabify one tab missed in previous To generate a diff of this commit: cvs rdiff -u -r1.9 -r1.10 src/share/man/man4/ksyms.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/ksyms.4 diff -u src/share/man/man4/ksyms.4:1.9 src/share/man/man4/ksyms.4:1.10 --- src/share/man/man4/ksyms.4:1.9 Sat Jul 27 13:13:25 2024 +++ src/share/man/man4/ksyms.4 Sat Jul 27 13:14:04 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ksyms.4,v 1.9 2024/07/27 13:13:25 uwe Exp $ +.\" $NetBSD: ksyms.4,v 1.10 2024/07/27 13:14:04 uwe Exp $ .\" .\" Copyright (c) 2003 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -84,7 +84,7 @@ contains the symbol value. Returns the complete symbol for the given symbol name. .Bd -literal -offset indent struct ksyms_gsymbol { - const char *kg_name; +const char *kg_name; void *kg_sym; }; .Ed
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Jul 27 13:14:04 UTC 2024 Modified Files: src/share/man/man4: ksyms.4 Log Message: ksyms(4): untabify one tab missed in previous To generate a diff of this commit: cvs rdiff -u -r1.9 -r1.10 src/share/man/man4/ksyms.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Jul 27 13:13:25 UTC 2024 Modified Files: src/share/man/man4: ksyms.4 Log Message: ksyms(4): brush up markup To generate a diff of this commit: cvs rdiff -u -r1.8 -r1.9 src/share/man/man4/ksyms.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/ksyms.4 diff -u src/share/man/man4/ksyms.4:1.8 src/share/man/man4/ksyms.4:1.9 --- src/share/man/man4/ksyms.4:1.8 Sat Jul 27 11:19:30 2024 +++ src/share/man/man4/ksyms.4 Sat Jul 27 13:13:25 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ksyms.4,v 1.8 2024/07/27 11:19:30 tnn Exp $ +.\" $NetBSD: ksyms.4,v 1.9 2024/07/27 13:13:25 uwe Exp $ .\" .\" Copyright (c) 2003 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -60,27 +60,27 @@ command codes below are defined in The (third) argument to the .Xr ioctl 2 should be a pointer to the type indicated. -.Bl -tag -width indent -offset indent -.It Dv KIOCGSIZE (int) +.Bl -tag -width Dv -offset indent +.It Dv KIOCGSIZE Pq Vt int Returns the total size of the current symbol table. This should be used when allocating a buffer to read in the whole symbol table to memory. -.It Dv KIOCGVALUE (struct ksyms_gvalue) +.It Dv KIOCGVALUE Pq Vt struct ksyms_gvalue Returns the value for the given symbol name in a symtab-independent fashion. .Bd -literal -offset indent struct ksyms_gvalue { - const char *kv_name; - uint64_t kv_value; +const char *kv_name; +uint64_t kv_value; }; .Ed .Pp -The struct element -.Va kv_name +The struct member +.Fa kv_name should be set to the name of the requested value, and upon return -.Va kv_value +.Fa kv_value contains the symbol value. -.It Dv KIOCGSYMBOL (struct ksyms_gsymbol) +.It Dv KIOCGSYMBOL Pq Vt struct ksyms_gsymbol Returns the complete symbol for the given symbol name. .Bd -literal -offset indent struct ksyms_gsymbol { @@ -89,17 +89,17 @@ struct ksyms_gsymbol { }; .Ed .Pp -The struct element -.Va kg_name +The struct member +.Fa kg_name should be set to the name of the requested symbol, and the found symbol will be written to the -.Va kg_sym +.Fa kg_sym address. It is the callers responsibility to ensure that enough space for the symbol is allocated. .El .Sh FILES -.Bl -tag -width /dev/ksymsX +.Bl -tag -width Pa .It Pa /dev/ksyms .El .Sh SEE ALSO
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Jul 27 13:13:25 UTC 2024 Modified Files: src/share/man/man4: ksyms.4 Log Message: ksyms(4): brush up markup To generate a diff of this commit: cvs rdiff -u -r1.8 -r1.9 src/share/man/man4/ksyms.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: tnn Date: Sat Jul 27 11:19:30 UTC 2024 Modified Files: src/share/man/man4: ksyms.4 Log Message: ksyms(4): correct description of KIOCGVALUE ioctl To generate a diff of this commit: cvs rdiff -u -r1.7 -r1.8 src/share/man/man4/ksyms.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/ksyms.4 diff -u src/share/man/man4/ksyms.4:1.7 src/share/man/man4/ksyms.4:1.8 --- src/share/man/man4/ksyms.4:1.7 Mon Mar 22 18:58:31 2010 +++ src/share/man/man4/ksyms.4 Sat Jul 27 11:19:30 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ksyms.4,v 1.7 2010/03/22 18:58:31 joerg Exp $ +.\" $NetBSD: ksyms.4,v 1.8 2024/07/27 11:19:30 tnn Exp $ .\" .\" Copyright (c) 2003 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -24,7 +24,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd November 12, 2008 +.Dd July 27, 2024 .Dt KSYMS 4 .Os .Sh NAME @@ -65,21 +65,21 @@ should be a pointer to the type indicate Returns the total size of the current symbol table. This should be used when allocating a buffer to read in the whole symbol table to memory. -.It Dv KIOCGVALUE (struct ksyms_gsymbol) +.It Dv KIOCGVALUE (struct ksyms_gvalue) Returns the value for the given symbol name in a symtab-independent fashion. .Bd -literal -offset indent -struct ksyms_gsymbol { - const char *kg_name; - unsigned long *kg_value; +struct ksyms_gvalue { + const char *kv_name; + uint64_t kv_value; }; .Ed .Pp The struct element -.Va kg_name -should be set to the name of the requested value, and the address that -.Va kg_value -points to will receive the symbol value. +.Va kv_name +should be set to the name of the requested value, and upon return +.Va kv_value +contains the symbol value. .It Dv KIOCGSYMBOL (struct ksyms_gsymbol) Returns the complete symbol for the given symbol name. .Bd -literal -offset indent
CVS commit: src/share/man/man4
Module Name:src Committed By: tnn Date: Sat Jul 27 11:19:30 UTC 2024 Modified Files: src/share/man/man4: ksyms.4 Log Message: ksyms(4): correct description of KIOCGVALUE ioctl To generate a diff of this commit: cvs rdiff -u -r1.7 -r1.8 src/share/man/man4/ksyms.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: reinoud Date: Fri Jul 5 13:02:56 UTC 2024 Modified Files: src/share/man/man4: options.4 Log Message: Update `file-system UDF' description. Since it now has fsck_udf(4) and it has matured enough to remove the EXPERIMENTAL flag. To generate a diff of this commit: cvs rdiff -u -r1.530 -r1.531 src/share/man/man4/options.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/options.4 diff -u src/share/man/man4/options.4:1.530 src/share/man/man4/options.4:1.531 --- src/share/man/man4/options.4:1.530 Mon May 13 00:06:04 2024 +++ src/share/man/man4/options.4 Fri Jul 5 13:02:55 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: options.4,v 1.530 2024/05/13 00:06:04 msaitoh Exp $ +.\" $NetBSD: options.4,v 1.531 2024/07/05 13:02:55 reinoud Exp $ .\" .\" Copyright (c) 1996 .\" Perry E. Metzger. All rights reserved. @@ -900,15 +900,15 @@ See .Xr mount_procfs 8 for details. .It Cd file-system UDF -.Bq Em EXPERIMENTAL -Includes code for the UDF file system commonly found on CD and DVD -media but also on USB sticks. -Currently supports read and write access up to UDF 2.01 and somewhat limited -write support for UDF 2.50. -It is marked experimental since there is no -.Xr fsck_udf 8 . +Includes code for the UDF file system commonly found on CD and DVD media but +also on USB sticks and harddiscs for interchange and backup. Supports read and +write access for all formats on discs and on rewritable and recordable +CD/DVD/BD media. It has a somewhat limited write support for UDF 2.50 as it +can't expand the metadata partion. See .Xr mount_udf 8 +and +.Xr fsck_udf 8 for details. .It Cd file-system UMAPFS Includes a loopback file system in which user and group IDs may be
CVS commit: src/share/man/man4
Module Name:src Committed By: reinoud Date: Fri Jul 5 13:02:56 UTC 2024 Modified Files: src/share/man/man4: options.4 Log Message: Update `file-system UDF' description. Since it now has fsck_udf(4) and it has matured enough to remove the EXPERIMENTAL flag. To generate a diff of this commit: cvs rdiff -u -r1.530 -r1.531 src/share/man/man4/options.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: rin Date: Sat Jun 29 06:39:34 UTC 2024 Modified Files: src/share/man/man4: ddb.4 Log Message: ddb(4): vax: Clarify how to enter into DDB from console See gencnrint() and kdbrint(). // At last, I can activate DDB on SIMH ;) To generate a diff of this commit: cvs rdiff -u -r1.203 -r1.204 src/share/man/man4/ddb.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/ddb.4 diff -u src/share/man/man4/ddb.4:1.203 src/share/man/man4/ddb.4:1.204 --- src/share/man/man4/ddb.4:1.203 Sun Jul 9 17:10:47 2023 +++ src/share/man/man4/ddb.4 Sat Jun 29 06:39:34 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ddb.4,v 1.203 2023/07/09 17:10:47 riastradh Exp $ +.\" $NetBSD: ddb.4,v 1.204 2024/06/29 06:39:34 rin Exp $ .\" .\" Copyright (c) 1997 - 2019 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -56,7 +56,7 @@ .\" any improvements or extensions that they make and grant Carnegie Mellon .\" the rights to redistribute these changes. .\" -.Dd April 28, 2022 +.Dd June 29, 2024 .Dt DDB 4 .Os .Sh NAME @@ -170,7 +170,7 @@ Abort switch on CPU card. .It "" on serial console. .It vax ---D on serial console. + followed by -D on serial console. .It x68k Interrupt switch on the body. .It xen dom0
CVS commit: src/share/man/man4
Module Name:src Committed By: rin Date: Sat Jun 29 06:39:34 UTC 2024 Modified Files: src/share/man/man4: ddb.4 Log Message: ddb(4): vax: Clarify how to enter into DDB from console See gencnrint() and kdbrint(). // At last, I can activate DDB on SIMH ;) To generate a diff of this commit: cvs rdiff -u -r1.203 -r1.204 src/share/man/man4/ddb.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: andvar Date: Thu Jun 6 21:26:12 UTC 2024 Modified Files: src/share/man/man4: bge.4 Log Message: s/dupex/duplex/ To generate a diff of this commit: cvs rdiff -u -r1.17 -r1.18 src/share/man/man4/bge.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: andvar Date: Thu Jun 6 21:26:12 UTC 2024 Modified Files: src/share/man/man4: bge.4 Log Message: s/dupex/duplex/ To generate a diff of this commit: cvs rdiff -u -r1.17 -r1.18 src/share/man/man4/bge.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/bge.4 diff -u src/share/man/man4/bge.4:1.17 src/share/man/man4/bge.4:1.18 --- src/share/man/man4/bge.4:1.17 Tue Oct 15 13:21:19 2019 +++ src/share/man/man4/bge.4 Thu Jun 6 21:26:12 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: bge.4,v 1.17 2019/10/15 13:21:19 ryoon Exp $ +.\" $NetBSD: bge.4,v 1.18 2024/06/06 21:26:12 andvar Exp $ .\" .\" Copyright (c) 2003 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -187,7 +187,7 @@ Set 1000baseT operation over twisted pai Both .Cm full-duplex and -.Cm half-dupex +.Cm half-duplex modes are supported. .It Cm 1000baseSX Set 1000Mbps (Gigabit Ethernet) operation.
CVS commit: src/share/man/man4
Module Name:src Committed By: nia Date: Mon May 27 02:39:15 UTC 2024 Modified Files: src/share/man/man4: audio.4 Log Message: audio.4: Document how the "delta" affects setting mixer levels. Explicitly say that "delta" is optional and may be zero. While this hasn't previously been specified anywhere (to my knowledge), the best de-facto specification we have (sb and mixerctl source code) points towards the historical practice being there. To generate a diff of this commit: cvs rdiff -u -r1.105 -r1.106 src/share/man/man4/audio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/audio.4 diff -u src/share/man/man4/audio.4:1.105 src/share/man/man4/audio.4:1.106 --- src/share/man/man4/audio.4:1.105 Tue Feb 27 02:14:23 2024 +++ src/share/man/man4/audio.4 Mon May 27 02:39:15 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: audio.4,v 1.105 2024/02/27 02:14:23 gutteridge Exp $ +.\" $NetBSD: audio.4,v 1.106 2024/05/27 02:39:15 nia Exp $ .\" .\" Copyright (c) 1996 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -27,7 +27,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd March 28, 2020 +.Dd May 27, 2024 .Dt AUDIO 4 .Os .Sh NAME @@ -604,11 +604,19 @@ channel. If the channel count does not match the current channel count, the attempt to change the setting may fail (depending on the hardware device driver implementation). +Audio levels may be adjusted in increments of the +.Dv delta +value returned by +.Dv AUDIO_MIXER_DEVINFO . +This field is optional for hardware drivers to specify - devices with a +delta of 0 may allow arbitrary adjustment of levels. +.Pp For an enumeration value, the .Va ord field should be set to one of the possible values as returned by a prior .Dv AUDIO_MIXER_DEVINFO command. +.Pp The type .Dv AUDIO_MIXER_CLASS is only used for classifying particular mixer device
CVS commit: src/share/man/man4
Module Name:src Committed By: nia Date: Mon May 27 02:39:15 UTC 2024 Modified Files: src/share/man/man4: audio.4 Log Message: audio.4: Document how the "delta" affects setting mixer levels. Explicitly say that "delta" is optional and may be zero. While this hasn't previously been specified anywhere (to my knowledge), the best de-facto specification we have (sb and mixerctl source code) points towards the historical practice being there. To generate a diff of this commit: cvs rdiff -u -r1.105 -r1.106 src/share/man/man4/audio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: nia Date: Sun May 26 09:27:20 UTC 2024 Modified Files: src/share/man/man4: urtwn.4 Log Message: urtwn.4: List more supported devices To generate a diff of this commit: cvs rdiff -u -r1.18 -r1.19 src/share/man/man4/urtwn.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/urtwn.4 diff -u src/share/man/man4/urtwn.4:1.18 src/share/man/man4/urtwn.4:1.19 --- src/share/man/man4/urtwn.4:1.18 Wed Jun 2 22:32:29 2021 +++ src/share/man/man4/urtwn.4 Sun May 26 09:27:20 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: urtwn.4,v 1.18 2021/06/02 22:32:29 wiz Exp $ +.\" $NetBSD: urtwn.4,v 1.19 2024/05/26 09:27:20 nia Exp $ .\" $OpenBSD: urtwn.4,v 1.15 2011/11/26 06:39:33 ckuethe Exp $ .\" .\" Copyright (c) 2010 Damien Bergamini @@ -15,7 +15,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd December 17, 2018 +.Dd May 26, 2024 .Dt URTWN 4 .Os .Sh NAME @@ -110,6 +110,7 @@ The following adapters should work: .It B-Link BL-LW05-5R .It Belkin F7D1102 Surf Wireless Micro .It D-Link DWA-121 +.It D-Link DWA-125 .It D-Link DWA-131 .It D-Link DWA-133 .It D-Link DWA-135 @@ -120,6 +121,7 @@ The following adapters should work: .It Full River FR-W100NUL .It Hercules Wireless N USB Pico HWNUp-150 .It IO-DATA WN-G150UMW +.It Mercusys MW150US v2 .It Netgear WNA1000A .It Planex GW-USEco300 .It Planex GW-USNano2 @@ -129,8 +131,12 @@ The following adapters should work: .It Sitecom N300 USB (WLA-2102 v1) .It Sitecom WL-365 .It Solwise NET-WL-UMD-606N +.It TP-LINK TL-WN722N v2 .It TP-LINK TL-WN723N v3 .It TP-LINK TL-WN725N v2 +.It TP-LINK TL-WN821N +.It TP-LINK TL-WN822N v4 +.It TP-LINK TL-WN823N v2 .It TRENDnet TEW-648UBM .El .Sh EXAMPLES
CVS commit: src/share/man/man4
Module Name:src Committed By: nia Date: Sun May 26 09:27:20 UTC 2024 Modified Files: src/share/man/man4: urtwn.4 Log Message: urtwn.4: List more supported devices To generate a diff of this commit: cvs rdiff -u -r1.18 -r1.19 src/share/man/man4/urtwn.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Wed May 22 00:25:56 UTC 2024 Modified Files: src/share/man/man4: uaudio.4 Log Message: uaudio.4: improve markup To generate a diff of this commit: cvs rdiff -u -r1.30 -r1.31 src/share/man/man4/uaudio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/uaudio.4 diff -u src/share/man/man4/uaudio.4:1.30 src/share/man/man4/uaudio.4:1.31 --- src/share/man/man4/uaudio.4:1.30 Tue May 21 10:45:39 2024 +++ src/share/man/man4/uaudio.4 Wed May 22 00:25:56 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: uaudio.4,v 1.30 2024/05/21 10:45:39 nia Exp $ +.\" $NetBSD: uaudio.4,v 1.31 2024/05/22 00:25:56 uwe Exp $ .\" .\" Copyright (c) 1999-2024 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -46,46 +46,63 @@ audio class devices. A .Tn USB audio device consists of a number of components: -input terminals (e.g. USB digital input), output terminals (e.g. -speakers), and a number of units in between (e.g. volume control). +input terminals +.Pq e.g. USB digital input , +output terminals +.Pq e.g. speakers , +and a number of units in between +.Pq e.g. volume control . The following types of units are handled by the .Nm -driver and are accessible via the mixer (see -.Xr audio 4 ) +driver and are accessible via the mixer +.Pq see Xr audio 4 interface: -.Bl -tag -width Dv -offset 3n -compact -.It mixer +.Bl -tag -width Em +.It Em mixer A mixer has a number of inputs and one output. Each input has a control that determines its volume in the output. The name of the control is -.Ar mixN-S , +.Sm off +.Li mix Ar N Li \|- Ar S , +.Sm on where .Ar N is a number that identifies which mixer it is and .Ar S which input. -.It selector +. +.It Em selector A selector unit selects one of multiple audio sources such as mic-in and line-in. The name of the control is -.Ar selN-S1S2S3... , +.Sm off +.Li sel Ar N Li \|- Ar S1S2S3... , +.Sm on where .Ar N is a number that identifies which selector unit it is and the sequence of .Ar Sn indicates candidate units for the audio source. -.It feature +. +.It Em feature A feature unit changes the sound in some way, like bass, treble, mute, or volume. The name of the control is determined in a heuristic way. If the unit changes the sound to a speaker output terminal, -the names of the controls may be outputs.speaker.bass, outputs.speaker.treble, -outputs.speaker.mute, outputs.speaker, or likewise. -.It processing +the names of the controls may be +.Li outputs.speaker.bass , +.Li outputs.speaker.treble , +.Li outputs.speaker.mute , +.Li outputs.speaker , +or likewise. +. +.It Em processing A processing unit does one of a number of audio processing functions -(e.g., channel up-down mixing, Dolby ProLogic, or chorus effects). -The name of the on-off control is -.Ar proN.M-enable , +.Pq e.g., channel up-down mixing, Dolby ProLogic, or chorus effects . +The name of the on\[en]off control is +.Sm off +.Li pro Ar N Li \&. Ar M Li \|-enable , +.Sm on where .Ar N is a number that identifies which processing unit it is and @@ -93,10 +110,13 @@ is a number that identifies which proces which kind. Depending on the type of processing unit there may be other controls as well. -.It extension +. +.It Em extension An extension unit performs some unspecified audio processing -The name of the on-off control is -.Ar extN-enable , +The name of the on\[en]off control is +.Sm off +.Li ext Ar N Li \|-enable , +.Sm on where .Ar N is a number that identifies which processing unit it is.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Wed May 22 00:25:56 UTC 2024 Modified Files: src/share/man/man4: uaudio.4 Log Message: uaudio.4: improve markup To generate a diff of this commit: cvs rdiff -u -r1.30 -r1.31 src/share/man/man4/uaudio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: nia Date: Tue May 21 10:45:39 UTC 2024 Modified Files: src/share/man/man4: uaudio.4 Log Message: uaudio.4: update documentation reflecting initial uac2 support To generate a diff of this commit: cvs rdiff -u -r1.29 -r1.30 src/share/man/man4/uaudio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/uaudio.4 diff -u src/share/man/man4/uaudio.4:1.29 src/share/man/man4/uaudio.4:1.30 --- src/share/man/man4/uaudio.4:1.29 Mon Jan 26 22:47:41 2015 +++ src/share/man/man4/uaudio.4 Tue May 21 10:45:39 2024 @@ -1,6 +1,6 @@ -.\" $NetBSD: uaudio.4,v 1.29 2015/01/26 22:47:41 wiz Exp $ +.\" $NetBSD: uaudio.4,v 1.30 2024/05/21 10:45:39 nia Exp $ .\" -.\" Copyright (c) 1999 The NetBSD Foundation, Inc. +.\" Copyright (c) 1999-2024 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This code is derived from software contributed to The NetBSD Foundation @@ -27,7 +27,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd January 26, 2015 +.Dd May 21, 2024 .Dt UAUDIO 4 .Os .Sh NAME @@ -119,14 +119,9 @@ The driver appeared in .Nx 1.5 . +Support for USB Audio Class 2.0 devices appeared in +.Nx 11.0 . .Sh BUGS -Releases 1.0 and 2.0 of the -.Tn USB -Audio class specification are not mutually compatible. -The -.Nm -driver only supports devices compliant with Release 1.0. -.Pp There is no support for multiple-endpoints audio stream, adaptive recording, async playback, and TYPE-II/III formats. .Pp
CVS commit: src/share/man/man4
Module Name:src Committed By: nia Date: Tue May 21 10:45:39 UTC 2024 Modified Files: src/share/man/man4: uaudio.4 Log Message: uaudio.4: update documentation reflecting initial uac2 support To generate a diff of this commit: cvs rdiff -u -r1.29 -r1.30 src/share/man/man4/uaudio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Re: CVS commit: src/share/man/man4
On Thu, May 16, 2024 at 05:48:05PM +0300, Valery Ushakov wrote: > On Thu, May 16, 2024 at 11:54:20 +, Nia Alarie wrote: > > > Modified Files: > > src/share/man/man4: eap.4 > > > > Log Message: > > Note that EAP_USE_BOTH_DACS is deprecated in the eap(4) manual page. > > Please, can you restore the part that explains what this option > is/does? It might be on its way out, but since we document it's > there, it's a good idea to actually document it, IMHO. > > I don't know much about audio, but the kernel mixer is software, isn't > it. I would imagine the type of systems that might have this device > may actually benefit from the hardware acceleration that this option > seems to imply. > > I.e. if anything, I'd rather this option is documented even better > than it was. Let me know if the new version of the text leaves any doubts.
CVS commit: src/share/man/man4
Module Name:src Committed By: nia Date: Thu May 16 17:00:32 UTC 2024 Modified Files: src/share/man/man4: eap.4 Log Message: add additional details about how EAP_USE_BOTH_DACS works and is used requested by uwe To generate a diff of this commit: cvs rdiff -u -r1.19 -r1.20 src/share/man/man4/eap.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/eap.4 diff -u src/share/man/man4/eap.4:1.19 src/share/man/man4/eap.4:1.20 --- src/share/man/man4/eap.4:1.19 Thu May 16 14:41:03 2024 +++ src/share/man/man4/eap.4 Thu May 16 17:00:31 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: eap.4,v 1.19 2024/05/16 14:41:03 uwe Exp $ +.\" $NetBSD: eap.4,v 1.20 2024/05/16 17:00:31 nia Exp $ .\" .\" Copyright (c) 1999 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -52,7 +52,10 @@ By specifying: .D1 Cd options EAP_USE_BOTH_DACS .Pp a second audio device is attached. -You can use it simply by directing audio output to it. +This can be used for audio output simultaneously with the primary DAC. +You can use it simply by directing audio output to the additional +.Pa /dev/audioX +device associated with it. .Sh SEE ALSO .Xr ac97 4 , .Xr audio 4 , @@ -79,3 +82,13 @@ The .Dv EAP_USE_BOTH_DACS option is rather redundant after the introduction of the in-kernel audio mixer, and may be removed in a future release. +It is possible that it could be used to accelerate mixing streams by +taking advantage of the hardware's features, but currently the +additional (small) overhead of the kernel mixer is impossible to bypass, +since +.Nx +no longer allows userspace software to write directly to audio hardware. +The +.Nm +hardware only features one clock, so generally the second audio device +must be configured in the same way as the first.
CVS commit: src/share/man/man4
Module Name:src Committed By: nia Date: Thu May 16 17:00:32 UTC 2024 Modified Files: src/share/man/man4: eap.4 Log Message: add additional details about how EAP_USE_BOTH_DACS works and is used requested by uwe To generate a diff of this commit: cvs rdiff -u -r1.19 -r1.20 src/share/man/man4/eap.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Re: CVS commit: src/share/man/man4
On Thu, May 16, 2024 at 11:54:20 +, Nia Alarie wrote: > Modified Files: > src/share/man/man4: eap.4 > > Log Message: > Note that EAP_USE_BOTH_DACS is deprecated in the eap(4) manual page. Please, can you restore the part that explains what this option is/does? It might be on its way out, but since we document it's there, it's a good idea to actually document it, IMHO. I don't know much about audio, but the kernel mixer is software, isn't it. I would imagine the type of systems that might have this device may actually benefit from the hardware acceleration that this option seems to imply. I.e. if anything, I'd rather this option is documented even better than it was. -uwe
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Thu May 16 14:41:03 UTC 2024 Modified Files: src/share/man/man4: eap.4 Log Message: eap(4): touch up markup a bit To generate a diff of this commit: cvs rdiff -u -r1.18 -r1.19 src/share/man/man4/eap.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/eap.4 diff -u src/share/man/man4/eap.4:1.18 src/share/man/man4/eap.4:1.19 --- src/share/man/man4/eap.4:1.18 Thu May 16 11:54:19 2024 +++ src/share/man/man4/eap.4 Thu May 16 14:41:03 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: eap.4,v 1.18 2024/05/16 11:54:19 nia Exp $ +.\" $NetBSD: eap.4,v 1.19 2024/05/16 14:41:03 uwe Exp $ .\" .\" Copyright (c) 1999 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -34,11 +34,12 @@ .Nm eap .Nd AudioPCI audio device driver .Sh SYNOPSIS -.Cd "eap* at pci? dev ? function ?" -.Cd "audio* at audiobus?" -.Cd "joy* at eap?" -.Cd "midi* at eap?" +.Cd "eap*at pci? dev ? function ?" .Cd "options EAP_USE_BOTH_DACS" +.Pp +.Cd "audio* at audiobus?" +.Cd "joy*at eap?" +.Cd "midi* at eap?" .Sh DESCRIPTION The .Nm @@ -47,9 +48,8 @@ SoundBlaster PCI series of audio cards. All models based on the ES1370, ES1371, and ES1373 chips are supported. .Pp By specifying: -.Bd -unfilled -offset indent -options EAP_USE_BOTH_DACS -.Ed +.Pp +.D1 Cd options EAP_USE_BOTH_DACS .Pp a second audio device is attached. You can use it simply by directing audio output to it.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Thu May 16 14:41:03 UTC 2024 Modified Files: src/share/man/man4: eap.4 Log Message: eap(4): touch up markup a bit To generate a diff of this commit: cvs rdiff -u -r1.18 -r1.19 src/share/man/man4/eap.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: nia Date: Thu May 16 11:54:20 UTC 2024 Modified Files: src/share/man/man4: eap.4 Log Message: Note that EAP_USE_BOTH_DACS is deprecated in the eap(4) manual page. To generate a diff of this commit: cvs rdiff -u -r1.17 -r1.18 src/share/man/man4/eap.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/eap.4 diff -u src/share/man/man4/eap.4:1.17 src/share/man/man4/eap.4:1.18 --- src/share/man/man4/eap.4:1.17 Wed Apr 30 13:10:53 2008 +++ src/share/man/man4/eap.4 Thu May 16 11:54:19 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: eap.4,v 1.17 2008/04/30 13:10:53 martin Exp $ +.\" $NetBSD: eap.4,v 1.18 2024/05/16 11:54:19 nia Exp $ .\" .\" Copyright (c) 1999 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -27,7 +27,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd July 22, 2006 +.Dd May 16, 2024 .Dt EAP 4 .Os .Sh NAME @@ -53,8 +53,6 @@ options EAP_USE_BOTH_DACS .Pp a second audio device is attached. You can use it simply by directing audio output to it. -This way it is possible for two different programs to use the "same" -audio device simultaneously. .Sh SEE ALSO .Xr ac97 4 , .Xr audio 4 , @@ -76,3 +74,8 @@ This is unlikely to work on PCI busses o There is also a possibility for conflicts with real ISA devices because the PCI bus is probed before ISA. Use with caution. +.Pp +The +.Dv EAP_USE_BOTH_DACS +option is rather redundant after the introduction of the in-kernel audio +mixer, and may be removed in a future release.
CVS commit: src/share/man/man4
Module Name:src Committed By: nia Date: Thu May 16 11:54:20 UTC 2024 Modified Files: src/share/man/man4: eap.4 Log Message: Note that EAP_USE_BOTH_DACS is deprecated in the eap(4) manual page. To generate a diff of this commit: cvs rdiff -u -r1.17 -r1.18 src/share/man/man4/eap.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: msaitoh Date: Mon May 13 00:06:05 UTC 2024 Modified Files: src/share/man/man4: options.4 Log Message: s/withe/with/ To generate a diff of this commit: cvs rdiff -u -r1.529 -r1.530 src/share/man/man4/options.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/options.4 diff -u src/share/man/man4/options.4:1.529 src/share/man/man4/options.4:1.530 --- src/share/man/man4/options.4:1.529 Sat May 11 06:50:23 2024 +++ src/share/man/man4/options.4 Mon May 13 00:06:04 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: options.4,v 1.529 2024/05/11 06:50:23 andvar Exp $ +.\" $NetBSD: options.4,v 1.530 2024/05/13 00:06:04 msaitoh Exp $ .\" .\" Copyright (c) 1996 .\" Perry E. Metzger. All rights reserved. @@ -30,7 +30,7 @@ .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" -.Dd September 3, 2023 +.Dd May 12, 2024 .Dt OPTIONS 4 .Os .Sh NAME @@ -1294,7 +1294,7 @@ for more information. .It Cd options SELFRELOC Make the kernel able to self relocate at bootstrap, so that it can run whatever its load address is. -This is intented to be used withe the +This is intented to be used with the .Ic reloc bootstrap command documented in .Xr x86/boot 8 ,
CVS commit: src/share/man/man4
Module Name:src Committed By: msaitoh Date: Mon May 13 00:06:05 UTC 2024 Modified Files: src/share/man/man4: options.4 Log Message: s/withe/with/ To generate a diff of this commit: cvs rdiff -u -r1.529 -r1.530 src/share/man/man4/options.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4/man4.hp300
Module Name:src Committed By: tsutsui Date: Wed May 1 19:34:19 UTC 2024 Modified Files: src/share/man/man4/man4.hp300: topcat.4 Log Message: Note that 98542 and 98543 variants are also supported by topcat(4). To generate a diff of this commit: cvs rdiff -u -r1.7 -r1.8 src/share/man/man4/man4.hp300/topcat.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/man4.hp300/topcat.4 diff -u src/share/man/man4/man4.hp300/topcat.4:1.7 src/share/man/man4/man4.hp300/topcat.4:1.8 --- src/share/man/man4/man4.hp300/topcat.4:1.7 Wed Feb 9 14:37:56 2011 +++ src/share/man/man4/man4.hp300/topcat.4 Wed May 1 19:34:19 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: topcat.4,v 1.7 2011/02/09 14:37:56 wiz Exp $ +.\" $NetBSD: topcat.4,v 1.8 2024/05/01 19:34:19 tsutsui Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -33,7 +33,7 @@ .\" .\" from: @(#)tc.4 8.1 (Berkeley) 6/9/93 .\" -.Dd February 9, 2011 +.Dd May 1, 2024 .Dt TOPCAT 4 hp300 .Os .Sh NAME @@ -52,7 +52,7 @@ device interface .Sh DESCRIPTION This driver is for the .Tn HP98544 , -98545 and 98547 +98545, 98542, 98543, and 98547 .Dq Topcat and .Tn HP98548 ,
CVS commit: src/share/man/man4/man4.hp300
Module Name:src Committed By: tsutsui Date: Wed May 1 19:34:19 UTC 2024 Modified Files: src/share/man/man4/man4.hp300: topcat.4 Log Message: Note that 98542 and 98543 variants are also supported by topcat(4). To generate a diff of this commit: cvs rdiff -u -r1.7 -r1.8 src/share/man/man4/man4.hp300/topcat.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: andvar Date: Wed May 1 11:22:06 UTC 2024 Modified Files: src/share/man/man4: wm.4 Log Message: Fix typos (nerwork->network, exepense->expense). To generate a diff of this commit: cvs rdiff -u -r1.43 -r1.44 src/share/man/man4/wm.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/wm.4 diff -u src/share/man/man4/wm.4:1.43 src/share/man/man4/wm.4:1.44 --- src/share/man/man4/wm.4:1.43 Sat May 28 00:53:41 2022 +++ src/share/man/man4/wm.4 Wed May 1 11:22:06 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: wm.4,v 1.43 2022/05/28 00:53:41 manu Exp $ +.\" $NetBSD: wm.4,v 1.44 2024/05/01 11:22:06 andvar Exp $ .\" .\" Copyright 2002, 2003 Wasabi Systems, Inc. .\" All rights reserved. @@ -186,12 +186,12 @@ utility configures the adapter to receiv .Sh OPTIONS The driver default behavior is to handle packets in interrupt context, which reduces the CPU time available to user processes when under -heavy nerwork load. The +heavy network load. The .Em hw.wmX.txrx_workqueue .Xr sysctl 8 alters this behavior so that packets are handled by a kernel thread, which executes at a lower priority. This gives user processes more -opportunity to be executed, at the exepense of network throughput. +opportunity to be executed, at the expense of network throughput. .Pp The following options can be set at build time: .Bl -tag -width WM_RX_INTR_PROCESS_LIMIT_DEFAULT -offset 3n
CVS commit: src/share/man/man4
Module Name:src Committed By: andvar Date: Wed May 1 11:22:06 UTC 2024 Modified Files: src/share/man/man4: wm.4 Log Message: Fix typos (nerwork->network, exepense->expense). To generate a diff of this commit: cvs rdiff -u -r1.43 -r1.44 src/share/man/man4/wm.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: christos Date: Sat Apr 27 14:54:58 UTC 2024 Modified Files: src/share/man/man4: thinkpad.4 Log Message: mention that we handle battery controls too. To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/share/man/man4/thinkpad.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: christos Date: Sat Apr 27 14:54:58 UTC 2024 Modified Files: src/share/man/man4: thinkpad.4 Log Message: mention that we handle battery controls too. To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/share/man/man4/thinkpad.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/thinkpad.4 diff -u src/share/man/man4/thinkpad.4:1.4 src/share/man/man4/thinkpad.4:1.5 --- src/share/man/man4/thinkpad.4:1.4 Tue Mar 18 14:20:39 2014 +++ src/share/man/man4/thinkpad.4 Sat Apr 27 10:54:58 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: thinkpad.4,v 1.4 2014/03/18 18:20:39 riastradh Exp $ +.\" $NetBSD: thinkpad.4,v 1.5 2024/04/27 14:54:58 christos Exp $ .\" .\" Copyright (c) 2008 Jared D. McNeill .\" All rights reserved. @@ -24,7 +24,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd June 9, 2010 +.Dd April 27, 2024 .Dt THINKPAD 4 .Os .Sh NAME @@ -36,8 +36,8 @@ The .Nm driver provides support for vendor specific features found in IBM and -Lenovo brand laptops, such as function key handling, hotkey handling, and -temperature and fan monitoring. +Lenovo brand laptops, such as function key handling, hotkey handling, +battery controls, and temperature and fan monitoring. .Sh SEE ALSO .Xr acpi 4 , .Xr aps 4 ,
CVS commit: src/share/man/man4/man4.amiga
Module Name:src Committed By: jandberg Date: Thu Apr 11 13:06:29 UTC 2024 Modified Files: src/share/man/man4/man4.amiga: amidisplaycc.4 Log Message: Mention the 16-color screenmode. To generate a diff of this commit: cvs rdiff -u -r1.16 -r1.17 src/share/man/man4/man4.amiga/amidisplaycc.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/man4.amiga/amidisplaycc.4 diff -u src/share/man/man4/man4.amiga/amidisplaycc.4:1.16 src/share/man/man4/man4.amiga/amidisplaycc.4:1.17 --- src/share/man/man4/man4.amiga/amidisplaycc.4:1.16 Sat Aug 13 17:06:38 2022 +++ src/share/man/man4/man4.amiga/amidisplaycc.4 Thu Apr 11 13:06:29 2024 @@ -22,7 +22,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $NetBSD: amidisplaycc.4,v 1.16 2022/08/13 17:06:38 wiz Exp $ +.\" $NetBSD: amidisplaycc.4,v 1.17 2024/04/11 13:06:29 jandberg Exp $ .Dd November 12, 2003 .Dt AMIDISPLAYCC 4 amiga .Os @@ -88,7 +88,7 @@ utility runtime. The X11 server works using the .Xr wsfb 4 driver. -The driver supports 256 color and monochrome modes. +The driver supports 256 and 16 color modes. .Sh SEE ALSO .Xr wscons 4 , .Xr wsdisplay 4 ,
CVS commit: src/share/man/man4/man4.amiga
Module Name:src Committed By: jandberg Date: Thu Apr 11 13:06:29 UTC 2024 Modified Files: src/share/man/man4/man4.amiga: amidisplaycc.4 Log Message: Mention the 16-color screenmode. To generate a diff of this commit: cvs rdiff -u -r1.16 -r1.17 src/share/man/man4/man4.amiga/amidisplaycc.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Wed Apr 3 00:40:46 UTC 2024 Modified Files: src/share/man/man4: dk.4 Log Message: dk(4): touch up markup, sort options To generate a diff of this commit: cvs rdiff -u -r1.14 -r1.15 src/share/man/man4/dk.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Wed Apr 3 00:40:46 UTC 2024 Modified Files: src/share/man/man4: dk.4 Log Message: dk(4): touch up markup, sort options To generate a diff of this commit: cvs rdiff -u -r1.14 -r1.15 src/share/man/man4/dk.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/dk.4 diff -u src/share/man/man4/dk.4:1.14 src/share/man/man4/dk.4:1.15 --- src/share/man/man4/dk.4:1.14 Tue Apr 2 23:46:19 2024 +++ src/share/man/man4/dk.4 Wed Apr 3 00:40:46 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: dk.4,v 1.14 2024/04/02 23:46:19 charlotte Exp $ +.\" $NetBSD: dk.4,v 1.15 2024/04/03 00:40:46 uwe Exp $ .\" .\" Copyright (c) 2006 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -39,11 +39,11 @@ driver .Sh SYNOPSIS .Cd "options DKWEDGE_AUTODISCOVER" +.Cd "options DKWEDGE_METHOD_APPLE" .Cd "options DKWEDGE_METHOD_BSDLABEL" .Cd "options DKWEDGE_METHOD_GPT" .Cd "options DKWEDGE_METHOD_MBR" .Cd "options DKWEDGE_METHOD_RDB" -.Cd "options DKWEDGE_METHOD_APPLE" .Cd "options DKWEDGE_METHOD_TOS" .Sh DESCRIPTION The @@ -59,79 +59,107 @@ Wedges need to have unique names. If a duplicate name is detected during auto-discovery, that partition is ignored. .Sh KERNEL OPTIONS -.Bl -tag -width DKWEDGE_METHOD_BSDLABEL +.Bl -tag -width Dv +.\" .It Dv DKWEDGE_AUTODISCOVER Automatically detect and configure wedges using any available methods. +For each partition found, a wedge with a corresponding name is created. .Pp Currently only .Dv DKWEDGE_METHOD_GPT and .Dv DKWEDGE_METHOD_APPLE are enabled by default. -.Pp -For each partition found, a wedge with a corresponding name is created. +.\" +.It Dv DKWEDGE_METHOD_APPLE +Apple partition map detection method. +.\" .It Dv DKWEDGE_METHOD_BSDLABEL -BSD disklabel detection method. +.Tn BSD +disklabel detection method. For each configured partition in the .Xr disklabel 5 that is not of type .Dv FS_UNUSED , a wedge is created and named after the -.Va d_packname +.Fa d_packname field followed by -.Sq \&/ +.Ql \&/ and the partition letter -.So a Sc Ns \&.. Ns So p Sc . +.Sm off +.So Li a Sc \&.. So Li p Sc . +.Sm on .Pp When the -.Va d_packname +.Fa d_packname is empty or has the value -.Dq fictitious , +.Ql fictitious , the regular partition names are used as wedge names, i.e. the device name, unit number and partition letter, for example -.Dq wd0a . +.Ql wd0a . +.\" .It Dv DKWEDGE_METHOD_GPT Extensible Firmware Interface Globally Unique Identifier Partition Table -(GPT) detection method. +.Tn ( GPT ) +detection method. .Pp For every GPT partition a wedge is created and named after the partition label. -GPT partitions are UTF-16-encoded, this is converted into UTF-8. +GPT partitions are UTF-16\(enencoded, this is converted into UTF-8. If a partition has no label, its UUID is used instead. +.\" .It Dv DKWEDGE_METHOD_MBR -IBM PC-compatible Master Boot Record (MBR) partitioning detection method, -with support for Extended MBRs. +IBM PC-compatible Master Boot Record +.Tn ( MBR ) +partitioning detection method, with support for Extended MBRs. .Pp For every partition in the MBR a wedge is created and named like a regular partition name, i.e. the device name, unit number and a partition letter, for example -.Dq wd0e . +.Ql wd0e . Primary partitions start with -.Sq e , +.Ql e , extended partitions start with -.Sq i . +.Ql i . +.\" .It Dv DKWEDGE_METHOD_RDB -Amiga Rigid Disk Block (RDB) partitioning detection method. -.It Dv DKWEDGE_METHOD_APPLE -Apple partition map detection method. +Amiga Rigid Disk Block +.Tn ( RDB ) +partitioning detection method. +.\" .It Dv DKWEDGE_METHOD_TOS -Atari's TOS partition map detection method. +Atari's +.Tn TOS +partition map detection method. .Pp For each partition, a wedge is created with a name of the format -.Dq ATARI_{TYPE}_{NUMBER} -where TYPE may either be -.Dq GEM +.Sm off +.Li ATARI_ Bro Ar type Brc Li _ Bro Ar number Brc +.Sm on +where +.Ar type +may either be +.Ql GEM or -.Dq BGM . -The first partition typically corresponds to the C: drive when read on an -actual Atari, the second to D: and so on. Extended partitions (those of type -.Dq XGM ) +.Ql BGM . +The first partition typically corresponds to the +.Ql C: +drive when read on an actual Atari, the second to +.Ql D: +and so on. +Extended partitions +.Pq those of type Ql XGM are not currently supported. .El .Sh FILES -.Bl -tag -width /dev/XXrXdkX -compact -.It Pa /dev/{,r}dk* +.Bl -tag -width Pa -compact +.It Pa /dev/dk* +Block mode +.Nm +device special files. +.It Pa /dev/rdk* +Raw mode .Nm device special files. .El
CVS commit: src/share/man/man4
Module Name:src Committed By: charlotte Date: Tue Apr 2 23:46:20 UTC 2024 Modified Files: src/share/man/man4: dk.4 Log Message: dk.4: Document DKWEDGE_METHOD_TOS To generate a diff of this commit: cvs rdiff -u -r1.13 -r1.14 src/share/man/man4/dk.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/dk.4 diff -u src/share/man/man4/dk.4:1.13 src/share/man/man4/dk.4:1.14 --- src/share/man/man4/dk.4:1.13 Wed Jan 6 18:05:58 2021 +++ src/share/man/man4/dk.4 Tue Apr 2 23:46:19 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: dk.4,v 1.13 2021/01/06 18:05:58 wiz Exp $ +.\" $NetBSD: dk.4,v 1.14 2024/04/02 23:46:19 charlotte Exp $ .\" .\" Copyright (c) 2006 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -29,7 +29,7 @@ .\" .\" Jonathan A. Kollasch used vnd(4) as the template for this man page. .\" -.Dd January 6, 2021 +.Dd April 2, 2024 .Dt DK 4 .Os .Sh NAME @@ -44,6 +44,7 @@ driver .Cd "options DKWEDGE_METHOD_MBR" .Cd "options DKWEDGE_METHOD_RDB" .Cd "options DKWEDGE_METHOD_APPLE" +.Cd "options DKWEDGE_METHOD_TOS" .Sh DESCRIPTION The .Nm @@ -114,6 +115,19 @@ extended partitions start with Amiga Rigid Disk Block (RDB) partitioning detection method. .It Dv DKWEDGE_METHOD_APPLE Apple partition map detection method. +.It Dv DKWEDGE_METHOD_TOS +Atari's TOS partition map detection method. +.Pp +For each partition, a wedge is created with a name of the format +.Dq ATARI_{TYPE}_{NUMBER} +where TYPE may either be +.Dq GEM +or +.Dq BGM . +The first partition typically corresponds to the C: drive when read on an +actual Atari, the second to D: and so on. Extended partitions (those of type +.Dq XGM ) +are not currently supported. .El .Sh FILES .Bl -tag -width /dev/XXrXdkX -compact
CVS commit: src/share/man/man4
Module Name:src Committed By: charlotte Date: Tue Apr 2 23:46:20 UTC 2024 Modified Files: src/share/man/man4: dk.4 Log Message: dk.4: Document DKWEDGE_METHOD_TOS To generate a diff of this commit: cvs rdiff -u -r1.13 -r1.14 src/share/man/man4/dk.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: jdolecek Date: Sun Mar 24 21:27:48 UTC 2024 Modified Files: src/share/man/man4: lagg.4 Log Message: minor spelling fix - 'with' and 'into' To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/share/man/man4/lagg.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/lagg.4 diff -u src/share/man/man4/lagg.4:1.5 src/share/man/man4/lagg.4:1.6 --- src/share/man/man4/lagg.4:1.5 Wed Oct 18 07:59:06 2023 +++ src/share/man/man4/lagg.4 Sun Mar 24 21:27:48 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: lagg.4,v 1.5 2023/10/18 07:59:06 yamaguchi Exp $ +.\" $NetBSD: lagg.4,v 1.6 2024/03/24 21:27:48 jdolecek Exp $ .\" .\" Copyright (c) 2005, 2006 Reyk Floeter .\" @@ -119,7 +119,7 @@ available, the VLAN tag, and the IP sour .It Ic lacp Supports the IEEE 802.1AX (formerly 802.3ad) Link Aggregation Control Protocol (LACP) and the Marker Protocol. -LACP will negotiate a set of aggregable links wit the peer in to a Link +LACP will negotiate a set of aggregable links with the peer into a Link Aggregated Group. The LAG is composed of ports of the different speed, set to full-duplex operation, if
CVS commit: src/share/man/man4
Module Name:src Committed By: jdolecek Date: Sun Mar 24 21:27:48 UTC 2024 Modified Files: src/share/man/man4: lagg.4 Log Message: minor spelling fix - 'with' and 'into' To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/share/man/man4/lagg.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sun Mar 24 00:45:06 UTC 2024 Modified Files: src/share/man/man4: wg.4 Log Message: wg(4): specify 4 space offsets as 4n To generate a diff of this commit: cvs rdiff -u -r1.9 -r1.10 src/share/man/man4/wg.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sun Mar 24 00:45:06 UTC 2024 Modified Files: src/share/man/man4: wg.4 Log Message: wg(4): specify 4 space offsets as 4n To generate a diff of this commit: cvs rdiff -u -r1.9 -r1.10 src/share/man/man4/wg.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/wg.4 diff -u src/share/man/man4/wg.4:1.9 src/share/man/man4/wg.4:1.10 --- src/share/man/man4/wg.4:1.9 Sat Mar 23 21:34:07 2024 +++ src/share/man/man4/wg.4 Sun Mar 24 00:45:06 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: wg.4,v 1.9 2024/03/23 21:34:07 riastradh Exp $ +.\" $NetBSD: wg.4,v 1.10 2024/03/24 00:45:06 uwe Exp $ .\" .\" Copyright (c) 2020 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -74,7 +74,7 @@ endpoint IP address outside the tunnel. .\" .Sh EXAMPLES Typical network topology: -.Bd -literal -offset abcd +.Bd -literal -offset 4n Stationary server: Roaming client: +-++-+ |A||B| @@ -96,7 +96,7 @@ Stationary server: .Ed .Pp Generate key pairs on A and B: -.Bd -literal -offset abcd +.Bd -literal -offset 4n A# (umask 0077; wg-keygen > /etc/wg/wg0) A# wg-keygen --pub < /etc/wg/wg0 > /etc/wg/wg0.pub A# cat /etc/wg/wg0.pub @@ -111,13 +111,13 @@ X7EGm3T3IfodBcyilkaC89j0SH3XD6+/pwvp7Dgp Generate a pre-shared key on A and copy it to B to defend against potential future quantum cryptanalysis (not necessary for functionality): -.Bd -literal -offset abcd +.Bd -literal -offset 4n A# (umask 0077; wg-keygen > /etc/wg/wg0.A-B) .Ed .Pp Configure A to listen on port 1234 and allow connections from B to appear in the 10.2.0.0/24 and fd00:2::/64 subnets: -.Bd -literal -offset abcd +.Bd -literal -offset 4n A# ifconfig wg0 create A# ifconfig wg0 inet 10.2.0.1/24 A# ifconfig wg0 inet6 fd00:2::1/64 @@ -138,7 +138,7 @@ wg0: flags=0x8041 .Pp Configure B to connect to A at 192.0.2.123 on port 1234 and the packets can begin to flow: -.Bd -literal -offset abcd +.Bd -literal -offset 4n B# ifconfig wg0 create B# ifconfig wg0 inet 10.2.0.42/24 B# ifconfig wg0 inet6 fd00:2::42/64
CVS commit: src/share/man/man4
Module Name:src Committed By: riastradh Date: Sat Mar 23 21:34:07 UTC 2024 Modified Files: src/share/man/man4: wg.4 Log Message: wg(4): Fix IPv6 numbering in example diagram. This way it matches the configuration suggested below (which avoids host number zero on the subnet). PR misc/58015 To generate a diff of this commit: cvs rdiff -u -r1.8 -r1.9 src/share/man/man4/wg.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/wg.4 diff -u src/share/man/man4/wg.4:1.8 src/share/man/man4/wg.4:1.9 --- src/share/man/man4/wg.4:1.8 Tue Mar 12 02:28:03 2024 +++ src/share/man/man4/wg.4 Sat Mar 23 21:34:07 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: wg.4,v 1.8 2024/03/12 02:28:03 riastradh Exp $ +.\" $NetBSD: wg.4,v 1.9 2024/03/23 21:34:07 riastradh Exp $ .\" .\" Copyright (c) 2020 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -83,7 +83,7 @@ Stationary server: |[wm0]--internet---[bge0]| |[wg0] port 1234 - - - (tunnel) - - - - - - [wg0]| | 10.2.0.1 | 10.2.0.42 | -| fd00:2::0 | fd00:2::42 | +| fd00:2::1 | fd00:2::42 | | | || | +--[wm1]--+ +-+ +-+ | 10.1.0.1 | VPN 10.2.0.0/24 |
CVS commit: src/share/man/man4
Module Name:src Committed By: riastradh Date: Sat Mar 23 21:34:07 UTC 2024 Modified Files: src/share/man/man4: wg.4 Log Message: wg(4): Fix IPv6 numbering in example diagram. This way it matches the configuration suggested below (which avoids host number zero on the subnet). PR misc/58015 To generate a diff of this commit: cvs rdiff -u -r1.8 -r1.9 src/share/man/man4/wg.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Thu Mar 21 11:17:13 UTC 2024 Modified Files: src/share/man/man4: acpihed.4 Log Message: acpihed(4): fix name in Dt, use Ql To generate a diff of this commit: cvs rdiff -u -r1.1 -r1.2 src/share/man/man4/acpihed.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/acpihed.4 diff -u src/share/man/man4/acpihed.4:1.1 src/share/man/man4/acpihed.4:1.2 --- src/share/man/man4/acpihed.4:1.1 Thu Mar 21 02:36:01 2024 +++ src/share/man/man4/acpihed.4 Thu Mar 21 11:17:13 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: acpihed.4,v 1.1 2024/03/21 02:36:01 riastradh Exp $ +.\" $NetBSD: acpihed.4,v 1.2 2024/03/21 11:17:13 uwe Exp $ .\" .\" Copyright (c) 2024 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -25,7 +25,7 @@ .\" POSSIBILITY OF SUCH DAMAGE. .\" .Dd March 18, 2024 -.Dt APEI 4 +.Dt ACPIHED 4 .Os .\" .Sh NAME @@ -38,8 +38,11 @@ .Sh DESCRIPTION Certain hardware error sources that can be queried by .Xr apei 4 -notify an ACPI node with PNP ID -.Sq Li PNP0C33 +notify an +.Tn ACPI +node with +.Tn PNP ID +.Ql PNP0C33 when an error occurs. The .Nm
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Thu Mar 21 11:17:13 UTC 2024 Modified Files: src/share/man/man4: acpihed.4 Log Message: acpihed(4): fix name in Dt, use Ql To generate a diff of this commit: cvs rdiff -u -r1.1 -r1.2 src/share/man/man4/acpihed.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: gutteridge Date: Mon Mar 18 22:47:20 UTC 2024 Modified Files: src/share/man/man4: ipsec.4 Log Message: ipsec.4: minor grammatical improvements To generate a diff of this commit: cvs rdiff -u -r1.45 -r1.46 src/share/man/man4/ipsec.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/ipsec.4 diff -u src/share/man/man4/ipsec.4:1.45 src/share/man/man4/ipsec.4:1.46 --- src/share/man/man4/ipsec.4:1.45 Fri Jun 15 23:13:19 2018 +++ src/share/man/man4/ipsec.4 Mon Mar 18 22:47:19 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ipsec.4,v 1.45 2018/06/15 23:13:19 wiz Exp $ +.\" $NetBSD: ipsec.4,v 1.46 2024/03/18 22:47:19 gutteridge Exp $ .\" $KAME: ipsec.4,v 1.17 2001/06/27 15:25:10 itojun Exp $ .\" .\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project. @@ -38,7 +38,7 @@ .Cd "options IPSEC" .Cd "options IPSEC_DEBUG" .Sh DESCRIPTION -This manual pages describes the IPsec protocol. +This manual page describes the IPsec protocol. For the network device driver please see .Xr ipsecif 4 . .Pp @@ -374,15 +374,14 @@ so for the receiving kernel there's no s The issue will be solved when we revamp our policy engine to keep all the packet decapsulation history. .Pp -Under certain condition, -truncated result may be raised from the kernel +Under certain conditions, truncated results may be raised from the kernel against .Dv SADB_DUMP and .Dv SADB_SPDDUMP -operation on +operations on .Dv PF_KEY -socket. +sockets. This occurs if there are too many database entries in the kernel and socket buffer for the .Dv PF_KEY
CVS commit: src/share/man/man4
Module Name:src Committed By: gutteridge Date: Mon Mar 18 22:47:20 UTC 2024 Modified Files: src/share/man/man4: ipsec.4 Log Message: ipsec.4: minor grammatical improvements To generate a diff of this commit: cvs rdiff -u -r1.45 -r1.46 src/share/man/man4/ipsec.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: pgoyette Date: Thu Mar 14 15:19:03 UTC 2024 Modified Files: src/share/man/man4: ihidev.4 Log Message: Be a bit more clear about which devices are being handled. To generate a diff of this commit: cvs rdiff -u -r1.3 -r1.4 src/share/man/man4/ihidev.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/ihidev.4 diff -u src/share/man/man4/ihidev.4:1.3 src/share/man/man4/ihidev.4:1.4 --- src/share/man/man4/ihidev.4:1.3 Sat Oct 5 06:28:50 2019 +++ src/share/man/man4/ihidev.4 Thu Mar 14 15:19:03 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ihidev.4,v 1.3 2019/10/05 06:28:50 ryoon Exp $ +.\" $NetBSD: ihidev.4,v 1.4 2024/03/14 15:19:03 pgoyette Exp $ .\" .\" Copyright (c) 2001,2017 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -39,7 +39,7 @@ .Sh DESCRIPTION The .Nm -driver handles all Human Interface Devices. +driver handles all Human Interface Devices attached via I2C bus. Each HID device can have several components, e.g., a keyboard and a mouse. These components use different report identifiers (a byte)
CVS commit: src/share/man/man4
Module Name:src Committed By: pgoyette Date: Thu Mar 14 15:19:03 UTC 2024 Modified Files: src/share/man/man4: ihidev.4 Log Message: Be a bit more clear about which devices are being handled. To generate a diff of this commit: cvs rdiff -u -r1.3 -r1.4 src/share/man/man4/ihidev.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: riastradh Date: Tue Mar 12 02:28:03 UTC 2024 Modified Files: src/share/man/man4: wg.4 Log Message: wg(4): Rework example numbering for clarity and add IPv6. Let's avoid triggering unease with host number 0. PR misc/58015 To generate a diff of this commit: cvs rdiff -u -r1.7 -r1.8 src/share/man/man4/wg.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/wg.4 diff -u src/share/man/man4/wg.4:1.7 src/share/man/man4/wg.4:1.8 --- src/share/man/man4/wg.4:1.7 Sat Mar 9 12:36:07 2024 +++ src/share/man/man4/wg.4 Tue Mar 12 02:28:03 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: wg.4,v 1.7 2024/03/09 12:36:07 riastradh Exp $ +.\" $NetBSD: wg.4,v 1.8 2024/03/12 02:28:03 riastradh Exp $ .\" .\" Copyright (c) 2020 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -75,21 +75,23 @@ endpoint IP address outside the tunnel. .Sh EXAMPLES Typical network topology: .Bd -literal -offset abcd -wm0 = 192.0.2.123 bge0 = 198.51.100.45 - Stationary server: Roaming client: +-++-+ |A||B| |-||-| -|[wm0]-internet[bge0]| +| | 192.0.2.123 198.51.100.45 | | +|[wm0]--internet---[bge0]| |[wg0] port 1234 - - - (tunnel) - - - - - - [wg0]| -| 10.0.1.0 | 10.0.1.1 | +| 10.2.0.1 | 10.2.0.42 | +| fd00:2::0 | fd00:2::42 | | | || | +--[wm1]--+ +-+ +-+ - | | VPN 10.0.1.0/24 | + | 10.1.0.1 | VPN 10.2.0.0/24 | + | | fd00:2::/64 | | +-+ +-+ -| LAN 10.0.0.0/24 | +| LAN 10.1.0.0/24 | +| fd00:1::/64 | +-+ .Ed .Pp @@ -114,40 +116,52 @@ A# (umask 0077; wg-keygen > /etc/wg/wg0. .Ed .Pp Configure A to listen on port 1234 and allow connections from B to -appear in the 10.0.1.0/24 subnet: +appear in the 10.2.0.0/24 and fd00:2::/64 subnets: .Bd -literal -offset abcd -A# ifconfig wg0 create 10.0.1.0/24 +A# ifconfig wg0 create +A# ifconfig wg0 inet 10.2.0.1/24 +A# ifconfig wg0 inet6 fd00:2::1/64 A# wgconfig wg0 set private-key /etc/wg/wg0 A# wgconfig wg0 set listen-port 1234 A# wgconfig wg0 add peer B \e X7EGm3T3IfodBcyilkaC89j0SH3XD6+/pwvp7Dgp5SU= \e --preshared-key=/etc/wg/wg0.A-B \e ---allowed-ips=10.0.1.1/32 +--allowed-ips=10.2.0.42/32,fd00:2::42/128 A# ifconfig wg0 up A# ifconfig wg0 wg0: flags=0x8041 mtu 1420 -inet 10.0.1.0/24 flags 0 +status: active inet6 fe80::22f7:d6ff:fe3a:1e60%wg0/64 flags 0 scopeid 0x3 +inet6 fd00:2::1/64 flags 0 +inet 10.2.0.1/24 flags 0 .Ed .Pp Configure B to connect to A at 192.0.2.123 on port 1234 and the packets can begin to flow: .Bd -literal -offset abcd -B# ifconfig wg0 create 10.0.1.1/24 +B# ifconfig wg0 create +B# ifconfig wg0 inet 10.2.0.42/24 +B# ifconfig wg0 inet6 fd00:2::42/64 B# wgconfig wg0 set private-key /etc/wg/wg0 B# wgconfig wg0 add peer A \e N+B4Nelg+4ysvbLW3qenxIwrJVE9MdjMyqrIisH7V0Y= \e --preshared-key=/etc/wg/wg0.A-B \e ---allowed-ips=10.0.1.0/32 \e +--allowed-ips=10.2.0.1/32,fd00:2::1/128 \e --endpoint=192.0.2.123:1234 B# ifconfig wg0 up B# ifconfig wg0 wg0: flags=0x8041 mtu 1420 -inet 10.0.1.1/24 flags 0 +status: active inet6 fe80::56eb:59ff:fe3d:d413%wg0/64 flags 0 scopeid 0x3 -B# ping -n 10.0.1.0 -PING 10.0.1.0 (10.0.1.0): 56 data bytes -64 bytes from 10.0.1.0: icmp_seq=0 ttl=255 time=2.721110 ms +inet6 fd00:2::42/64 flags 0 +inet 10.2.0.42/24 flags 0 +B# ping -n 10.2.0.1 +PING 10.2.0.1 (10.2.0.1): 56 data bytes +64 bytes from 10.2.0.1: icmp_seq=0 ttl=255 time=2.721110 ms +\&... +B# ping6 -n fd00:2::1 +PING6(56=40+8+8 bytes) fd00:2::42 --> fd00:2::1 +16 bytes from fd00:2::1, icmp_seq=0 hlim=64 time=2.634 ms \&... .Ed .\"
CVS commit: src/share/man/man4
Module Name:src Committed By: riastradh Date: Tue Mar 12 02:28:03 UTC 2024 Modified Files: src/share/man/man4: wg.4 Log Message: wg(4): Rework example numbering for clarity and add IPv6. Let's avoid triggering unease with host number 0. PR misc/58015 To generate a diff of this commit: cvs rdiff -u -r1.7 -r1.8 src/share/man/man4/wg.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: riastradh Date: Sat Mar 9 12:36:07 UTC 2024 Modified Files: src/share/man/man4: wg.4 Log Message: wg(4): Spruce up example a bit. - Suggest umask so the private keys aren't world readable. - Suggest use of pre-shared key files. - Use TEST-NET-1 and TEST-NET-2 addresses for the example instead of real publicly routable addresses. Holding off on adding IPv6 example until the tun(4) issue is fixed (PR bin/58013). PR misc/58015 To generate a diff of this commit: cvs rdiff -u -r1.6 -r1.7 src/share/man/man4/wg.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/wg.4 diff -u src/share/man/man4/wg.4:1.6 src/share/man/man4/wg.4:1.7 --- src/share/man/man4/wg.4:1.6 Mon Aug 31 20:20:22 2020 +++ src/share/man/man4/wg.4 Sat Mar 9 12:36:07 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: wg.4,v 1.6 2020/08/31 20:20:22 riastradh Exp $ +.\" $NetBSD: wg.4,v 1.7 2024/03/09 12:36:07 riastradh Exp $ .\" .\" Copyright (c) 2020 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -75,7 +75,7 @@ endpoint IP address outside the tunnel. .Sh EXAMPLES Typical network topology: .Bd -literal -offset abcd -wm0 = 1.2.3.4 bge0 = 4.3.2.1 +wm0 = 192.0.2.123 bge0 = 198.51.100.45 Stationary server: Roaming client: +-++-+ @@ -95,17 +95,24 @@ Stationary server: .Pp Generate key pairs on A and B: .Bd -literal -offset abcd -A# wg-keygen > /etc/wg/wg0 +A# (umask 0077; wg-keygen > /etc/wg/wg0) A# wg-keygen --pub < /etc/wg/wg0 > /etc/wg/wg0.pub A# cat /etc/wg/wg0.pub N+B4Nelg+4ysvbLW3qenxIwrJVE9MdjMyqrIisH7V0Y= -B# wg-keygen > /etc/wg/wg0 +B# (umask 0077; wg-keygen > /etc/wg/wg0) B# wg-keygen --pub < /etc/wg/wg0 > /etc/wg/wg0.pub B# cat /etc/wg/wg0.pub X7EGm3T3IfodBcyilkaC89j0SH3XD6+/pwvp7Dgp5SU= .Ed .Pp +Generate a pre-shared key on A and copy it to B to defend against +potential future quantum cryptanalysis (not necessary for +functionality): +.Bd -literal -offset abcd +A# (umask 0077; wg-keygen > /etc/wg/wg0.A-B) +.Ed +.Pp Configure A to listen on port 1234 and allow connections from B to appear in the 10.0.1.0/24 subnet: .Bd -literal -offset abcd @@ -114,6 +121,7 @@ A# wgconfig wg0 set private-key /etc/wg/ A# wgconfig wg0 set listen-port 1234 A# wgconfig wg0 add peer B \e X7EGm3T3IfodBcyilkaC89j0SH3XD6+/pwvp7Dgp5SU= \e +--preshared-key=/etc/wg/wg0.A-B \e --allowed-ips=10.0.1.1/32 A# ifconfig wg0 up A# ifconfig wg0 @@ -122,15 +130,16 @@ wg0: flags=0x8041 inet6 fe80::22f7:d6ff:fe3a:1e60%wg0/64 flags 0 scopeid 0x3 .Ed .Pp -Configure B to connect to A at 1.2.3.4 on port 1234 and the packets can -begin to flow: +Configure B to connect to A at 192.0.2.123 on port 1234 and the packets +can begin to flow: .Bd -literal -offset abcd B# ifconfig wg0 create 10.0.1.1/24 B# wgconfig wg0 set private-key /etc/wg/wg0 B# wgconfig wg0 add peer A \e N+B4Nelg+4ysvbLW3qenxIwrJVE9MdjMyqrIisH7V0Y= \e +--preshared-key=/etc/wg/wg0.A-B \e --allowed-ips=10.0.1.0/32 \e ---endpoint=1.2.3.4:1234 +--endpoint=192.0.2.123:1234 B# ifconfig wg0 up B# ifconfig wg0 wg0: flags=0x8041 mtu 1420
CVS commit: src/share/man/man4
Module Name:src Committed By: riastradh Date: Sat Mar 9 12:36:07 UTC 2024 Modified Files: src/share/man/man4: wg.4 Log Message: wg(4): Spruce up example a bit. - Suggest umask so the private keys aren't world readable. - Suggest use of pre-shared key files. - Use TEST-NET-1 and TEST-NET-2 addresses for the example instead of real publicly routable addresses. Holding off on adding IPv6 example until the tun(4) issue is fixed (PR bin/58013). PR misc/58015 To generate a diff of this commit: cvs rdiff -u -r1.6 -r1.7 src/share/man/man4/wg.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: cnst Date: Wed Mar 6 22:18:56 UTC 2024 Modified Files: src/share/man/man4: pci.4 wwanc.4 Log Message: wwanc(4): amend Nd; Xr from pci(4) To generate a diff of this commit: cvs rdiff -u -r1.123 -r1.124 src/share/man/man4/pci.4 cvs rdiff -u -r1.6 -r1.7 src/share/man/man4/wwanc.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/pci.4 diff -u src/share/man/man4/pci.4:1.123 src/share/man/man4/pci.4:1.124 --- src/share/man/man4/pci.4:1.123 Sun Jul 10 08:17:02 2022 +++ src/share/man/man4/pci.4 Wed Mar 6 22:18:56 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: pci.4,v 1.123 2022/07/10 08:17:02 nia Exp $ +.\" $NetBSD: pci.4,v 1.124 2024/03/06 22:18:56 cnst Exp $ .\" .\" Copyright (c) 1997 Jason R. Thorpe. All rights reserved. .\" Copyright (c) 1997 Jonathan Stone @@ -313,6 +313,11 @@ WaveLAN/IEEE and PRISM-II 802.11 wireles .It Xr wpi 4 Intel PRO/Wireless 3945ABG Mini PCI Express network adapters. .El +.Ss Cellular WAN interfaces +.Bl -tag -width pcdisplay(4) -offset indent +.It Xr wwanc 4 +Intel XMM 7360 LTE modem. +.El .Ss Serial interfaces .Bl -tag -width pcdisplay(4) -offset indent .It Xr cy 4 Index: src/share/man/man4/wwanc.4 diff -u src/share/man/man4/wwanc.4:1.6 src/share/man/man4/wwanc.4:1.7 --- src/share/man/man4/wwanc.4:1.6 Mon Jul 27 14:17:47 2020 +++ src/share/man/man4/wwanc.4 Wed Mar 6 22:18:56 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: wwanc.4,v 1.6 2020/07/27 14:17:47 jdolecek Exp $ +.\" $NetBSD: wwanc.4,v 1.7 2024/03/06 22:18:56 cnst Exp $ .\" .\" Copyright (c) 2020 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -29,7 +29,7 @@ .Os .Sh NAME .Nm wwanc -.Nd PCI LTE modem +.Nd Intel XMM 7360 LTE modem .Sh SYNOPSIS .Cd "wwanc* at pci? dev ? function ?" .Cd "wwan* at wwanc?"
CVS commit: src/share/man/man4
Module Name:src Committed By: cnst Date: Wed Mar 6 22:18:56 UTC 2024 Modified Files: src/share/man/man4: pci.4 wwanc.4 Log Message: wwanc(4): amend Nd; Xr from pci(4) To generate a diff of this commit: cvs rdiff -u -r1.123 -r1.124 src/share/man/man4/pci.4 cvs rdiff -u -r1.6 -r1.7 src/share/man/man4/wwanc.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: gutteridge Date: Tue Feb 27 02:14:23 UTC 2024 Modified Files: src/share/man/man4: audio.4 Log Message: audio.4: fix grammar and style in places No change to technical content. To generate a diff of this commit: cvs rdiff -u -r1.104 -r1.105 src/share/man/man4/audio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/audio.4 diff -u src/share/man/man4/audio.4:1.104 src/share/man/man4/audio.4:1.105 --- src/share/man/man4/audio.4:1.104 Wed Dec 9 05:48:56 2020 +++ src/share/man/man4/audio.4 Tue Feb 27 02:14:23 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: audio.4,v 1.104 2020/12/09 05:48:56 isaki Exp $ +.\" $NetBSD: audio.4,v 1.105 2024/02/27 02:14:23 gutteridge Exp $ .\" .\" Copyright (c) 1996 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -120,8 +120,8 @@ To achieve this, the audio driver has a a channel mixer, and a frequency converter. The frequency conversion adapts the simplest way (interpolation method for upward, and simple thinning method for downward) -due to restriction in kernel resources and processing time. -It will work well in most case but don't expect excessive quality. +due to restrictions in kernel resources and processing time. +It will work well in most cases but don't expect excessive quality. .Pp The audio device is normally accessed with .Xr read 2 @@ -148,8 +148,8 @@ calls can be used. Note that .Xr mmap 2 no longer maps hardware buffers directly. -Now it is achieved by emulation so don't expect any improvements excessively -rather than normal +Now it is achieved by emulation, so don't expect significant improvements +over normal .Xr write 2 . For historical reasons, only encodings that are not set .Dv AUDIO_ENCODINGFLAG_EMULATED @@ -201,9 +201,9 @@ typedef struct audio_device { .Ed .It Dv AUDIO_GETENC (audio_encoding_t) This command is used iteratively to fetch sample encoding names and -format ids into the input/output audio_encoding_t argument. -The encoding returned by the command is user accessible encoding and -is not hardware supported encoding. +format IDs into the input/output audio_encoding_t argument. +The encoding returned by the command is the user-accessible encoding, +not the hardware-supported encoding. .Bd -literal typedef struct audio_encoding { int index; /* input: nth encoding */ @@ -247,8 +247,7 @@ the device is capable of audio capture. .It Dv AUDIO_GETOOFFS (audio_offset_t) This command fetches the current offset in the input(output) buffer where the track mixer will be putting(getting) data. -It mostly useful when the device -buffer is available in user space via the +It mostly useful when the device buffer is available in user space via the .Xr mmap 2 call. The information is returned in the @@ -266,7 +265,7 @@ typedef struct audio_offset { .It Dv AUDIO_SETINFO (audio_info_t) Get or set audio information as encoded in the audio_info structure. For historical reasons, the audio_info structure has three different -layer's parameters: track, track mixer and hardware rich mixer. +layer's parameters: track, track mixer, and hardware rich mixer. .Bd -literal typedef struct audio_info { struct audio_prinfo play; /* info for play (output) side */ @@ -412,11 +411,11 @@ ranges from 1000Hz to 192000Hz, regardless of frequency (ranges) supported by underlying driver. .Va channels depends your underlying driver. -If the underlying driver only supports monaural (1channel) -or stereo (2channels), you can specify 1 or 2 regardless of +If the underlying driver only supports monaural (1 channel) +or stereo (2 channels), you can specify 1 or 2 regardless of number of channels supported by underlying driver. If the underlying driver supports three or more channels, you can specify -the number of channels supported by the underlying driver or less. +the number of channels supported by the underlying driver or fewer. .Pp The .Va gain , @@ -672,8 +671,8 @@ commands. The .Va type field identifies the type of this mixer control. -Enumeration types are typically used for on/off style controls (e.g. a -mute control) or for input/output device selection (e.g. select +Enumeration types are typically used for on/off style controls (e.g., a +mute control) or for input/output device selection (e.g., select recording input source from CD, line in, or microphone). Set types are similar to enumeration types but any combination of the mask bits can be used. @@ -685,8 +684,7 @@ The .Pq arbitrary value set by the hardware driver may be determined by examining the .Va mixer_class -field of the class itself, -a mixer of type +field of the class itself, a mixer of type .Dv AUDIO_MIXER_CLASS . For example, a mixer controlling the input gain on the line in circuit would have a @@ -700,12 +698,11 @@ of .Dq line .Dv ( AudioNline ) . Mixer controls which control audio circuitry f
CVS commit: src/share/man/man4
Module Name:src Committed By: gutteridge Date: Tue Feb 27 02:14:23 UTC 2024 Modified Files: src/share/man/man4: audio.4 Log Message: audio.4: fix grammar and style in places No change to technical content. To generate a diff of this commit: cvs rdiff -u -r1.104 -r1.105 src/share/man/man4/audio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: msaitoh Date: Wed Feb 7 04:25:58 UTC 2024 Modified Files: src/share/man/man4: gcscaudio.4 Log Message: Fix date. To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/share/man/man4/gcscaudio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/gcscaudio.4 diff -u src/share/man/man4/gcscaudio.4:1.4 src/share/man/man4/gcscaudio.4:1.5 --- src/share/man/man4/gcscaudio.4:1.4 Wed Feb 7 04:20:26 2024 +++ src/share/man/man4/gcscaudio.4 Wed Feb 7 04:25:58 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: gcscaudio.4,v 1.4 2024/02/07 04:20:26 msaitoh Exp $ +.\" $NetBSD: gcscaudio.4,v 1.5 2024/02/07 04:25:58 msaitoh Exp $ .\" .\" Copyright (c) 2009 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -27,7 +27,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd February 27, 2024 +.Dd February 7, 2024 .Dt GCSCAUDIO 4 .Os .Sh NAME
CVS commit: src/share/man/man4
Module Name:src Committed By: msaitoh Date: Wed Feb 7 04:25:58 UTC 2024 Modified Files: src/share/man/man4: gcscaudio.4 Log Message: Fix date. To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/share/man/man4/gcscaudio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4/man4.hppa
Module Name:src Committed By: gutteridge Date: Thu Feb 1 02:44:17 UTC 2024 Modified Files: src/share/man/man4/man4.hppa: phantomas.4 Log Message: phantomas.4: minor grammar fix To generate a diff of this commit: cvs rdiff -u -r1.2 -r1.3 src/share/man/man4/man4.hppa/phantomas.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4/man4.hppa
Module Name:src Committed By: gutteridge Date: Thu Feb 1 02:44:17 UTC 2024 Modified Files: src/share/man/man4/man4.hppa: phantomas.4 Log Message: phantomas.4: minor grammar fix To generate a diff of this commit: cvs rdiff -u -r1.2 -r1.3 src/share/man/man4/man4.hppa/phantomas.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/man4.hppa/phantomas.4 diff -u src/share/man/man4/man4.hppa/phantomas.4:1.2 src/share/man/man4/man4.hppa/phantomas.4:1.3 --- src/share/man/man4/man4.hppa/phantomas.4:1.2 Fri Feb 17 22:24:46 2017 +++ src/share/man/man4/man4.hppa/phantomas.4 Thu Feb 1 02:44:17 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: phantomas.4,v 1.2 2017/02/17 22:24:46 christos Exp $ +.\" $NetBSD: phantomas.4,v 1.3 2024/02/01 02:44:17 gutteridge Exp $ .\" .\" $OpenBSD: phantomas.4,v 1.6 2003/09/02 21:11:50 jmc Exp $ .\" @@ -51,7 +51,7 @@ and memory are located. .Sh MACHINES The Phantom bus convertor is used in conjunction with the .Tn PA7300LC -CPU in this machines: +CPU in these machines: .Pp .Bl -bullet -compact .It