VNCONFIG(8)             OpenBSD System Manager's Manual            VNCONFIG(8)

NAME
     vnconfig - configure vnode disks for file swapping or pseudo file systems

SYNOPSIS
     vnconfig -c [-vk] rawdev regular_file
     vnconfig -u [-v] rawdev

DESCRIPTION
     The vnconfig command configures vnode pseudo disk devices.  It will asso-
     ciate the special file rawdev with the regular file 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 filesys-
     tem that is mounted in the name space.  Both traditional devices, vnd,
     and the cache-coherent devices, svnd, are configured through vnconfig.

     If you read the regular file while using svnd, you need to mount the svnd
     with the mount option sync to ensure consistency in the buffer cache.
     For normal operation this is not necessary.

     The options are as follows:

     -c      Configures the device.  If successful, references to rawdev will
             access the contents of regular_file.

     -u      Unconfigures the device.

     -v      Print messages to stdout describing actions taken.

     -k      Associate an encryption key with the device.  All data will be
             encrypted before it is written to the disk.  Encryption only
             works with svnd.

     If no action option is given, -c is assumed.

FILES
     /dev/{,r}{,s}vnd*

EXAMPLES
     Configure the vnode disk svnd0 (all of its partitions become usable):

           vnconfig svnd0 /tmp/diskimage

     Unconfigure the same device:

           vnconfig -u svnd0

BUGS
     This command should really be named vndconfig.

SEE ALSO
     vnd(4), mount(8), swapon(8), umount(8)

OpenBSD 3.0                      July 8, 1993                                1
