Sys::Virt::NetworkPort(3)

NAME
Sys::Virt::NetworkPort - Represent & manage a libvirt virtual network port

DESCRIPTION
The "Sys::Virt::NetworkPort" module represents a port in a virtual network.

METHODS

my $uuid = $port->get_uuid()
    Returns a 16 byte long string containing the raw globally unique identifier (UUID) for the network port.

my $uuid = $port->get_uuid_string()
    Returns a printable string representation of the raw UUID, in the format 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'.

my $xml = $port->get_xml_description()
    Returns an XML document containing a complete description of the network port's configuration

$port->delete()
    Delete the network port from the managed network.

my $params = $port->get_parameters($flags=0);
    Get tunable parameters associated with the network port. The $flags parameter is currently unused and defaults to zero. The returned $params is a hash reference whose keys are one or more of the following constants:

    Sys::Virt::NetworkPort::BANDWIDTH_IN_AVERAGE
        The average inbound bandwidth

    Sys::Virt::NetworkPort::BANDWIDTH_IN_BURST
        The burstable inbound bandwidth

    Sys::Virt::NetworkPort::BANDWIDTH_IN_FLOOR
        The minimum inbound bandwidth

    Sys::Virt::NetworkPort::BANDWIDTH_IN_PEAK
        The peak inbound bandwidth

    Sys::Virt::NetworkPort::BANDWIDTH_OUT_AVERAGE
        The average outbound bandwidth

    Sys::Virt::NetworkPort::BANDWIDTH_OUT_BURST
        The burstable outbound bandwidth

    Sys::Virt::NetworkPort::BANDWIDTH_OUT_PEAK
        The peak outbound bandwidth

$port->set_parameters($params, $flags=0);
    Set tunable parameters associated with the network port. The $flags parameter is currently unused and defaults to zero. The $params parameter is a hash reference whose keys are one or more of the constants listed for "get_parameters".

  NETWORK PORT CREATION CONSTANTS
When creating network ports zero or more of the following constants may be used

Sys::Virt::NetworkPort::CREATE_RECLAIM
    Providing configuration reclaiming a pre-existing network port.

Sys::Virt::NetworkPort::CREATE_VALIDATE
    Validate the XML document against the XML schema

AUTHORS
Daniel P. Berrange <berrange@redhat.com>

COPYRIGHT
Copyright (C) 2019 Red Hat

LICENSE
This program is free software; you can redistribute it and/or modify it under the terms of either the GNU General Public License as published by the Free Software Foundation (either version 2 of the License, or at your option any later version), or, the Artistic License, as specified in the Perl README file.

SEE ALSO
Sys::Virt, Sys::Virt::Network, Sys::Virt::Error, "http://libvirt.org"