/ 
Sys-Async-Virt-0.2.5
River stage zero No dependents
/ Sys::Async::Virt::Connection::Process

NAME

Sys::Async::Virt::Connection::Process - Connection to LibVirt server using an external process

VERSION

v0.2.5

SYNOPSIS

use v5.26;
use Future::AsyncAwait;
use Sys::Async::Virt::Connection::Factory;

my $factory = Sys::Async::Virt::Connection::Factory->new;
my $conn    = $factory->create_connection( 'qemu+ext:///system?cmd=/bin/true' );

DESCRIPTION

This module connects to a local LibVirt server through an external command which forwards standard input to and standard output from the LibVirt server.

NOTE This module requires the Future::IO->waitpid call to work, which the default implementation does not provide. Any of the other backends listed in Future::IO needs to be active for this module to work.

URL PARAMETERS

This connection driver supports these parameters in the query string of the URL, as per LibVirt's documentation:

  • command

CONSTRUCTOR

new

Not to be called directly. Instantiated via the connection factory (Sys::Async::Virt::Connection::Factory).

METHODS

connect

await $conn->connect;

is_secure

my $bool = $conn->is_secure;

Returns false: there is no guarantee that the external process is transferring the data securely. As LibVirt's docs put it: we fail on the safe side.

SEE ALSO

LibVirt, Sys::Virt

LICENSE AND COPYRIGHT

Copyright (C) 2024-2026 Erik Huelsmann

All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.