xref: /openbsd/share/man/man8/man8.amd64/MAKEDEV.8 (revision 09467b48)
1.\" $OpenBSD: MAKEDEV.8,v 1.89 2020/07/06 06:13:10 dlg Exp $
2.\"
3.\" THIS FILE AUTOMATICALLY GENERATED.  DO NOT EDIT.
4.\" generated from:
5.\"
6.\"	OpenBSD: etc.amd64/MAKEDEV.md,v 1.75 2020/04/24 20:09:04 ratchov Exp
7.\"	OpenBSD: MAKEDEV.common,v 1.110 2020/04/18 21:28:35 ratchov 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 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 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 apm
198Power Management Interface, 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 nvram
237NVRAM access, see
238.Xr nvram 4 .
239.It Ar kcov
240Kernel code coverage tracing, see
241.Xr kcov 4 .
242.It Ar pci*
243PCI bus devices, see
244.Xr pci 4 .
245.It Ar pctr*
246PC Performance Tuning Register access device, see
247.Xr pctr 4 .
248.It Ar pf*
249Packet Filter, see
250.Xr pf 4 .
251.It Ar pppx*
252PPP Multiplexer, see
253.Xr pppx 4 .
254.It Ar pppac*
255PPP Access Concentrator, see
256.Xr pppac 4 .
257.It Ar radio*
258FM tuner devices, see
259.Xr radio 4 .
260.It Ar *random
261In-kernel random data source, see
262.Xr random 4 .
263.It Ar rmidi*
264Raw MIDI devices, see
265.Xr midi 4 .
266.It Ar speaker
267PC speaker, see
268.Xr spkr 4 .
269.It Ar tun*
270Network tunnel driver, see
271.Xr tun 4 .
272.It Ar tap*
273Ethernet tunnel driver, see
274.Xr tap 4 .
275.It Ar tuner*
276Tuner devices, see
277.Xr bktr 4 .
278.It Ar uk*
279Unknown SCSI devices, see
280.Xr uk 4 .
281.It Ar video*
282Video V4L2 devices, see
283.Xr video 4 .
284.It Ar vmm
285Virtual Machine Monitor, see
286.Xr vmm 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