share/man/man8/man8.i386/MAKEDEV.8

   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 $
  34 .\" $DragonFly: src/share/man/man8/man8.i386/MAKEDEV.8,v 1.5 2005/05/07 17:38:33 swildner Exp $
  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
  44 name ...
  45 .Sh DESCRIPTION
  46 The shell script
  47 .Nm
  48 found in the
  49 .Dq Pa /dev
  50 directory, is used to create the common special files.
  51 See
  52 .Xr intro 4
  53 for a more complete discussion of special files.
  54 .Pp
  55 .Nm
  56 takes any number of device names as arguments, where the names are
  57 the common abbreviation for the device.
  58 There are two special devices,
  59 .Dq std
  60 and
  61 .Dq local .
  62 The former creates the standard devices for the architecture.
  63 The latter is for devices specific to the local site, and
  64 executes the shell file
  65 .Dq Pa MAKEDEV.local .
  66 .Pp
  67 The i386 supports the following devices.
  68 Where a device name is followed by a hash sign
  69 .Pq Dq # ,
  70 the hash sign
  71 must be replaced by a unit number.
  72 .Bl -tag -width indent
  73 .It std
  74 the standard devices (console, fd/*, klog, kmem, mem, null,
  75 stderr, stdin, stdout, tty)
  76 .It local
  77 configuration specific devices
  78 .It tty#
  79 standard PC COM ports
  80 .It fd#
  81 .Dq floppy
  82 disk drives (3 1/2, 5 1/4)
  83 .It pty#
  84 set of 32 master and slave pseudo terminals
  85 .It da#
  86 SCSI disk drives
  87 .It sa#
  88 SCSI tape drives
  89 .It ch#
  90 SCSI changer devices
  91 .It ses#
  92 SCSI SES/SAF-TE environmental devices
  93 .It vty#
  94 set of 12 virtual console devices for syscons
  95 .It ad#
  96 .Dq ATAPI
  97 disk drives (IDE).
  98 .It ast#
  99 .Dq ATAPI
 100 tape drives.
 101 .It acd#
 102 .Dq ATAPI
 103 CDROM drives.
 104 .El
 105 .Pp
 106 .Nm
 107 creates each special file with reasonable default ownership and permissions.
 108 Under DragonFly BSD, you can change these default settings by putting
 109 .Dq local override
 110 entries in the
 111 .Pa /etc/devices.conf
 112 file.
 113 .Pp
 114 Whenever
 115 .Nm
 116 finds overrides for a given special file in
 117 .Pa /etc/devices.conf ,
 118 it will use these settings when it creates the device node.
 119 .Pp
 120 Please see the devices.conf(5) manpage for more information on how to override the
 121 default settings.
 122 .Sh FILES
 123 .Bl -tag -width /dev/xxxx -compact
 124 .It Pa /dev
 125 The special file directory.
 126 .It Pa /etc/devices.conf
 127 File containing local ownership and permissions overrides.
 128 .El
 129 .Sh SEE ALSO
 130 .Xr devices.conf 5 ,
 131 .Xr ata 4 ,
 132 .Xr intro 4 ,
 133 .Xr config 8 ,
 134 .Xr mknod 8