diff options
Diffstat (limited to 'static/openbsd/man8/man8.hppa')
| -rw-r--r-- | static/openbsd/man8/man8.hppa/MAKEDEV.8 | 263 | ||||
| -rw-r--r-- | static/openbsd/man8/man8.hppa/Makefile | 4 | ||||
| -rw-r--r-- | static/openbsd/man8/man8.hppa/boot_hppa.8 | 347 |
3 files changed, 614 insertions, 0 deletions
diff --git a/static/openbsd/man8/man8.hppa/MAKEDEV.8 b/static/openbsd/man8/man8.hppa/MAKEDEV.8 new file mode 100644 index 00000000..fcb4e6a1 --- /dev/null +++ b/static/openbsd/man8/man8.hppa/MAKEDEV.8 @@ -0,0 +1,263 @@ +.\" $OpenBSD: MAKEDEV.8,v 1.79 2025/09/29 01:02:58 deraadt Exp $ +.\" +.\" THIS FILE AUTOMATICALLY GENERATED. DO NOT EDIT. +.\" generated from: +.\" +.\" OpenBSD: etc.hppa/MAKEDEV.md,v 1.71 2025/09/29 01:00:14 deraadt Exp +.\" OpenBSD: MAKEDEV.common,v 1.122 2025/01/08 23:09:25 kirill Exp +.\" OpenBSD: MAKEDEV.man,v 1.10 2025/09/29 01:00:14 deraadt Exp +.\" OpenBSD: MAKEDEV.mansub,v 1.2 2004/02/20 19:13:01 miod Exp +.\" +.\" Copyright (c) 2004, Miodrag Vallat +.\" Copyright (c) 2001-2004 Todd T. Fries <todd@OpenBSD.org> +.\" +.\" 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 $Mdocdate: September 29 2025 $ +.Dt MAKEDEV 8 hppa +.Os +.Sh NAME +.Nm MAKEDEV +.Nd create system and device special files +.Sh SYNOPSIS +.Nm MAKEDEV +.Op Ar name ... +.Sh DESCRIPTION +The shell script +.Nm , +found in the +.Pa /dev +directory, is used to create various special files. +See +.Xr intro 4 +for a more complete discussion of special files. +.Pp +.Nm +takes any number of device names as arguments, where the names are +the common abbreviation for the device or group of devices. +Files are created in the current working directory. +.Pp +Where a device name is followed by a star +.Sq * , +the star must be replaced by a unit number. +If units are expected for a device but not provided, +.Nm +will supply the standard numbers in most cases. +.Pp +The hppa supports the following devices: +.Pp +.Sy Special device names +.Bl -tag -width tenletters -compact +.It Ar all +Creates special files for all devices on hppa. +.It Ar ramdisk +Ramdisk kernel devices. +.It Ar std +Creates the +.Sq standard +devices (console, klog, kmem, ksyms, mem, null, +stderr, stdin, stdout, tty, zero) +which are absolutely necessary for the system to function properly. +.It Ar local +Creates configuration-specific devices, by invoking the shell file +.Pa MAKEDEV.local . +.It Ar redodisks +Recreates all partitions for disks found in +.Pa /etc . +.El +.Pp +.Sy Disks +.Bl -tag -width tenletters -compact +.It Ar cd* +ATAPI and SCSI CD-ROM drives, see +.Xr cd 4 . +.It Ar fd* +Floppy disk drives (3 1/2", 5 1/4"), see +.Xr fd 4 . +.It Ar sd* +SCSI disks, including flopticals, see +.Xr sd 4 . +.It Ar rd* +.Dq rd +pseudo-disks, see +.Xr rd 4 . +.It Ar vnd* +.Dq file +pseudo-disk devices, see +.Xr vnd 4 . +.It Ar wd* +.Dq winchester +disk drives (ST506, IDE, ESDI, RLL, ...), see +.Xr wd 4 . +.El +.Pp +.Sy Tapes +.Bl -tag -width tenletters -compact +.It Ar ch* +SCSI media changers, see +.Xr ch 4 . +.It Ar st* +SCSI tape drives, see +.Xr st 4 . +.El +.Pp +.Sy Terminal ports +.Bl -tag -width tenletters -compact +.It Ar tty[0-7][0-9a-f] +NS16x50 serial ports, see +.Xr com 4 . +.El +.Pp +.Sy Pseudo terminals +.Bl -tag -width tenletters -compact +.It Ar ptm +pty master device, see +.Xr ptm 4 . +.It Ar pty* +Set of 62 master pseudo terminals, see +.Xr pty 4 . +.It Ar tty* +Set of 62 slave pseudo terminals, see +.Xr tty 4 . +.El +.Pp +.Sy Console ports +.Bl -tag -width tenletters -compact +.It Ar ttyC-J* +wscons display devices, see +.Xr wsdisplay 4 . +.It Ar wscons +Minimal wscons devices, see +.Xr wscons 4 . +.It Ar wskbd* +wscons keyboards, see +.Xr wskbd 4 . +.It Ar wsmux +wscons keyboard/mouse mux devices, see +.Xr wsmux 4 . +.El +.Pp +.Sy Pointing devices +.Bl -tag -width tenletters -compact +.It Ar wsmouse* +wscons mice, see +.Xr wsmouse 4 . +.El +.Pp +.Sy Printers +.Bl -tag -width tenletters -compact +.It Ar lpt* +IEEE 1284 centronics printer, see +.Xr lpt 4 . +.El +.Pp +.Sy USB devices +.Bl -tag -width tenletters -compact +.It Ar uall +All USB devices, see +.Xr usb 4 . +.It Ar usb* +Bus control devices used by usbd for attach/detach, see +.Xr usb 4 . +.It Ar uhid* +Generic HID devices, see +.Xr uhid 4 . +.It Ar fido +fido/* nodes, see +.Xr fido 4 . +.It Ar ujoy +ujoy/* nodes, see +.Xr ujoy 4 . +.It Ar ugen* +Generic USB devices, see +.Xr ugen 4 . +.It Ar ulpt* +Printer devices, see +.Xr ulpt 4 . +.It Ar ttyU* +USB serial ports, see +.Xr ucom 4 . +.El +.Pp +.Sy Special purpose devices +.Bl -tag -width tenletters -compact +.It Ar audio* +Audio devices, see +.Xr audio 4 . +.It Ar bio +ioctl tunnel pseudo-device, see +.Xr bio 4 . +.It Ar bpf +Berkeley Packet Filter, see +.Xr bpf 4 . +.It Ar diskmap +Disk mapper, see +.Xr diskmap 4 . +.It Ar dt +Dynamic Tracer, see +.Xr dt 4 . +.It Ar fd +fd/* nodes, see +.Xr fd 4 . +.It Ar fuse +Userland Filesystem, see +.Xr fuse 4 . +.It Ar hotplug +devices hot plugging, see +.Xr hotplug 4 . +.It Ar pci* +PCI bus devices, see +.Xr pci 4 . +.It Ar pdc +PDC device, see +.Xr pdc 4 . +.It Ar pf +Packet Filter, see +.Xr pf 4 . +.It Ar pppx* +PPP Multiplexer, see +.Xr pppx 4 . +.It Ar pppac* +PPP Access Concentrator, see +.Xr pppac 4 . +.It Ar *random +In-kernel random data source, see +.Xr random 4 . +.It Ar tun* +Network tunnel driver, see +.Xr tun 4 . +.It Ar tap* +Ethernet tunnel driver, see +.Xr tap 4 . +.It Ar uk* +Unknown SCSI devices, see +.Xr uk 4 . +.It Ar video* +Video V4L2 devices, see +.Xr video 4 . +.It Ar vscsi* +Virtual SCSI controller, see +.Xr vscsi 4 . +.It Ar kstat +Kernel Statistics, see +.Xr kstat 4 . +.El +.Sh FILES +.Bl -tag -width /dev -compact +.It Pa /dev +The special file directory. +.El +.Sh SEE ALSO +.Xr intro 4 , +.Xr config 8 , +.Xr mknod 8 diff --git a/static/openbsd/man8/man8.hppa/Makefile b/static/openbsd/man8/man8.hppa/Makefile new file mode 100644 index 00000000..730e61ee --- /dev/null +++ b/static/openbsd/man8/man8.hppa/Makefile @@ -0,0 +1,4 @@ +MAN = boot_hppa.8 \ + MAKEDEV.8 + +include ../../../mandoc.mk diff --git a/static/openbsd/man8/man8.hppa/boot_hppa.8 b/static/openbsd/man8/man8.hppa/boot_hppa.8 new file mode 100644 index 00000000..70d0eeb5 --- /dev/null +++ b/static/openbsd/man8/man8.hppa/boot_hppa.8 @@ -0,0 +1,347 @@ +.\" $OpenBSD: boot_hppa.8,v 1.15 2022/09/05 10:29:27 kn Exp $ +.\" +.\" Copyright (c) 2002, Miodrag Vallat. +.\" 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 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. +.\" +.Dd $Mdocdate: September 5 2022 $ +.Dt BOOT_HPPA 8 hppa +.Os +.Sh NAME +.Nm boot_hppa +.Nd hppa system bootstrapping procedures +.Sh DESCRIPTION +.Ss System starts +When powered on, after a panic, or if the system is rebooted via +.Xr reboot 8 +or +.Xr shutdown 8 , +the hppa firmware +.Pq Dq PDC +will proceed to its initialization, and will boot an operating system +if autoboot is enabled. +.\" +.Ss Boot process description +System boot blocks are provided as a +.Dq LIF +.Pq Logical Interchange Format +archive, either on a disk device, or via the network, using the +.Em bootp +or +.Em rboot +protocols, depending on the PDC version. +A small +.Xr mkboot 8 +utility +is provided for combining primary boot and a number +of images (OS kernels or standalone binaries) +into one +.Dq LIF +volume suitable for booting. +.Ss PDC concepts +If autoboot is enabled, the PDC will attempt to boot from the specified +.Dq boot path +value. +If no +.Dq boot path +has been specified, the PDC will then scan for bootable devices and +boot from the first found, after a few seconds allowing the user to +interrupt the boot process. +If autoboot is disabled, the PDC will enter interactive mode, after an +optional device scan. +In all cases, it is possible to enter interactive mode by holding the +escape key during the selftests, or when prompted to do so to abort +the current operation, unless the PDC has been configured in +.Dq secure mode . +.\" +.Ss ISL interaction +.Dq ISL +stands for +.Dq Initial System Loader +and is the +.Xr boot 8 +program in +.Ox . +On all versions of the PDC except for the 712 and 725 models the +.Dq boot +command (see below) will be followed by the question: +.Dq Interact with IPL (Y, N, or Cancel)?> +where a positive answer will invoke an interactive prompt in the +.Xr boot 8 +program later and negative will thus suppress it. +A cancellation will abort the boot process. +.Pp +On the 712 and 725 models firmware an additional +.Dq isl +argument should be given to the +.Dq boot +command to invoke the +.Xr boot 8 +interactive prompt. +With the default behaviour being a non-interactive boot process. +.\" +.Ss Old PDC operation +This version is used on the following models: +705, 7x0, 715/33/50/75, 725/50/75, 735, 755. +There are two levels of interactive commands in this version. +The first level is a short menu: +.Bd -literal -offset indent +b) Boot from specified device +s) Search for bootable device +a) Enter Boot Administration mode +x) Exit and continue boot sequence + +Select from menu: +.Ed +.Pp +which provides the following commands: +.Pp +.Bl -tag -width "XXX" -offset indent -compact +.It Cm b +boot from a device found during the scan, +either with its short +.Dq P# +form, or a complete name specification. +For example, to boot from the +.Tn SCSI +disk with id 6 off the built-in (first) controller, +one would enter +.Ic b Ar scsi.6.0 . +.It Cm s +rescan for bootable devices. +.It Cm a +enter the second part of interactive mode. +.It Cm x +resume an interrupted boot sequence. +.El +.Pp +The +.Dq Boot Administration +mode, recognizable with its +.Em BOOT_ADMIN> +prompt, controls the various boot options. +The complete list of commands depends on the machine and PDC version. +The following list only mentions commands impacting the boot process. +.Bl -tag -width AUTOSELECT -offset indent +.It AUTOSELECT +Displays or changes the autoboot setting. +If autoselect is set to +.Dq on , +the PDC will always attempt to boot the first bootable device found in +this order: +.Bl -enum -offset indent -compact +.It +Boot device +.Em path +setting. +.It +.Tn SCSI +devices connected to the built-in +.Tn SCSI +controller, +the highest ID numbers being preferred. +.It +Network +.Em rboot +server (see also +.Xr rbootd 8 ) . +.It +Other +.Tn SCSI +devices connected to secondary controllers, +the highest ID numbers being preferred. +.El +If the +.Em primary path +setting defines a bootable device, no device scan will occur. +.It BOOT +Boots off the specified device. +It is similar to the +.Ic b +command from the short menu above. +The +.Dq primary +and +.Dq alternate +path settings may be booted with +.Ic boot Ar pri +and +.Ic boot Ar alt +respectively. +.It PATH +Displays or changes the boot and console devices. +The boot device is defined as the +.Dq primary +path, and another setting may be stored as the +.Dq alternate +path for rescue purposes. +For example, to define the primary boot path to the +.Tn SCSI +disk with ID 5 connected to the built-in controller, one would enter +.Ic path primary Ar scsi.5 +.Pp +When invoked without parameters, +.Ic path +will list the various path settings. +.El +.\" +.Ss Modern PDC operation +Machines equipped with 7100LC, 7200 or 7300LC CPU types are +usually blessed with a different kind of PDC. +There is only one interactive mode, with a +.Em BOOT_ADMIN> +prompt, which provides both boot settings and commands. +The complete list of commands depends on the machine and PDC version. +The following list only mentions commands impacting the boot process. +.Bl -tag -width auto\ search -offset indent +.It Ic auto boot +Displays or changes the autoboot setting. +If +.Ic auto boot +is set to +.Dq on , +the PDC will always attempt to boot. +The booted device chosen will depend on the +.Ic auto search +setting. +.It Ic auto search +Displays or changes the device scan setting. +If +.Ic auto search +is set to +.Dq on , +the PDC will attempt to boot the first bootable device found in +this order: +.Bl -enum -offset indent -compact +.It +Boot device +.Em path +setting. +.It +.Tn SCSI +devices connected to the built-in +.Tn SCSI +controller, +the highest ID numbers being preferred. +.It +Network +.Em bootp +server (see also +.Xr dhcpd 8 ) . +.It +Other +.Tn SCSI +devices connected to secondary controllers, +the highest ID numbers being preferred. +.El +If +.Ic auto search +is set to +.Dq off +and the primary boot path points to a bootable device, +no device scan will occur. +.Pp +Note that setting +.Ic auto search +to +.Dq on +will force autoboot, regardless of the +.Ic auto boot +value. +.It Ic boot +Boots off the specified device. +The +.Dq primary +and +.Dq alternate +path settings may be booted with +.Ic boot Ar pri +and +.Ic boot Ar alt +respectively. +.It Ic path +Displays or changes the boot and console devices. +The boot device is defined as the +.Dq primary +path, and another setting may be stored as the +.Dq alternate +path for rescue purposes. +For example, to define the primary boot path to the +.Tn SCSI +disk with ID 5 connected to the built-in controller, one would enter +.Ic path pri Ar scsi.5 . +.Pp +When invoked without parameters, +.Ic path +will list the various path settings. +.El +.\" +.Ss Boot process options +The +.Ox +hppa boot loader program is extensively described in a separate document, +.Xr boot 8 . +.Ss Abnormal system termination +If the system crashes, it will enter the kernel debugger, +.Xr ddb 4 , +if it is configured in the kernel. +If the crash occurred during +initialization and the debugger is not present or is exited, the +kernel will halt the system. +If the crash occurred during normal operation and the debugger +is not present or is exited, the system will attempt a dump to the +configured dump device (which will be automatically recovered with +.Xr savecore 8 +during the next multi-user boot cycle), and after the dump is complete +(successful or not) the kernel will attempt a reboot. +.Sh FILES +.Bl -tag -width /usr/mdec/xxbootxx -compact +.It Pa /bsd +default system kernel +.It Pa /bsd.rd +standalone installation kernel, suitable for disaster recovery +.It Pa boot.lif +network bootstrap and kernel combined image +.It Pa /usr/mdec/cdboot +primary bootstrap for +.Dq cd9660 +file system +.It Pa /usr/mdec/xxboot +primary bootstrap for +.Dq ffs +file system +.It Pa /usr/mdec/boot +system bootstrap (usually also installed as +.Pa /boot ) +.El +.Sh SEE ALSO +.Xr ddb 4 , +.Xr boot 8 , +.Xr dhcpd 8 , +.Xr halt 8 , +.Xr init 8 , +.Xr installboot 8 , +.Xr rbootd 8 , +.Xr reboot 8 , +.Xr savecore 8 , +.Xr shutdown 8 |