diff options
| author | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 14:02:27 -0400 |
|---|---|---|
| committer | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 14:02:27 -0400 |
| commit | 6d8bdc65446a704d0750217efd05532fc641ea7d (patch) | |
| tree | 8ae6d698b3c9801750a8b117b3842fb369872a3a /static/openbsd/man8/man8.alpha | |
| parent | 2f467bd7ff8f8db0dafa40426166491d7f57f368 (diff) | |
docs: OpenBSD Man Pages Added
Diffstat (limited to 'static/openbsd/man8/man8.alpha')
| -rw-r--r-- | static/openbsd/man8/man8.alpha/MAKEDEV.8 | 284 | ||||
| -rw-r--r-- | static/openbsd/man8/man8.alpha/Makefile | 4 | ||||
| -rw-r--r-- | static/openbsd/man8/man8.alpha/boot_alpha.8 | 115 |
3 files changed, 403 insertions, 0 deletions
diff --git a/static/openbsd/man8/man8.alpha/MAKEDEV.8 b/static/openbsd/man8/man8.alpha/MAKEDEV.8 new file mode 100644 index 00000000..d97b634d --- /dev/null +++ b/static/openbsd/man8/man8.alpha/MAKEDEV.8 @@ -0,0 +1,284 @@ +.\" $OpenBSD: MAKEDEV.8,v 1.85 2025/09/29 01:02:58 deraadt Exp $ +.\" +.\" THIS FILE AUTOMATICALLY GENERATED. DO NOT EDIT. +.\" generated from: +.\" +.\" OpenBSD: etc.alpha/MAKEDEV.md,v 1.79 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 alpha +.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 alpha supports the following devices: +.Pp +.Sy Special device names +.Bl -tag -width tenletters -compact +.It Ar all +Creates special files for all devices on alpha. +.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 rd* +.Dq rd +pseudo-disks, see +.Xr rd 4 . +.It Ar sd* +SCSI disks, including flopticals, see +.Xr sd 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 . +.It Ar ttyc* +Cyclades serial ports, see +.Xr cy 4 . +.It Ar ttyB* +DEC 3000 serial ports, see +.Xr zs 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 lpa* +Polled printer port, see +.Xr lpt 4 . +.It Ar lpt* +IEEE 1284 centronics printer, see +.Xr lpt 4 . +.El +.Pp +.Sy USB devices +.Bl -tag -width tenletters -compact +.It Ar ttyU* +USB serial ports, see +.Xr ucom 4 . +.It Ar uall +All USB devices, see +.Xr usb 4 . +.It Ar ugen* +Generic USB devices, see +.Xr ugen 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 ulpt* +Printer devices, see +.Xr ulpt 4 . +.It Ar usb* +Bus control devices used by usbd for attach/detach, see +.Xr usb 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 bktr* +Video frame grabbers, see +.Xr bktr 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 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 radio* +FM tuner devices, see +.Xr radio 4 . +.It Ar *random +In-kernel random data source, see +.Xr random 4 . +.It Ar rmidi* +Raw MIDI devices, see +.Xr midi 4 . +.It Ar speaker +PC speaker, see +.Xr spkr 4 . +.It Ar tun* +Network tunnel driver, see +.Xr tun 4 . +.It Ar tap* +Ethernet tunnel driver, see +.Xr tap 4 . +.It Ar tuner* +Tuner devices, see +.Xr bktr 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.alpha/Makefile b/static/openbsd/man8/man8.alpha/Makefile new file mode 100644 index 00000000..8e160c60 --- /dev/null +++ b/static/openbsd/man8/man8.alpha/Makefile @@ -0,0 +1,4 @@ +MAN = boot_alpha.8 \ + MAKEDEV.8 + +include ../../../mandoc.mk diff --git a/static/openbsd/man8/man8.alpha/boot_alpha.8 b/static/openbsd/man8/man8.alpha/boot_alpha.8 new file mode 100644 index 00000000..e6eb7b39 --- /dev/null +++ b/static/openbsd/man8/man8.alpha/boot_alpha.8 @@ -0,0 +1,115 @@ +.\" $OpenBSD: boot_alpha.8,v 1.17 2023/03/13 20:32:28 miod 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 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. +.Dd $Mdocdate: March 13 2023 $ +.Dt BOOT_ALPHA 8 alpha +.Os +.Sh NAME +.Nm boot_alpha +.Nd Alpha system bootstrapping procedures +.Sh DESCRIPTION +.Ss Cold starts +When powered on, the SRM firmware will proceed to its initialization, and +will boot an operating system if the +.Em auto_action +variable is set to +.Dq boot +or +.Dq restart , +or will wait for interactive commands if set to +.Dq halt . +.Ss Warm starts +After a panic, or if the system is rebooted via +.Xr reboot 8 +or +.Xr shutdown 8 , +the SRM console will only restart the system if the +.Em auto_action +variable is set to +.Dq boot . +.Ss Boot process options +The SRM console will attempt to boot from the device listed in the +.Em bootdef_dev +variable. +A list of the recognized SRM devices can be obtained with the command +.Ic show dev +at the SRM prompt. +.Pp +The +.Ox +alpha boot loader program is extensively described in a separate document, +.Xr boot 8 . +.Ss Abnormal system termination +In case of system crashes, the kernel will usually enter the kernel +debugger, +.Xr ddb 4 , +unless it is not present in the kernel, or it is disabled via the +.Em ddb.panic +sysctl. +Upon leaving ddb, or if ddb was not entered, the kernel will halt the system +if it was still in device configuration phase, or attempt a dump to the +configured dump device, if possible. +The crash dump will then be recovered by +.Xr savecore 8 +during the next multi-user boot cycle. +It is also possible to force other behaviours from ddb. +.Sh FILES +.Bl -tag -width /usr/mdec/netboot -compact +.It Pa /bsd +default system kernel +.It Pa /bsd.rd +standalone installation kernel, suitable for disaster recovery +.It Pa /usr/mdec/bootxx +primary bootstrap for +.Dq ffs +file system +.It Pa /usr/mdec/boot +secondary bootstrap (usually also installed as +.Pa /boot ) +.It Pa /usr/mdec/netboot +network bootstrap +.El +.Sh SEE ALSO +.Xr ddb 4 , +.Xr boot 8 , +.Xr boot_config 8 , +.Xr halt 8 , +.Xr init 8 , +.Xr installboot 8 , +.Xr reboot 8 , +.Xr savecore 8 , +.Xr setnetbootinfo 8 , +.Xr shutdown 8 +.Rs +.%T "Alpha Architecture Reference Manual Third Edition" +.%Q "Alpha Architecture Committee" +.%I "Digital Press" +.%D 1998 +.Re +.Sh BUGS +The device names used by +.Ox Ns / Ns alpha +and the +.Tn SRM Console +often have no relation to each other. |
