summaryrefslogtreecommitdiff
path: root/static/openbsd/man8/man8.alpha
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 14:02:27 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 14:02:27 -0400
commit6d8bdc65446a704d0750217efd05532fc641ea7d (patch)
tree8ae6d698b3c9801750a8b117b3842fb369872a3a /static/openbsd/man8/man8.alpha
parent2f467bd7ff8f8db0dafa40426166491d7f57f368 (diff)
docs: OpenBSD Man Pages Added
Diffstat (limited to 'static/openbsd/man8/man8.alpha')
-rw-r--r--static/openbsd/man8/man8.alpha/MAKEDEV.8284
-rw-r--r--static/openbsd/man8/man8.alpha/Makefile4
-rw-r--r--static/openbsd/man8/man8.alpha/boot_alpha.8115
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.