Sys::Virt::NetworkPort(3pm)                User Contributed Perl Documentation


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"

perl v5.38.0                      2023-07-26       Sys::Virt::NetworkPort(3pm)