xref: /netbsd-src/share/man/man8/MAKEDEV.local.8 (revision fd3dad8d8179d5113eed378fb078df16477ee0d1)
1.\" $NetBSD: MAKEDEV.local.8,v 1.8 2011/08/06 12:32:29 jmcneill Exp $
2.\"
3.\" Copyright (c) 2007 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25.\" POSSIBILITY OF SUCH DAMAGE.
26.\"
27.Dd August 6, 2011
28.Dt MAKEDEV.LOCAL 8
29.Os
30.Sh NAME
31.Nm MAKEDEV.local
32.Nd create site-specific device special files
33.Sh SYNOPSIS
34.Nm
35.Op Fl fMsu
36.Op Fl m Ar mknod
37.Op Fl p Ar pax
38.Op Fl t Ar mtree
39.Bro Pa all | site-specific-argument Brc Op Ar ...
40.Sh DESCRIPTION
41.Nm
42is used to create site-specific device special files.
43Each argument may be the word
44.Pa all
45or a site-specific argument.
46By default, there are no valid site-specific arguments,
47and the
48.Pa all
49argument has no effect;
50This may be changed by editing the script.
51.Pp
52The script is in
53.Pa /dev/MAKEDEV.local .
54Devices are created in the current working directory;
55in normal use,
56.Nm
57should be invoked with
58.Pa /dev
59as the current working directory.
60.Pp
61Supported options for
62.Nm
63are the same as for
64.Xr MAKEDEV 8 .
65.Sh FILES
66.Bl -tag -width "/dev/MAKEDEV.local" -compact
67.It Pa /dev
68special device files directory
69.It Pa /dev/MAKEDEV
70script that invokes
71.Nm
72with the
73.Pa all
74argument.
75.It Pa /dev/MAKEDEV.local
76script described in this man page
77.El
78.Sh SEE ALSO
79.Xr config 1 ,
80.Xr intro 4 ,
81.Xr MAKEDEV 8 ,
82.Xr mknod 8
83.Sh HISTORY
84The
85.Nm
86command appeared in
87.Bx 4.2 .
88Handling of the same command line options as
89.Xr MAKEDEV 8 ,
90and the use of
91.Xr MAKEDEV 8
92as a function library, was added in
93.Nx 5.0 .
94.Sh NOTES
95The relationship between
96.Nm
97and
98.Xr MAKEDEV 8
99is complex:
100.Bl -bullet
101.It
102If
103.Xr MAKEDEV 8
104is invoked with the
105.Pa all
106or
107.Pa local
108argument, then it will invoke
109.Nm
110as a child process, with options similar to
111those that were originally passed to
112.Xr MAKEDEV 8 ,
113and with the
114.Pa all
115argument.
116.It
117.Nm
118uses shell functions defined in
119.Xr MAKEDEV 8 .
120This is done by loading
121.Xr MAKEDEV 8
122using the shell
123.Dq \&.
124command, with the
125.Ev MAKEDEV_AS_LIBRARY
126variable set (to inform
127.Xr MAKEDEV 8
128that it should behave as a function library,
129not as an independent program).
130.El
131