qemu.qmp.qom module

QEMU Object Model testing tools.

usage: qom [-h] {set,get,list,tree,fuse} …

Query and manipulate QOM data

optional arguments:

-h, --help

show this help message and exit

QOM commands:

{set,get,list,tree,fuse}

set Set a QOM property value get Get a QOM property value list List QOM properties at a given path tree Show QOM tree from a given path fuse Mount a QOM tree as a FUSE filesystem

class qemu.qmp.qom.QOMGet(args: argparse.Namespace)

Bases: qemu.qmp.qom_common.QOMCommand

QOM Command - Get a property’s current value.

usage: qom-get [-h] [–socket SOCKET] <path>.<property>

Get a QOM property value

positional arguments:

<path>.<property> QOM path and property, separated by a period ‘.’

optional arguments:

-h, --help

show this help message and exit

--socket SOCKET, -s SOCKET

QMP socket path or address (addr:port). May also be set via QMP_SOCKET environment variable.

classmethod configure_parser(parser: argparse.ArgumentParser) → None

Configure a parser with this command’s arguments.

Parameters

parser – argparse parser or subparser object.

help: str = 'Get a QOM property value'

name: str = 'get'

run() → int

Run this command.

Returns

0 on success, 1 otherwise.

class qemu.qmp.qom.QOMList(args: argparse.Namespace)

Bases: qemu.qmp.qom_common.QOMCommand

QOM Command - List the properties at a given path.

usage: qom-list [-h] [–socket SOCKET] <path>

List QOM properties at a given path

positional arguments:

<path> QOM path

optional arguments:

-h, --help

show this help message and exit

--socket SOCKET, -s SOCKET

QMP socket path or address (addr:port). May also be set via QMP_SOCKET environment variable.

classmethod configure_parser(parser: argparse.ArgumentParser) → None

Configure a parser with this command’s arguments.

Parameters

parser – argparse parser or subparser object.

help: str = 'List QOM properties at a given path'

name: str = 'list'

run() → int

Run this command.

Returns

0 on success, 1 otherwise.

class qemu.qmp.qom.QOMSet(args: argparse.Namespace)

Bases: qemu.qmp.qom_common.QOMCommand

QOM Command - Set a property to a given value.

usage: qom-set [-h] [–socket SOCKET] <path>.<property> <value>

Set a QOM property value

positional arguments:

<path>.<property> QOM path and property, separated by a period ‘.’ <value> new QOM property value

optional arguments:

-h, --help

show this help message and exit

--socket SOCKET, -s SOCKET

QMP socket path or address (addr:port). May also be set via QMP_SOCKET environment variable.

classmethod configure_parser(parser: argparse.ArgumentParser) → None

Configure a parser with this command’s arguments.

Parameters

parser – argparse parser or subparser object.

help: str = 'Set a QOM property value'

name: str = 'set'

run() → int

Run this command.

Returns

0 on success, 1 otherwise.

class qemu.qmp.qom.QOMTree(args: argparse.Namespace)

Bases: qemu.qmp.qom_common.QOMCommand

QOM Command - Show the full tree below a given path.

usage: qom-tree [-h] [–socket SOCKET] [<path>]

Show QOM tree from a given path

positional arguments:

<path> QOM path

optional arguments:

-h, --help

show this help message and exit

--socket SOCKET, -s SOCKET

QMP socket path or address (addr:port). May also be set via QMP_SOCKET environment variable.

classmethod configure_parser(parser: argparse.ArgumentParser) → None

Configure a parser with this command’s arguments.

Parameters

parser – argparse parser or subparser object.

help: str = 'Show QOM tree from a given path'

name: str = 'tree'

run() → int

Run this command.

Returns

0 on success, 1 otherwise.

qemu.qmp.qom.main() → int

QOM script main entry point.