xref: /openbsd/share/man/man8/man8.i386/MAKEDEV.8 (revision 5dea098c)
1.\" $OpenBSD: MAKEDEV.8,v 1.123 2022/11/10 11:02:27 krw Exp $
2.\"
3.\" THIS FILE AUTOMATICALLY GENERATED.  DO NOT EDIT.
4.\" generated from:
5.\"
6.\"	OpenBSD: etc.i386/MAKEDEV.md,v 1.96 2022/11/09 19:35:23 krw Exp
7.\"	OpenBSD: MAKEDEV.common,v 1.118 2022/11/10 09:50:00 krw Exp
8.\"	OpenBSD: MAKEDEV.man,v 1.9 2017/06/06 08:11:23 tb Exp
9.\"	OpenBSD: MAKEDEV.mansub,v 1.2 2004/02/20 19:13:01 miod Exp
10.\"
11.\" Copyright (c) 2004, Miodrag Vallat
12.\" Copyright (c) 2001-2004 Todd T. Fries <todd@OpenBSD.org>
13.\"
14.\" Permission to use, copy, modify, and distribute this software for any
15.\" purpose with or without fee is hereby granted, provided that the above
16.\" copyright notice and this permission notice appear in all copies.
17.\"
18.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
19.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
20.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
21.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
22.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
23.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
24.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
25.\"
26.Dd $Mdocdate: November 10 2022 $
27.Dt MAKEDEV 8 i386
28.Os
29.Sh NAME
30.Nm MAKEDEV
31.Nd create system and device special files
32.Sh SYNOPSIS
33.Nm MAKEDEV
34.Op Ar name ...
35.Sh DESCRIPTION
36The shell script
37.Nm ,
38found in the
39.Pa /dev
40directory, is used to create various special files.
41See
42.Xr intro 4
43for a more complete discussion of special files.
44.Pp
45.Nm
46takes any number of device names as arguments, where the names are
47the common abbreviation for the device or group of devices.
48Files are created in the current working directory.
49.Pp
50Where a device name is followed by a star
51.Sq * ,
52the star must be replaced by a unit number.
53If units are expected for a device but not provided,
54.Nm
55will supply the standard numbers in most cases.
56.Pp
57The i386 supports the following devices:
58.Pp
59.Sy Special device names
60.Bl -tag -width tenletters -compact
61.It Ar all
62Creates special files for all devices on i386.
63.It Ar ramdisk
64Ramdisk kernel devices.
65.It Ar std
66Creates the
67.Sq standard
68devices (console, klog, kmem, ksyms, mem, null,
69stderr, stdin, stdout, tty, zero)
70which are absolutely necessary for the system to function properly.
71.It Ar local
72Creates configuration-specific devices, by invoking the shell file
73.Pa MAKEDEV.local .
74.El
75.Pp
76.Sy Disks
77.Bl -tag -width tenletters -compact
78.It Ar cd*
79ATAPI and SCSI CD-ROM drives, see
80.Xr cd 4 .
81.It Ar fd*
82Floppy disk drives (3 1/2", 5 1/4"), see
83.Xr fd 4 .
84.It Ar rd*
85.Dq rd
86pseudo-disks, see
87.Xr rd 4 .
88.It Ar sd*
89SCSI disks, including flopticals, see
90.Xr sd 4 .
91.It Ar vnd*
92.Dq file
93pseudo-disk devices, see
94.Xr vnd 4 .
95.It Ar wd*
96.Dq winchester
97disk drives (ST506, IDE, ESDI, RLL, ...), see
98.Xr wd 4 .
99.El
100.Pp
101.Sy Tapes
102.Bl -tag -width tenletters -compact
103.It Ar ch*
104SCSI media changers, see
105.Xr ch 4 .
106.It Ar st*
107SCSI tape drives, see
108.Xr st 4 .
109.El
110.Pp
111.Sy Terminal ports
112.Bl -tag -width tenletters -compact
113.It Ar tty[0-7][0-9a-f]
114NS16x50 serial ports, see
115.Xr com 4 .
116.It Ar ttyc*
117Cyclades serial ports, see
118.Xr cy 4 .
119.El
120.Pp
121.Sy Pseudo terminals
122.Bl -tag -width tenletters -compact
123.It Ar ptm
124pty master device, see
125.Xr ptm 4 .
126.It Ar pty*
127Set of 62 master pseudo terminals, see
128.Xr pty 4 .
129.It Ar tty*
130Set of 62 slave pseudo terminals, see
131.Xr tty 4 .
132.El
133.Pp
134.Sy Console ports
135.Bl -tag -width tenletters -compact
136.It Ar ttyC-J*
137wscons display devices, see
138.Xr wsdisplay 4 .
139.It Ar wscons
140Minimal wscons devices, see
141.Xr wscons 4 .
142.It Ar wskbd*
143wscons keyboards, see
144.Xr wskbd 4 .
145.It Ar wsmux
146wscons keyboard/mouse mux devices, see
147.Xr wsmux 4 .
148.El
149.Pp
150.Sy Pointing devices
151.Bl -tag -width tenletters -compact
152.It Ar wsmouse*
153wscons mice, see
154.Xr wsmouse 4 .
155.El
156.Pp
157.Sy Printers
158.Bl -tag -width tenletters -compact
159.It Ar lpa*
160Polled printer port, see
161.Xr lpt 4 .
162.It Ar lpt*
163IEEE 1284 centronics printer, see
164.Xr lpt 4 .
165.El
166.Pp
167.Sy USB devices
168.Bl -tag -width tenletters -compact
169.It Ar ttyU*
170USB serial ports, see
171.Xr ucom 4 .
172.It Ar uall
173All USB devices, see
174.Xr usb 4 .
175.It Ar ugen*
176Generic USB devices, see
177.Xr ugen 4 .
178.It Ar uhid*
179Generic HID devices, see
180.Xr uhid 4 .
181.It Ar fido
182fido/* nodes, see
183.Xr fido 4 .
184.It Ar ujoy
185ujoy/* nodes, see
186.Xr ujoy 4 .
187.It Ar ulpt*
188Printer devices, see
189.Xr ulpt 4 .
190.It Ar usb*
191Bus control devices used by usbd for attach/detach, see
192.Xr usb 4 .
193.El
194.Pp
195.Sy Special purpose devices
196.Bl -tag -width tenletters -compact
197.It Ar amdmsr
198AMD MSR access device, see
199.Xr amdmsr 4 .
200.It Ar apm
201Power management device, see
202.Xr apm 4 .
203.It Ar audio*
204Audio devices, see
205.Xr audio 4 .
206.It Ar bio
207ioctl tunnel pseudo-device, see
208.Xr bio 4 .
209.It Ar bktr*
210Video frame grabbers, see
211.Xr bktr 4 .
212.It Ar bpf
213Berkeley Packet Filter, see
214.Xr bpf 4 .
215.It Ar dt
216Dynamic Tracer, see
217.Xr dt 4 .
218.It Ar diskmap
219Disk mapper, see
220.Xr diskmap 4 .
221.It Ar dri
222Direct Rendering Infrastructure, see
223.Xr drm 4 .
224.It Ar fd
225fd/* nodes, see
226.Xr fd 4 .
227.It Ar fuse
228Userland Filesystem, see
229.Xr fuse 4 .
230.It Ar gpio*
231General Purpose Input/Output, see
232.Xr gpio 4 .
233.It Ar hotplug
234devices hot plugging, see
235.Xr hotplug 4 .
236.It Ar ipmi*
237IPMI BMC access, see
238.Xr ipmi 4 .
239.It Ar joy*
240Joystick driver, see
241.Xr joy 4 .
242.It Ar kcov
243Kernel code coverage tracing, see
244.Xr kcov 4 .
245.It Ar nvram
246NVRAM access, see
247.Xr nvram 4 .
248.It Ar pci*
249PCI bus devices, see
250.Xr pci 4 .
251.It Ar pctr*
252PC Performance Tuning Register access device, see
253.Xr pctr 4 .
254.It Ar pf
255Packet Filter, see
256.Xr pf 4 .
257.It Ar pppx*
258PPP Multiplexer, see
259.Xr pppx 4 .
260.It Ar pppac*
261PPP Access Concentrator, see
262.Xr pppac 4 .
263.It Ar radio*
264FM tuner devices, see
265.Xr radio 4 .
266.It Ar *random
267In-kernel random data source, see
268.Xr random 4 .
269.It Ar rmidi*
270Raw MIDI devices, see
271.Xr midi 4 .
272.It Ar speaker
273PC speaker, see
274.Xr spkr 4 .
275.It Ar tun*
276Network tunnel driver, see
277.Xr tun 4 .
278.It Ar tap*
279Ethernet tunnel driver, see
280.Xr tap 4 .
281.It Ar tuner*
282Tuner devices, see
283.Xr bktr 4 .
284.It Ar uk*
285Unknown SCSI devices, see
286.Xr uk 4 .
287.It Ar video*
288Video V4L2 devices, see
289.Xr video 4 .
290.It Ar vscsi*
291Virtual SCSI controller, see
292.Xr vscsi 4 .
293.It Ar pvbus*
294paravirtual device tree root, see
295.Xr pvbus 4 .
296.It Ar kstat
297Kernel Statistics, see
298.Xr kstat 4 .
299.El
300.Sh FILES
301.Bl -tag -width /dev -compact
302.It Pa /dev
303The special file directory.
304.El
305.Sh SEE ALSO
306.Xr intro 4 ,
307.Xr config 8 ,
308.Xr mknod 8
309