Fix xref order.
[dragonfly.git] / share / man / man8 / man8.i386 / MAKEDEV.8
CommitLineData
984263bc
MD
1.\" Copyright (c) 1991, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\" notice, this list of conditions and the following disclaimer in the
11.\" documentation and/or other materials provided with the distribution.
12.\" 3. All advertising materials mentioning features or use of this software
13.\" must display the following acknowledgement:
14.\" This product includes software developed by the University of
15.\" California, Berkeley and its contributors.
16.\" 4. Neither the name of the University nor the names of its contributors
17.\" may be used to endorse or promote products derived from this software
18.\" without specific prior written permission.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" @(#)MAKEDEV.8 8.1 (Berkeley) 6/5/93
33.\" $FreeBSD: src/share/man/man8/man8.i386/MAKEDEV.8,v 1.15.2.5 2002/05/11 06:15:16 dd Exp $
375d1659 34.\" $DragonFly: src/share/man/man8/man8.i386/MAKEDEV.8,v 1.8 2006/03/21 04:24:28 swildner Exp $
984263bc
MD
35.\"
36.Dd June 5, 1993
37.Dt MAKEDEV 8 i386
38.Os
39.Sh NAME
40.Nm MAKEDEV
41.Nd create system and device special files
42.Sh SYNOPSIS
43.Nm
44name ...
45.Sh DESCRIPTION
46The shell script
47.Nm
48found in the
49.Dq Pa /dev
50directory, is used to create the common special files.
51See
52.Xr intro 4
53for a more complete discussion of special files.
54.Pp
55.Nm
56takes any number of device names as arguments, where the names are
57the common abbreviation for the device.
58There are two special devices,
59.Dq std
60and
61.Dq local .
62The former creates the standard devices for the architecture.
63The latter is for devices specific to the local site, and
64executes the shell file
65.Dq Pa MAKEDEV.local .
66.Pp
67The i386 supports the following devices.
68Where a device name is followed by a hash sign
69.Pq Dq # ,
70the hash sign
71must be replaced by a unit number.
72.Bl -tag -width indent
73.It std
74the standard devices (console, fd/*, klog, kmem, mem, null,
75stderr, stdin, stdout, tty)
76.It local
77configuration specific devices
78.It tty#
79standard PC COM ports
80.It fd#
81.Dq floppy
aa0d550a 82disk drives (3 \(12, 5 \(14)
984263bc
MD
83.It pty#
84set of 32 master and slave pseudo terminals
85.It da#
86SCSI disk drives
87.It sa#
88SCSI tape drives
89.It ch#
90SCSI changer devices
91.It ses#
92SCSI SES/SAF-TE environmental devices
93.It vty#
7e5d4a4c 94set of 12 virtual console devices for syscons
984263bc
MD
95.It ad#
96.Dq ATAPI
97disk drives (IDE).
98.It ast#
99.Dq ATAPI
100tape drives.
101.It acd#
102.Dq ATAPI
103CDROM drives.
104.El
093d5d6c
MD
105.Pp
106.Nm
107creates each special file with reasonable default ownership and permissions.
a3220ac5
SW
108Under
109.Dx ,
110you can change these default settings by putting
093d5d6c
MD
111.Dq local override
112entries in the
113.Pa /etc/devices.conf
114file.
115.Pp
116Whenever
117.Nm
118finds overrides for a given special file in
119.Pa /etc/devices.conf ,
120it will use these settings when it creates the device node.
121.Pp
122Please see the devices.conf(5) manpage for more information on how to override the
123default settings.
984263bc
MD
124.Sh FILES
125.Bl -tag -width /dev/xxxx -compact
126.It Pa /dev
127The special file directory.
093d5d6c
MD
128.It Pa /etc/devices.conf
129File containing local ownership and permissions overrides.
984263bc
MD
130.El
131.Sh SEE ALSO
132.Xr ata 4 ,
133.Xr intro 4 ,
375d1659 134.Xr devices.conf 5 ,
984263bc
MD
135.Xr config 8 ,
136.Xr mknod 8