summaryrefslogtreecommitdiffstats
path: root/usr.sbin/vnconfig
diff options
context:
space:
mode:
authorben <ben@FreeBSD.org>2001-03-29 11:36:46 +0000
committerben <ben@FreeBSD.org>2001-03-29 11:36:46 +0000
commit4ae9cfa7a0f46c31830082a60a87a39f9d7ccd37 (patch)
tree411b8c43f37eae5d25d39d15a833e7e24d6bc739 /usr.sbin/vnconfig
parent9991180a00bb48543e2c67a594975cc62329680b (diff)
downloadFreeBSD-src-4ae9cfa7a0f46c31830082a60a87a39f9d7ccd37.zip
FreeBSD-src-4ae9cfa7a0f46c31830082a60a87a39f9d7ccd37.tar.gz
Kill vn related manual pages, they're not used any more.
Approved by: phk
Diffstat (limited to 'usr.sbin/vnconfig')
-rw-r--r--usr.sbin/vnconfig/vnconfig.8275
1 files changed, 0 insertions, 275 deletions
diff --git a/usr.sbin/vnconfig/vnconfig.8 b/usr.sbin/vnconfig/vnconfig.8
deleted file mode 100644
index 201abf7..0000000
--- a/usr.sbin/vnconfig/vnconfig.8
+++ /dev/null
@@ -1,275 +0,0 @@
-.\" Copyright (c) 1993 University of Utah.
-.\" Copyright (c) 1980, 1989, 1991, 1993
-.\" The Regents of the University of California. All rights reserved.
-.\"
-.\" This code is derived from software contributed to Berkeley by
-.\" the Systems Programming Group of the University of Utah Computer
-.\" Science Department.
-.\"
-.\" 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.
-.\"
-.\" 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.
-.\"
-.\" @(#)vnconfig.8 8.1 (Berkeley) 6/5/93
-.\" $FreeBSD$
-.\"
-.Dd July 8, 1993
-.Dt VNCONFIG 8
-.Os BSD 4
-.Sh NAME
-.Nm vnconfig
-.Nd configure and enable vnode disks
-.Sh SYNOPSIS
-.Nm
-.Op Fl cdeguv
-.Oo Fl s Ar option Ns
-.Op , Ns Ar option Ns Ar ... Oc
-.Oo Fl r Ar option Ns
-.Op , Ns Ar option Ns Ar ... Oc
-.Op Fl S Ar value
-.Ar special_file Op Ar regular_file
-.Op Ar feature
-.Nm
-.Fl a
-.Op Fl cdeguv
-.Op Fl s Ar option
-.Op Fl r Ar option
-.Op Fl f Ar config_file
-.Sh WARNING
-.Nm
-is being phased out.
-Please use
-.Xr mdconfig 8
-instead.
-.Sh DESCRIPTION
-The
-.Nm
-command configures and enables vnode pseudo disk devices.
-The first form of the command will associate the special file
-.Ar special_file
-with the regular file
-.Ar regular_file
-allowing the latter to be accessed as though it were a disk.
-Hence a regular file within the filesystem can be used for swapping
-or can contain a filesystem that is mounted in the name space. If you
-want to use swap backing store for your device instead of a file, you
-can leave regular_file out and specify the size of the block device
-with the -S option.
-.Pp
-Options indicate an action to be performed:
-.Bl -tag -width indent
-.It Fl a
-Read a command file and performs the
-specified actions for each device/file pair.
-.It Fl c
-Configure the device.
-If successful, references to
-.Ar special_file
-will access the contents of
-.Ar regular_file .
-.It Fl d
-Disable (if possible) the specified feature.
-.It Fl e
-Configure the device and enables any
-.Ar feature
-that was specified.
-If no feature was specified,
-.Fl e
-is the same as
-.Fl c .
-.It Fl f Ar config_file
-Use
-.Ar config_file
-as an alternate config file.
-.It Fl g
-Fiddle global options.
-.It Fl r Ar flag
-Reset
-.Ar flag .
-The list of allowed flags and their meanings are:
-.Bl -tag -width "follow"
-.It Ar reserve
-Pre-reserve the blocks underlying the file or swap backing store. Currently only
-works for swap backing store. This option also disables on-the-fly freeing of
-the underlying backing store (for example, when you remove a large file).
-Use this option if you wish to avoid long-term fragmentation of the backing
-store. Also note that when this option is used, the initial contents of the
-backing store may contain garbage rather then zeros. It may even be possible to
-recover the prior contents of a swap-backed VN across a reboot if the VN device
-is configured before any swap is allocated by the system.
-.It Ar follow
-debug flow in the
-.Xr vn 4
-driver.
-.It Ar debug
-debug data in the
-.Xr vn 4
-driver.
-.It Ar io
-debug I/O in the
-.Xr vn 4
-driver.
-.It Ar all
-turn on all flags.
-.It Ar none
-turn off all flags.
-.El
-.It Fl s Ar flag
-Set
-.Ar flag .
-The list of allowed flags and their meanings are the same as for the
-.Fl r
-option.
-.It Fl S Xo
-.Sm off
-.Ar value
-.Es \&{ \&}
-.En Cm k , m , g , t
-.Sm on
-.Xc
-If no regular file is specified, VN will use swap for backing store.
-This option specifies the size of the device and implies the
-.Fl c
-option.
-For example, '23m' for
-23 megabytes. The VN device will round the size up to a machine page boundary.
-Filesystems up to 7.9 terabytes are supported. When specified along with
-a regular file, this option overrides the regular file's size insofar as
-VN is concerned.
-.It Fl T
-When a regular file is specified, VN will ftruncate() the file to 0 first.
-Normally you should also specify the -S option to set the size of the file.
-This option also creates the file if it did not previously exist.
-This option is only meaningful if the -S option has been specified.
-.It Fl Z
-When a regular file is specified, VN will zero the contents of the file to
-ensure that all blocks have been allocated by the filesystem. This option is
-only meaningful if the -S option has been specified.
-.It Fl u
-Disable and ``unconfigure'' the device.
-.It Fl v
-Print messages to stdout describing actions taken.
-.El
-.Pp
-If no action option is given,
-.Fl c
-is assumed.
-.Pp
-The
-.Ar feature
-argument specifies a feature that can be enabled via the
-.Fl e
-option:
-.Bl -tag -width indent
-.It Dv swap
-Swapping is enabled on the special file.
-See
-.Xr swapon 2 .
-.It Dv mountro Ns = Ns Pa mount_point
-The special file is mounted read-only on
-.Ar mount_point .
-See
-.Xr mount 2 .
-.It Dv mountrw Ns = Ns Pa mount_point
-The special file is mounted read-write on
-.Ar mount_point .
-See
-.Xr mount 2 .
-.It Dv mount Ns = Ns Pa mount_point
-Same as ``mountrw=''.
-.El
-.Pp
-A configuration file contains one line per device/file pair in the form:
-.Bd -literal
- special_file regular_file [ feature ]
-.Ed
-.Pp
-where fields are separated by white space.
-The previously described action options serve to configure, enable,
-disable or unconfigure all devices in the configuration file.
-.Sh FILES
-.Bl -tag -width /etc/vntab -compact
-.It Pa /etc/vntab
-default configuration file for
-.Fl a
-option
-.El
-.Sh EXAMPLES
-.Pp
-.Dl vnconfig vn0c /tmp/diskimage
-.Pp
-Configures the vnode disk
-.Pa vn0c .
-.Pp
-.Dl vnconfig -e vn0c /var/swapfile swap
-.Pp
-Configures
-.Pa vn0c
-and enables swapping on it.
-.Pp
-.Dl vnconfig -d vn0c myfilesystem mount=/mnt
-.Pp
-Unmounts (disables)
-.Pa vn0c .
-.Pp
-.Dl vnconfig -ae
-.Pp
-Configures and enables all devices specified in
-.Pa /etc/vntab .
-.Pp
-.Dl vnconfig -c vn0 somebackingfile
-.Dl disklabel -r -w vn0 auto
-.Dl disklabel -e vn0
-.Pp
-Is an example of how to configure a file-backed VN disk with a disk label
-and to initialize and then edit the label. Once you create the label, you
-can partition your VN disk and, for example, create a filesystem on one of
-the partitions. If you are using a file as backing store, it may be possible
-to recover your VN disk after a crash by vnconfig'ing the same file again
-and using the VN configuration already stored in the file rather then
-relabeling and recreating the filesystem. It is even possible to fsck the
-VN partitions that previously contained filesystems.
-.Pp
-.Dl vnconfig -e -s reserve -S 400m vn1
-.Dl disklabel -r -w vn1 auto
-.Dl newfs /dev/vn1c
-.Dl mount /dev/vn1c /usr/obj
-.Pp
-Is an example of a swap-backed VN disk configuration. This example assumes
-that you have at least 400 megabytes of swap free (and hopefully much more).
-The swap space is pre-reserved in order to maintain maximum performance.
-We then label the disk, newfs it, and mount it as /usr/obj. Swap-backed VN
-devices are recoverable after a crash if you (A) use the reserve flag, and if
-(B) the same swap is reserved as was the last time, meaning that such
-vnconfig's would have to be run in your rc.local. In general, though, you
-only use swap-backed VN devices to hold information you don't mind losing
-on every reboot.
-.Sh SEE ALSO
-.Xr mount 2 ,
-.Xr swapon 2 ,
-.Xr unmount 2 ,
-.Xr vn 4
OpenPOWER on IntegriCloud