Cisco::UCS::Common::EthernetPort is a class used to represent a single Ethernet port in a Cisco::UCS
system. This class provides functionality to retrieve information and statistics for Ethernet ports.
Please note that you should not need to call the constructor directly as Cisco::UCS::Common::EthernetPort
objects are created for you automatically via methods in other Cisco::UCS packages like the i<get_ports>
method in Cisco::UCS::Interconnect.
Dependent on UCSM version, some attributes of the Ethernet port may not be provided and hence the
accessor methods may return an empty string.
All statistical methods are implemented in both a non-caching and caching form; non-caching methods
always query the UCSM for data retrieval and therefore may be more expensive in terms of system and
network resources than the equivalent caching method. Non-caching methods are always named using the
Where <B>typeB> is one of rx, tx or err as described in the <B>STATISTICS METHODSB> section above, and
<B>counter_nameB> is the name of the counter as per the section below.
Caching methods return a cached result retrieved during a previous query if available, if cached data
retrieved from a previous query is not available, then a the UCSM is queried for the requested data.
Caching methods are named using the same form as non-caching methods excluding the prefix <B>get_B>.
Because UCSM queries may be expensive it is important to note the way in which caching has been implemented
and the potential side-effects that this may have. In brief, when a non-caching method is executed for a
particular counter type (tx, rx or err) either implicitly or explicitly, all other available counters for
that type are also retrieved and cached.
This may introduce side-effects and action-at-a-distance and thus, and Cisco::UCS::Common::EthernetPort
objects cannot be considered reentrant.