xref: /netbsd-src/usr.sbin/mdconfig/mdconfig.8 (revision 01869ca4d24a86379a68731bf9706a9f0820fe4e)
1ea702e59Sgwr.\"
2*01869ca4Swiz.\"	$NetBSD: mdconfig.8,v 1.10 2017/07/03 21:35:31 wiz Exp $
3ea702e59Sgwr.\"
4ea702e59Sgwr.\" Copyright (c) 1995 Gordon W. Ross
5ea702e59Sgwr.\" All rights reserved.
6ea702e59Sgwr.\"
7ea702e59Sgwr.\" Redistribution and use in source and binary forms, with or without
8ea702e59Sgwr.\" modification, are permitted provided that the following conditions
9ea702e59Sgwr.\" are met:
10ea702e59Sgwr.\" 1. Redistributions of source code must retain the above copyright
11ea702e59Sgwr.\"    notice, this list of conditions and the following disclaimer.
12ea702e59Sgwr.\" 2. Redistributions in binary form must reproduce the above copyright
13ea702e59Sgwr.\"    notice, this list of conditions and the following disclaimer in the
14ea702e59Sgwr.\"    documentation and/or other materials provided with the distribution.
15ea702e59Sgwr.\" 3. The name of the author may not be used to endorse or promote products
16ea702e59Sgwr.\"    derived from this software without specific prior written permission.
17ea702e59Sgwr.\"
18ea702e59Sgwr.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19ea702e59Sgwr.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20ea702e59Sgwr.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21ea702e59Sgwr.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22ea702e59Sgwr.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23ea702e59Sgwr.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24ea702e59Sgwr.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25ea702e59Sgwr.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26ea702e59Sgwr.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27ea702e59Sgwr.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28ea702e59Sgwr.\"
29ea702e59Sgwr.Dd July 8, 1993
30fa84b16bSpk.Dt MDCONFIG 8
31d1407362Sgarbled.Os
32ea702e59Sgwr.Sh NAME
33fa84b16bSpk.Nm mdconfig
34fa84b16bSpk.Nd configure MEMORY disks
35ea702e59Sgwr.Sh SYNOPSIS
36fcfec169Slukem.Nm
37ea702e59Sgwr.Ar special_file
38ea702e59Sgwr.Ar 512-byte-blocks
39ea702e59Sgwr.Sh DESCRIPTION
40ea702e59SgwrThe
41fcfec169Slukem.Nm
42fa84b16bSpkcommand configures memory disk devices.
43ea702e59SgwrIt will associate the special file
44ea702e59Sgwr.Ar special_file
45ea702e59Sgwrwith a range of user-virtual memory allocated by the
46fcfec169Slukem.Nm
47ea702e59Sgwrprocess itself.  The
48fcfec169Slukem.Nm
49ea702e59Sgwrcommand should be run in the background.
50ea702e59SgwrIf successful, the command will not return.
51ea702e59SgwrOtherwise, an error message will be printed.
52ea702e59Sgwr.Pp
53fa84b16bSpkTo "unconfigure" the memory disk, just kill the background
54fcfec169Slukem.Nm
55ea702e59Sgwrprocess started earlier.
56ea702e59Sgwr.Sh FILES
57fa84b16bSpk.Bl -tag -width /etc/rmd?? -compact
58fa84b16bSpk.It Pa /dev/rmd??
59fa84b16bSpk.It Pa /dev/md??
60ea702e59Sgwr.El
61ea702e59Sgwr.Sh EXAMPLES
62*01869ca4Swiz.Dl mdconfig /dev/md0c 2048 &
63ea702e59Sgwr.Pp
64fa84b16bSpkConfigures the memory disk
65e4e5afeeStsutsui.Pa md0c
66ea702e59Sgwrwith one megabyte of user-space memory.
678f48ce14Swiz.Sh SEE ALSO
688f48ce14Swiz.Xr mount 8 ,
698f48ce14Swiz.Xr swapon 8 ,
708f48ce14Swiz.Xr umount 8
71ea702e59Sgwr.Sh BUGS
72ea702e59SgwrThe special device will become inoperative if the
73fcfec169Slukem.Nm
74ea702e59Sgwrprocess is killed while the special device is open.
75