diff options
Diffstat (limited to 'static/openbsd/man8/man8.macppc')
| -rw-r--r-- | static/openbsd/man8/man8.macppc/MAKEDEV.8 | 277 | ||||
| -rw-r--r-- | static/openbsd/man8/man8.macppc/Makefile | 4 | ||||
| -rw-r--r-- | static/openbsd/man8/man8.macppc/boot_macppc.8 | 177 |
3 files changed, 458 insertions, 0 deletions
diff --git a/static/openbsd/man8/man8.macppc/MAKEDEV.8 b/static/openbsd/man8/man8.macppc/MAKEDEV.8 new file mode 100644 index 00000000..ff8ff687 --- /dev/null +++ b/static/openbsd/man8/man8.macppc/MAKEDEV.8 @@ -0,0 +1,277 @@ +.\" $OpenBSD: MAKEDEV.8,v 1.89 2025/09/29 01:02:59 deraadt Exp $ +.\" +.\" THIS FILE AUTOMATICALLY GENERATED. DO NOT EDIT. +.\" generated from: +.\" +.\" OpenBSD: etc.macppc/MAKEDEV.md,v 1.82 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 macppc +.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 macppc supports the following devices: +.Pp +.Sy Special device names +.Bl -tag -width tenletters -compact +.It Ar all +Creates special files for all devices on macppc. +.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 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 cua[a-z]* +Zilog 8530 serial ports, see +.Xr zs 4 . +.It Ar tty[0-7][0-9a-f] +NS16x50 serial ports, see +.Xr com 4 . +.It Ar tty[a-z]* +Zilog 8530 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 wscons +Minimal wscons devices, see +.Xr wscons 4 . +.It Ar ttyC-J* +wscons display devices, see +.Xr wsdisplay 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 USB devices +.Bl -tag -width tenletters -compact +.It Ar uall +All USB devices, see +.Xr usb 4 . +.It Ar ttyU* +USB serial ports, see +.Xr ucom 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 apm +Power management device, see +.Xr apm 4 . +.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 dt +Dynamic Tracer, see +.Xr dt 4 . +.It Ar diskmap +Disk mapper, see +.Xr diskmap 4 . +.It Ar dri +Direct Rendering Infrastructure, see +.Xr drm 4 . +.It Ar fd +fd/* nodes, see +.Xr fd 4 . +.It Ar fuse +Userland Filesystem, see +.Xr fuse 4 . +.It Ar gpio* +General Purpose Input/Output, see +.Xr gpio 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 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.macppc/Makefile b/static/openbsd/man8/man8.macppc/Makefile new file mode 100644 index 00000000..02284efb --- /dev/null +++ b/static/openbsd/man8/man8.macppc/Makefile @@ -0,0 +1,4 @@ +MAN = boot_macppc.8 \ + MAKEDEV.8 + +include ../../../mandoc.mk diff --git a/static/openbsd/man8/man8.macppc/boot_macppc.8 b/static/openbsd/man8/man8.macppc/boot_macppc.8 new file mode 100644 index 00000000..93e580b1 --- /dev/null +++ b/static/openbsd/man8/man8.macppc/boot_macppc.8 @@ -0,0 +1,177 @@ +.\" $OpenBSD: boot_macppc.8,v 1.23 2022/09/05 10:29:27 kn Exp $ +.\" +.\" Copyright (c) 1992, 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. +.\" +.\" @(#)boot_macppc.8 +.\" +.Dd $Mdocdate: September 5 2022 $ +.Dt BOOT_MACPPC 8 macppc +.Os +.Sh NAME +.Nm boot_macppc +.Nd macppc system bootstrapping procedures +.Sh DESCRIPTION +.Ss System startup +When powered on, after a panic, or if the system is rebooted via +.Xr reboot 8 +or +.Xr shutdown 8 , +the Open Firmware will proceed to its initialization, +and will boot an operating system if the +.Va auto-boot?\& +variable is set to +.Dq true , +or will wait for interactive commands otherwise. +.Ss Boot process description +The Apple Open Firmware will normally load the kernel from the device and +filename as instructed by the +.Va boot-device +and +.Va boot-file +variables. +If the +.Va boot-file +variable is empty, the +.Ox +bootloader will look for a kernel named +.Pa bsd , +unless a different filename has been specified in the boot command. +To reset this variable to its default, empty, value, type the following +at the Open Firmware prompt: +.Pp +.Dl set-default boot-device +.Pp +The +.Ox +bootstrap program is named +.Dq ofwboot . +It can be installed either in a HFS partition or in a +MSDOS partition on the disk. +If MBR partitioning is chosen for +the disk, the bootstrap program will be installed automatically during the +.Ox +installation procedure. +For HFS shared disks, the +.Pa ofwboot +file must be installed manually. +The ofwboot program can be loaded from any Open Firmware recognized +disk or network device. +.Ss Boot process options +If invoked manually without parameters, or if the specified kernel could +not be loaded, the +.Ox +bootloader will let the user enter a boot device, kernel +filename and boot options. +.Pp +If the special line +.Ic exit +is entered, the bootloader will attempt to restart the machine. +.Pp +The file specification used is of the form: +.Pp +.Dl Oo Oo Ar promdev : Oc Ns Ar filename Oc Op Fl acds +.Pp +where +.Ar promdev +is an optional Open Firmware device name (such as +.Dq hd +or +.Dq ide ) . +Normal line editing characters can be used when typing the file +specification. +.Pp +The following options are recognized: +.Pp +.Bl -tag -width "-XXX" -offset indent -compact +.It Fl a +Prompt for the root filesystem and swap devices after the devices have +been configured. +.It Fl c +Enter the +.Dq User Kernel Config +mode upon startup +.Pq see Xr boot_config 8 . +.It Fl d +Enter the debugger, +.Xr ddb 4 , +as soon as the kernel console has been initialized. +.It Fl s +Boot the system single-user. +The system will be booted multi-user unless this option is specified. +.El +.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 +.Va 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. +.Ss Accessing the PROM +The prom can only be accessed during system reset, or at power-up. +To enter Open Firmware, press and hold +.Dq Cntrl +.Dq Cmd +.Dq o +.Dq f +as the machine resets until it enters the Open Firmware debugger. +.Pp +On an Xserve using serial console the System Identifier button is used to +enter Open Firmware instead of the keyboard. +To enter Open Firmware, hold down the System Identifier button while pressing +the Power button. +When the upper LED bank begins lighting up in sequence, repeatedly press +the System Identifier button until the seventh LED from the right is +highlighted in the lower bank. +Now hold the System Identifier button for two seconds, until all the top +row LEDs light up. +.Sh FILES +.Bl -tag -width /usr/mdec/ofwboot -compact +.It Pa /bsd +default system kernel +.It Pa /bsd.rd +standalone installation kernel, suitable for disaster recovery +.It Pa /usr/mdec/ofwboot +system bootstrap (usually installed on a stand-alone FAT partition or an +Apple HFS partition, to be readable by Open Firmware) +.El +.Sh SEE ALSO +.Xr ddb 4 , +.Xr boot_config 8 , +.Xr halt 8 , +.Xr init 8 , +.Xr installboot 8 , +.Xr reboot 8 , +.Xr savecore 8 , +.Xr shutdown 8 |