xref: /openbsd-src/share/man/man8/man8.amd64/MAKEDEV.8 (revision c2d1b0f40f648cef138158c9f5c1008f384d6fc0)
1.\" $OpenBSD: MAKEDEV.8,v 1.98 2024/09/04 13:45:25 jsg Exp $
2.\"
3.\" THIS FILE AUTOMATICALLY GENERATED.  DO NOT EDIT.
4.\" generated from:
5.\"
6.\"	OpenBSD: etc.amd64/MAKEDEV.md,v 1.83 2024/09/03 09:35:46 bluhm Exp
7.\"	OpenBSD: MAKEDEV.common,v 1.121 2024/09/03 09:35:46 bluhm 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: September 4 2024 $
27.Dt MAKEDEV 8 amd64
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 amd64 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 amd64.
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.It Ar ttyVI*
120Virtio serial ports, see
121.Xr viocon 4 .
122.El
123.Pp
124.Sy Pseudo terminals
125.Bl -tag -width tenletters -compact
126.It Ar ptm
127pty master device, see
128.Xr ptm 4 .
129.It Ar pty*
130Set of 62 master pseudo terminals, see
131.Xr pty 4 .
132.It Ar tty*
133Set of 62 slave pseudo terminals, see
134.Xr tty 4 .
135.El
136.Pp
137.Sy Console ports
138.Bl -tag -width tenletters -compact
139.It Ar ttyC-J*
140wscons display devices, see
141.Xr wsdisplay 4 .
142.It Ar wscons
143Minimal wscons devices, see
144.Xr wscons 4 .
145.It Ar wskbd*
146wscons keyboards, see
147.Xr wskbd 4 .
148.It Ar wsmux
149wscons keyboard/mouse mux devices, see
150.Xr wsmux 4 .
151.El
152.Pp
153.Sy Pointing devices
154.Bl -tag -width tenletters -compact
155.It Ar wsmouse*
156wscons mice, see
157.Xr wsmouse 4 .
158.El
159.Pp
160.Sy Printers
161.Bl -tag -width tenletters -compact
162.It Ar lpa*
163Polled printer port, see
164.Xr lpt 4 .
165.It Ar lpt*
166IEEE 1284 centronics printer, see
167.Xr lpt 4 .
168.El
169.Pp
170.Sy USB devices
171.Bl -tag -width tenletters -compact
172.It Ar ttyU*
173USB serial ports, see
174.Xr ucom 4 .
175.It Ar uall
176All USB devices, see
177.Xr usb 4 .
178.It Ar ugen*
179Generic USB devices, see
180.Xr ugen 4 .
181.It Ar uhid*
182Generic HID devices, see
183.Xr uhid 4 .
184.It Ar fido
185fido/* nodes, see
186.Xr fido 4 .
187.It Ar ujoy
188ujoy/* nodes, see
189.Xr ujoy 4 .
190.It Ar ulpt*
191Printer devices, see
192.Xr ulpt 4 .
193.It Ar usb*
194Bus control devices used by usbd for attach/detach, see
195.Xr usb 4 .
196.El
197.Pp
198.Sy Special purpose devices
199.Bl -tag -width tenletters -compact
200.It Ar apm
201Power Management Interface, 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 efi
225EFI runtime services, see
226.Xr efi 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 nvram
243NVRAM access, see
244.Xr nvram 4 .
245.It Ar kcov
246Kernel code coverage tracing, see
247.Xr kcov 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 vmm
291Virtual Machine Monitor, see
292.Xr vmm 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.It Ar psp
303Platform Security Processor, see
304.Xr psp 4 .
305.El
306.Sh FILES
307.Bl -tag -width /dev -compact
308.It Pa /dev
309The special file directory.
310.El
311.Sh SEE ALSO
312.Xr intro 4 ,
313.Xr config 8 ,
314.Xr mknod 8
315