xref: /openbsd/share/man/man8/man8.i386/MAKEDEV.8 (revision 3cab2bb3)
1.\" $OpenBSD: MAKEDEV.8,v 1.116 2020/07/06 06:13:10 dlg Exp $
2.\"
3.\" THIS FILE AUTOMATICALLY GENERATED.  DO NOT EDIT.
4.\" generated from:
5.\"
6.\"	OpenBSD: etc.i386/MAKEDEV.md,v 1.91 2020/07/06 06:11:27 dlg Exp
7.\"	OpenBSD: MAKEDEV.common,v 1.111 2020/07/06 06:11:26 dlg 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: July 6 2020 $
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 ulpt*
185Printer devices, see
186.Xr ulpt 4 .
187.It Ar usb*
188Bus control devices used by usbd for attach/detach, see
189.Xr usb 4 .
190.El
191.Pp
192.Sy Special purpose devices
193.Bl -tag -width tenletters -compact
194.It Ar amdmsr
195AMD MSR access device, see
196.Xr amdmsr 4 .
197.It Ar apm
198Power management device, see
199.Xr apm 4 .
200.It Ar audio*
201Audio devices, see
202.Xr audio 4 .
203.It Ar bio
204ioctl tunnel pseudo-device, see
205.Xr bio 4 .
206.It Ar bktr*
207Video frame grabbers, see
208.Xr bktr 4 .
209.It Ar bpf
210Berkeley Packet Filter, see
211.Xr bpf 4 .
212.It Ar dt
213Dynamic Tracer, see
214.Xr dt 4 .
215.It Ar diskmap
216Disk mapper, see
217.Xr diskmap 4 .
218.It Ar drm*
219Direct Rendering Manager, see
220.Xr drm 4 .
221.It Ar fd
222fd/* nodes, see
223.Xr fd 4 .
224.It Ar fuse
225Userland Filesystem, see
226.Xr fuse 4 .
227.It Ar gpio*
228General Purpose Input/Output, see
229.Xr gpio 4 .
230.It Ar hotplug
231devices hot plugging, see
232.Xr hotplug 4 .
233.It Ar ipmi*
234IPMI BMC access, see
235.Xr ipmi 4 .
236.It Ar joy*
237Joystick driver, see
238.Xr joy 4 .
239.It Ar kcov
240Kernel code coverage tracing, see
241.Xr kcov 4 .
242.It Ar nvram
243NVRAM access, see
244.Xr nvram 4 .
245.It Ar pci*
246PCI bus devices, see
247.Xr pci 4 .
248.It Ar pctr*
249PC Performance Tuning Register access device, see
250.Xr pctr 4 .
251.It Ar pf*
252Packet Filter, see
253.Xr pf 4 .
254.It Ar pppx*
255PPP Multiplexer, see
256.Xr pppx 4 .
257.It Ar pppac*
258PPP Access Concentrator, see
259.Xr pppac 4 .
260.It Ar radio*
261FM tuner devices, see
262.Xr radio 4 .
263.It Ar *random
264In-kernel random data source, see
265.Xr random 4 .
266.It Ar rmidi*
267Raw MIDI devices, see
268.Xr midi 4 .
269.It Ar speaker
270PC speaker, see
271.Xr spkr 4 .
272.It Ar tun*
273Network tunnel driver, see
274.Xr tun 4 .
275.It Ar tap*
276Ethernet tunnel driver, see
277.Xr tap 4 .
278.It Ar tuner*
279Tuner devices, see
280.Xr bktr 4 .
281.It Ar uk*
282Unknown SCSI devices, see
283.Xr uk 4 .
284.It Ar video*
285Video V4L2 devices, see
286.Xr video 4 .
287.It Ar vscsi*
288Virtual SCSI controller, see
289.Xr vscsi 4 .
290.It Ar pvbus*
291paravirtual device tree root, see
292.Xr pvbus 4 .
293.It Ar switch*
294Switch driver, see
295.Xr switch 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