Sys::Virt::NetworkPort(3) | User Contributed Perl Documentation | 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"
2023-10-06 | perl v5.26.3 |