HP Integrity Virtual Machines 4.2: Installation, Configuration, and Administration

hpvmdevmgmt(1M)
NAME
hpvmdevmgmt -- Manage the devices that are associated with the VM Host and the guests.
SYNOPSIS
hpvmdevmgmt -a { server | env |rdev | gdev }:entry-name [-V]
hpvmdevmgmt -d { server | env |rdev | gdev }:entry-name [-V]
hpvmdevmgmt -d gdev: { all | entry-name } :depend:dependent-name [-V]
hpvmdevmgmt -d { gdev |rdev }:/devpath IGNOREWWID
hpvmdevmgmt -d { server | env |rdev | gdev }:entry-name:attr:attr-name [-V]
hpvmdevmgmt -d gdev_alias:/dev/rdisk/disknn
hpvmdevmgmt -m { server | env |rdev | gdev
}:entry-nameattr:attr-name=attr-value [-V]
hpvmdevmgmt -m {[gdev ] | [rdev]} :/devpath:IGNOREWWID={YES|NO}
hpvmdevmgmt -n {[gdev ] | [rdev]}:oldentry-name:newentry-name0
[,newentry-name1] [-V]
hpvmdevmgmt -l { all |server env | rdev | gdev } [:entry-name] [-V]
hpvmdevmgmt -l { all |server env | rdev | gdev }:depend:dependent-name [-V]
hpvmdevmgmt -l { all |server env | rdev | gdev }:attr-name=attr-value [-V]
hpvmdevmgmt -I [-V]
hpvmdevmgmt -r > repair_script.h
hpvmdevmgmt -v
hpvmdevmgmt [-A] -S file-size file-name [-V]
DESCRIPTION
Manages entries in the Integrity VM device-management database, which tracks and validates
guest-device usage, ensures that devices are only shared deliberately, and restricts guest access
to devices used by the VM Host. Guest devices are added, modified, and removed from this
database when you use Integrity VM commands, such as hpvmcreate, hpvmmodify, and
hpvmclone. The hpvmdevmgmt command allows you to examine the database entries, alter
specific device attributes, such as shared devices. You can also use the hpvmdevmgmt command
to create database entries for restricted devices (to which guest access is prohibited) and for
pre-extending files used as virtual devices.
The device management database contains four types of entries:
• Restricted devices (rdev)
• Guest devices (gdev)
• Environmental entries (env)
• VM Host devices (server)
A device management database entry contains a name or alias, attributes in the form
attribute-name=value, a list of guest names and device entities that depend on the entry (called its
dependents), and a unique identifier.
The Integrity VM device-management facility allows you to restrict devices and directories for
exclusive use by the VM Host in two ways:
• By specifying individual device, file, or directory paths:
# hpvmdevmgmt -a rdev:/some-device
# hpvmdevmgmt -a rdev:/some-file
# hpvmdevmgmt -a rdev:/some-directory
This method restricts the ability to later designate the specified device, file, or directory for
use by a guest.
• By specifying recursive directory paths:
244