xref: /netbsd-src/share/man/man8/MAKEDEV.local.8 (revision fd3dad8d8179d5113eed378fb078df16477ee0d1)
1*fd3dad8dSjmcneill.\" $NetBSD: MAKEDEV.local.8,v 1.8 2011/08/06 12:32:29 jmcneill Exp $
2234c7e39Sapb.\"
3234c7e39Sapb.\" Copyright (c) 2007 The NetBSD Foundation, Inc.
4234c7e39Sapb.\" All rights reserved.
5234c7e39Sapb.\"
6234c7e39Sapb.\" Redistribution and use in source and binary forms, with or without
7234c7e39Sapb.\" modification, are permitted provided that the following conditions
8234c7e39Sapb.\" are met:
9234c7e39Sapb.\" 1. Redistributions of source code must retain the above copyright
10234c7e39Sapb.\"    notice, this list of conditions and the following disclaimer.
11234c7e39Sapb.\" 2. Redistributions in binary form must reproduce the above copyright
12234c7e39Sapb.\"    notice, this list of conditions and the following disclaimer in the
13234c7e39Sapb.\"    documentation and/or other materials provided with the distribution.
14234c7e39Sapb.\"
15234c7e39Sapb.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
16234c7e39Sapb.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17234c7e39Sapb.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18234c7e39Sapb.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19234c7e39Sapb.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20234c7e39Sapb.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21234c7e39Sapb.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22234c7e39Sapb.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23234c7e39Sapb.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24234c7e39Sapb.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25234c7e39Sapb.\" POSSIBILITY OF SUCH DAMAGE.
26234c7e39Sapb.\"
27*fd3dad8dSjmcneill.Dd August 6, 2011
280a76dbaeSwiz.Dt MAKEDEV.LOCAL 8
29234c7e39Sapb.Os
30234c7e39Sapb.Sh NAME
31234c7e39Sapb.Nm MAKEDEV.local
32234c7e39Sapb.Nd create site-specific device special files
33234c7e39Sapb.Sh SYNOPSIS
34234c7e39Sapb.Nm
35*fd3dad8dSjmcneill.Op Fl fMsu
36234c7e39Sapb.Op Fl m Ar mknod
37beae89cdSapb.Op Fl p Ar pax
380942122dSapb.Op Fl t Ar mtree
39234c7e39Sapb.Bro Pa all | site-specific-argument Brc Op Ar ...
40234c7e39Sapb.Sh DESCRIPTION
41234c7e39Sapb.Nm
42234c7e39Sapbis used to create site-specific device special files.
43234c7e39SapbEach argument may be the word
44234c7e39Sapb.Pa all
45234c7e39Sapbor a site-specific argument.
46234c7e39SapbBy default, there are no valid site-specific arguments,
47234c7e39Sapband the
48234c7e39Sapb.Pa all
49234c7e39Sapbargument has no effect;
50234c7e39SapbThis may be changed by editing the script.
51234c7e39Sapb.Pp
52234c7e39SapbThe script is in
530942122dSapb.Pa /dev/MAKEDEV.local .
540942122dSapbDevices are created in the current working directory;
550942122dSapbin normal use,
560942122dSapb.Nm
570942122dSapbshould be invoked with
58234c7e39Sapb.Pa /dev
590942122dSapbas the current working directory.
60234c7e39Sapb.Pp
61234c7e39SapbSupported options for
62234c7e39Sapb.Nm
63234c7e39Sapbare the same as for
64beae89cdSapb.Xr MAKEDEV 8 .
65234c7e39Sapb.Sh FILES
66234c7e39Sapb.Bl -tag -width "/dev/MAKEDEV.local" -compact
67234c7e39Sapb.It Pa /dev
68234c7e39Sapbspecial device files directory
69234c7e39Sapb.It Pa /dev/MAKEDEV
70234c7e39Sapbscript that invokes
71234c7e39Sapb.Nm
72234c7e39Sapbwith the
73234c7e39Sapb.Pa all
74234c7e39Sapbargument.
75234c7e39Sapb.It Pa /dev/MAKEDEV.local
76234c7e39Sapbscript described in this man page
77234c7e39Sapb.El
78234c7e39Sapb.Sh SEE ALSO
79234c7e39Sapb.Xr config 1 ,
80234c7e39Sapb.Xr intro 4 ,
81234c7e39Sapb.Xr MAKEDEV 8 ,
82234c7e39Sapb.Xr mknod 8
8385ea48fdSapb.Sh HISTORY
8485ea48fdSapbThe
8585ea48fdSapb.Nm
8685ea48fdSapbcommand appeared in
8785ea48fdSapb.Bx 4.2 .
8885ea48fdSapbHandling of the same command line options as
8985ea48fdSapb.Xr MAKEDEV 8 ,
9085ea48fdSapband the use of
9185ea48fdSapb.Xr MAKEDEV 8
9285ea48fdSapbas a function library, was added in
9385ea48fdSapb.Nx 5.0 .
9485ea48fdSapb.Sh NOTES
9585ea48fdSapbThe relationship between
9685ea48fdSapb.Nm
9785ea48fdSapband
9885ea48fdSapb.Xr MAKEDEV 8
9985ea48fdSapbis complex:
10085ea48fdSapb.Bl -bullet
10185ea48fdSapb.It
10285ea48fdSapbIf
10385ea48fdSapb.Xr MAKEDEV 8
10485ea48fdSapbis invoked with the
10585ea48fdSapb.Pa all
10685ea48fdSapbor
10785ea48fdSapb.Pa local
10885ea48fdSapbargument, then it will invoke
10985ea48fdSapb.Nm
110b76e2d3dSapbas a child process, with options similar to
111b76e2d3dSapbthose that were originally passed to
11285ea48fdSapb.Xr MAKEDEV 8 ,
113b76e2d3dSapband with the
11485ea48fdSapb.Pa all
11585ea48fdSapbargument.
11685ea48fdSapb.It
11785ea48fdSapb.Nm
11885ea48fdSapbuses shell functions defined in
11985ea48fdSapb.Xr MAKEDEV 8 .
12085ea48fdSapbThis is done by loading
12185ea48fdSapb.Xr MAKEDEV 8
12285ea48fdSapbusing the shell
12385ea48fdSapb.Dq \&.
12485ea48fdSapbcommand, with the
12585ea48fdSapb.Ev MAKEDEV_AS_LIBRARY
12685ea48fdSapbvariable set (to inform
12785ea48fdSapb.Xr MAKEDEV 8
12885ea48fdSapbthat it should behave as a function library,
12985ea48fdSapbnot as an independent program).
13085ea48fdSapb.El
131