xref: /openbsd/share/man/man8/man8.i386/MAKEDEV.8 (revision 73471bf0)
1.\" $OpenBSD: MAKEDEV.8,v 1.119 2021/11/11 09:51:32 claudio Exp $
2.\"
3.\" THIS FILE AUTOMATICALLY GENERATED.  DO NOT EDIT.
4.\" generated from:
5.\"
6.\"	OpenBSD: etc.i386/MAKEDEV.md,v 1.94 2021/11/11 09:47:33 claudio Exp
7.\"	OpenBSD: MAKEDEV.common,v 1.114 2021/11/11 09:47:32 claudio 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 11 2021 $
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 drm*
225Direct Rendering Manager, see
226.Xr drm 4 .
227.It Ar fd
228fd/* nodes, see
229.Xr fd 4 .
230.It Ar fuse
231Userland Filesystem, see
232.Xr fuse 4 .
233.It Ar gpio*
234General Purpose Input/Output, see
235.Xr gpio 4 .
236.It Ar hotplug
237devices hot plugging, see
238.Xr hotplug 4 .
239.It Ar ipmi*
240IPMI BMC access, see
241.Xr ipmi 4 .
242.It Ar joy*
243Joystick driver, see
244.Xr joy 4 .
245.It Ar kcov
246Kernel code coverage tracing, see
247.Xr kcov 4 .
248.It Ar nvram
249NVRAM access, see
250.Xr nvram 4 .
251.It Ar pci*
252PCI bus devices, see
253.Xr pci 4 .
254.It Ar pctr*
255PC Performance Tuning Register access device, see
256.Xr pctr 4 .
257.It Ar pf*
258Packet Filter, see
259.Xr pf 4 .
260.It Ar pppx*
261PPP Multiplexer, see
262.Xr pppx 4 .
263.It Ar pppac*
264PPP Access Concentrator, see
265.Xr pppac 4 .
266.It Ar radio*
267FM tuner devices, see
268.Xr radio 4 .
269.It Ar *random
270In-kernel random data source, see
271.Xr random 4 .
272.It Ar rmidi*
273Raw MIDI devices, see
274.Xr midi 4 .
275.It Ar speaker
276PC speaker, see
277.Xr spkr 4 .
278.It Ar tun*
279Network tunnel driver, see
280.Xr tun 4 .
281.It Ar tap*
282Ethernet tunnel driver, see
283.Xr tap 4 .
284.It Ar tuner*
285Tuner devices, see
286.Xr bktr 4 .
287.It Ar uk*
288Unknown SCSI devices, see
289.Xr uk 4 .
290.It Ar video*
291Video V4L2 devices, see
292.Xr video 4 .
293.It Ar vscsi*
294Virtual SCSI controller, see
295.Xr vscsi 4 .
296.It Ar pvbus*
297paravirtual device tree root, see
298.Xr pvbus 4 .
299.It Ar kstat
300Kernel Statistics, see
301.Xr kstat 4 .
302.El
303.Sh FILES
304.Bl -tag -width /dev -compact
305.It Pa /dev
306The special file directory.
307.El
308.Sh SEE ALSO
309.Xr intro 4 ,
310.Xr config 8 ,
311.Xr mknod 8
312