Module Name: src Committed By: tsutsui Date: Sun Jun 12 03:51:13 UTC 2022
Modified Files: src/distrib/sets/lists/base: mi src/distrib/sets/lists/man: mi src/etc/mtree: NetBSD.dist.base src/share/man/man4: Makefile Added Files: src/share/man/man4/man4.luna68k: Makefile autoconf.4 intro.4 lcd.4 mem.4 xp.4 Log Message: Add luna68k specific section 4 man pages. Taken from mostly OpenBSD/luna88k and partially NetBSD/hp300. To generate a diff of this commit: cvs rdiff -u -r1.1309 -r1.1310 src/distrib/sets/lists/base/mi cvs rdiff -u -r1.1748 -r1.1749 src/distrib/sets/lists/man/mi cvs rdiff -u -r1.245 -r1.246 src/etc/mtree/NetBSD.dist.base cvs rdiff -u -r1.723 -r1.724 src/share/man/man4/Makefile cvs rdiff -u -r0 -r1.1 src/share/man/man4/man4.luna68k/Makefile \ src/share/man/man4/man4.luna68k/autoconf.4 \ src/share/man/man4/man4.luna68k/intro.4 \ src/share/man/man4/man4.luna68k/lcd.4 \ src/share/man/man4/man4.luna68k/mem.4 \ src/share/man/man4/man4.luna68k/xp.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Modified files: Index: src/distrib/sets/lists/base/mi diff -u src/distrib/sets/lists/base/mi:1.1309 src/distrib/sets/lists/base/mi:1.1310 --- src/distrib/sets/lists/base/mi:1.1309 Wed Jun 8 19:27:37 2022 +++ src/distrib/sets/lists/base/mi Sun Jun 12 03:51:13 2022 @@ -1,4 +1,4 @@ -# $NetBSD: mi,v 1.1309 2022/06/08 19:27:37 uwe Exp $ +# $NetBSD: mi,v 1.1310 2022/06/12 03:51:13 tsutsui Exp $ # # Note: Don't delete entries from here - mark them as "obsolete" instead, # unless otherwise stated below. @@ -4206,6 +4206,7 @@ ./usr/share/man/cat4/hpcsh base-man-share ./usr/share/man/cat4/hppa base-man-share ./usr/share/man/cat4/i386 base-man-share +./usr/share/man/cat4/luna68k base-man-share ./usr/share/man/cat4/mac68k base-man-share ./usr/share/man/cat4/macppc base-man-share ./usr/share/man/cat4/mvme68k base-man-share @@ -4336,6 +4337,7 @@ ./usr/share/man/html4/hpcsh base-man-share ./usr/share/man/html4/hppa base-man-share ./usr/share/man/html4/i386 base-man-share +./usr/share/man/html4/luna68k base-man-share ./usr/share/man/html4/mac68k base-man-share ./usr/share/man/html4/macppc base-man-share ./usr/share/man/html4/mvme68k base-man-share @@ -4467,6 +4469,7 @@ ./usr/share/man/man4/hpcsh base-man-share ./usr/share/man/man4/hppa base-man-share ./usr/share/man/man4/i386 base-man-share +./usr/share/man/man4/luna68k base-man-share ./usr/share/man/man4/mac68k base-man-share ./usr/share/man/man4/macppc base-man-share ./usr/share/man/man4/mvme68k base-man-share Index: src/distrib/sets/lists/man/mi diff -u src/distrib/sets/lists/man/mi:1.1748 src/distrib/sets/lists/man/mi:1.1749 --- src/distrib/sets/lists/man/mi:1.1748 Mon Jun 6 10:56:27 2022 +++ src/distrib/sets/lists/man/mi Sun Jun 12 03:51:13 2022 @@ -1,4 +1,4 @@ -# $NetBSD: mi,v 1.1748 2022/06/06 10:56:27 nia Exp $ +# $NetBSD: mi,v 1.1749 2022/06/12 03:51:13 tsutsui Exp $ # # Note: don't delete entries from here - mark them as "obsolete" instead. # @@ -1432,6 +1432,12 @@ ./usr/share/man/cat4/lo.0 man-sys-catman .cat ./usr/share/man/cat4/lsu.0 man-obsolete obsolete ./usr/share/man/cat4/lua.0 man-sys-catman .cat +./usr/share/man/cat4/luna68k/autoconf.0 man-sys-catman .cat +./usr/share/man/cat4/luna68k/intro.0 man-sys-catman .cat +./usr/share/man/cat4/luna68k/kmem.0 man-sys-catman .cat +./usr/share/man/cat4/luna68k/lcd.0 man-sys-catman .cat +./usr/share/man/cat4/luna68k/mem.0 man-sys-catman .cat +./usr/share/man/cat4/luna68k/xp.0 man-sys-catman .cat ./usr/share/man/cat4/lxtphy.0 man-sys-catman .cat ./usr/share/man/cat4/m25p.0 man-sys-catman .cat ./usr/share/man/cat4/mac68k/adb.0 man-obsolete obsolete @@ -4654,6 +4660,12 @@ ./usr/share/man/html4/lmtemp.html man-sys-htmlman html ./usr/share/man/html4/lo.html man-sys-htmlman html ./usr/share/man/html4/lua.html man-sys-htmlman html +./usr/share/man/html4/luna68k/autoconf.html man-sys-htmlman html +./usr/share/man/html4/luna68k/intro.html man-sys-htmlman html +./usr/share/man/html4/luna68k/kmem.html man-sys-htmlman html +./usr/share/man/html4/luna68k/lcd.html man-sys-htmlman html +./usr/share/man/html4/luna68k/mem.html man-sys-htmlman html +./usr/share/man/html4/luna68k/xp.html man-sys-htmlman html ./usr/share/man/html4/lxtphy.html man-sys-htmlman html ./usr/share/man/html4/m25p.html man-sys-htmlman html ./usr/share/man/html4/mac68k/ae.html man-sys-htmlman html @@ -7718,6 +7730,12 @@ ./usr/share/man/man4/lo.4 man-sys-man .man ./usr/share/man/man4/lsu.4 man-obsolete obsolete ./usr/share/man/man4/lua.4 man-sys-man .man +./usr/share/man/man4/luna68k/autoconf.4 man-sys-man .man +./usr/share/man/man4/luna68k/intro.4 man-sys-man .man +./usr/share/man/man4/luna68k/kmem.4 man-sys-man .man +./usr/share/man/man4/luna68k/lcd.4 man-sys-man .man +./usr/share/man/man4/luna68k/mem.4 man-sys-man .man +./usr/share/man/man4/luna68k/xp.4 man-sys-man .man ./usr/share/man/man4/lxtphy.4 man-sys-man .man ./usr/share/man/man4/m25p.4 man-sys-man .man ./usr/share/man/man4/mac68k/adb.4 man-obsolete obsolete Index: src/etc/mtree/NetBSD.dist.base diff -u src/etc/mtree/NetBSD.dist.base:1.245 src/etc/mtree/NetBSD.dist.base:1.246 --- src/etc/mtree/NetBSD.dist.base:1.245 Mon Jun 6 10:56:28 2022 +++ src/etc/mtree/NetBSD.dist.base Sun Jun 12 03:51:13 2022 @@ -1,4 +1,4 @@ -# $NetBSD: NetBSD.dist.base,v 1.245 2022/06/06 10:56:28 nia Exp $ +# $NetBSD: NetBSD.dist.base,v 1.246 2022/06/12 03:51:13 tsutsui Exp $ # @(#)4.4BSD.dist 8.1 (Berkeley) 6/13/93 # Do not customize this file as it may be overwritten on upgrades. @@ -998,6 +998,7 @@ ./usr/share/man/cat4/hpcsh ./usr/share/man/cat4/hppa ./usr/share/man/cat4/i386 +./usr/share/man/cat4/luna68k ./usr/share/man/cat4/mac68k ./usr/share/man/cat4/macppc ./usr/share/man/cat4/mvme68k @@ -1107,6 +1108,7 @@ ./usr/share/man/html4/hpcsh ./usr/share/man/html4/hppa ./usr/share/man/html4/i386 +./usr/share/man/html4/luna68k ./usr/share/man/html4/mac68k ./usr/share/man/html4/macppc ./usr/share/man/html4/mvme68k @@ -1216,6 +1218,7 @@ ./usr/share/man/man4/hpcsh ./usr/share/man/man4/hppa ./usr/share/man/man4/i386 +./usr/share/man/man4/luna68k ./usr/share/man/man4/mac68k ./usr/share/man/man4/macppc ./usr/share/man/man4/mvme68k Index: src/share/man/man4/Makefile diff -u src/share/man/man4/Makefile:1.723 src/share/man/man4/Makefile:1.724 --- src/share/man/man4/Makefile:1.723 Thu Mar 24 14:00:19 2022 +++ src/share/man/man4/Makefile Sun Jun 12 03:51:13 2022 @@ -1,4 +1,4 @@ -# $NetBSD: Makefile,v 1.723 2022/03/24 14:00:19 manu Exp $ +# $NetBSD: Makefile,v 1.724 2022/06/12 03:51:13 tsutsui Exp $ # @(#)Makefile 8.1 (Berkeley) 6/18/93 MAN= aac.4 ac97.4 acardide.4 aceride.4 acphy.4 \ @@ -255,7 +255,7 @@ SUBDIR= man4.acorn32 man4.alpha man4.ami man4.cobalt man4.dreamcast man4.emips man4.evbarm man4.evbmips \ man4.evbppc \ man4.hp300 man4.hpcarm man4.hpcmips man4.hpcsh man4.hppa man4.i386 \ - man4.mac68k man4.macppc man4.mvme68k man4.pmax man4.prep \ + man4.luna68k man4.mac68k man4.macppc man4.mvme68k man4.pmax man4.prep \ man4.sandpoint man4.sgimips man4.sparc man4.sparc64 man4.sun2 \ man4.sun3 man4.vax man4.x68k man4.x86 Added files: Index: src/share/man/man4/man4.luna68k/Makefile diff -u /dev/null src/share/man/man4/man4.luna68k/Makefile:1.1 --- /dev/null Sun Jun 12 03:51:14 2022 +++ src/share/man/man4/man4.luna68k/Makefile Sun Jun 12 03:51:13 2022 @@ -0,0 +1,9 @@ +# $NetBSD: Makefile,v 1.1 2022/06/12 03:51:13 tsutsui Exp $ + +MAN= autoconf.4 intro.4 lcd.4 mem.4 xp.4 + +MLINKS= mem.4 kmem.4 + +MANSUBDIR=/luna68k + +.include <bsd.man.mk> Index: src/share/man/man4/man4.luna68k/autoconf.4 diff -u /dev/null src/share/man/man4/man4.luna68k/autoconf.4:1.1 --- /dev/null Sun Jun 12 03:51:14 2022 +++ src/share/man/man4/man4.luna68k/autoconf.4 Sun Jun 12 03:51:13 2022 @@ -0,0 +1,76 @@ +.\" $NetBSD: autoconf.4,v 1.1 2022/06/12 03:51:13 tsutsui Exp $ +.\" +.\" Copyright (c) 1990, 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: @(#)autoconf.4 8.1 (Berkeley) 6/9/93 +.\" +.Dd June 12, 2022 +.Dt AUTOCONF 4 luna68k +.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. +.Pp +Normally, the system uses the disk from which it was loaded as the root +filesystem. +If that is not possible, +or if such a system is booted with the +.Dv RB_ASKNAME +option (see +.Xr reboot 2 ) , +then the name of the root device is read from the console terminal at boot +time, and any available device may be used. +.Sh DIAGNOSTICS +.Bl -diag +.It unknown CPU type +You tried to boot +.Nx +on a +.Tn CPU +type which it doesn't +(or at least this compiled version of +.Nx +doesn't) understand. +.Pp +.It %s%d at mainbus0 +.It %s%d: %s +An on-board device controller was found. +.El +.Sh SEE ALSO +.Xr config 1 , +.Xr hp300/intro 4 Index: src/share/man/man4/man4.luna68k/intro.4 diff -u /dev/null src/share/man/man4/man4.luna68k/intro.4:1.1 --- /dev/null Sun Jun 12 03:51:14 2022 +++ src/share/man/man4/man4.luna68k/intro.4 Sun Jun 12 03:51:13 2022 @@ -0,0 +1,120 @@ +.\" $NetBSD: intro.4,v 1.1 2022/06/12 03:51:13 tsutsui Exp $ +.\" $OpenBSD: intro.4,v 1.10 2022/03/31 17:27:22 naddy Exp $ +.\" +.\" Copyright (c) 1983, 1986, 1991 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: @(#)intro.4 5.2 (Berkeley) 3/27/91 +.\" +.Dd June 12, 2022 +.Dt INTRO 4 luna68k +.Os +.Sh NAME +.Nm intro +.Nd introduction to luna68k special files and hardware support +.Sh DESCRIPTION +The manual pages in section 4 describe the special files, +related driver functions, and networking support +available in the system. +In this part of the manual, the +.Tn SYNOPSIS +section of +each configurable device gives a sample specification +for use in constructing a system description for the +.Xr config 1 +program. +The +.Tn DIAGNOSTICS +section lists messages which may appear on the console +and/or in the system error log +.Pa /var/log/messages +due to errors in device operation; +see +.Xr syslogd 8 +for more information. +.Pp +This section contains both devices +which may be configured into the system +and network related information. +The networking support is introduced in +.Xr netintro 4 . +.Sh DEVICE SUPPORT +This section describes the hardware supported on the +luna68k platform. +Software support for these devices comes in two forms. +A hardware device may be supported with a character or block +.Em device driver , +or it may be used within the networking subsystem and have a +.Em network interface driver . +Block and character devices are accessed through files in the file +system of a special type; see +.Xr mknod 8 . +Network interfaces are indirectly accessed through the interprocess +communication facilities provided by the system; see +.Xr socket 2 . +.Pp +A hardware device is identified to the system at configuration time +and the appropriate device or network interface driver is then compiled +into the system. +When the resultant system is booted, the autoconfiguration facilities +in the system probe for the device and, if found, enable the software +support for it. +If a device does not respond at autoconfiguration +time, it is not accessible at any time afterwards. +To enable a device which did not autoconfigure, +the system will have to be rebooted. +.Pp +The autoconfiguration system is described in +.Xr luna68k/autoconf 4 . +.Sh LIST OF DEVICES +The devices listed below are supported in this incarnation of +the system. +Pseudo-devices are not listed. +Devices are indicated by their functional interface. +Not all supported devices are listed. +.Pp +.Bl -tag -width "luna68k/lcd(4)" -offset indent -compact +.\".It Xr clock 4 +.\"battery-backed clock +.\".It Xr fb 4 +.\"on-board frame buffer +.It Xr luna68k/lcd 4 +front panel LCD display +.It Xr le 4 +AMD LANCE Ethernet device +.\".It Xr sio 4 +.\"on-board serial ports +.It Xr spc 4 +Fujitsu MB87030/MB89352 SCSI device +.\".It Xr ws 4 +.\"on-board keyboard and mouse ports +.It Xr luna68k/xp 4 +HD647180X I/O processor +.El +.Sh SEE ALSO +.Xr config 1 +.Xr luna68k/autoconf 4 Index: src/share/man/man4/man4.luna68k/lcd.4 diff -u /dev/null src/share/man/man4/man4.luna68k/lcd.4:1.1 --- /dev/null Sun Jun 12 03:51:14 2022 +++ src/share/man/man4/man4.luna68k/lcd.4 Sun Jun 12 03:51:13 2022 @@ -0,0 +1,86 @@ +.\" $NetBSD: lcd.4,v 1.1 2022/06/12 03:51:13 tsutsui Exp $ +.\" $OpenBSD: lcd.4,v 1.4 2015/02/15 22:26:45 bentley Exp $ +.\" +.\" Copyright (c) 2007 Kenji AOYAMA <aoy...@nk-home.net> +.\" 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. +.\" +.Dd June 12, 2022 +.Dt LCD 4 luna68k +.Os +.Sh NAME +.Nm lcd +.Nd front panel LCD display +.Sh SYNOPSIS +.Cd "lcd0 at mainbus0" +.Sh DESCRIPTION +The +.Nm +driver provides access to the front panel LCD display on LUNA. +It is accessed using +.Xr write 2 +to print the characters on the LCD. +The device has a physical display area of 16 characters x 2 lines +and an internal line buffer of 40 characters x 2 lines. +.Pp +The following ioctl calls apply to the +.Nm +device: +.Bl -tag -width LCD +.It Dv LCDCLS +Clear the LCD screen, restore display area from shift and move the +cursor to upper-left position. +.It Dv LCDHOME +Restore display area from shift and move the cursor to upper-left +position. +.It Dv LCDMODE Fa "int *" +Specify cursor advance direction and display shift mode. +.It Dv LCDDISP Fa "int *" +Control display on/off, cursor on/off, and cursor blinking on/off. +.It Dv LCDMOVE Fa "int *" +Move the cursor or shift the display area. +.It Dv LCDSEEK Fa "int *" +Move the cursor to the specified position. +On the first line, the position is specified by a value between 0x00 and 0x27. +On the second line, the value is between 0x40 and 0x67. +.It Dv LCDRESTORE +Restore boot-time LCD message. +.El +.Pp +These ioctl parameters are defined in +.In machine/lcd.h . +.Sh FILES +.Bl -tag -width /dev/lcd +.It Pa /dev/lcd +.El +.Sh SEE ALSO +.Xr ioctl 2 +.Sh HISTORY +The +.Nm +driver originally first appeared in +.Ox 4.1 . +It was ported from +.Ox +and first appeared in +.Nx 8.0 . Index: src/share/man/man4/man4.luna68k/mem.4 diff -u /dev/null src/share/man/man4/man4.luna68k/mem.4:1.1 --- /dev/null Sun Jun 12 03:51:14 2022 +++ src/share/man/man4/man4.luna68k/mem.4 Sun Jun 12 03:51:13 2022 @@ -0,0 +1,77 @@ +.\" $NetBSD: mem.4,v 1.1 2022/06/12 03:51:13 tsutsui Exp $ +.\" $OpenBSD: mem.4,v 1.4 2018/01/12 04:36:44 deraadt Exp $ +.\" Copyright (c) 1992, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This software was developed by the Computer Systems Engineering group +.\" at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and +.\" contributed to Berkeley. +.\" +.\" 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 June 12, 2022 +.Dt MEM 4 luna68k +.Os +.Sh NAME +.Nm mem , +.Nm kmem +.Nd memory files +.Sh DESCRIPTION +The file +.Pa /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. +An error will be returned if an attempt is made to reference +an offset outside of +.Pa /dev/mem . +.Pp +Kernel virtual memory is accessed via the file +.Pa /dev/kmem +in the same manner as +.Pa /dev/mem . +Only kernel virtual addresses that are currently mapped to memory are allowed. +.Pp +On the luna68k, physical memory is always contiguous and begens at +.Ad 0x00000000 , +and kernel virtual memory also begins at +.Ad 0x00000000 . +.Pp +.Sh FILES +.Bl -tag -width /dev/kmem -compact +.It Pa /dev/mem +.It Pa /dev/kmem +.El +.Sh HISTORY +The files +.Nm mem +and +.Nm kmem +appeared in +.At v6 . Index: src/share/man/man4/man4.luna68k/xp.4 diff -u /dev/null src/share/man/man4/man4.luna68k/xp.4:1.1 --- /dev/null Sun Jun 12 03:51:14 2022 +++ src/share/man/man4/man4.luna68k/xp.4 Sun Jun 12 03:51:13 2022 @@ -0,0 +1,75 @@ +.\" $NetBSD: xp.4,v 1.1 2022/06/12 03:51:13 tsutsui Exp $ +.\" $OpenBSD: xp.4,v 1.2 2017/02/11 23:08:43 jmc Exp $ +.\" +.\" Copyright (c) 2017 Kenji Aoyama. +.\" +.\" 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 12, 2022 +.Dt XP 4 luna68k +.Os +.Sh NAME +.Nm xp +.Nd HD647180X I/O processor +.Sh SYNOPSIS +.Cd "xpbus0 at mainbus0" +.Cd "xp0 at xpbus0" +.Sh DESCRIPTION +The file +.Pa /dev/xp +is an +.Xr mmap 2 +capable interface to the memory area of the HD647180X I/O processor +(so-called "XP") on LUNA-I and LUNA-II. +Byte offsets in this file are interpreted as relative memory addresses +of the I/O processor. +The range should be between 0x0 and 0xffff. +.Pp +The following +.Xr ioctl 2 +call applies to +.Pa /dev/xp : +.Bl -tag -width 4n +.It Dv XPIOCDOWNLD Fa "struct xp_download" +Load binary and reset I/O processor. +.Bd -literal -offset indent +struct xp_download { + u_int size; + u_int8_t *data; +}; +.Ed +.Pp +The +.Va size +member specifies the loading binary size, in bytes. +The +.Va data +member points to the binary image. +.El +.Sh FILES +.Bl -tag -width /dev/xp -compact +.It Pa /dev/xp +.El +.Sh ERRORS +.Bl -tag -width Er +.It Bq Er EACCES +The device is opened without write permission. +.It Bq Er EINVAL +The specified size is 0 or more than the I/O processor's memory size. +.El +.Sh SEE ALSO +.Xr ioctl 2 +.Sh HISTORY +The +.Pa /dev/xp +file first appeared in +.Nx 7.1 .