MOUNT_VND(8) - System Manager's Manual

MOUNT_VND(8) - System Manager’s Manual #

MOUNT_VND(8) - System Manager’s Manual

NAME #

mount_vnd - mount vnode disks

SYNOPSIS #

mount_vnd [-k] [-K rounds] [-o options] [-S saltfile] [-t disktype] image vnd_dev

DESCRIPTION #

mount_vnd works similarly to vnconfig(8), but it provides an interface that can be used by the fstab(5) infrastructure, so that an image file can be configured to a device vnd_dev while booting.

For fstab(5) lines with type “ffs”, the “noauto” option must be set to prevent a mount(8) of the FFS partitions before the necessary vnd devices are configured. Also, the “fs_passno” field has to be set to 0 to prevent fsck(8) from checking the file system for the same reasons.

mount_vnd is invoked by mount(8) when using the following syntax:

mount [options] -t vnd image vnd_dev

The options are as follows:

-K rounds

Associate an encryption key with the device. All data will be encrypted using the Blowfish cipher before it is written to the disk. The user is asked for both a passphrase and the name of a salt file. The salt file can also be specified on the command line using the -S option. The passphrase and salt are combined according to PKCS #5 PBKDF2 for the specified number of rounds to generate the actual key used. rounds is a number between 1000 and INT_MAX. DO NOT LOSE THE SALT FILE.

-k

Associate an encryption key with the device. All data will be encrypted using the Blowfish cipher before it is written to the disk.

-o options

Options are specified with a -o flag followed by a comma separated string of options. See the mount(8) man page for possible options and their meanings.

At the moment, -o is only here for compatibility reasons, but no use is made of supplied options.

-S saltfile

When -K is used, specify the saltfile.

-t disktype

Specify a disktype entry from the disktab(5) database. The vnd_dev will have the sector size, sectors per track, and tracks per cylinder values of the specified disktype. The defaults are 512-byte sectors, 100 sectors per track and 1 track per cylinder.

FILES #

/dev/{,r}vnd*‌

EXAMPLES #

An example fstab(5) entry is:

/tmp/cryptimg /dev/vnd0c vnd rw,noauto,-k       0 0
/dev/vnd0a   /mnt        ffs rw,noauto          0 0

Mounting images during the first pass of fsck(8) and mount(8) is not possible, because the image to be configured to a vnd itself resides on a file system that first has to be checked and mounted.

SEE ALSO #

vnd(4), disktab(5), fstab(5), mount(8), swapon(8), umount(8)

HISTORY #

The mount_vnd command first appeared in OpenBSD 4.2.

OpenBSD 7.5 - April 23, 2020