NAME

ldom.conf — Logical Domain configuration

DESCRIPTION

ldom.conf is the configuration file to configure logical domains.

Domains are defined in the following format:

domain name {...}

Declare a scope for resources assigned to the specified domain. The scope must be opened and closed with curly braces and contains one or more of the following keywords, each on a separate line. A scope with name primary configures resources for the primary domain. If no configuration for the primary domain exists it is assigned all CPU and memory resources not used by any guest domains.

vcpu number[:stride]

Declare the number of virtual CPUs assigned to a domain. Optionally a stride can be specified to allocate additional virtual CPUs but not assign them to a domain. This can be used to distribute virtual CPUs over the available CPU cores.

memory number[unit]

Declare the amount of memory assigned to a domain, in bytes. Optionally, the units 'K', 'M', or 'G', for kilo-, mega-, and gigabytes can be used.

iodevice path

Assign the specified PCIe device to the guest domain. This keyword can be used multiple times.

variable name=value

Set the specified NVRAM variable for the domain. See eeprom(8) for a list of OpenPROM variables.

vdisk file

The specified file is used to back a virtual disk of the guest domain. file can be a block device node or a disk image file created with dd(1). This keyword can be used multiple times.

vnet [{keyword=value ...}]

Assign a vnet(4) network interface to the guest domain. This keyword can be used multiple times. The curly braces are optional and can contain the following keywords:

mac-addr=address

Configure the MAC address of the interface.

mtu=number

Configure the MTU of the interface.

EXAMPLES

Define a domain with 12 virtual cores, 4GB memory, two file based virtual disks and one virtual network interface:

domain "puffy" {
	vcpu 12
	memory 4G
	vdisk "/home/puffy/vdisk0"
	vdisk "/home/puffy/vdisk1"
	vnet
}

Define another one with slightly less resources:

domain "salmah" {
	vcpu 8
	memory 2G
	vdisk "/home/salmah/vdisk0"
	vdisk "/home/salmah/vdisk1"
	vnet
}

On a machine with 32 cores and 64GB physical memory, this leaves 12 cores and 58GB memory to the primary domain.

SEE ALSO

eeprom(8), ldomctl(8), ldomd(8)