BSD 4_4 release

[unix-history] / usr / src / share / man / man8 / makedev.8

diff --git a/usr/src/share/man/man8/makedev.8 b/usr/src/share/man/man8/makedev.8
index b4da02b..270d029 100644 (file)
--- a/usr/src/share/man/man8/makedev.8
+++ b/usr/src/share/man/man8/makedev.8
@@ -1,61 +1,110 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983, 1991, 1993
+.\"    The Regents of the University of California.  All rights reserved.

 .\"
 .\"

-.\"    @(#)makedev.8   6.1 (Berkeley) %G%
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.TH MAKEDEV 8 ""
-.UC 5
-.SH NAME
-makedev \- make system special files
-.SH SYNOPSIS
-.B /dev/MAKEDEV 
-.IR device ...
-.SH DESCRIPTION
-.I MAKEDEV
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"     @(#)makedev.8  8.1 (Berkeley) 6/5/93
+.\"
+.Dd June 5, 1993
+.Dt MAKEDEV 8
+.Os BSD 4.2
+.Sh NAME
+.Nm makedev
+.Nd make system special files
+.Sh SYNOPSIS
+.Nm MAKEDEV
+.Ar device ...
+.Sh DESCRIPTION
+.Nm MAKEDEV

 is a shell script normally used to install
 special files.  It resides in the 
 is a shell script normally used to install
 special files.  It resides in the 

-.I /dev
+.Pa /dev

 directory, as this is the normal location of special files.
 Arguments to 
 directory, as this is the normal location of special files.
 Arguments to 

-.I MAKEDEV
+.Nm MAKEDEV

 are usually of the form
 are usually of the form

-.IR device-name ?
+.Ar device-name Ns Sy \&?

 where
 where

-.I device-name
+.Ar device-name

 is one of the supported devices listed in section 4 of the
 is one of the supported devices listed in section 4 of the

-manual and ``?'' is a logical unit number (0-9).  A few
+manual and
+.Dq Sy \&?
+is a logical unit number (0-9).  A few

 special arguments create assorted collections of devices and are
 listed below.
 special arguments create assorted collections of devices and are
 listed below.

-.TP
-.B std
+.Bl -tag -width Ds
+.It Sy std

 Create the
 Create the

-.I standard
-devices for the system; e.g. /dev/console, /dev/tty.
-The VAX-11/780 console floppy device, /dev/floppy, and VAX-11/750
-and VAX-11/730 console cassette device(s), /dev/tu?, are also
-created with this entry.
-.TP
-.B local
+.Em standard
+devices for the system; for example the standard
+.Tn UNIX
+devices
+.Pa /dev/console and /dev/tty;
+the standard hardware dependent devices,
+for example in the VAX family
+the
+.Tn VAX-11/780
+console floppy device,
+.Pa /dev/floppy ,
+and
+.Tn VAX-11/750
+and
+.Tn VAX-11/730
+console cassette device(s),
+.Pa /dev/tu?
+devices would be made for the appropriate system.
+.It Sy local

 Create those devices specific to the local site.  This
 request causes the shell file 
 Create those devices specific to the local site.  This
 request causes the shell file 

-.I /dev/MAKEDEV.local
+.Pa /dev/MAKEDEV.local

 to be executed.  Site specific commands, such as those
 to be executed.  Site specific commands, such as those

-used to setup dialup lines as ``ttyd?'' should be included
+used to setup dialup lines as
+.Pa ttyd?
+should be included

 in this file.
 in this file.

-.PP
+.El
+.Pp

 Since all devices are created using 
 Since all devices are created using 

-.IR mknod (8),
+.Xr mknod 8 ,

 this shell script is useful only to the super-user.
 this shell script is useful only to the super-user.

-.SH DIAGNOSTICS
+.Sh DIAGNOSTICS

 Either self-explanatory, or generated by one of the programs
 Either self-explanatory, or generated by one of the programs

-called from the script.  Use ``sh -x MAKEDEV'' in case of
+called from the script.  Use
+.Ql sh -x MAKEDEV
+in case of

 trouble.
 trouble.

-.SH "SEE ALSO"
-intro(4),
-config(8),
-mknod(8)
-.SH BUGS
-When more than one piece of hardware of the same ``kind'' is
-present on a machine (for instance, a dh and a dmf), naming
-conflicts arise.
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr config 8 ,
+.Xr mknod 8
+.Sh HISTORY
+The
+.Nm
+command appeared in
+.Bx 4.2 .