Common vdev options

There are common options that apply to more than one type of vdev.

These common options are described below. If, however, an option is also described in the reference for an individual vdev, refer to that description.

hostvector vector_number

Applies only to PIC vdevs. This option sets the associated host vector number of the first line of the current vdev. This number is used by InterruptAttach() and InterruptAttachEvent() (see the QNX OS C Library Reference). The PIC input lines that follow are sequentially assigned to host vector numbers.

This option is needed only if any of the PIC guest interrupts will be marked as pass-through. If hostvector isn't specified, its value defaults to the previous PIC device's hostvector number, plus this previous device's number of lines. If this is the first PIC specified, hostvector defaults to 0 (zero).

intr guest_intr

The guest interrupt of the current vdev is set to guest_intr, in two parts, separated by a colon (e.g., intr gic:40).

For PCI devices that use an interrupt, if you don't set a number for guest_intr, this number is automatically assigned. For non-PCI devices (e.g., MMIO devices), you must set this option.

For more information, see Guest interrupts in the Configuration chapter.

loc location_spec

Make the current vdev appear to the guest at location_spec, which can be in memory, in I/O space, or on the PCI bus, depending on the vdev. The location_spec argument is complex, consisting of multiple fields that depend on which of these resource types is being configured. This option is mandatory for non-PCI (e.g., MMIO) devices.

log filter[,filter,...] output_dest

The message types to output and their output destination. This option lets you override the VM's global logging for the current vdev, so you can see certain message types related to the vdev's activity.

The option's argument has two tokens: The first is a comma-separated list of the severity levels of the messages to be output. The possible severity levels are:

• fatal
• internal
• error
• warning
• info
• debug
• verbose

The second token is the destination, which is one of: stdout, stderr, slog, and none. This last setting allows you to disable outputting certain message types.

You may specify as many log options as you like, but if you specify conflicting destinations for a given severity level, the latter (rightmost) option takes precedence. For example, if you have the following:

log fatal,internal,error,warn stdout
log warn none

The second option setting cancels the logging of warnings that was set by the first setting.

The log and logger options work similarly, so for more details about the syntax and semantics of this option, see the logger entry in the VM Configuration Reference chapter.

name name

An optional name used by the vdev for further configuration. Currently this option is relevant only for peer vdevs, such as virtio-net, and for PIC devices. For certain PIC devices, the name may be referenced in guest_intr specifications to say that the device is connected to a given PIC input line.

See VM configuration file example for details on how the name option relates to specific PIC hardware. See vdev virtio-net in this chapter for more information about using the name option when configuring peers in a network.