diff options
| author | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 15:32:58 -0400 |
|---|---|---|
| committer | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 15:32:58 -0400 |
| commit | 5cb84ec742fd33f78c8022863fadaa8d0d93e176 (patch) | |
| tree | 1a81ca3665e6153923e40db7b0d988f8573ab59c /static/netbsd/man4/man4.x86 | |
| parent | a59214f344567c037d5776879bcfc5fcc1d4d5f6 (diff) | |
feat: Added NetBSD man pages
Diffstat (limited to 'static/netbsd/man4/man4.x86')
23 files changed, 2078 insertions, 0 deletions
diff --git a/static/netbsd/man4/man4.x86/Makefile b/static/netbsd/man4/man4.x86/Makefile new file mode 100644 index 00000000..67434962 --- /dev/null +++ b/static/netbsd/man4/man4.x86/Makefile @@ -0,0 +1,4 @@ +MAN = $(wildcard *.4) + +include ../../../mandoc.mk + diff --git a/static/netbsd/man4/man4.x86/amdccp.4 b/static/netbsd/man4/man4.x86/amdccp.4 new file mode 100644 index 00000000..d27c4f76 --- /dev/null +++ b/static/netbsd/man4/man4.x86/amdccp.4 @@ -0,0 +1,54 @@ +.\" $NetBSD: amdccp.4,v 1.1 2021/07/25 07:35:55 nia Exp $ +.\" +.\" Copyright (c) 2021 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT 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 July 25, 2021 +.Dt AMDCCP 4 +.Os +.Sh NAME +.Nm amdccp +.Nd AMD Cryptographic Coprocessor device driver +.Sh SYNOPSIS +.Cd "amdccp* at pci?" +.Sh DESCRIPTION +The +.Nm +driver provides support for cryptographic coprocessors found on +certain AMD CPUs. +The coprocessor supports hardware offloading for common cryptographic +algorithms and a True Random Number Generator (TRNG). +.Pp +Currently, this driver only supports providing additional entropy +to the kernel's random number generator. +.Sh SEE ALSO +.Xr pci 4 , +.Xr rnd 4 , +.Xr entropy 7 , +.Xr rnd 9 +.Sh HISTORY +The +.Nm +device driver appeared in +.Nx 9.0 . diff --git a/static/netbsd/man4/man4.x86/amdpcib.4 b/static/netbsd/man4/man4.x86/amdpcib.4 new file mode 100644 index 00000000..6297e087 --- /dev/null +++ b/static/netbsd/man4/man4.x86/amdpcib.4 @@ -0,0 +1,43 @@ +.\" $NetBSD: amdpcib.4,v 1.4 2017/02/18 22:39:02 wiz Exp $ +.\" +.\" $OpenBSD: amdpcib.4,v 1.4 2007/10/08 12:48:21 jmc Exp $ +.\" +.\" Marc Balmer, 2007. Public Domain. +.\" Jukka Ruohonen, 2010. Public Domain. +.\" +.Dd February 17, 2017 +.Dt AMDPCIB 4 x86 +.Os +.Sh NAME +.Nm amdpcib +.Nd AMD-8111 series LPC bridge and timecounter +.Sh SYNOPSIS +.Cd "amdpcib* at pci?" +.Cd "hpet* at amdpcib?" +.Cd "isa* at amdpcib?" +.Sh DESCRIPTION +The +.Nm +driver provides support for the AMD-8111 +.Tn LPC +bridge and implements a 32/64-bit +14.3 MHz (or variable) timecounter using the HPET timer. +.Sh SEE ALSO +.Xr isa 4 , +.Xr pci 4 , +.Xr x86/hpet 4 +.Rs +.%A Advanced Micro Devices +.%T AMD-8111 HyperTransport I/O Hub +.%N Revision 3.03 +.%D July, 2004 +.%U http://support.amd.com/us/ChipsetMotherboard_TechDocs/24674.pdf +.Re +.Sh HISTORY +The +.Nm +driver first appeared in +.Nx 5.0 . +.Sh AUTHORS +.An Nicolas Joly +.Aq njoly@NetBSD.org diff --git a/static/netbsd/man4/man4.x86/amdsmn.4 b/static/netbsd/man4/man4.x86/amdsmn.4 new file mode 100644 index 00000000..0aa433a0 --- /dev/null +++ b/static/netbsd/man4/man4.x86/amdsmn.4 @@ -0,0 +1,89 @@ +.\" $NetBSD: amdsmn.4,v 1.5 2022/10/02 09:48:39 msaitoh Exp $ +.\" +.\" Copyright (c) 2018 Ian Clark <mrrooster@gmail.com> +.\" All rights reserved. +.\" +.\" This code is derived from the FreeBSD amdsmn driver by +.\" Conrad Meyer <cem@FreeBSD.org> +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" 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. +.\" +.\"- +.\" Copyright (c) 2017 Conrad Meyer <cem@FreeBSD.org> +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" 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. +.\" +.\" $FreeBSD: head/share/man/man4/amdsmn.4 323184 2017-09-05 15:13:41Z cem $ +.\" +.Dd October 2, 2022 +.Dt AMDSMN 4 x86 +.Os +.Sh NAME +.Nm amdsmn +.Nd device driver for AMD processor System Management Network +.Sh SYNOPSIS +.Cd "amdsmn* at pci?" +.Sh DESCRIPTION +The +.Nm +driver provides support for resources on the System Management Network bus +in AMD Family 19h processors, 17h processors and some later +AMD Family 15h processors. +.Sh SEE ALSO +.Xr amdzentemp 4 +.Sh HISTORY +The +.Nm +driver first appeared in +.Fx +and +.Nx 9.0 . +.Sh AUTHORS +.An -nosplit +Based on the +.Fx +driver by +.An Conrad Meyer . +It was adapted to +.Nx +by +.An Ian Clark . diff --git a/static/netbsd/man4/man4.x86/amdzentemp.4 b/static/netbsd/man4/man4.x86/amdzentemp.4 new file mode 100644 index 00000000..2ec68b99 --- /dev/null +++ b/static/netbsd/man4/man4.x86/amdzentemp.4 @@ -0,0 +1,100 @@ +.\" $NetBSD: amdzentemp.4,v 1.7 2020/04/20 11:09:48 simonb Exp $ +.\"- +.\" Copyright (c) 2008 Christoph Egger +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" 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. +.\" +.\" $FreeBSD: src/share/man/man4/coretemp.4,v 1.4 2007/10/15 20:00:19 netchild Exp $ +.\" +.Dd April 20, 2020 +.Dt AMDZENTEMP 4 x86 +.Os +.Sh NAME +.Nm amdzentemp +.Nd AMD Zen CPU family on-die digital thermal sensor +.Sh SYNOPSIS +.Cd "amdzentemp* at amdsmnbus?" +.Sh DESCRIPTION +The +.Nm +driver provides support for the on-die digital thermal sensor present +on AMD Ryzen CPUs and some later AMD Opteron CPUs. +.Pp +These sensors provide 0.125\(deC accuracy. +There is one sensor for each CPU socket. +.Pp +The +.Nm +driver reports temperatures through the +.Xr envsys 4 +API. +.Bl -column "CPUN sensor0" "Units" "Typical Use" -offset indent +.It Sy "Sensor" Ta Sy "Units" Ta Sy "Typical Use" +.It CPU Ns Em N No sensor0 Ta \(*mK Ta cpu Ns Em N No temperature +.El +.Sh SEE ALSO +.Xr amdtemp 4 , +.Xr envsys 4 , +.Xr envstat 8 , +.Xr powerd 8 +.Sh HISTORY +The +.Nm +driver first appeared in +.Ox 4.4 +named +.Dq kate . +It was then ported to +.Nx 5.0 +under the name +.Xr amdtemp 4 . +The +.Fx +version of the driver was updated with support for newer AMD CPUs. +For +.Nx , +the support for the newer CPUs was separated into its own +.Nm +driver. +.Sh AUTHORS +.An -nosplit +The +.Nm +driver was written by +.An Constantine A. Murenin Aq Mt cnst@openbsd.org +whilst at the University of Waterloo. +Porting of support for the newer AMD CPUs from +.Fx +was provided by +.An Ian Clark . +.Sh BUGS +The temperature reading provided to +.Xr envsys 4 +needs to have a CPU-dependent offset applied. +For Ryzen X processors, the offset is 20\(deC, while for Threadripper +processors an offset of 27\(deC is needed. +.Pp +The sensor has a thermal-trip value which should be retrieved and +provided to +.Xr envsys 4 +as the sensors critical-maximum value. diff --git a/static/netbsd/man4/man4.x86/apic.4 b/static/netbsd/man4/man4.x86/apic.4 new file mode 100644 index 00000000..2e2d8b1c --- /dev/null +++ b/static/netbsd/man4/man4.x86/apic.4 @@ -0,0 +1,174 @@ +.\" $NetBSD: apic.4,v 1.3 2017/02/18 22:39:02 wiz Exp $ +.\" +.\" Copyright (c) 2011 Jukka Ruohonen <jruohonen@iki.fi> +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Neither the name of the author nor the names of any +.\" contributors may be used to endorse or promote products derived +.\" from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT 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 February 17, 2017 +.Dt APIC 4 x86 +.Os +.Sh NAME +.Nm apic , +.Nm ioapic , +.Nm lapic +.Nd Intel APIC Architecture +.Sh SYNOPSIS +.Cd "ioapic* at mainbus*" +.Sh DESCRIPTION +The +.Nm +subsystem provides basis for a system of advanced programmable +interrupt controllers +.Pq Tn APICs +originally designed by Intel but now widely used on all x86 systems. +.Pp +There are two elements in the architecture, the local +.Tn APIC +.Pq Tn LAPIC +and the +.Tn I/O APIC . +Historically these were connected by a dedicated 3-wire +.Dq APIC bus , +but the system bus is used for communication today. +The configuration is increasingly dependent on +.Tn ACPI . +.Pp +Typically each +.Tn CPU +in the system contains one +.Tn LAPIC +that performs two primary functions: +.Bl -enum -offset indent +.It +It receives interrupts both from internal sources and from the external +.Tn I/O APIC . +The interrupt sources include +.Tn I/O +devices, the programmable +.Tn APIC +timer, performance monitoring counters, +thermal sensor interrupts, and others. +.It +In multiprocessor +.Pq Tn MP +systems a +.Tn LAPIC +receives and sends interprocessor interrupts +.Pq Tn IPIs +from and to other processors in the system. +.Tn IPIs +are used to provide software interrupts, +interrupt forwarding, or preemptive scheduling. +Against this, the architecture can be generally seen as an attempt +to solve the interrupt routing efficiency issues in +.Tn MP +systems. +.El +.Pp +There is typically one +.Tn I/O APIC +for each peripheral bus in the system. +Each +.Tn I/O APIC +has a series of interrupt inputs to external interrupt sources. +The architecture usually contains a redirection table which can be used +to route the interrupts that an +.Tn I/O APIC +receives to one or more local +.Tn APICs . +When a +.Tn LAPIC +is able to accept an interrupt, it will signal the +.Tn CPU . +Without an +.Tn I/O APIC , +the local +.Tn APICs +are therefore mostly useless; one of the primary functions +of the architecture is no longer achievable, interrupts can +not be distributed to different +.Tn CPUs . +.Pp +The 8259 +.Tn PIC +has coexisted with the architecture since its introduction. +It is still possible to disable the +.Tn APIC +system and revert back to a 8259-compatible +.Tn PIC . +But the widespread use of +.Tn MP +systems has made this mainly a fallback option. +.Sh SEE ALSO +.Xr acpi 4 , +.Xr mainbus 4 , +.Xr x86/ichlpcib 4 +.Rs +.%A Intel Corporation +.%T Intel 64 and IA-32 Architectures Software Developer's Manual +.%V Volume 3A: System Programming Guide, Part 1 +.%P Chapter 10 +.%D January, 2011 +.%U http://www.intel.com/Assets/PDF/manual/253668.pdf +.Re +.Rs +.%A Intel Corporation +.%T Intel 82093AA I/O Advanced Programmable +.%T Interrupt Controller (I/O APIC) Datasheet +.%D May, 1996 +.%U http://www.intel.com/design/chipsets/datashts/29056601.pdf +.Re +.Rs +.%A Intel Corporation +.%T 8259A, Programmable Interrupt Controller +.%D December, 1988 +.%U http://pdos.csail.mit.edu/6.828/2005/readings/hardware/8259A.pdf +.Re +.Rs +.%A John Baldwin +.%T PCI Interrupts for x86 Machines under FreeBSD +.%D May 18-19, 2007 +.%O Proceedings of BSDCan 2007 +.%U http://people.freebsd.org/~jhb/papers/bsdcan/2007/article.pdf +.Re +.Rs +.%A Microsoft Corporation +.%T PCI IRQ Routing on a Multiprocessor ACPI System +.%D December 4, 2001 +.%U http://www.microsoft.com/whdc/archive/acpi-mp.mspx +.Re +.Sh AUTHORS +.An -nosplit +Authors of the +.Nx +implementation of the Intel APIC Architecture include +.An Andrew Doran , +.An Bill Sommerfeld , +.An Frank van der Linden , +and +.An Stefan Grefen , +among others. +The older 8259 +.Tn PIC +implementation is based on the work of +.An William Jolitz . diff --git a/static/netbsd/man4/man4.x86/autoconf.4 b/static/netbsd/man4/man4.x86/autoconf.4 new file mode 100644 index 00000000..2b188569 --- /dev/null +++ b/static/netbsd/man4/man4.x86/autoconf.4 @@ -0,0 +1,69 @@ +.\" $NetBSD: autoconf.4,v 1.2 2024/09/07 19:13:28 rillig Exp $ +.\" +.\" Copyright (c) 1994 Christopher G. Demetriou +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed for the +.\" NetBSD Project. See https://www.NetBSD.org/ for +.\" information about NetBSD. +.\" 4. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 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. +.\" +.\" <<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>> +.\" +.Dd February 17, 2017 +.Dt AUTOCONF 4 x86 +.Os +.Sh NAME +.Nm autoconf +.Nd diagnostics from the autoconfiguration code +.Sh DESCRIPTION +When +.Nx +bootstraps it probes the innards of the machine +on which it is running +and locates controllers, drives, and other devices, printing out +what it finds on the console. +This procedure is driven by a system +configuration table which is processed by +.Xr config 1 +and compiled into each kernel. +Devices which exist in the machine but are not configured into the +kernel are not detected. +.Sh DIAGNOSTICS +.Bl -diag +.It CPU class not configured. +You tried to boot +.Nx +on a class of +.Tn CPU +type which it doesn't +(or at least this compiled version of +.Nx +doesn't) understand. +.El +.Sh SEE ALSO +.Xr config 1 , +.Xr intro 4 , +.Xr boot 8 diff --git a/static/netbsd/man4/man4.x86/balloon.4 b/static/netbsd/man4/man4.x86/balloon.4 new file mode 100644 index 00000000..9ad6521a --- /dev/null +++ b/static/netbsd/man4/man4.x86/balloon.4 @@ -0,0 +1,209 @@ +.\" $NetBSD: balloon.4,v 1.11 2014/03/18 18:20:40 riastradh Exp $ +.\" +.\" Copyright (c) 2011 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to The NetBSD Foundation +.\" by Jean-Yves Migeon <jym@NetBSD.org>. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT 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 July 30, 2011 +.Dt BALLOON 4 xen +.Os +.Sh NAME +.Nm balloon +.Nd Xen memory balloon driver +.Sh SYNOPSIS +.Cd "balloon* at xenbus?" +.Sh DESCRIPTION +The +.Nm +driver supports the memory ballooning operations offered in +.Tn Xen +environments. +It allows shrinking or extending a domain's available memory by passing +pages between different domains. +At any time, the total memory available to a domain is called the +``reservation''. +.Pp +Pages are moved via the use of the balloon, a reserved quantity +of memory available to all domains that can be freely deflated (or inflated) +at a domain's will. +Deflating balloon means that pages are moved out from it, and bound to +domain's virtual memory. +Respectively, inflating balloon indicates that pages are moved out of +domain's memory and pushed inside balloon. +This is similar to a dynamic allocation of wired physical memory, except +that the pages are not available to domain anymore. +.Pp +Any domain is free to request memory from +.Nm +up to the maximum value set by the host's administrator through the +.Ic mem-max +command of +.Xr xm 1 . +Alternatively, the host's administrator is free to request to a particular +domain to give some memory back. +This command requires the targeted domain's cooperation and requires +.Nm balloon +support within it. +This can be done through the +.Ic mem-set +command of +.Xr xm 1 . +Alternatively, one can control the ballooning directly by writing +under the +.Dq memory/target +node inside Xenstore. +This entry controls the target memory reservation +of a given domain, indicated in kilobytes (KiB). +.Pp +An interface to control +.Nm +is also available through +.Xr sysctl 8 +under +.Dq machdep.xen.balloon +(all values being in kilobytes): +.Bl -tag -width xxxxxxx +.It current +(read-only) The current memory reservation of the domain. +.It min +(read-write) The minimum reservation value acceptable by the domain's +.Nm balloon +driver. +Any request that would require domain to reduce its reservation below +this threshold will be refused by the driver. +This can be used by a domain's administrator to control the number of memory +pages that will be kept available to domain. +.It max +(read-only) The maximum reservation accessible to a domain. +Its value can only be changed by the dom0's administrator, through the +.Ic mem-max +command of +.Xr xm 1 . +.It target +(read-write) The target reservation of the domain. +This entry serves the same purpose as the +.Dq memory/target +entry in Xenstore. +This controls the targeted number of pages that the domain should have. +Note that this is only a target, and may not be achieved for a variety of +reasons. +.El +.Sh DIAGNOSTICS +.Bl -diag +.It "WARNING: balloon could not reach target %zu (current %zu)" +.Nm +failed to reach the target reservation. +This is typically due to a target set too low; the kernel prevented +memory exhaustion by refusing further allocation. +.It "increase reservation incomplete: was %zu, returned %d" +The hypervisor only gave a partial set of memory pages to domain. +This happens when host's memory consumption is high, and hypervisor +is unable to give enough free pages back to domain. +.It "memory 'hot-plug' unsupported - clipping reservation %zu => %zu pages." +An attempt was made by domain to get more memory than initially obtained +during boot. +As physical memory pages cannot be added to memory management sub-system +dynamically, +.Nm +will limit reservation up to the maximum value it can handle. +.El +.Sh ERRORS +When setting the minimum threshold or target reservation entries through +.Dq machdep.xen.balloon , +the following errors can be returned: +.Bl -tag -width Er +.It Bq Er EPERM +The value passed is beyond limits. +The new value is either too low +.Po Dq min +is below driver's safeguard value, or +.Dq target +is below minimum value +.Pc , +or too high +.Po Dq target +is above maximum value +.Pc . +.El +.Sh SEE ALSO +.Xr xm 1 , +.Xr xenbus 4 , +.Xr uvm 9 +.Rs +.%A Carl A. Waldspurger +.%T "Memory Resource Management in VMware ESX Server" +.%I USENIX Association +.%B Proceedings of the 5th Symposium on \ +Operating Systems Design and Implementation +.%D December 9-11, 2002 +.%U http://www.usenix.org/events/osdi02/tech/full_papers/waldspurger/waldspurger.pdf +.Re +.\" +.Sh HISTORY +The +.Nm +driver first appeared in +.Nx 6.0 . +.Sh AUTHORS +.An -nosplit +The +.Nm +driver was written by +.An Cherry G. Mathew Aq Mt cherry@NetBSD.org +and +.An Jean-Yves Migeon Aq Mt jym@NetBSD.org . +.Sh BUGS +There are a number of reasons why a domain may not attain the targeted +memory reservation: +.Nm +can be empty and cannot be collapsed further, domain +may not have enough free memory pages (due to memory fragmentation, +memory exhaustion, ...) so it cannot give enough back to +.Nm . +.Pp +Currently, the virtual memory sub-system of +.Nx +is not capable of ``hot-plugging'' new memory pages into place. +This means that increasing a domain's memory reservation above +its initial maximum value is pointless, as new memory pages +cannot be consumed by the memory management sub-system. +.Pp +Over expanding +.Nm +generates high kernel memory pressure. +While the driver tries to stay as conservative as possible to avoid +crashes, a very low memory reservation will lead to unwanted swap or even +.Fn panic . +.Sh SECURITY CONSIDERATIONS +Ballooning involves moving pages between different domains. +This includes their content, which can lead to information leak. +If you are running domains of different sensitivities on the same host, +consider disabling the use of ballooning altogether. +The +.Nx +kernel zeroes all pages before relinquishing them to +.Nm +but this may not be the case for other operating systems. diff --git a/static/netbsd/man4/man4.x86/console.4 b/static/netbsd/man4/man4.x86/console.4 new file mode 100644 index 00000000..c9e4c6c1 --- /dev/null +++ b/static/netbsd/man4/man4.x86/console.4 @@ -0,0 +1,116 @@ +.\" $NetBSD: console.4,v 1.1 2021/06/03 07:41:26 wiz Exp $ +.\" +.Dd September 6, 2006 +.Dt CONS 4 x86 +.Os +.Sh NAME +.Nm console +.Nd x86 console interface +.Sh SYNOPSIS +.Cd options CONSDEVNAME=string +.Cd options CONADDR=integer +.Cd options CONSPEED=integer +.Cd options CONS_OVERRIDE +.Cd options CONMODE=integer +.Sh DESCRIPTION +The +.Dq console +device is used for +.Em kernel printf +messages and accesses to the +.Pa /dev/console +character special device in user mode. +It is attached to a hardware interface at boot time controlled by options +in the kernel configuration file, or information passed by the boot loader. +.Pp +Bootblocks from +.Nx 1.4 +or newer select their console device from a compiled-in list, +and then pass their choice of console device and console parameters to +the kernel. +.Pp +As of +.Nx 1.5 , +the +.Ic consdev +bootblock command allows changing the console device on-the-fly. +.Pp +The kernel will use the same console device as the +bootblock; no special kernel configuration is required. +.Pp +To override +the bootblock's choice of console, or to use a serial kernel console +with older bootblocks, you must specify kernel config-file options to +override the information passed by the bootblock. +The current option choices are: +.Bl -tag -width aaa +.It - the standard PC keyboard and display +(with either the +.Dq pc +or the +.Xr wscons 4 +driver) +.It - standard PC serial ports +(with +.Xr com 4 +driver) +.El +.Pp +The available +.Em kernel configuration +options are: +.Bl -ohang +.It Cd options CONSDEVNAME=string +specifies the name of the console device. +Valid values are +.Dq pc +for the pc keyboard / display (default) +and +.Dq com +for a serial port. +.It Cd options CONADDR=integer +sets the base address for the serial console port (default: 0x3f8). +.It Cd options CONSPEED=integer +sets the baudrate for the serial console (default: 9600). +.It Cd options CONS_OVERRIDE +causes console information passed by the bootloader to be ignored and +the settings specified by the three options above (or the defaults) to be +used. +Default behaviour is to use the settings from the bootloader if +present, and to use option / default values only if no information was +passed. +.It Cd options CONMODE=integer +allows to specify terminal control flags. +The argument is a +.Dq cflag +value, see +.Xr termios 4 +for details. +Default is +.Li ( CREAD | CS8 | HUPCL ) +(8N1). +This option takes always effect, because mode settings are not passed +by the bootloader. +.El +.Sh FILES +.Bl -tag -width /dev/console +.It Pa /dev/console +.El +.Sh EXAMPLES +.Cd options CONSDEVNAME=\&"\e"com\e"\&",CONADDR=0x2f8,CONSPEED=57600 +.Sh SEE ALSO +.Xr config 1 , +.Xr tty 4 , +.Xr boot 8 +.Sh BUGS +The console device is chosen early in system startup regardless +if the specified driver / device is present in the system configuration file. +If the driver asked for by the bootloader or +.Dq Cd options CONSDEVNAME +is not configured into the system, a panic is caused. +Because there is +no console device, no explaining message will be printed. +If the driver is present, but the specific device instance not, kernel +printf will work, but +.Pa /dev/console +becomes a dummy. diff --git a/static/netbsd/man4/man4.x86/coretemp.4 b/static/netbsd/man4/man4.x86/coretemp.4 new file mode 100644 index 00000000..4dc13055 --- /dev/null +++ b/static/netbsd/man4/man4.x86/coretemp.4 @@ -0,0 +1,90 @@ +.\" $NetBSD: coretemp.4,v 1.5 2020/11/14 20:04:46 wiz Exp $ +.\"- +.\" Copyright (c) 2007 Juan Romero Pardines. +.\" Copyright (c) 2007 Dag-Erling Coïdan Smørgrav +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" 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. +.\" +.\" $FreeBSD: src/share/man/man4/coretemp.4,v 1.4 2007/10/15 20:00:19 netchild Exp $ +.\" +.Dd February 23, 2010 +.Dt CORETEMP 4 x86 +.Os +.Sh NAME +.Nm coretemp +.Nd Intel Core on-die digital thermal sensor +.Sh SYNOPSIS +.Cd "coretemp* at cpu?" +.Sh DESCRIPTION +The +.Nm +driver provides support for the on-die digital thermal sensor present +on Intel Core and newer CPUs. +.Pp +The temperatures can be observed by using the +.Xr envsys 4 +.Tn API +or the +.Xr envstat 8 +command. +Temperatures are reported for each core separately. +.Sh EVENTS +The +.Nm +driver is able to send a +.Em critical +event to the +.Xr powerd 8 +daemon. +The script +.Pa /etc/powerd/scripts/sensor_temperature +will be executed by the daemon (if running) when the limit has been reached. +.Sh SEE ALSO +.Xr envsys 4 , +.Xr envstat 8 , +.Xr powerd 8 +.Rs +.%A Michael Berktold +.%A Tian Tian (Intel Corporation) +.%T CPU Monitoring With DTS/PECI, White Paper +.%D September 2010 +.%U http://edc.intel.com/Download.aspx?id=2612 +.Re +.Sh HISTORY +The +.Nm +driver first appeared in +.Fx 7.0 . +It was later ported to +.Nx 5.0 . +.Sh AUTHORS +.An -nosplit +The +.Nm +driver was written by +.An Rui Paulo Aq Mt rpaulo@FreeBSD.org +as part of a Google Summer of Code project. +It was adapted to +.Nx +by +.An Juan Romero Pardines . diff --git a/static/netbsd/man4/man4.x86/est.4 b/static/netbsd/man4/man4.x86/est.4 new file mode 100644 index 00000000..5f3fe053 --- /dev/null +++ b/static/netbsd/man4/man4.x86/est.4 @@ -0,0 +1,89 @@ +.\" $NetBSD: est.4,v 1.7 2020/11/14 20:04:46 wiz Exp $ +.\" +.\" Copyright (c) 2011 Jukka Ruohonen <jruohonen@iki.fi> +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Neither the name of the author nor the names of any +.\" contributors may be used to endorse or promote products derived +.\" from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT 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 7, 2020 +.Dt EST 4 x86 +.Os +.Sh NAME +.Nm est +.Nd Enhanced SpeedStep +.Sh SYNOPSIS +.Cd "est0 at cpu0" +.Sh DESCRIPTION +The +.Nm +driver provides support for Enhanced SpeedStep introduced in +Intel's first and second generation of Pentium M processors. +The following +.Xr sysctl 8 +variables are available with +.Nm : +.Bl -tag -width "machdep.cpu.frequency.available" -offset indent +.It Ic machdep.cpu.frequency.target +The target frequency of the +.Tn CPUs . +.It Ic machdep.cpu.frequency.current +The current frequency. +.It Ic machdep.cpu.frequency.available +The frequencies recognized by +.Nm . +.El +.Pp +Note, however, that these variables are +not guaranteed to exist in the future versions of +.Nx . +.Sh SEE ALSO +.Xr acpicpu 4 , +.Xr x86/odcm 4 , +.Xr x86/powernow 4 +.Rs +.%A Intel Corporation +.%T Intel Pentium M Processor. +.%T Datasheet +.%D March, 2004 +.%U http://download.intel.com/support/processors/mobile/pm/sb/25261203.pdf +.Re +.Rs +.%A Intel Corporation +.%T Enhanced Intel SpeedStep Technology for the Intel Pentium M Processor. +.%T White Paper +.%D March, 2004 +.%U http://download.intel.com/design/network/papers/30117401.pdf +.Re +.Sh CAVEATS +The +.Nm +driver is considered a legacy interface to be used only with old systems. +It is known to be problematic with new +.Tn CPUs . +Furthermore, in the unlikely case where both +.Nm +and +.Xr x86/ichlpcib 4 +or +.Xr piixpcib 4 +provide support for SpeedStep, +the PCI-based interfaces should not be accessed due possible race conditions. diff --git a/static/netbsd/man4/man4.x86/fdc.4 b/static/netbsd/man4/man4.x86/fdc.4 new file mode 100644 index 00000000..ec9751ae --- /dev/null +++ b/static/netbsd/man4/man4.x86/fdc.4 @@ -0,0 +1,112 @@ +.\" $NetBSD: fdc.4,v 1.1 2011/09/23 14:45:06 jruoho Exp $ +.\" +.\" Copyright (c) 1996, 1997 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to The NetBSD Foundation +.\" by John Kohl. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT 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 23, 2011 +.Dt FDC 4 x86 +.Os +.Sh NAME +.Nm fdc +.Nd NEC 765 floppy disk controller driver +.Sh SYNOPSIS +.Cd "fdc0 at isa? port 0x3f0 irq 6 drq 2" +.Cd "fdc* at acpi?" +.Cd "fdc* at pnpbios? index ?" +.Cd "fd* at fdc? drive ?" +.Sh DESCRIPTION +The +.Nm +driver provides support for the NEC 765 floppy disk controller and +floppy disk drives, commonly found on IBM-PC compatible systems. +.Pp +The driver supports the following floppy diskette formats by using +particular partitions: +.Bl -tag -width xxxx -offset indent -compact +.It 1.44MB 3.5-inch (b) +.It "1.2MB " 5.25-inch (c) +.It "360KB " 5.25-inch (1.2MB drive) (d) +.It "360KB " 5.25-inch (IBM-PC drive) (e) +.It "720KB " 3.5-inch (f) +.It "720KB " 5.25-inch (g) +.It "360KB " 3.5-inch (h) +.El +Partition +.Ar a +selects the default format for the attached floppy drive, as determined +by the BIOS configuration for the diskette drive. +.Sh FORMATTING +The driver supports floppy disk formatting using the interfaces in +.In sys/fdio.h : +.Bl -tag -width FDIOCFORMAT_TRACK -compact +.It Dv FDIOCGETFORMAT Fa struct fdformat_parms +Fetch current formatting parameters. +This gets the default parameters +for the open device if no parameters have been set during the session. +.It Dv FDIOCSETFORMAT Fa struct fdformat_parms +Set formatting parameters. +The driver saves this state and it persists while the device is open. +.It Dv FDIOCFORMAT_TRACK Fa struct fdformat_cmd +Format a track on the medium. +If this call returns +.Er EINVAL , +the track formatting parameters were out of range for the medium. +If it returns +.Er EIO , +there was a medium error while formatting the track. +.It Dv FDIOCSETOPTS Fa int +Set driver options which persist until the device is closed. +The options should be the logical OR of the desired values below: +.Bl -tag -width FDOPT_NORETRY -compact +.It Dv FDOPT_NORETRY +Do not retry operations on failure +.It Dv FDOPT_SILENT +Do not print error messages to the console +.El +.It Dv FDIOCGETOPTS Fa int +Fetch drive options. +.El +.Pp +A typical use of the formatting facilities would be to open the device, +call +.Dv FDIOCGETFORMAT +to fetch the current format parameters, perhaps +change a parameter or two, display the formatting details to the user, +and then call +.Dv FDIOCSETFORMAT +followed by a series of calls to +.Dv FDIOCFORMAT_TRACK . +.Sh SEE ALSO +.Xr fdformat 1 , +.Xr acpi 4 , +.Xr isa 4 , +.Xr pnpbios 4 +.Sh HISTORY +The +.Nm +formatting support appeared in +.Nx 1.3 . diff --git a/static/netbsd/man4/man4.x86/fwhrng.4 b/static/netbsd/man4/man4.x86/fwhrng.4 new file mode 100644 index 00000000..be3647bc --- /dev/null +++ b/static/netbsd/man4/man4.x86/fwhrng.4 @@ -0,0 +1,60 @@ +.\" $NetBSD: fwhrng.4,v 1.3 2017/02/18 22:39:02 wiz Exp $ +.\" +.\" Copyright (c) 2010 Jukka Ruohonen <jruohonen@iki.fi> +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Neither the name of the author nor the names of any +.\" contributors may be used to endorse or promote products derived +.\" from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT 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 February 17, 2017 +.Dt FWHRNG 4 x86 +.Os +.Sh NAME +.Nm fwhrng +.Nd Intel Firmware Hub Random Number Generator +.Sh SYNOPSIS +.Cd "fwhrng* at ichlpcib?" +.Sh DESCRIPTION +The +.Nm +driver provides support for hardware Random Number Generator +.Pq Tn RNG +available on some Intel Firmware Hubs +.Pq Tn FWHs . +The +.Nm +driver accesses the +.Tn RNG +through an +.Tn I/O +controller hub +.Pq Tn ICH . +.Sh SEE ALSO +.Xr rnd 4 , +.Xr x86/ichlpcib 4 +.Rs +.%A Intel Corporation +.%T Intel 82802AB/82802AC Firmware Hub (FWH) +.%D November, 2000 +.%U http://download.intel.com/design/chipsets/datashts/29065804.pdf +.Re +.Sh CAVEATS +The entropy source is not tested for randomness. diff --git a/static/netbsd/man4/man4.x86/hpet.4 b/static/netbsd/man4/man4.x86/hpet.4 new file mode 100644 index 00000000..f55a9bb9 --- /dev/null +++ b/static/netbsd/man4/man4.x86/hpet.4 @@ -0,0 +1,78 @@ +.\" $NetBSD: hpet.4,v 1.3 2011/06/14 13:59:24 jruoho Exp $ +.\" +.\" Copyright (c) 2010 Jukka Ruohonen <jruohonen@iki.fi> +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Neither the name of the author nor the names of any +.\" contributors may be used to endorse or promote products derived +.\" from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT 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 June 14, 2011 +.Dt HPET 4 x86 +.Os +.Sh NAME +.Nm hpet +.Nd High Precision Event Timer +.Sh SYNOPSIS +.Cd "hpet* at acpihpetbus?" +.Cd "hpet* at acpinodebus?" +.Cd "hpet* at amdpcib?" +.Cd "hpet* at ichlpcib?" +.Sh DESCRIPTION +The +.Nm +driver supports High Precision Event Timers +.Pq Tn HPETs . +The +.Tn HPET +architecture defines one main 64-bit counter and several +additional timers with variable width. +The minimum clock frequency of the main timecounter is 10 MHz, +but much higher rates are common. +The additional 32 or 64 -bit parts are typically accessible via +.Tn MMIO +that is set by the system +.Tn BIOS +through +.Tn ACPI . +.Pp +As a +.Tn HPET +can provide higher interrupt rates than a +.Tn RTC +or +.Xr attimer 4 , +multimedia is one typical application context. +The interrupt logic is configurable through +.Tn I/O +.Tn APIC , +but a legacy mode is provided for older systems. +.Sh SEE ALSO +.Xr acpi 4 , +.Xr attimer 4 , +.Xr timecounter 9 , +.Xr tsc 9 +.Rs +.%A Intel Corporation +.%T IA-PC HPET (High Precision Event Timers) Specification +.%N Revision 1.0a +.%D October, 2004 +.%U http://www.intel.com/hardwaredesign/hpetspec_1.pdf +.Re diff --git a/static/netbsd/man4/man4.x86/ichlpcib.4 b/static/netbsd/man4/man4.x86/ichlpcib.4 new file mode 100644 index 00000000..f33f3160 --- /dev/null +++ b/static/netbsd/man4/man4.x86/ichlpcib.4 @@ -0,0 +1,126 @@ +.\" $NetBSD: ichlpcib.4,v 1.12 2017/02/18 22:39:02 wiz Exp $ +.\" +.\" Copyright (c) 2004 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to The NetBSD Foundation +.\" by Minoura Makoto and Matthew R. Green. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT 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 February 17, 2017 +.Dt ICHLPCIB 4 x86 +.Os +.Sh NAME +.Nm ichlpcib +.Nd Intel ICH LPC Interface Bridge +.Sh SYNOPSIS +.Cd "ichlpcib* at pci? dev ? function ?" +.Cd "fwhrng* at ichlpcib?" +.Cd "hpet0 at ichlpcib?" +.Cd "isa0 at ichlpcib?" +.Cd "gpio* at ichlpcib?" +.Cd "tco* at ichlpcib?" +.Sh DESCRIPTION +The +.Nm +driver supports the Intel ICH LPC Interface Bridges on compatible +chipsets. +Supported functions include: +.Bl -bullet +.It +Watchdog timer. +The watchdog timer may be configured for a 1 seconds (on ICH6 or newer) +and 2 seconds (on ICH5 or older) min period and for a 23 seconds +(on ICH5 or older) or 367 seconds max period (on ICH6 or newer). +.Pp +Prior to +.Nx 8.0 , +the +.Xr x86/tco 4 +watchdog timer was included as part of the +.Nm +driver, and did not require explicit configuration. +.It +Power Management timer. +A 24-bit timer available to be used by the timecounters framework. +.It +SpeedStep. +In some older systems the SpeedStep function is also available, and can be +used to switch between high and low frequency (to reduce power consumption) +via the +.Li machdep.speedstep_state +.Xr sysctl 8 +node. +A value of 0 will use the low frequency (low power) and a 1 will +enable the high frequency (full power). +.It +General Purpose Input/Output. +The ICH provides up to 64 I/O pins which can be accessed through the +.Xr gpio 4 +framework. +.El +.Sh SEE ALSO +.Xr gpio 4 , +.Xr x86/est 4 , +.Xr x86/fwhrng 4 , +.Xr x86/hpet 4 , +.Xr x86/ioapic 4 , +.Xr x86/tco 4 , +.Xr sysctl 8 , +.Xr wdogctl 8 +.Rs +.%A Intel Corporation +.%T Intel I/O Controller Hub 6 (ICH6) Family +.%D January, 2005 +.%U http://www.intel.com/assets/pdf/datasheet/301473.pdf +.Re +.Rs +.%A Intel Corporation +.%T Intel I/O Controller Hub 7 (ICH7) Family +.%D April, 2007 +.%U http://www.intel.com/Assets/PDF/datasheet/307013.pdf +.Re +.Rs +.%A Intel Corporation +.%T Intel I/O Controller Hub 8 (ICH8) Family +.%D May, 2007 +.%U http://www.intel.com/assets/pdf/datasheet/313056.pdf +.Re +.Rs +.%A Intel Corporation +.%T Using the Intel ICH Family Watchdog Timer (WDT) +.%D September, 2002 +.%U ftp://download.intel.com/design/chipsets/applnots/29227301.pdf +.Re +.Sh HISTORY +The +.Nm +driver first appeared in +.Nx 3.0 . +.Sh AUTHORS +The +.Nm +driver was written by +.An Minoura Makoto +and +.An Matthew R. Green . diff --git a/static/netbsd/man4/man4.x86/imcsmb.4 b/static/netbsd/man4/man4.x86/imcsmb.4 new file mode 100644 index 00000000..00e1e25f --- /dev/null +++ b/static/netbsd/man4/man4.x86/imcsmb.4 @@ -0,0 +1,171 @@ +.\" $NetBSD: imcsmb.4,v 1.10 2020/11/14 20:04:46 wiz Exp $ +.\" +.\" Copyright (c) 2018 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to The NetBSD Foundation +.\" by Paul Goyette +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT 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. +.\" +.\" SPDX-License-Identifier: BSD-2-Clause-FreeBSD +.\" +.\" Copyright (c) 2018 Panasas +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 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. +.\" +.\" $FreeBSD$ +.\" +.Dd April 16, 2020 +.Dt IMCSMB 4 x86 +.Os +.Sh NAME +.Nm imcsmb +.Nd Intel integrated Memory Controller (iMC) SMBus controller driver +.Sh SYNOPSIS +.Cd "imc* at pci? dev ? func ?" +.Cd "imcsmb* at imc?" +.Cd "iic* at i2cbus?" +.Pp +Alternatively, to load the driver as a module at boot time, place the following +line in +.Xr boot.cfg 5 : +.Pp +.Dl load=imcsmb +.Pp +or add the following line to your /etc/modules file: +.Pp +.Dl imcsmb +.Sh DESCRIPTION +The +.Nm +driver provides +.Xr iic 4 +support for the SMBus controller functionality in the integrated Memory +Controllers (iMCs) embedded in Intel Sandybridge-Xeon, Ivybridge-Xeon, +Haswell-Xeon, and Broadwell-Xeon CPUs. +Each CPU implements one or more iMCs, depending on the number of cores; each +iMC implements two SMBus controllers (iMC-SMBs). +The iMC-SMBs are used by the iMCs to read configuration information from the +DIMMs during POST. +They may also be used, by motherboard firmware or a BMC, to monitor the +temperature of the DIMMs. +.Pp +The iMC-SMBs are +.Sy not +general-purpose SMBus controllers. +By their nature, they are only ever attached to DIMMs, so they implement only +the SMBus operations needed for communicating with DIMMs. +Specifically: +.Pp +.Bl -dash -offset indent -compact +.It +READB +.It +READW +.It +WRITEB +.It +WRITEW +.El +.Pp +A more detailed discussion of the hardware and driver architecture can be found +at the top of +.Pa sys/dev/imcsmb/imc.c . +.Sh WARNINGS +As mentioned above, firmware might use the iMC-SMBs to read DIMM temperatures. +The public iMC documentation does not describe any sort of coordination +mechanism to prevent requests from different sources \(em such as the motherboard +firmware, a BMC, or the operating system \(em from interfering with each other. +.Pp +.Bf Sy +Therefore, it is highly recommended that developers contact the motherboard +vendor for any board-specific instructions on how to disable and re-enable DIMM +temperature monitoring. +.Ef +.Pp +DIMM temperature monitoring should be disabled before returning from +.Fn imcsmb_pci_request_bus , +and re-enabled before returning from +.Fn imcsmb_pci_release_bus . +The driver includes comments to that effect at the appropriate locations. +The driver has been tested and shown to work, with only that type of +modification, on certain motherboards from Intel. +(Unfortunately, those modifications were based on material covered under a +non-disclosure agreement, and therefore are not included in this driver.) +The driver has also been tested and shown to work as-is on various motherboards +from SuperMicro and ASUS. +.Pp +Because of the above, the +.Nm +driver is not included in the default +.Dv GENERIC +kernel. +In order to use the +.Nm +driver, you must compile a custom kernel, or load the driver using +.Xr modload 8 . +.Pp +The +.Xr iic 4 +driver will connect to the i2cbus instances created by +.Nm . +.Sh SEE ALSO +.Xr iic 4 +.Sh HISTORY +The +.Nm +driver first appeared in +.Fx 12.0 . +It was later ported to +.Nx 9.0 . +.Sh AUTHORS +.An -nosplit +The +.Nm +driver was originally written for Panasas by +.An Joe Kloss . +It was substantially refactored, and this manual page was written, by +.An Ravi Pokala Aq Mt rpokala@freebsd.org . +It was adapted to +.Nx +by +.An Paul Goyette Aq Mt pgoyette@NetBSD.org . diff --git a/static/netbsd/man4/man4.x86/lpt.4 b/static/netbsd/man4/man4.x86/lpt.4 new file mode 100644 index 00000000..6121bc0b --- /dev/null +++ b/static/netbsd/man4/man4.x86/lpt.4 @@ -0,0 +1,74 @@ +.\" $NetBSD: lpt.4,v 1.2 2024/09/07 19:13:28 rillig Exp $ +.\" +.\" Copyright (c) 1993 Christopher G. Demetriou +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed for the +.\" NetBSD Project. See https://www.NetBSD.org/ for +.\" information about NetBSD. +.\" 4. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 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. +.\" +.\" <<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>> +.\" +.Dd September 23, 2011 +.Dt LPT 4 x86 +.Os +.Sh NAME +.Nm lpt +.Nd +Parallel port driver +.Sh SYNOPSIS +.\" XXX this is awful hackery to get it to work right... -- cgd +.Cd "lpt0 at isa? port" \&"IO_LPT1\&" irq 7 +.Cd "lpt1 at isa? port" \&"IO_LPT2\&" +.Cd "lpt* at acpi?" +.Cd "lpt* at ofisa?" +.Cd "lpt* at pnpbios? index ?" +.Cd "lpt* at puc? port ?" +.Sh DESCRIPTION +This driver provides access to parallel ports. +The bits in the minor number select various features of the driver. +If no IRQ is +specified in the kernel configuration, only the polling device may be used. +.Pp +.Bl -column "Minor Bit" "Functionxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -offset indent +.It Sy "Minor Bit" Function +.It 128 Use the interruptless driver. (polling) +.It 64 \&Do not initialize the device on the port. +.It 32 Automatic LF on CR. +.El +.Sh FILES +.Bl -tag -width "/dev/lpt0xx" -compact +.It Pa /dev/lpt0 +first interrupt-driven parallel port device +.It Pa /dev/lpa0 +first polled parallel port device +.El +.Sh SEE ALSO +.Xr acpi 4 , +.Xr isa 4 , +.Xr ofisa 4 , +.Xr pnpbios 4 , +.Xr puc 4 diff --git a/static/netbsd/man4/man4.x86/mem.4 b/static/netbsd/man4/man4.x86/mem.4 new file mode 100644 index 00000000..8524a0f2 --- /dev/null +++ b/static/netbsd/man4/man4.x86/mem.4 @@ -0,0 +1,72 @@ +.\" $NetBSD: mem.4,v 1.2 2026/03/27 13:31:02 yamt Exp $ +.\" +.\" Copyright (c) 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" 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. +.\" +.\" from: @(#)mem.4 8.1 (Berkeley) 6/5/93 +.\" +.Dd March 27, 2026 +.Dt MEM 4 x86 +.Os +.Sh NAME +.Nm mem , +.Nm kmem +.Nd memory files +.Sh DESCRIPTION +The special file +.Nm /dev/mem +is an interface to the physical memory of the computer. +Byte offsets in this file are interpreted as physical memory addresses. +Reading and writing this file is equivalent to reading and writing +memory itself. +Only offsets within the bounds of +.Nm /dev/mem +are allowed. +.Pp +Kernel virtual memory is accessed through the interface +.Nm /dev/kmem +in the same manner as +.Nm /dev/mem . +Only kernel virtual addresses that are currently mapped to memory are allowed. +.Pp +On +.Tn ISA +the +.Tn I/O +memory space begins at physical address 0x000a0000 +and runs to 0x00100000. +.Sh FILES +.Bl -tag -width Pa -compact +.It Pa /dev/mem +.It Pa /dev/kmem +.El +.Sh HISTORY +The +.Nm mem , +.Nm kmem +files appeared in +.At v6 . diff --git a/static/netbsd/man4/man4.x86/odcm.4 b/static/netbsd/man4/man4.x86/odcm.4 new file mode 100644 index 00000000..b6a1a97d --- /dev/null +++ b/static/netbsd/man4/man4.x86/odcm.4 @@ -0,0 +1,75 @@ +.\" $NetBSD: odcm.4,v 1.6 2020/11/14 20:04:46 wiz Exp $ +.\" +.\" Copyright (c) 2011 Jukka Ruohonen <jruohonen@iki.fi> +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Neither the name of the author nor the names of any +.\" contributors may be used to endorse or promote products derived +.\" from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT 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 February 17, 2017 +.Dt ODCM 4 x86 +.Os +.Sh NAME +.Nm odcm +.Nd On-demand Clock Modulation +.Sh SYNOPSIS +.Cd "odcm0 at cpu0" +.Sh DESCRIPTION +The +.Nm +driver provides support for changing the duty cycle of a +.Tn CPU . +This is sometimes known as +.Dq on-demand clock modulation +.Pq Tn ODCM . +Refer to +.Xr acpicpu 4 +for additional details about +.Tn ODCM . +.Pp +The following +.Xr sysctl 8 +variables are available with +.Nm : +.Bl -tag -width "machdep.clockmod.available " -offset indent +.It Ic machdep.clockmod.target +The target duty cycle of all +.Tn CPUs . +The values range from 7 (100 %) to 0 (approximately 13 %). +.It Ic machdep.clockmod.current +The current duty cycle of +.Tn CPUs . +.It Ic machdep.clockmod.available +A list of available duty cycles. +.El +.Pp +Note that some errata may limit the availability of some duty cycles. +.Sh SEE ALSO +.Xr acpicpu 4 , +.Xr x86/est 4 , +.Xr x86/powernow 4 +.Sh CAVEATS +.Tn ODCM +is meant for short-term thermal management, not power management. +There is usually no reason for a system administrator +to change the values manually. +Lowering the duty cycle may dramatically decrease +performance and responsiveness of the system. diff --git a/static/netbsd/man4/man4.x86/powernow.4 b/static/netbsd/man4/man4.x86/powernow.4 new file mode 100644 index 00000000..7b18019a --- /dev/null +++ b/static/netbsd/man4/man4.x86/powernow.4 @@ -0,0 +1,77 @@ +.\" $NetBSD: powernow.4,v 1.5 2020/11/14 20:04:46 wiz Exp $ +.\" +.\" Copyright (c) 2011 Jukka Ruohonen <jruohonen@iki.fi> +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Neither the name of the author nor the names of any +.\" contributors may be used to endorse or promote products derived +.\" from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT 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 7, 2020 +.Dt POWERNOW 4 x86 +.Os +.Sh NAME +.Nm powernow +.Nd AMD PowerNow! and Cool'n'Quiet +.Sh SYNOPSIS +.Cd "powernow0 at cpu0" +.Sh DESCRIPTION +The +.Nm +driver supports +.Tn AMD +.Dq PowerNow! +and +.Dq Cool'n'Quiet +.Tn CPU +frequency scaling technologies. +The following +.Xr sysctl 8 +variables are available with +.Nm : +.Bl -tag -width "machdep.cpu.frequency.available" -offset 2n +.It Ic machdep.cpu.frequency.target +The target frequency of the +.Tn CPUs . +.It Ic machdep.cpu.frequency.current +The current frequency. +.It Ic machdep.cpu.frequency.available +The available frequencies. +.El +.Pp +Note, however, that these variables are +not guaranteed to exist in the future versions of +.Nx . +.Sh SEE ALSO +.Xr acpicpu 4 , +.Xr x86/est 4 , +.Xr x86/odcm 4 +.Sh CAVEATS +The +.Nm +driver is considered a legacy interface to +be used only with relatively old systems. +The driver supports only +.Tn AMD +processor families +.Tn K7 +(for instance, Duron, Athlon, and some Semprons) and +.Tn K8 +(namely, the early 64-bit family, including Athlon 64, Opteron, and Turion). diff --git a/static/netbsd/man4/man4.x86/soekrisgpio.4 b/static/netbsd/man4/man4.x86/soekrisgpio.4 new file mode 100644 index 00000000..2e99eb10 --- /dev/null +++ b/static/netbsd/man4/man4.x86/soekrisgpio.4 @@ -0,0 +1,64 @@ +.\" $NetBSD: soekrisgpio.4,v 1.5 2014/03/18 18:20:40 riastradh Exp $ +.\" from OpenBSD +.\" +.\" Copyright (c) 2013 Matt Dainty <matt <at> bodgit-n-scarper.com> +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES +.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR +.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF +.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +.\" +.Dd June 10, 2013 +.Dt SOEKRIS 4 x86 +.Os +.Sh NAME +.Nm soekrisgpio +.Nd Soekris net6501 GPIO and LEDs +.Sh SYNOPSIS +.Cd "soekrisgpio0 at isa? port 0x680" +.Cd "gpio* at soekrisgpio?" +.Sh DESCRIPTION +The +.Nm +driver provides support for the GPIO and LEDs as implemented by the Xilinx +Spartan FGPA integrated into the Soekris net6501 programmed with the default +bitstream found in the BIOS. +.Pp +Two standard +.Xr gpio 4 +interfaces are provided, one for the 16 real pins which can be configured as +either inputs or outputs and another with 2 output-only pins that map +to the error and ready LEDs respectively. +Both may be used with +.Xr gpioctl 8 . +.Sh SEE ALSO +.Xr gpio 4 , +.Xr intro 4 , +.Xr isa 4 , +.Xr gpioctl 8 +.Sh HISTORY +The +.Nm +driver first appeared in +.Nx 7.0 . +.Sh AUTHORS +The +.Nm +driver was written by +.An Matt Dainty Aq Mt matt@... +and imported from a patch for +.Ox +to +.Nx +by +.An Frank Kardel Aq Mt kardel@NetBSD.org . +.Sh BUGS +If the Xilinx FPGA is programmed with a different bitstream, the driver will +likely not function. diff --git a/static/netbsd/man4/man4.x86/tco.4 b/static/netbsd/man4/man4.x86/tco.4 new file mode 100644 index 00000000..41dac6c5 --- /dev/null +++ b/static/netbsd/man4/man4.x86/tco.4 @@ -0,0 +1,77 @@ +.\" $NetBSD: tco.4,v 1.5 2015/05/04 08:16:28 pgoyette Exp $ +.\" $OpenBSD: pwdog.4,v 1.6 2007/12/23 22:16:39 jmc Exp $ +.\" +.\" Copyright (c) 2015 The NetBSD Foundation +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to The NetBSD Foundation +.\" by Paul Goyette +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT 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 April 4, 2015 +.Dt TCO 4 x86 +.Os +.Sh NAME +.Nm tco +.Nd Intel Controller Hub TCO watchdog timer device +.Sh SYNOPSIS +.Cd "tco* at ichlpcib?" +.Sh DESCRIPTION +The +.Nm +driver provides support for the watchdog timer included in the Intel +Controller Hub (ICH). +.Pp +Setting the timer interval and arming the watchdog is performed using +the +.Xr wdogctl 8 +utility. +For ICH5 and earlier controllers, the interval is in the range of 2 to +23 seconds; for ICH6 and newer controllers, the interval is in the range +of 1 to 367 seconds. +.Sh SEE ALSO +.Xr wdogctl 8 +.Sh HISTORY +The +.Nm +driver first appeared in +.Nx 8.0 . +In earlier releases of +.Nx +the driver was included as part of the +.Xr x86/ichlpcib 4 +driver. +.Sh AUTHORS +.An -nosplit +The +.Nm +driver was written by +.An Minoura Makoto Aq Mt minoura@NetBSD.org +and +.An Matthew R. Green Aq Mt mrg@NetBSD.org . +The +.Nm +driver was separated from the +.Xr x86/ichlpcib 4 +driver by +.An Paul Goyette Aq Mt pgoyette@NetBSD.org . diff --git a/static/netbsd/man4/man4.x86/viac7temp.4 b/static/netbsd/man4/man4.x86/viac7temp.4 new file mode 100644 index 00000000..806ea644 --- /dev/null +++ b/static/netbsd/man4/man4.x86/viac7temp.4 @@ -0,0 +1,55 @@ +.\" $NetBSD: viac7temp.4,v 1.1 2024/04/30 19:35:29 andvar Exp $ +.\" +.\" Copyright (c) 2011 Jukka Ruohonen <jruohonen@iki.fi> +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Neither the name of the author nor the names of any +.\" contributors may be used to endorse or promote products derived +.\" from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT 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 April 30, 2024 +.Dt VIAC7TEMP 4 +.Os +.Sh NAME +.Nm viac7temp +.Nd VIA C7, VIA Nano and Zhaoxin CPU temperature sensor +.Sh SYNOPSIS +.Cd "viac7temp* at cpu?" +.Sh DESCRIPTION +The +.Nm +driver supports temperature sensors found in +.Tn VIA +.Tn C7, +.Tn VIA +.Tn Nano +and +.Tn Zhaoxin +processors. +The available information is available through the +.Xr envsys 4 +.Tn API +and the +.Xr envstat 8 +command. +.Sh SEE ALSO +.Xr coretemp 4 +.Sh AUTHORS +.An Jared D. McNeill Aq Mt jmcneill@invisible.ca |
