Previous page

Next page

Locate page in Contents

Print this page

Serial Port Management Parameters

This group of parameters is used to manage serial ports in a virtual machine.

Syntax

pctl set ID | VM_name --device-add serial

{ --device name | --output file | --socket name }

[ --enable | --disable ][ --connect | --disconnect ]

pctl set ID | VM_name --device-set serialN

{ --device name | --output file | --socket name }

[ --enable | --disable ][ --connect | --disconnect ]

Parameters

Name

Description

ID

The virtual machine ID.

VM_name

The virtual machine name.

--device-add

Adds a new serial port to the virtual machine. You can connect up to four serial ports to a virtual machine.

--device-set

Modifies the parameters of an existing serial port.

serial

Specifies the type of the virtual device to add (in this instance, a serial port).

--device name

The name of the physical serial port to which to connect the virtual machine.

--output file

The name and path of the output file to which to connect the virtual serial port.

--socket name

The name of the physical socket to which to connect the virtual serial port.

--enable

Enables the virtual serial port. All newly added serial ports are enabled by default (provided the --disable option is omitted).

--disable

Disables the virtual serial port.

--connect

Automatically connect the virtual serial port during the virtual machine startup process.

--disconnect

Do not automatically connect the virtual serial port during the virtual machine startup process.

Links

General Syntax , Virtual Device Management , Legend