byteblowerll package¶

byteblowerll.byteblower module¶

`byteblowerll.byteblower.ByteBlower`(*args, …)	Singleton class that is the entry point to start using the ByteBlower API.
`byteblowerll.byteblower.ByteBlowerAPIException`()
`byteblowerll.byteblower.ByteBlowerInterface`(…)	Example
`byteblowerll.byteblower.ByteBlowerInterfaceList`(*args)
`byteblowerll.byteblower.ByteBlowerLicense`(…)	This class represents the license information of your connected server.
`byteblowerll.byteblower.ByteBlowerPort`(…)	Logical representation of a network host docked somewhere in the NUT, which can transmit or schedule network traffic, process incoming traffic and run stateful network applications.
`byteblowerll.byteblower.ByteBlowerPortList`(*args)
`byteblowerll.byteblower.ByteBlowerPortResultData`(…)	ByteBlower port counter result set.
`byteblowerll.byteblower.ByteBlowerPortResultHistory`(…)	Port counter result history.
`byteblowerll.byteblower.ByteBlowerPortResultRxData`(…)	ByteBlower port counter result set.
`byteblowerll.byteblower.ByteBlowerPortResultSnapshot`(…)	ByteBlower port counter result set.
`byteblowerll.byteblower.ByteBlowerServer`(…)	Representation of a client connection to a shared, physical ByteBlower server, which can send and receive network traffic through its interfaces.
`byteblowerll.byteblower.ByteBlowerServerServiceInfo`(…)	This class contains information on the ByteBlower System.
`byteblowerll.byteblower.Capability`(*args, …)	Represents a capability, A feature it supports or not.
`byteblowerll.byteblower.CapabilityValue`(…)	The Capability Value class.
`byteblowerll.byteblower.CapturedFrame`(…)	A representation of a Captured Frame captured using a `CaptureRawPacket`.
`byteblowerll.byteblower.CapturedHTTPData`(…)	This class represents captured HTTP data.
`byteblowerll.byteblower.CaptureRawPacket`(…)	This class is used to capture the raw packet data that is received on the Physical interface that is associated with a ByteBlowerPort.
`byteblowerll.byteblower.CaptureResultSnapshot`(…)	This class represents the result of a `CaptureRawpacket`.
`byteblowerll.byteblower.CHAPProtocol`(*args, …)	Represents the Challenge-Handshake Authentication Protocol
`byteblowerll.byteblower.DataRate`(inSize, …)	Represents a data rate.
`byteblowerll.byteblower.DataSize`(bytes)	Represents a data size.
`byteblowerll.byteblower.DeviceInfo`(*args, …)	Device information of the wireless endpoint.
`byteblowerll.byteblower.DHCPv4Protocol`(…)	The `DHCPv4Protocol` is the entry point to configure the DHCP client behavior of a ByteBlowerPort.
`byteblowerll.byteblower.DHCPv4SessionInfo`(…)	Class containing the info about the DHCPSession.
`byteblowerll.byteblower.DHCPv6Protocol`(…)	The `DHCPv6Protocol` is the entry point to configure the DHCPv6 client behavior of a ByteBlowerPort.
`byteblowerll.byteblower.DHCPv6SessionInfo`(…)	Class containing the info about the DHCPSession.
`byteblowerll.byteblower.EthernetConfiguration`(…)	EthernetII provides an interface for the Ethernet configuration on a ByteBlower port.
`byteblowerll.byteblower.Frame`(args, *kwargs)	Class: Frame
`byteblowerll.byteblower.FrameFieldModifierIncremental`(…)	A frame field modifier which will increase the value of the frame field between a minimum and maximum value.
`byteblowerll.byteblower.FrameFieldModifierRandom`(…)	A frame field modifier which will change the field value of the frame randomly between a minimum and maximum value.
`byteblowerll.byteblower.FrameMobile`(*args, …)	A FrameMobile is an object that configures the payload of a frame belonging to a StreamMobile object.
`byteblowerll.byteblower.FrameResultData`(…)
`byteblowerll.byteblower.FrameResultHistory`(…)	Sender-side frame transmission result history.
`byteblowerll.byteblower.FrameResultSnapshot`(…)	TODO
`byteblowerll.byteblower.FrameSizeModifierGrowing`(…)	A frame size modifier which will increase the size of the frame between a minimum and maximum value.
`byteblowerll.byteblower.FrameSizeModifierRandom`(…)	A frame size modifier which will change the size of the frame randomly between a minimum and maximum value.
`byteblowerll.byteblower.FrameSizeModifierResultSnapshot`(…)	A collection of statistics containing the results of a frame size modifier.
`byteblowerll.byteblower.FrameTagMetrics`(…)	Class which represents the metrics of a FrameTag.
`byteblowerll.byteblower.FrameTagRx`(*args, …)	The FrameTagRx class describes the receive configuration of a Tag in a Frame.
`byteblowerll.byteblower.FrameTagTx`(*args, …)	The FrameTagTx class describes the transmit configuration of a Tag in a Frame.
`byteblowerll.byteblower.HTTPClient`(*args, …)	HTTP client application that may schedule HTTP requests to real webservers or the HTTP server application.
`byteblowerll.byteblower.HTTPClientMobile`(…)	HTTP client application that may schedule HTTP requests to the HTTP server application.
`byteblowerll.byteblower.HTTPMultiClient`(…)	HTTPMultiClient can be used in combination with MultiServer to start multiple concurrent HTTP requests.
`byteblowerll.byteblower.HTTPMultiResultData`(…)	Contains the result counters for `HTTPMultiClient` or `HTTPMultiServer`.
`byteblowerll.byteblower.HTTPMultiResultHistory`(…)	General interface for getting cumulative or interval results.
`byteblowerll.byteblower.HTTPMultiResultSnapshot`(…)	Refreshable snapshot that contains the result counters for HTTPMultiClient or HTTPMultiServer.
`byteblowerll.byteblower.HTTPMultiServer`(…)	HTTPMultiServer provides the server-side for HTTPMultiClient.
`byteblowerll.byteblower.HTTPResultData`(…)	Contains the HTTP result counters.
`byteblowerll.byteblower.HTTPResultHistory`(…)	General interface for getting cumulative or interval results.
`byteblowerll.byteblower.HTTPResultSnapshot`(…)	Contains HTTP result counters.
`byteblowerll.byteblower.HTTPServer`(*args, …)	HTTP server application that handles incoming HTTP requests with the correct URL format by returning a document of the appropriate size.
`byteblowerll.byteblower.HTTPSessionInfo`(…)	Class containing the info about the HTTPSession.
`byteblowerll.byteblower.ICMPEchoSession`(…)	Session for handling ICMP Echo Requests and Replies.
`byteblowerll.byteblower.ICMPEchoSessionInfo`(…)
`byteblowerll.byteblower.ICMPProtocol`(*args, …)	The ICMP protocol is attached to the IPv4 protocol and allows the host to start ICMP sessions, through which it can communicate with the Layer3 IP network.
`byteblowerll.byteblower.ICMPv6EchoSession`(…)	Session for handling ICMPv6 Echo Requests and Replies.
`byteblowerll.byteblower.ICMPv6EchoSessionInfo`(…)
`byteblowerll.byteblower.ICMPv6Protocol`(…)	ICMPv6 Protocol.
`byteblowerll.byteblower.IGMPMemberSessionInfo`(…)	InfoObject of the IGMPSession.
`byteblowerll.byteblower.IGMPProtocol`(*args, …)	The Internet Group Management Protocol (IGMP) Protocol for IPv4 manages multicast group membership for a given IPv4 host.
`byteblowerll.byteblower.IGMPProtocolInfo`(…)	Class: IGMPProtocolInfo
`byteblowerll.byteblower.IGMPv1MemberSession`(…)
`byteblowerll.byteblower.IGMPv2MemberSession`(…)
`byteblowerll.byteblower.IGMPv3MemberSession`(…)
`byteblowerll.byteblower.IPv4Configuration`(…)	Provides an interface for the IPv4 configuration on a ByteBlower port.
`byteblowerll.byteblower.IPv4CPProtocol`(…)	Internet Protocol Control Protocol.
`byteblowerll.byteblower.IPv6Configuration`(…)	A class representing the IPv6 protocol that allows managing IPv6 settings, running IPv6 commands and accessing attached protocols.
`byteblowerll.byteblower.IPv6CPProtocol`(…)	IP version 6 over PPPoE.
`byteblowerll.byteblower.LatencyBasic`(*args, …)	Receive-side packet processor which calculates latency on the incoming frames, matching a filter.
`byteblowerll.byteblower.LatencyBasicMobile`(…)	Receive-side packet processor which calculates latency on the incoming frames, matching a filter.
`byteblowerll.byteblower.LatencyBasicResultData`(…)	Receive-side latency result set.
`byteblowerll.byteblower.LatencyBasicResultHistory`(…)	Receive-side latency result history.
`byteblowerll.byteblower.LatencyBasicResultSnapshot`(…)	Receive-side latency result set.
`byteblowerll.byteblower.LatencyDistribution`(…)	Receive-side packet processor which calculates distribution of latency on the incoming frames, matching a filter.
`byteblowerll.byteblower.LatencyDistributionMobile`(…)	Receive-side packet processor which calculates distribution of latency on the incoming frames, matching a filter.
`byteblowerll.byteblower.LatencyDistributionResultSnapshot`(…)	The latency distribution result.
`byteblowerll.byteblower.MeetingPoint`(*args, …)	A MeetingPoint is a server that controls a set of wireless devices.
`byteblowerll.byteblower.MeetingPointLicense`(…)	This class represents the license information of your connected Meeting Point.
`byteblowerll.byteblower.MeetingPointServiceInfo`(…)	This class contains information on the MeetingPoint System.
`byteblowerll.byteblower.MLDMulticastListenerSessionInfo`(…)
`byteblowerll.byteblower.MLDProtocol`(*args, …)	The Multicast Listener Discovery Protocol (MLD) Protocol for IPv6 manages multicast address listening for a given IPv6 host.
`byteblowerll.byteblower.MLDProtocolInfo`(…)
`byteblowerll.byteblower.MLDv1MulticastListenerSession`(…)
`byteblowerll.byteblower.MLDv1StartListening`(arg2)
`byteblowerll.byteblower.MLDv1StopListening`(arg2)
`byteblowerll.byteblower.MLDv2MulticastListenerSession`(…)
`byteblowerll.byteblower.MultipleBurstModifier`(…)
`byteblowerll.byteblower.NetworkInfo`(*args, …)	Network information of the wireless endpoint.
`byteblowerll.byteblower.NetworkInfoMonitor`(…)	Monitor to collect the NetworkInfo over time
`byteblowerll.byteblower.NetworkInfoMonitorResultHistory`(…)	History for the network info monitor representing the results over time
`byteblowerll.byteblower.NetworkInfoMonitorResultData`(…)	Result snapshot for the network information.
`byteblowerll.byteblower.NetworkInterface`(…)	NetworkInterface information of the wireless endpoint.
`byteblowerll.byteblower.NetworkInterfaceType`
`byteblowerll.byteblower.NormalDistributionTimingModifier`(…)
`byteblowerll.byteblower.OutOfSequence`(*args, …)	Receive-side packet processor which checks out-of-sequence on the incoming frames, matching a filter.
`byteblowerll.byteblower.OutOfSequenceResultData`(…)	Non-refreshable object containing the out-of-sequence results.
`byteblowerll.byteblower.OutOfSequenceResultHistory`(…)	Receive-side out-of-sequence result history.
`byteblowerll.byteblower.OutOfSequenceResultSnapshot`(…)	Refreshable object containing the out-of-sequence results.
`byteblowerll.byteblower.PacketDump`(*args, …)	Utility for dumping ByteBlower network traffic to a pcap file.
`byteblowerll.byteblower.PAPProtocol`(*args, …)	Represents the Password Authentication Protocol
`byteblowerll.byteblower.PPPoEClient`(*args, …)	A PPPoE client which allows you to setup Layer3 connectivity.
`byteblowerll.byteblower.PPPProtocol`(*args, …)	The Point-to-Point Protocol (PPP) provides a standard method for transporting multi-protocol datagrams over point-to-point links.
`byteblowerll.byteblower.Schedule`(args, *kwargs)	This class contains the base functionality to configure a scheduled action.
`byteblowerll.byteblower.ScheduleGroup`(*args, …)	A collection of schedulable objects that can be started.
`byteblowerll.byteblower.Stream`(args, *kwargs)	A ByteBlower stream is an object representing a stream of ByteBlower frames (Frame) used for transmission on a ByteBlower port.
`byteblowerll.byteblower.StreamGrowingSizeModifier`(…)	A frame size modifier which will increase the size of the frame between a minimum and maximum value.
`byteblowerll.byteblower.StreamMobile`(*args, …)	A StreamMobile object configures a stream of frames that will be transmitted by a WirelessEndpoint.
`byteblowerll.byteblower.StreamRandomSizeModifier`(…)	A frame size modifier which will change the size of the frame randomly between a minimum and maximum value.
`byteblowerll.byteblower.StreamResultData`(…)
`byteblowerll.byteblower.StreamResultHistory`(…)	Sender-side transmit result history.
`byteblowerll.byteblower.StreamResultSnapshot`(…)
`byteblowerll.byteblower.StreamRuntimeStatus`(…)	Status information about a Stream
`byteblowerll.byteblower.TCPResultData`(*args, …)	Contains static TCP result counters.
`byteblowerll.byteblower.TCPResultHistory`(…)	Interface that allows you to obtain the cumulative and interval result data objects regarding TCP stats.
`byteblowerll.byteblower.TCPResultSnapshot`(…)	Contains TCP result counters.
`byteblowerll.byteblower.TCPSessionInfo`(…)	Class containing info about the TCP session.
`byteblowerll.byteblower.TCPTunnel`(*args, …)	Creates a TCP port forwarding configuration between a local host and a remote server.
`byteblowerll.byteblower.TelnetClient`(*args, …)	A Telnet client application that allows communication with an external Telnet server.
`byteblowerll.byteblower.TriggerBasic`(*args, …)	Receive-side packet processor which counts the incoming frames, matching a filter.
`byteblowerll.byteblower.TriggerBasicMobile`(…)	Receive-side packet processor on a WirelessEndpoint that counts all incoming frames that match a filter.
`byteblowerll.byteblower.TriggerBasicResultData`(…)	Receive-side trigger result set.
`byteblowerll.byteblower.TriggerBasicResultHistory`(…)	Receive-side trigger result history.
`byteblowerll.byteblower.TriggerBasicResultSnapshot`(…)	Receive-side trigger result set.
`byteblowerll.byteblower.TriggerSizeDistribution`(…)	Receive-side packet processor which counts the incoming frames, frame rate and frames per size, matching a filter.
`byteblowerll.byteblower.TriggerSizeDistributionResultSnapshot`(…)	Contains the results for the size distribution.
`byteblowerll.byteblower.VLANTag`(args, *kwargs)	Configure the VLAN tag on a ByteBlower Port.
`byteblowerll.byteblower.WirelessEndpoint`(…)	A WirelessEndpoint is a handle to a wireless device-under-test.
`byteblowerll.byteblower.ByteBlowerPortCounterType`
`byteblowerll.byteblower.DeviceOsType`
`byteblowerll.byteblower.DeviceStatus`
`byteblowerll.byteblower.EthernetEncoding`
`byteblowerll.byteblower.FrameTagType`	The type of the FrameTag as found in a Trigger and a Frame
`byteblowerll.byteblower.HTTPMultiClientStatus`
`byteblowerll.byteblower.HTTPMultiServerStatus`
`byteblowerll.byteblower.HTTPRequestMethod`
`byteblowerll.byteblower.HTTPRequestStatus`
`byteblowerll.byteblower.HTTPRequestType`
`byteblowerll.byteblower.HTTPServerStatus`
`byteblowerll.byteblower.IGMPVersion`
`byteblowerll.byteblower.LinkStatus`	Link status object
`byteblowerll.byteblower.LinkType`
`byteblowerll.byteblower.LogLevel`
`byteblowerll.byteblower.MLDVersion`
`byteblowerll.byteblower.ModifierType`
`byteblowerll.byteblower.MulticastSourceFilter`
`byteblowerll.byteblower.NetworkInterfaceType`
`byteblowerll.byteblower.PhysicalInterfaceType`
`byteblowerll.byteblower.PPPoEStatus`
`byteblowerll.byteblower.RequestStartType`
`byteblowerll.byteblower.ResultDataType`
`byteblowerll.byteblower.RetransmissionPolicy`
`byteblowerll.byteblower.Role`
`byteblowerll.byteblower.ScheduleGroupStatus`
`byteblowerll.byteblower.SequenceNumberFormat`
`byteblowerll.byteblower.TCPCongestionAvoidanceAlgorithm`
`byteblowerll.byteblower.TCPConnectionState`	The state of the TCP Connection
`byteblowerll.byteblower.TimeStampFormat`
`byteblowerll.byteblower.TimeUnit`
`byteblowerll.byteblower.TransmitErrorSource`	The source of an error of a `Stream`
`byteblowerll.byteblower.TransmitErrorStatus`	The error status of a `Stream`
`byteblowerll.byteblower.TransmitStatus`	The current transmission status of a class:Stream

class byteblowerll.byteblower.AbstractModifier(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

GetByteBlowerStream()¶

GetModifierType()¶

class byteblowerll.byteblower.AbstractObject(*args, **kwargs)¶

Bases: object

Base class for most of the ByteBlowerobjects

DescriptionGet(*args)¶

Gets a textual description for the current object

Example

from byteblowerll.byteblower import ByteBlower
server = ByteBlower.ServerAdd('byteblower-1.lab.byteblower.com')
# ...
# :return: TODO

Gets a textual description for the current object

Example

from byteblowerll.byteblower import ByteBlower
server = ByteBlower.ServerAdd('byteblower-1.lab.byteblower.com')
# ...
# :return: TODO

ParentGet()¶: Returns the parent object.

Refresh()¶: Retrieves the latest data from the server for this object.

class byteblowerll.byteblower.AbstractObjectList(*args)¶

Bases: object

append(x)¶

assign(n, x)¶

back()¶

begin()¶

capacity()¶

clear()¶

empty()¶

end()¶

erase(*args)¶

front()¶

get_allocator()¶

insert(*args)¶

iterator()¶

pop()¶

pop_back()¶

push_back(x)¶

rbegin()¶

rend()¶

reserve(n)¶

resize(*args)¶

size()¶

swap(v)¶

class byteblowerll.byteblower.AbstractRefreshableResult(*args, **kwargs)¶: Bases: byteblowerll.byteblower.AbstractObject

class byteblowerll.byteblower.AbstractRefreshableResultList(*args)¶

Bases: object

append(x)¶

assign(n, x)¶

back()¶

begin()¶

capacity()¶

clear()¶

empty()¶

end()¶

erase(*args)¶

front()¶

get_allocator()¶

insert(*args)¶

iterator()¶

pop()¶

pop_back()¶

push_back(x)¶

rbegin()¶

rend()¶

reserve(n)¶

resize(*args)¶

size()¶

swap(v)¶

exception byteblowerll.byteblower.AddressResolutionFailed(*args)¶: Bases: byteblowerll.byteblower.InitializationError

class byteblowerll.byteblower.Buffer(*args)¶

Bases: object

append(x)¶

assign(n, x)¶

back()¶

begin()¶

capacity()¶

clear()¶

empty()¶

end()¶

erase(*args)¶

front()¶

get_allocator()¶

insert(*args)¶

iterator()¶

pop()¶

pop_back()¶

push_back(x)¶

rbegin()¶

rend()¶

reserve(n)¶

resize(*args)¶

size()¶

swap(v)¶

class byteblowerll.byteblower.BufferList(*args)¶

Bases: object

append(x)¶

assign(n, x)¶

back()¶

begin()¶

capacity()¶

clear()¶

empty()¶

end()¶

erase(*args)¶

front()¶

get_allocator()¶

insert(*args)¶

iterator()¶

pop()¶

pop_back()¶

push_back(x)¶

rbegin()¶

rend()¶

reserve(n)¶

resize(*args)¶

size()¶

swap(v)¶

class byteblowerll.byteblower.ByteBlower(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

Singleton class that is the entry point to start using the ByteBlower API.

Typically, this is the first class you will use when writing a ByteBlower test script. Use this class to connect to ByteBlower servers, to start or stop all configured ByteBlower ports across those servers, and to control the logging behavior.

Retrieve the singleton ByteBlower object using the static method InstanceGet().

This class contains some static convenience methods. They are wrappers around the corresponding non-static methods of the singleton object.

APIVersionGet()¶

Returns the version of the API.

New in version 2.6.0.

Example

DefaultTimeout = 10000000000L¶

static DestroyInstance()¶

static InstanceGet()¶

Creates or returns the ByteBlower API singleton instance.

This object is the entry point to start working with the ByteBlower Python API.

If no ByteBlower instance is created yet, this method creates one and returns the object. If the instance exists already, it is simply returned. Any other static call will implicitly instantiate this singleton object.

Returns:	ByteBlower singleton instance.

Example

instance = bb.InstanceGet()

MeetingPointAdd(*args)¶

Opens a connection to a MeetingPoint and adds it to the current API instance.

A single client instance may be connected to multiple MeetingPoint servers. This allows to use a set of Meeting point servers as a single system. On the other hand, multiple client instances may be connected to a single (shared) MeetingPoint server and will share its resources. See MeetingPoint for more information.

New in version 2.6.0.

Parameters:	server – IP address or hostname of the MeetingPoint server to connect. port – Remote TCP port on which to connect the MeetingPoint server. Should normally never be overridden. Default: 9101
Returns:	A MeetingPoint object that represents the server connection.
Raises:	`MeetingPointUnreachable` - When the MeetingPoint server daemon could not be reached. Typical causes are an incorrect or unreachable DNS name or IP address or a MeetingPoint server daemon that is not running (on purpose or due to a software issue).
Raises:	<python_error> - Relevant network error: When something unexpectedly went wrong with the network connection.
Raises:	`NotImplementedError` - When the <port> parameter is provided and is no integer.

Example

bb.MeetingPointAdd('byteblower-1.lab.byteblower.com')

Opens a connection to a MeetingPoint and adds it to the current API instance.

A single client instance may be connected to multiple MeetingPoint servers. This allows to use a set of Meeting point servers as a single system. On the other hand, multiple client instances may be connected to a single (shared) MeetingPoint server and will share its resources. See MeetingPoint for more information.

New in version 2.6.0.

Parameters:	server – IP address or hostname of the MeetingPoint server to connect. port – Remote TCP port on which to connect the MeetingPoint server. Should normally never be overridden. Default: 9101
Returns:	A MeetingPoint object that represents the server connection.
Raises:	`MeetingPointUnreachable` - When the MeetingPoint server daemon could not be reached. Typical causes are an incorrect or unreachable DNS name or IP address or a MeetingPoint server daemon that is not running (on purpose or due to a software issue).
Raises:	<python_error> - Relevant network error: When something unexpectedly went wrong with the network connection.
Raises:	`NotImplementedError` - When the <port> parameter is provided and is no integer.

Example

bb.MeetingPointAdd('byteblower-1.lab.byteblower.com')

Opens a connection to a MeetingPoint and adds it to the current API instance.

A single client instance may be connected to multiple MeetingPoint servers. This allows to use a set of Meeting point servers as a single system. On the other hand, multiple client instances may be connected to a single (shared) MeetingPoint server and will share its resources. See MeetingPoint for more information.

New in version 2.6.0.

Parameters:	server – IP address or hostname of the MeetingPoint server to connect. port – Remote TCP port on which to connect the MeetingPoint server. Should normally never be overridden. Default: 9101
Returns:	A MeetingPoint object that represents the server connection.
Raises:	`MeetingPointUnreachable` - When the MeetingPoint server daemon could not be reached. Typical causes are an incorrect or unreachable DNS name or IP address or a MeetingPoint server daemon that is not running (on purpose or due to a software issue).
Raises:	<python_error> - Relevant network error: When something unexpectedly went wrong with the network connection.
Raises:	`NotImplementedError` - When the <port> parameter is provided and is no integer.

Example

bb.MeetingPointAdd('byteblower-1.lab.byteblower.com')

MeetingPointGet()¶

Returns all Meeting Point connections within this API instance.

See MeetingPointAdd() for more information

New in version 2.6.0.

Returns:	`MeetingPointList` with objects created within this API instance. Can be empty

Example

meetingPoint = bb.MeetingPointGet()

MeetingPointRemove(inMeetingPoint)¶

MeetingPointRemoveAll()¶

PortsStart(inPorts)¶

Starts all traffic streams and application schedules on the specified ByteBlower ports.

More specifically, for each traffic stream and schedulable object on the specified ports, the configured time to wait kicks off and when this time has passed the corresponding action is performed.

Typical actions include starting a traffic stream or sending out a multicast join message or HTTP request. See Stream and SchedulesStart() for more information.

Streams or schedulable objects that are already scheduled and streams that are already active are ignored. Schedulable objects that are already stopped are scheduled again. See SchedulesStart() for more information.

If a port does not contain any streams or schedules, nothing happens for that port.

Parameters:	ports – `ByteBlowerPortList`
Raises:	ByteBlower.Exception.InvalidValue.NotAnObject - When one of the items in <ports> is no object identifier.
Raises:	ByteBlower.Exception.InvalidValue.ObjectType - When one of the items in <ports> is no ByteBlowerPort object.

Example

bb.PortsStart()

PortsStartAll()¶

PortsStop(inPorts)¶

Stops all traffic streams and application schedules on the specified ByteBlower ports.

More specifically, all traffic streams and schedulable objects that are currently scheduled are cancelled and all active traffic streams are stopped. Since schedulable objects are only active for an instant, aborting these is not possible.

For more information about schedulable objects, see SchedulesStart().

Streams and schedules that are not running are ignored. This may be because they have not yet started or because they are already finished or stopped.

If a port does not contain any streams or schedules, nothing happens for that port.

Parameters:	args – Zero, one or more ByteBlowerPort objects on which to abort traffic streams and application schedules.
Raises:	ByteBlower.Exception.InvalidValue.NotAnObject - When one of the items in <ports> is no object identifier.
Raises:	ByteBlower.Exception.InvalidValue.ObjectType - When one of the items in <ports> is no ByteBlowerPort object.

Example

bb.PortsStop()

PortsStopAll()¶

ResultsRefresh(inResults)¶

Refreshes multiple result objects.

New in version 2.2.

Sometimes you want to refresh a lot of results-objects at the same time. You can refresh all those objects in one API call. The results will be batched per server and then refreshed.

Returns:	nothing

Example

bb.ResultsRefresh()

ScheduleGroupCreate()¶

Create a ScheduleGroup.

Returns:	`ScheduleGroup`

Example

bb.ScheduleGroupCreate()

ScheduleGroupGet()¶

Returns all existing ScheduleGroup.

Returns:	`ScheduleGroupList`

Example

scheduleGroup = bb.ScheduleGroupGet('byteblower-1.lab.byteblower.com')

SchedulesStart(inSchedules)¶

Starts the specified schedulable objects.

More specifically, all specified schedulable objects have their time to wait period kick off simultaneously and when this time has passed the corresponding action is performed.

Typical actions include sending out a multicast join message or an HTTP request. All schedulable objects are listed below.

Schedulable objects that are already scheduled are ignored. Schedulable objects that are already finished or cancelled are scheduled again.

While re-scheduling them will always succeed (and this method will return without error), executing them multiple times may result in error states in other places. For example, a HttpClient can only manage one HTTP session and will refuse to send out a second HTTP request.

Different kinds of schedulable objects exist throughout the API. They are returned by methods such as Igmpv1MemberSession.ScheduleAdd().

After creating and configuring such schedules, they can be scheduled by either passing them to this method or by passing the port(s) on which they were created to PortsStart().

The following schedulable object types are available in the API:

IgmpScheduleIpMulticastListen
IgmpSchedule.Join
IgmpSchedule.Leave

Note

Bug HTTP requests are not yet available as a schedulable object and cannot be used with this method.

Parameters:	schedules – Zero, one or more schedulable objects to start.
Raises:	ByteBlower.Exception.InvalidValue.NotAnObject - When one of the items in <schedules> is no object identifier.
Raises:	ByteBlower.Exception.InvalidValue.ObjectType - When one of the items in <schedules> is no schedulable object.

Example

bb.SchedulesStart()

SchedulesStop(inSchedules)¶

Stops the specified schedulable objects.

More specifically, all specified schedulable objects that are currently scheduled are cancelled. Schedulable objects are only active for an instant, so actually aborting them is not possible.

For more information about schedulable objects, see SchedulesStart().

Schedules that are not running are ignored. This may be because they have not yet started or because they are already finished or cancelled.

Parameters:	inSchedules – Zero, one or more schedulable objects to abort.
Raises:	ByteBlower.Exception.InvalidValue.NotAnObject - When one of the items in <schedules> is no object identifier.
Raises:	ByteBlower.Exception.InvalidValue.ObjectType - When one of the items in <schedules> is no schedulable object.

Example

ServerAdd(*args)¶

Opens a connection to a ByteBlower server and adds it to the current API instance.

A single client instance may be connected to multiple ByteBlower servers. This allows to use a set of ByteBlower servers as a single system. On the other hand, multiple client instances may be connected to a single (shared) ByteBlower server and will share its resources. See ByteBlowerServer for more information.

Parameters:	server – IP address or hostname of the ByteBlower server to connect. port – Remote TCP port on which to connect the ByteBlower server. Should normally never be overridden. Default: 9002
Returns:	A `ByteBlowerServer` object that represents the server connection.
Raises:	`ByteBlowerServerUnreachable`: When the ByteBlower server daemon could not be reached. Typical causes are an incorrect or unreachable DNS name or IP address or a ByteBlower server daemon that is not running (on purpose or due to a software issue).
Raises:	`ByteBlowerServerIncompatible` When the ByteBlower server daemon is running an incompatible version.
Raises:	<python_error>: Relevant network error: When something unexpectedly went wrong with the network connection.
Raises:	`NotImplementedError` When the <port> parameter is provided and is no integer.

Example

This example connects to the server ‘byteblower-1.lab.byteblower.com¶

bb = bb.ServerAdd('byteblower-1.lab.byteblower.com')

Opens a connection to a ByteBlower server and adds it to the current API instance.

A single client instance may be connected to multiple ByteBlower servers. This allows to use a set of ByteBlower servers as a single system. On the other hand, multiple client instances may be connected to a single (shared) ByteBlower server and will share its resources. See ByteBlowerServer for more information.

Parameters:	server – IP address or hostname of the ByteBlower server to connect. port – Remote TCP port on which to connect the ByteBlower server. Should normally never be overridden. Default: 9002
Returns:	A `ByteBlowerServer` object that represents the server connection.
Raises:	`ByteBlowerServerUnreachable`: When the ByteBlower server daemon could not be reached. Typical causes are an incorrect or unreachable DNS name or IP address or a ByteBlower server daemon that is not running (on purpose or due to a software issue).
Raises:	`ByteBlowerServerIncompatible` When the ByteBlower server daemon is running an incompatible version.
Raises:	<python_error>: Relevant network error: When something unexpectedly went wrong with the network connection.
Raises:	`NotImplementedError` When the <port> parameter is provided and is no integer.

Example

This example connects to the server ‘byteblower-1.lab.byteblower.com¶

bb = bb.ServerAdd('byteblower-1.lab.byteblower.com')

Opens a connection to a ByteBlower server and adds it to the current API instance.

A single client instance may be connected to multiple ByteBlower servers. This allows to use a set of ByteBlower servers as a single system. On the other hand, multiple client instances may be connected to a single (shared) ByteBlower server and will share its resources. See ByteBlowerServer for more information.

Parameters:	server – IP address or hostname of the ByteBlower server to connect. port – Remote TCP port on which to connect the ByteBlower server. Should normally never be overridden. Default: 9002
Returns:	A `ByteBlowerServer` object that represents the server connection.
Raises:	`ByteBlowerServerUnreachable`: When the ByteBlower server daemon could not be reached. Typical causes are an incorrect or unreachable DNS name or IP address or a ByteBlower server daemon that is not running (on purpose or due to a software issue).
Raises:	`ByteBlowerServerIncompatible` When the ByteBlower server daemon is running an incompatible version.
Raises:	<python_error>: Relevant network error: When something unexpectedly went wrong with the network connection.
Raises:	`NotImplementedError` When the <port> parameter is provided and is no integer.

Example

This example connects to the server ‘byteblower-1.lab.byteblower.com¶

bb = bb.ServerAdd('byteblower-1.lab.byteblower.com')

ServerCount()¶

ServerGet()¶

Returns all server connections within this API instance.

See ServerAdd() for more information.

Returns:	a `ByteBlowerServerList` object

Example

ServerRemove(inByteBlowerServer)¶

ServerRemoveAll()¶

WirelessEndpointsPrepare(inWirelessEndpoints)¶

Prepares all the specified Wireless Endpoints.

If a wireless endpoint does not contain any streams or schedules, nothing happens for that Wireless Endpoint.

Parameters:	wirelessEndpoints – a `WirelessEndpointList` object with zero, one or more WirelessEndpoint objects on which to start traffic streams and application schedules.
Raises:	ByteBlower.Exception.InvalidValue.NotAnObject - When one of the items in <wirelessEndpoints> is no object identifier.
Raises:	ByteBlower.Exception.InvalidValue.ObjectType - When one of the items in <wirelessEndpoints> is no WirelessEndpoint object.
Raises:	`TechnicalError` - When the items in <wirelessEndpoints> are spread across multiple MeetingPoints.

WirelessEndpointsPrepareAsync(inWirelessEndpoints)¶

Prepares all the specified Wireless Endpoints in an asynchronious way.

If a wireless endpoint does not contain any streams or schedules, nothing happens for that Wireless Endpoint.

Parameters:	wirelessEndpoints – a `WirelessEndpointList` object with zero, one or more ByteBlowerPort objects on which to start traffic streams and application schedules.
Raises:	ByteBlower.Exception.InvalidValue.NotAnObject - When one of the items in <wirelessEndpoints> is no object identifier.
Raises:	ByteBlower.Exception.InvalidValue.ObjectType - When one of the items in <wirelessEndpoints> is no WirelessEndpoint object.
Raises:	`TechnicalError` - When the items in <wirelessEndpoints> are spread across multiple MeetingPoints.

Example

bb.WirelessEndpointsPrepareAsync()

WirelessEndpointsStart(inWirelessEndpoints)¶

Starts all traffic streams and application schedules on the specified Wireless Endpoints.

More specifically, for each traffic stream and trigger object on the specified endpoints, the configured time to wait kicks off and when this time has passed the corresponding action is performed.

Typical actions include starting a traffic stream or HTTP request. See StreamMobile for more information. If a wireless endpoint does not contain any streams or schedules, nothing happens for that Wireless Endpoint.

Parameters:	wirelessEndpoints – a `WirelessEndpointList` object with zero, one or more WirelessEndpoint objects on which to start traffic streams and application schedules.
Raises:	ByteBlower.Exception.InvalidValue.NotAnObject - When one of the items in <wirelessEndpoints> is no object identifier.
Raises:	ByteBlower.Exception.InvalidValue.ObjectType - When one of the items in <wirelessEndpoints> is no WirelessEndpoint object.
Raises:	`TechnicalError` - When the items in <wirelessEndpoints> are spread across multiple MeetingPoints.

WirelessEndpointsStartAndWait(inWirelessEndpoints)¶

Starts all traffic streams and application schedules on the specified Wireless Endpoints And waits until the devices are started.

More specifically, for each traffic stream and trigger object on the specified endpoints, the configured time to wait kicks off and when this time has passed the corresponding action is performed.

Typical actions include starting a traffic stream or HTTP request. See StreamMobile for more information.

If a wireless endpoint does not contain any streams or schedules, nothing happens for that Wireless Endpoint.

Parameters:	wireless_endpoints – Zero, one or more WirelessEndpont objects on which to start traffic streams and application schedules.
Raises:	ByteBlower.Exception.InvalidValue.NotAnObject - When one of the items in <wirelessEndpoints> is no object identifier.
Raises:	ByteBlower.Exception.InvalidValue.ObjectType - When one of the items in <wirelessEndpoints> is no WirelessEndpoint object.
Raises:	`TechnicalError` - When the items in <wirelessEndpoints> are spread across multiple MeetingPoints.

Example

     bb.WirelessEndpointsStartAndWait()

exception byteblowerll.byteblower.ByteBlowerAPIException¶

Bases: exceptions.Exception

getInfo()¶

getMessage()¶

getPublicName()¶

setInfo(info)¶

setPrivateName(name)¶

setPublicName(name)¶

setServer(server)¶

what()¶

class byteblowerll.byteblower.ByteBlowerInterface(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

Example

interface = bbServer.InterfaceGetByName('trunk-1-14')
packetDump = interface.PacketDumpCreate()

GetPhysicalInterface()¶

NameGet()¶

Returns the name of the ByteBlower Interface

Returns:	Name of the ByteBlower Interface
Return type:	str

Example

PacketDumpCreate()¶

Returns:	returns a PacketDump object
Return type:	PacketDump

Example

 packetDump = interface.PacketDumpCreate()

PacketDumpDestroy(packet_dump)¶

Destroys a PacketDump on this interface :param: PacketDump object that you want to destroy from the interface`. Example

     packetDump = interface.PacketDumpCreate()
 interface.PacketDumpDestroy(packetDump)

PortCountGet()¶

Returns:	number of ports on this ByteBlowerInterface
Return type:	long

Example

PortCreate()¶

Creates a new ByteBlower port on this ByteBlowerInterface.

Returns:	ByteBlowerPort
Return type:	unknown

Example

PortDestroy(inPort)¶

Parameters:	port – ByteBlowerPort object that you want to destroy from the interface`.

Example

PortGet()¶

Returns:	A list of ByteBlower ports on this interface
Return type:	ByteBlowerPortList

Example

portList = interface.PortGet()

PortIdGet()¶

Returns:	The id of the first ByteBlower port on this interface

Example

print(interface.PortIdGet())

SpeedGet()¶

Returns:	TODO??
Return type:	long

Example

print(interface.SpeedGet())

SwitchIdGet()¶

Returns the ID of the switch where the ByteBlower Interface ?? Deprecated??

Returns:	Id of the switch where the ByteBlower Interface is connected
Return type:	int

Example

class byteblowerll.byteblower.ByteBlowerInterfaceList(*args)¶

Bases: object

append(x)¶

assign(n, x)¶

back()¶

begin()¶

capacity()¶

clear()¶

empty()¶

end()¶

erase(*args)¶

front()¶

get_allocator()¶

insert(*args)¶

iterator()¶

pop()¶

pop_back()¶

push_back(x)¶

rbegin()¶

rend()¶

reserve(n)¶

resize(*args)¶

size()¶

swap(v)¶

class byteblowerll.byteblower.ByteBlowerLicense(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

This class represents the license information of your connected server.

The license is defined by the security key hardware on your ByteBlower server.

New in version 2.6.0.

Deprecated since version 2.10.0.

Example

 license = serverServiceInfo.LicenseGet()
 print(license.TimeAllowedGet())

NumberOfNonTrunksGet()¶

The maximum number of non-trunking interfaces allowed by the license

Returns:	number of nontrunks
Return type:	int

Example

 print(license.NumberOfNonTrunksGet())

NumberOfTrunkPortsGet(index)¶

The maximum number of ByteBlower Interfaces that can reside at the given trunk interface.

Parameters:	index (int) – Index of the trunk interface to obtain the value for.
Returns:	Allowed number of ByteBlower Interfaces on the physical interface
Rtype int:

Example

 print(license.NumberOfTrunkPortsGet())

NumberOfTrunksGet()¶

The maximum number of trunking interfaces allowed by the license

Returns:	number of trunking interfaces
Return type:	int

Example

 print(license.NumberOfTrunksGet())

SerialGet()¶

Retrieves the serial number.

This serial number is the serial number of the hardware containing the license. This is handy info when contacting the ByteBlower support department.

Returns:	the serial number of the hardware containing the license
Return type:	str

Example

 print(license.SerialGet())

TimeAllowedGet()¶

The number of minutes the ByteBlower server can run on the license.

If the value is set to 4294967295, the license is permanent and the number should be treated as infinity.

Returns:	Number of minutes the ByteBlower server can run.
Return type:	int

Example

 print(license.TimeAllowedGet())

TimeConsumedGet()¶

The number of minutes the ByteBlower server has run on the license.

This value has only a meaning when the license is a temporary (demo) license.

Returns:	Number of minutes the ByteBlower server has used of the maximum allowed
Return type:	int

Example

 print(license.TimeConsumedGet())

VersionGet()¶

Gets the version of the license.

Returns:	the version of the license
Return type:	int

Example

 print(license.VersionGet())

class byteblowerll.byteblower.ByteBlowerPort(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

Logical representation of a network host docked somewhere in the NUT, which can transmit or schedule network traffic, process incoming traffic and run stateful network applications.

A ByteBlowerPort is physically connected (or ‘attached’) to the NUT through the physical ByteBlower interface on which it is created. See ByteBlowerServer.PortCreate() for more information.

Multiple ports may be created on the same physical interface. From a network view, they are just different (simulated) hosts within a shared (datalink or layer 2) subnet. This means traffic to one port created on an interface is seen by all ports on that interface.

Most test scenarios start with one or more ByteBlower ports that are configured to do the following things:

become part of the network (layer2, layer3, perform DHCP, join multicast groups, …)
schedule network traffic streams for transmission (TX objects)
configure incoming packet processors (RX objects) that look for matching packets and e.g. count them
start network applications such as HTTP servers
schedule network application actions (called ‘schedulable objects’) such an HTTP client application sending out an HTTP request

When such ports are subsequently activated, the scheduled streams and network actions are performed at the configured time.

From that moment, relevant result data may be pulled from those streams (TX statistics), incoming packet processors (RX statistics) and network applications (application and session statistics).

Destroying a port will clean up everything that is configured on that port in a clean way:

streams, incoming packet processors and network applications are teared down, their results are gone
the port leaves all multicast groups of which it is part (but doesn’t wait for confirmation)
the port releases its DHCP lease (but doesn’t wait for confirmation)

CapabilityGetByName(name)¶

Returns a Capability object by its name.

New in version 2.6.0.

Returns:	An object representing the requested capability
Return type:	`Capability`
Raises:	`ConfigError` - UnsupportedConfig error message when the Capability is not supported

Example

capability = port.CapabilityGetByName('IPv4')
print(capability.DescriptionGet())

CapabilityIsSupported(name)¶

Checks whether a capability is supported.

New in version 2.6.0.

Returns:	True if it is supported, False if not
Return type:	bool

Example

CapabilityListGet()¶

Returns a list of Capability objects.

New in version 2.6.0.

Returns:	An object representing a list of known capabilities
Return type:	`CapabilityList`

Example

This example shows how to query the capabilities on a ByteBlowerPort¶

capability_list = port.CapabilityListGet()

for capability in capability_list:
    print(capability.DescriptionGet())

GetByteBlowerInterface()¶

InterfaceNameGet()¶

Returns physical ByteBlower interface code.

Each ByteBlower port is created on a physical ByteBlower interface of a server. This interface determines where the port will be ‘attached’ to the NUT.

See ByteBlowerServer.PortCreate() for more information and to see how an interface name is structured.

Returns:	String code representing the physical interface name (e.g. trunk-1-4 or nontrunk-1).
Return type:	str

Example

print(port.InterfaceNameGet())
# prints trunk-1-1

InterfaceSpeedGet()¶

Returns physical ByteBlower interface speed.

See ByteBlowerServer.PortCreate() for more information and to see how an interface name is structured.

Returns:	The maximum speed in bits per second a ByteBlower Interface can transmit. This does not take any VLAN overhead into account!
Return type:	long

Example

print(port.InterfaceSpeedGet())
# prints 1000000000

InterfaceSwitchIdGet()¶

Layer25PPPoEAdd()¶

Adds a layer 2.5 PPPoE Client to this port.

New in version 2.5.0.

Once a layer 2.5 configuration is added to a port, it cannot be destroyed or removed.

Returns:	an object representing an PPPoE client
Return type:	`PPPoEClient`
Raises:	`ConfigError` - When an underlying layer 2 or layer 2.5 configuration is not yet fully configured.

Example

Configure port’s network connection as a PPPoE-enabled virtual interface.

# set an PPPoE client
client = port.Layer25PPPoEAdd()
print(client.DescriptionGet())

Layer25PPPoEGet()¶

Returns the ordered list of layer 2.5 PPPoE objects of this port.

New in version 2.5.0: PPPoE objects can be added by ByteBlowerPort.Layer25PPPoEAdd()

Returns:	A list with all the PPPoE clients created
Return type:	`Layer25PPPoEList`

Example

layer25PPPoEGet = port.Layer25PPPoEGet()

Layer25PPPoERemove(inPPPoEClient)¶

Layer25VlanAdd()¶

Adds a layer 2.5 VLAN to this port.

Changed in version 2.5.0: Multiple layer 2.5 configurations can be added. They will be stacked on top each other in the the port’s network stack from the bottom up.

Once a layer 2.5 configuration is added to a port, it cannot be destroyed or removed.

Changed in version 2.3.0: Support for stacking multiple VLAN tags. Adding a second VLAN tag on an older server will throw a technical exception.

Returns:	Created VLAN configuration object.
Return type:	`VlanTag`
Raises:	`ConfigError` - When an underlying layer 2 or layer 2.5 configuration is not yet fully configured.

Example

Configure port’s network connection as a VLAN-enabled virtual interface.

vlan_tag = port.Layer25VlanAdd()
vlan_tag.IDSet(20)

Layer25VlanGet()¶

Returns the ordered list of layer 2.5 Vlan objects of this port.

New in version 2.5.0: VLAN objects can be added by Layer25VlanAdd().

Returns:	`Layer25VlanList`

Example Reading the number of VlanTag` objects of port Configure port’s network connection as a VLAN-enabled virtual interface. .. code-block:: python

emphasize-lines:

1

vlan_list = port.Layer25VlanGet()

Layer25VlanRemove(inVlanTag)¶

Layer2EthIIGet()¶

Returns the layer 2 configuration object of this port.

New in version 2.5.0.

Returns:	The ethernet configuration of the ByteBlower port
Return type:	`EthernetConfiguration`
Raises:	`ConfigError` - When the layer 2 configuration is not yet set.

Example

eth_conf = port.Layer2EthIIGet()

Layer2EthIISet()¶

Sets the layer 2 configuration of this port.

Once the layer 2 configuration is set, it cannot be destroyed or overwritten.

Returns:	`EthernetConfiguration` object.
Raises:	`ConfigError` - When the layer 2 configuration is already set.

Example

Configure port’s network connection as an Ethernet interface and add MAC address.

port.Layer2EthIISet().MacSet('00bb1b000001')

Layer3IPv4Get()¶

Returns the layer 3 IPv4 configuration object of this port.

New in version 2.5.0.

Returns:	A created IPv4 configuration object
Return type:	`IPv4Configuration`.
Raises:	`ConfigError` - When the layer 3 configuration is not yet set.

Example

ipv4_config = port.Layer3IPv4Get()
print(ipv4_config.DescriptionGet())

Layer3IPv4Set()¶

Sets the layer 3 IPv4 configuration of this port.

New in version 2.5.0.

Once a layer 3 configuration is set, it cannot be destroyed or overwritten.

Both IPv4 and IPv6 are supported. Dual stack is not available on a single port, but can be achieved by creating 2 separate ports with identical layer 2 and (possibly) layer 2.5 configurations.

Returns:	an object representing the IPv4 configuration for the ByteBlower port
Return type:	`IPv4Configuration`
Raises:	`ConfigError` - When an underlying layer 2 or layer 2.5 configuration is not yet fully configured.
Raises:	`ConfigError` - When the layer 3 configuration is already set.

Example

Configure port’s network connection as an IPv4 host.

ipv4_config = port.Layer3IPv4Set()

Layer3IPv6Get()¶

Returns the layer 3 IPv6 configuration object of this port.

New in version 2.5.0.

Returns:	An object with the IPv6 configuration of the ByteBlower Port
Return type:	`IPv6Configuration`
Raises:	`ConfigError` - When the layer 3 configuration is not yet set.

Example

l3_config = port.Layer3IPv6Get()

Layer3IPv6Set()¶

Sets the layer 3 IPv6 configuration of this port.

New in version 2.5.0.

Once a layer 3 configuration isM set, it cannot be destroyed or overwritten.

Both IPv4 and IPv6 are supported. Dual stack is not available on a single port, but can be achieved by creating 2 separate ports with identical layer 2 and (possibly) layer 2.5 configurations.

Returns:	`IPv6Configuration`
Raises:	`ConfigError` - When an underlying layer 2 or layer 2.5 configuration is not yet fully configured.
Raises:	`ConfigError` - When the layer 3 configuration is already set.

Example

Configure port’s network connection as an IPv6 host.

MDLGet()¶

Returns the port’s current Maximum Data Length (MDL), the maximum ethernet frame size that can be transmitted.

The MDL is the maximum size (in bytes) for any ethernet packet leaving the port. It includes the ethernet header, but excludes CRC, preamble and interframe gap. To calculate the maximum size of the layer 2 payload, substract the 14 bytes of the ethernet header.

This payload may be a layer 3 IP packet, a layer 2.5 VLAN tag followed by such a layer 3 IP packet or anything else.

The MDL value defaults to 1514, which corresponds with a layer 2 payload of 1500 bytes.

This value is used by the protocol stack. For example, the announced TCP Maximum Segment Size (MSS) is based on this MDL value. This value also limits the number of bytes that can be placed in a Frame when calling Frame.BytesSet().

Note

For ports without layer 2.5 configurations, the default MDL of 1514 will also lead to a maximum layer 3 packet size of 1500. This value is often called the Maximum Transmission Unit or MTU of an interface. When a port has a VLAN configuration however, the MTU will only be 1496 by default! Consider increasing the MDL to 1518 in such cases to simulate typical real-world behavior.

Note

On trunking interfaces the ByteBlower server adds a temporary VLAN automatically, to select an interface (e.g. trunk-1-10) on the ByteBlower switch. This is hidden from the user and has no influence on the MDL value. See ByteBlowerPort::MDLMaximumGet for more information.

Returns:	Current MDL value in bytes.

Example

Typical values for a trunking and non-trunking port.

MDLMaximumGet()¶

Returns the port’s highest allowed Maximum Data Length (MDL) value, which is limited by the physical interface.

The MDL of a ByteBlower port places a limit on the size of ethernet frames that may be sent on that port. It can be modified by the user through MDLSet(). The MDL value (in bytes) covers the whole ethernet packet, but excluding CRC, preamble and interframe gap.

The physical ByteBlower interface (e.g. nontrunk-1) on which a port is created places an upper bound on the allowed MDL values. Through this method, this property can be retrieved at runtime.

The typical value of the maximum MDL is 9014 on non-trunking interfaces and 9010 on trunking interfaces.

Note

On trunking interfaces the ByteBlower server adds a temporary VLAN automatically, to select an interface (e.g. trunk-1-10) on the ByteBlower switch. This is hidden from the user. However, it also means that from a user perspective, the maximum MDL value of the same physical interface is 4 bytes less when it’s configured as a trunking interface.

Returns:	Physical upper bound for the MDL in bytes.

Example

Typical values for a trunking and a non-trunking port.

MDLSet(mdl)¶

Sets the port’s Maximum Data Length (MDL), the maximum ethernet frame size that can be transmitted.

See MDLGet() for more information.

Parameters:	mdl (long) – New MDL value in bytes. Should be less then the value returned by `MDLMaximumGet()`.
Raises:	ByteBlower.Exception.InvalidValue.Integer - When `mdl` is no integer.
Raises:	TBD - When the provided value was larger than the maximum supported MDL. TODO: Decide on this exception and document (Tim, February 2015)

Example

port.MDLSet('1350')
print(port.MDLGet())
# prints 1350

ProtocolHttpClientAdd()¶

Creates a HTTP client application to run on this port.

A :HttpMultiServer application can initiate customized HTTP sessions that are typically used to emulate a TCP connection.

It allows configuring the special HTTP requests to which a running HttpServer application responds. For example, an HTTP client can ask (GET) for a response of a specified size or time or may send (PUT) a payload of a specified size or time itself.

Besides constructing such special HTTP requests, the HTTP client can interact with any normal webserver by configuring its URL.

Returns:	:`HttpMultiServer`

Example

httpClient = port.ProtocolHttpClientAdd()

ProtocolHttpClientGet()¶

Returns the list of all HTTP client applications created on this port.

See ProtocolHttpClientAdd() for more information.

Returns:	returns a list of created `HtppClient` objects
Return type:	`HttpClientList`

Example

all_clients = port.ProtocolHttpClientGet()
print(all_clients.size())

ProtocolHttpClientRemove(arg2)¶

ProtocolHttpMultiClientAdd()¶

Creates a Layer5.Http.MultiClient object on this port.

Example

httpClient = port.ProtocolHttpMultiClientAdd()

ProtocolHttpMultiClientGet()¶

Returns the list of a HttpMultiClient objects on this port.

Returns:	`HttpMultiClientList`

Example

print(port.ProtocolHttpMultiClientGet())

ProtocolHttpMultiClientRemove(arg2)¶

ProtocolHttpMultiServerAdd()¶

Creates a HttpMultiServer object on this port.

Example

# create the HTTP client
httpServer = port.ProtocolHttpMultiServerAdd()

ProtocolHttpMultiServerGet()¶

Returns the list of HttpMultiServer objects on this port.

Returns:	`HttpMultiServerList`

Example

print(port.ProtocolHttpMultiServerGet())

ProtocolHttpMultiServerRemove(arg2)¶

ProtocolHttpServerAdd()¶

Creates a HTTP server application to run on this port.

An HttpServer application is a customized HTTP server that is typically used to emulate a TCP connection.

It listens for special HTTP requests (sent by HttpClient applications) and responds in the desired way. For example, an HTTP request may ask (GET) for a response of a specified size and the HTTP server will emulate sending such a file back.

Returns:	an object representing an HTTP Server object.
Return type:	`HttpServer`

Example

http_server = port.ProtocolHttpServerAdd()

ProtocolHttpServerGet()¶

Returns the list of all HTTP server applications created on this port.

See ProtocolHttpServerAdd() for more information.

Returns:	class:.HttpServerList

Example

print(port.ProtocolHttpServerGet())

ProtocolHttpServerRemove(arg2)¶

ProtocolTelnetClientAdd()¶

Creates a Telnet client application to run on this port.

New in version API: 2.2.0

A TelnetClient application can contact and interact with an external Telnet server.

Apart from simulating such scenarios for its own sake, this application can be used to contact important nodes within the NUT (e.g. a router) and retrieve relevant statistics from it.

Returns:	`TelnetClient`.

Example

protocolTelnetClient = port.ProtocolTelnetClientAdd()

ProtocolTelnetClientGet()¶

Returns the list of all Telnet client applications created on this port.

New in version API: 2.2.0

See ProtocolTelnetClientAdd() for more information.

Returns:	`TelnetClientList`

Example

protocolTelnetClient = port.ProtocolTelnetClientGet()

ProtocolTelnetClientRemove(arg2)¶

ResultClear()¶

Clears the counters for the ByteBlower port and empties the ByteBlowerPortResultHistory.

Example

port.ResultClear()

ResultGet()¶

Returns the result object.

Returns:	A result object which contains the packet count, byte count etc for this ByteBlower port.
Return type:	`ByteBlowerPortResultSnapshot`

Example

result = port.ResultGet()
print(result.DescriptionGet())

ResultHistoryGet()¶

Returns the history for the counters for the ByteBlower port.

Returns:	`ByteBlowerPortResultHistory`

Example

historyResult = port.ResultHistoryGet()
print(historyResult.DescriptionGet())

RxCaptureBasicAdd()¶

Creates a capture tool, which captures the data and metadata of incoming frames (possibly restricted by a filter).

New in version 2.5.0.

Like all incoming packet processors (or ‘Rx’ objects), this object listens to incoming traffic matching a configurable BPF filter and performs some action when it arrives.

Typically, the filter should limit the matching packets to the interesting traffic, especially since capturing all incoming bytes at high rates may place a heavy load on the server.

Note

Unlike other Rx objects, the capture tool is not activated as soon as it is created. See the class documentation of the returned types for more information.

Warning

Using this tool requires a lot of system resources. Try to avoid capturing at high rates or for a long time. Set the capture filter as strict as possible to avoid unwanted traffic. When too much incoming traffic must be processed, the ByteBlower server may become unstable.

Note

It is also possible to log in to the server and capture there. Note that when capturing a trunking interface (i.e. connected to a switch) you will see an extra VLAN tag that shows to or from which interface the traffic goes. This is currently only possible on the 1x00 series, where the Linux tcpdump tool can sniff the server’s (native) data interfaces.

Note

This functionality is also available with a stand-alone command-line tool. It can be found and downloaded on our support portal.

The returned capture tool is a basic capture tool stores both the frame data and some metadata.

Returns:	An object representing the servers implementation of the capture functionality
Return type:	`CaptureRawPacket`

Example

RxCaptureBasicGet()¶

Returns the list of capture tools created on this port.

See RxCaptureBasicAdd() for more information.

Returns:	`CaptureRawPacketList`

Example

tools = port.RxCaptureBasicGet()

RxCaptureBasicRemove(inCapture)¶

RxLatencyBasicAdd()¶

Creates a latency calculator, which computes latency measurements based on timestamps in received frames (possibly restricted by a filter).

New in version 2.5.0.

Like all incoming packet processors (or ‘Rx’ objects), this object listens to incoming traffic matching a configurable BPF filter and performs some action when it arrives.

Typically, the filter should limit the matching traffic to the Tx.Stream whose transmitted frames actually contain the required timestamps!

The latency calculator is activated as soon as it is created, so don’t forget to reset its counters after setting the filter and initializing your test.

See Frame for information on timestamping.

Returns:	`LatencyBasic`

Example

latency = port.RxLatencyBasicAdd()

RxLatencyBasicGet()¶

Returns the list of latency calculators created on this port.

New in version 2.5.0.

See LatencyBasicAdd() for more information.

Returns:	`LatencyBasicList`

Example

all_latency = port.RxLatencyBasicGet()
print(all_latency.size())
# prints 1

RxLatencyBasicRemove(inLatency)¶

RxLatencyDistributionAdd()¶

Creates a latency calculator, which computes latency measurements based on timestamps in received frames (possibly restricted by a filter).

New in version 2.5.0.

Like all incoming packet processors (or ‘Rx’ objects), this object listens to incoming traffic matching a configurable BPF filter and performs some action when it arrives.

Typically, the filter should limit the matching traffic to the Tx.Stream whose transmitted frames actually contain the required timestamps!

The latency calculator is activated as soon as it is created, so don’t forget to reset its counters after setting the filter and initializing your test.

See Frame for information on timestamping.

Returns:	`LatencyDistribution`

Example

RxLatencyDistributionGet()¶

Returns the list of latency calculators created on this port.

New in version 2.5.0.

See LatencyDistributionAdd() for more information.

Returns:	`LatencyDistributionList`

Example

all_latency = port.RxLatencyDistributionGet()

RxLatencyDistributionRemove(inLatency)¶

RxOutOfSequenceBasicAdd()¶

Creates an out-of-sequence detector, which counts such cases based on sequence numbers in received frames (possibly restricted by a filter).

New in version 2.5.0.

Like all incoming packet processors (or ‘Rx’ objects), this object listens to incoming traffic matching a configurable BPF filter and performs some action when it arrives.

Typically, the filter should limit the matching traffic to the Stream whose transmitted frames actually contain the required sequence numbers!

The out-of-sequence detector is activated as soon as it is created, so don’t forget to reset its counters after setting the filter and initializing your test.

Returns:	Created out-of-sequence detector object.
Return type:	`OutOfSequence`

Example

out_of_sequence = port.RxOutOfsequenceBasicAdd()
# lets assume traffic is sent to UDP port 9000
out_of_sequence.FilterSet('ip && dst port 9000')
print(out_of_sequence.DescriptionGet())

RxOutOfSequenceBasicGet()¶

Returns the list of out-of-sequence detectors created on this port.

New in version 2.5.0.

See OutOfSequenceBasicAdd() for more information.

Returns:	A list of created objects
Return type:	`OutOfSequenceList`

Example

all_oos = port.RxOutOfSequenceBasicGet()
print(all_oos.size())
# prints 1

RxOutOfSequenceBasicRemove(inOutOfSequence)¶

RxTriggerBasicAdd()¶

Creates a basic receive trigger, whose counters are updated for each received frame (possibly restricted by a filter).

New in version 2.5.0.

Like all incoming packet processors (or ‘Rx’ objects), this object listens to incoming traffic matching a configurable BPF filter and performs some action when it arrives.

The receive trigger is activated as soon as it is created, so don’t forget to reset its counters after setting the filter and initializing your test.

See the class documentation of the returned types for more information.

Returns:	A basic trigger object, which allows to configure the trigger and getting the results
Return type:	`TriggerBasic`

Example

trigger = port.RxTriggerBasciAdd()

RxTriggerBasicGet()¶

Returns the list of receive triggers created on this port.

New in version 2.5.0.

See RxTriggerBasicAdd() for more information.

Returns:	an object representing a list of create basic triggers
Return type:	`TriggerBasicList`

Example

all_triggers = port.RxTriggerBasicGet()
print(all_triggers.size())
# prints 1  

RxTriggerBasicRemove(arg2)¶

RxTriggerSizeDistributionAdd()¶

Creates a size distribution receive trigger, whose counters are updated for each received frame (possibly restricted by a filter).

New in version 2.5.0.

Like all incoming packet processors (or ‘Rx’ objects), this object listens to incoming traffic matching a configurable BPF filter and performs some action when it arrives.

The receive trigger is activated as soon as it is created, so don’t forget to reset its counters after setting the filter and initializing your test.

See the class documentation of the returned types for more information.

Returns:	`TriggerSizeDistribution`

Example

trigger = port.RxTriggerSizeDistributionAdd()

RxTriggerSizeDistributionGet()¶

Returns the list of receive triggers created on this port.

New in version 2.5.0.

See RxTriggerSizeDistributionAdd() for more information.

Returns:	A list with all the sizedistribution triggers created
Return type:	`TriggerSizeDistributionList`

Example

all_size_dists = port.RxTriggerSizeDistributionGet()
print(all_size_dists.size())
# prints 1

RxTriggerSizeDistributionRemove(arg2)¶

ServerGet()¶

Start()¶

Starts all transmit streams and schedulable objects configured on this port.

See ByteBlower.PortsStart(), which does the same for a set of ports, for more information.

Example

     port.Start()

Stop()¶

TunnelTcpAdd()¶

Creates a TCP tunnel object.

A TcpTunnel can be used to configure TCP port forwarding between the user’s office network and the lab network.

Through the protocol, a client can requesting dynamic changes to the firewall or NAT port forwarding settings of a (PCP-enabled) gateway.

Returns:	The created TcpTunnel object. This object can be used to configure the tunnel
Return type:	`TcpTunnel`

Example

tunnel = port.TunnelTcpAdd()
print(tunnel.DescriptionGet())

TunnelTcpGet()¶

Returns a list of all TCP Tunnel objects created on this port.

See TunnelTcpAdd() for more information.

Returns:	`TcpTunnelList`

Example

tunnelTcp = port.TunnelTcpGet()

TunnelTcpRemove(arg2)¶

TxStreamAdd()¶

Creates a transmit stream, which can be configured to blast layer 2 frames traffic from this port in a stateless way.

Initially, a stream does not contain any traffic. It must still be configured by adding content (in the form of Frame objects) and timing information (especially the interframe gap).

A Stream can be compared to the transmitting part of a frame blasting flow in the GUI.

Returns:	an object representing a pure frame blasting stream.
Return type:	`Stream`

Example

stream = port.TxStreamAdd()

TxStreamGet()¶

Returns a list of transmit streams created on this port.

Returns:	A list with all created `Stream` objects
Return type:	`StreamList`

Example

streams = port.TxStreamGet()
print(streams.size())
# prints 1

TxStreamRemove(inStream)¶

class byteblowerll.byteblower.ByteBlowerPortCounterType¶

Bases: object

RxAll = 2¶: TODO

RxBroadcast = 0¶: TODO

RxUnicast = 1¶: TODO

class byteblowerll.byteblower.ByteBlowerPortList(*args)¶

Bases: object

append(x)¶

assign(n, x)¶

back()¶

begin()¶

capacity()¶

clear()¶

empty()¶

end()¶

erase(*args)¶

front()¶

get_allocator()¶

insert(*args)¶

iterator()¶

pop()¶

pop_back()¶

push_back(x)¶

rbegin()¶

rend()¶

reserve(n)¶

resize(*args)¶

size()¶

swap(v)¶

class byteblowerll.byteblower.ByteBlowerPortResultData(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

ByteBlower port counter result set.

The result set contains three different counters:

a Unicast counter, which counts all received unicast Ethernet frames.
a Broadcast counter, which counts all received broadcast Ethernet frames.
an All counter, which counts all received Ethernet frames.

Note

The ‘all’ counter can be seen as the combination of the unicast and the broadcast counter.

Note

See What’s new in API v2 for more information.

A ByteBlower port result data snapshot object can be created via a ByteBlowerPortResultData or ByteBlowerPort.ResultSnapshot

Example

Receive all frames on “trunk-1-2” of some server, matching UDP source or destination port 67.

 result = port.ResultHistoryGet()
 resultData = result.CumulativeLatestGet()

IntervalDurationGet()¶

Gets the configured duration of this results snapshot [NS].

New in version 2.3.0.

Example

This example gets interval duration of this result snapshot [NS]

 print(resultData.IntervalDurationGet())

RxAllGet()¶

Gets the received counters for the port.

This will return a ByteBlowerPortResultRxData object which contain all counters from a port

Returns:	`ByteBlowerPortResultRxData`

Example

     print(resultData.RxAllGet().DescriptionGet())

RxBroadcastGet()¶

Gets the received broadcast counters for the port.

This will return a ByteBlowerPortResultRxData object which contain all counters from a port. This will only contain the broadcast packets received on the port.

Returns:	`ByteBlowerPortResultRxData`

Example

     print(resultData.RxBroadcastGet().DescriptionGet())

RxUnicastGet()¶

Gets the received unicast counters for the port.

This will return a ByteBlowerPortResultRxData object which contain all unicast counters from a port. This will only contain the broadcast unicast received on the port.

Returns:	`ByteBlowerPortResultRxData`

Example

 print(resultData.RxUnicastGet().DescriptionGet())

TimestampGet()¶

Gets the snapshot timestamp [NS].

Example

This example gets the snapshot timestamp [NS].

 print(resultData.TimestampGet())

class byteblowerll.byteblower.ByteBlowerPortResultDataList(*args)¶

Bases: object

append(x)¶

assign(n, x)¶

back()¶

begin()¶

capacity()¶

clear()¶

empty()¶

end()¶

erase(*args)¶

front()¶

get_allocator()¶

insert(*args)¶

iterator()¶

pop()¶

pop_back()¶

push_back(x)¶

rbegin()¶

rend()¶

reserve(n)¶

resize(*args)¶

size()¶

swap(v)¶

class byteblowerll.byteblower.ByteBlowerPortResultHistory(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractRefreshableResult

Port counter result history.

The port counter history is - as always - available in two flavors: the cumulative and the interval results

Note

The information is not updated until Refresh() is called

Note

See History result for more information.

A result history object can be created via a ByteBlowerPort, using ByteBlowerPort.ResultHistoryGet()

Example

Receive all frames on “trunk-1-2” of some server, matching UDP source or destination port 67.

port_resultHistory = port.ResultHistoryGet()

Clear()¶

Removes the locally stored history snapshots.

This can be used to save memory in long tests where the results are requested at regular intervals.

Warning

Any interval or cumulative result object returned from this history object before calling Clear() will be destroyed and thus become unusable.

CumulativeGet()¶

Returns a list of available cumulative counters.

Returns:	`ByteBlowerPortResultDataList` containing the Interval counters

Example

This example gets the available cumulative counters

 for results in port_resultHistory.CumulativeGet():
     print(results.DescriptionGet())

CumulativeGetByIndex(index)¶

Returns a single item of the cumulative list.

Returns:	`ByteBlowerPortResultData` cumulative counter object at the specified index

Example

This example gets the available cumulative counters

 print(resultHistory.CumulativeGetByIndex(0).DescriptionGet())

CumulativeGetByTime(timestamp)¶

Returns a single item of the cumulative list using a timestamp nanoseconds.

New in version 2.2.

Example

This example gets the available cumulative counters

print(port_resultHistory.CumulativeGetByTime(timestamp).DescriptionGet())

CumulativeLatestGet()¶

Returns latest closed item of the cumulative list.

Returns:	The latests closed `ByteBlowerPortResultData` cumulative counter object.

New in version 2.2.

Example

This example gets the available cumulative counters

print(port_resultHistory.CumulativeLatestGet.DescriptionGet())

CumulativeLengthGet()¶

Returns the size of the cumulative list.

Returns:	The length of the cumulative list

Example

print(port_resultHistory.CumulativeLengthGet())

IntervalGet()¶

Returns a list of available interval counters.

Returns:	`ByteBlowerPortResultDataList` containing the Interval counters

Example

This example gets the available interval counters

 for i in resultHistory.IntervalGet():
     print(i.DescriptionGet())

IntervalGetByIndex(index)¶

Returns a single item of the interval list.

Returns:	`ByteBlowerPortResultData` interval counter object at the specified index

Example

This example gets the available interval counters

print(port_resultHistory.IntervalGetByIndex(0).DescriptionGet())

IntervalGetByTime(timestamp)¶

Returns a single item of the interval list using a timestamp in nanoseconds.

New in version 2.2.

Example

This example gets the available interval counters

interval = port_resultHistory.IntervalGetByTime(timestamp)

IntervalLatestGet()¶

Returns the latest closed item of the interval list.

Returns:	The latests closed `ByteBlowerPortResultData` interval counter object.

New in version 2.2.

Example

This example gets the available interval counters

print(port_resultHistory.IntervalLatestGet.DescriptionGet())

IntervalLengthGet()¶

Returns the size of the interval list.

Returns:	The length of the interval list

Example

print(port_resultHistory.IntervalLengthGet())

RefreshTimestampGet()¶

Returns the timestamp on the server when the current history is requested.

Returns:	Timestamp on the server when the current history is requested in nanoseconds since epoch

Example

print(port_resultHistory.RefreshTimestampGet())

SamplingBufferLengthGet()¶

Number of samples to keep in the buffer.

The ByteBlower server has a buffer to keep some samples before they are transferred to the client. This method gets the maximum number of samples the server can hold. The last sample will always be the running sample. When a sample is closed, the oldest sample in the buffer will be removed.

Returns:	The length of the sample buffer

Example

print(port_resultHistory.SamplingBufferLengthGet())

SamplingBufferLengthSet(inCount)¶

Sets the number of samples to keep in the buffer.

The ByteBlower server has a buffer to keep some samples before they are transferred to the client. This method sets the maximum number of samples the server can hold. The last sample will always be the running sample. When a sample is closed, the oldest sample in the buffer will be removed.

New in version 2.3.0.

Example

port_resultHistory.SamplingBufferLengthSet(10)

SamplingIntervalDurationGet()¶

Duration of one sampling interval in nanoseconds.

Returns:	Duration in nanoseconds

Example

print(port_resultHistory.SamplingIntervalDurationGet())

SamplingIntervalDurationSet(inDuration)¶

Sets the duration of one sampling interval.

Warning

This affects all users on the same ByteBlower interface.

Warning

The previously collected history will be invalidated.

New in version 2.3.0.

Example

print(port1_resultHistory.SamplingIntervalDurationGet())

class byteblowerll.byteblower.ByteBlowerPortResultRxData(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

ByteBlower port counter result set.

A ByteBlower port result data snapshot object can be created via a ByteBlowerPortResultData or ByteBlowerPortResultSnapshot

Note

See What’s new in API v2 for more information.

Example

Receive all frames on “trunk-1-2” of some server, matching UDP source or destination port 67.

 rx_result=port_result.RxAllGet()

ByteCountGet()¶

Gets the current received bytes counter.

Example

This example gets the received bytes counter

print(rx_result.ByteCountGet())

ByteCountWithCRCGet()¶

Gets the current received bytes counter with the CRC.

Example

This example gets the received bytes counter

     print(rx_result.ByteCountWithCRCGet())

CounterType_RxAll = 2¶

CounterType_RxBroadcast = 0¶

CounterType_RxUnicast = 1¶

FramesizeMaximumGet()¶

Gets the largest frame size received in this snapshot.

Raises:	CounterUnavailable - When no frames are received, this counter is unavailable

Example

This example gets the largest frame size received in this snapshot.

print(rx_result.FramesizeMaximumGet())

FramesizeMinimumGet()¶

Gets the smallest frame size received in this snapshot.

Raises:	CounterUnavailable - When no frames are received, this counter is unavailable

Example

This example gets the smallest frame size received in this snapshot.

print(rx_result.FramesizeMinimumGet())

IntervalDurationGet()¶

PacketCountGet()¶

Gets the received packet count.

Example

This example gets the received packet counter

print(rx_result.PacketCountGet())

TimestampFirstGet()¶

Gets the timestamp [NS] of the first packet in this snapshot.

Raises:	CounterUnavailable - When no frames are received, this counter is unavailable

Example

This example gets the timestamp [NS] of the first received packet in this snapshot

print(rx_result.TimestampFirstGet())

TimestampGet()¶

Gets the snapshot timestamp [NS].

Example

This example gets the snapshot timestamp [NS].

print(rx_result.TimestampGet()) 

TimestampLastGet()¶

Gets the current timestamp [NS] of the last packet in this snapshot.

Raises:	CounterUnavailable - When no frames are received, this counter is unavailable

Example

This example gets the timestamp [NS] of the last received packet in this snapshot

     print(rx_result.TimestampLastGet())

class byteblowerll.byteblower.ByteBlowerPortResultSnapshot(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractRefreshableResult

ByteBlower port counter result set.

The result set contains three different counters:

a Unicast counter, which counts all received unicast Ethernet frames.
a Broadcast counter, which counts all received broadcast Ethernet frames.
an All counter, which counts all received Ethernet frames.

Note

The “all” counter can be seen as the combination of the unicast and the broadcast counter.

Note

See What’s new in API v2 for more information.

A ByteBlower port result data snapshot object can be created via a ByteBlowerPortResultData or ByteBlowerPortResultSnapshot

Example

Receive all frames on “trunk-1-2” of some server, matching UDP source or destination port 67.

port_result = port.ResultGet()

Clear()¶

IntervalDurationGet()¶

Gets the configured duration of this results snapshot [NS].

New in version 2.3.0.

Example

This example gets interval duration of this result snapshot [NS]

     print(port_result.IntervalDurationGet())

RefreshImpl()¶

RefreshTimestampGet()¶

Returns the timestamp on the server when the current snapshot is requested.

When the snapshot is part of a history, the refresh timestamp will be the same as refresh timestamp of the History object.

..note:: This is not the same as TimestampGet()

Returns:	Timestamp on the server when the current snapshot is requested in nanoseconds since epoch

Example

 print(port_result.RefreshTimestampGet())

RxAllGet()¶

Gets the received counters for the port. This will return a ByteBlowerPortResultRxData object which contain all counters from a port.

Returns:	`ByteBlowerPortResultRxData`

Example

     print(port_result.RxAllGet.DescriptionGet())

RxBroadcastGet()¶

Gets the received broadcast counters for the port. This will return a ByteBlowerPortResultRxData object which contain all counters from a port. This will only contain the broadcast packets received on the port.

Returns:	`ByteBlowerPortResultRxData`

Example

     print(port_result.RxBroadcastGet.DescriptionGet())

RxUnicastGet()¶

Gets the received unicast counters for the port. This will return a ByteBlowerPortResultRxData object which contain all unicast counters from a port. This will only contain the broadcast unicast received on the port.

Returns:	`ByteBlowerPortResultRxData`

Example

     print(port_result.RxUnicastGet.DescriptionGet())

TimestampGet()¶

Gets the snapshot timestamp [NS].

Example

This example gets the snapshot timestamp [NS].

 print(port_result.TimestampGet())

class byteblowerll.byteblower.ByteBlowerServer(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

Representation of a client connection to a shared, physical ByteBlower server, which can send and receive network traffic through its interfaces.

Using this class, ByteBlower ports (logical network hosts) can be docked to a NUT at a specific place.

Furthermore, information about a shared ByteBlower Server, such as the available interfaces and the current connections can be retrieved.

InterfaceGetByName(name)¶

InterfaceNamesGet()¶

Shows the available physical ByteBlower interfaces on the ByteBlower server.

The available interfaces on a server depend on the static server configuration. Only the presence of USB interfaces can change dynamically (using ::Update).

ByteBlower interfaces are represented by a string code formatted as follows:

Trunking interfaces, which are interfaces located on a ByteBlower switch, have a format trunk-X-Y, where X is the server interface on which the switch is connected and Y is the interface number on the switch itself.
Non-trunking interface, which are located directly on the server (without switch), have a format nontrunk-X, where X is the (server) interface.

This format is used as keys in the key-value pair list returned by UsersGet(). It is also the format that should be passed to PortCreate() method as argument.

Returns:	A list of all available physical interfaces on this server.

Example

Assume server has a single 48-port trunking interface and a single non-trunking interface.

server.InterfaceNamesGet()
# Returns ['trunk-1-1', 'trunk-1-2', 'trunk-1-3', ... , 'trunk-1-48', 'nontrunk-1']

PacketDumpCreate(*args)¶

Creates a PacketDump object on the specified ByteBlower interface.

New in version 2.9.0.

The PacketDump API allows to capture all incoming and outgoing network traffic on a ByteBlower interface.

Parameters:	interface – Interface name of the ByteBlower interface
Returns:	`PacketDump`
Raises:	ByteBlower.Exception.API.UnknownByteBlowerInterface - When the specified interface name does not exist on the connected server.

Example

Create a PacketDump object on trunk-1-1

     dump = server.PacketDumpCreate('trunk-1-1')

Creates a PacketDump object on the specified ByteBlower interface.

New in version 2.9.0.

The PacketDump API allows to capture all incoming and outgoing network traffic on a ByteBlower interface.

Parameters:	interface – Interface name of the ByteBlower interface
Returns:	`PacketDump`
Raises:	ByteBlower.Exception.API.UnknownByteBlowerInterface - When the specified interface name does not exist on the connected server.

Example

Create a PacketDump object on trunk-1-1

     dump = server.PacketDumpCreate('trunk-1-1')

PacketDumpDestroy(packet_dump)¶

PhysicalInterfacesGet()¶

PhysicalInterfacesGetByType(inPhysicalInterfaceType)¶

PortCreate(*args)¶

Creates a new ByteBlower port on the specified ByteBlower interface.

By specifying a physical ByteBlower interface, we can ‘attach’ a ByteBlower port (which represents a network host) to the NUT somewhere. This depends of the physical set-up.

Available ByteBlower interfaces depend on the server type and configuration. Available interfaces on the connected server can be shown using InterfacesGet().

ByteBlower interfaces are represented by a string code formatted as follows:

Trunking interfaces, which are interfaces located on a ByteBlower switch, have a format trunk-X-Y, where X is the server interface on which the switch is connected and Y is the interface number on the switch itself.
Non-trunking interface, which are located directly on the server (without switch), have a format nontrunk-X, where X is the (server) interface.

Parameters:	interface – String code for the ByteBlower interface on which to create the port.
Returns:	`ByteBlowerPort`
Raises:	ByteBlower.Exception.API.UnknownByteBlowerInterface - When the specified interface name does not exist on the connected server.

Example

Create a simulated host and attach it to the NUT. More specifically, locate it within the ethernet subnet connected to the first interface of the first ByteBlower switch.

port = server.PortCreate('trunk-1-1')

Creates a new ByteBlower port on the specified ByteBlower interface.

By specifying a physical ByteBlower interface, we can ‘attach’ a ByteBlower port (which represents a network host) to the NUT somewhere. This depends of the physical set-up.

Available ByteBlower interfaces depend on the server type and configuration. Available interfaces on the connected server can be shown using InterfacesGet().

ByteBlower interfaces are represented by a string code formatted as follows:

Trunking interfaces, which are interfaces located on a ByteBlower switch, have a format trunk-X-Y, where X is the server interface on which the switch is connected and Y is the interface number on the switch itself.
Non-trunking interface, which are located directly on the server (without switch), have a format nontrunk-X, where X is the (server) interface.

Parameters:	interface – String code for the ByteBlower interface on which to create the port.
Returns:	`ByteBlowerPort`
Raises:	ByteBlower.Exception.API.UnknownByteBlowerInterface - When the specified interface name does not exist on the connected server.

Example

Create a simulated host and attach it to the NUT. More specifically, locate it within the ethernet subnet connected to the first interface of the first ByteBlower switch.

port = server.PortCreate('trunk-1-1')

Creates a new ByteBlower port on the specified ByteBlower interface.

By specifying a physical ByteBlower interface, we can ‘attach’ a ByteBlower port (which represents a network host) to the NUT somewhere. This depends of the physical set-up.

Available ByteBlower interfaces depend on the server type and configuration. Available interfaces on the connected server can be shown using InterfacesGet().

ByteBlower interfaces are represented by a string code formatted as follows:

Trunking interfaces, which are interfaces located on a ByteBlower switch, have a format trunk-X-Y, where X is the server interface on which the switch is connected and Y is the interface number on the switch itself.
Non-trunking interface, which are located directly on the server (without switch), have a format nontrunk-X, where X is the (server) interface.

Parameters:	interface – String code for the ByteBlower interface on which to create the port.
Returns:	`ByteBlowerPort`
Raises:	ByteBlower.Exception.API.UnknownByteBlowerInterface - When the specified interface name does not exist on the connected server.

Example

Create a simulated host and attach it to the NUT. More specifically, locate it within the ethernet subnet connected to the first interface of the first ByteBlower switch.

port = server.PortCreate('trunk-1-1')

PortDestroy(inPort)¶

PortGet()¶

Returns a list of all ByteBlower ports created through this server connection.

Only ports created through the connection represented by this object are returned, not those created by other client instances (either GUI or API) or those created by other server connections within this API instance! See UsersGet() to see the interfaces on which other users have created ports.

Returns:	`ByteBlowerPortList`

port = server.PortGet()

PortsStart(inPorts)¶

PortsStartAll()¶

PortsStop(inPorts)¶

PortsStopAll()¶

ResultsRefreshAll()¶

ServiceInfoGet()¶

Returns the service information of the ByteBlower server daemon.

New in version 2.6.0.

server.ServiceInfoGet()

TimestampGet()¶

Returns the current timestamp on the server.

New in version 2.3.0.

Retrieves the current timestamp of the server in nanoseconds. This can be used to calculate the offset between two servers to compare results.

Returns:	Timestamp in nanoseconds

Example

Assume the client is connected (through this object) to a server:

server.TimestampGet()
# :return: 1432805398000000000 

Update()¶

Updates dynamic interfaces (e.g. USB) on the connected server.

Deprecated since version 2.0: Since 2.0 are USB interfaces not supported anymore

This methods looks for attached USB interfaces and updates its available interfaces. If USB interfaces are attached, they will be returned by InterfacesGet() after this running this method.

Bug Since USB interfaces are not yet supported, this method currently has no use. Method is not yet implemented and will throw a TechnicalError

UsersGet()¶

Shows which physical interfaces of the (shared) physical ByteBlower server are currently used by which clients.

This method gives an overview of how a ByteBlower server is currently used. It displays which client connections (whether from GUI scenario runs or API sessions) have created ByteBlowerPort objects on which of the server’s physical ByteBlower interfaces.

Such a client connection to a server is represented by this very ByteBlowerServer type! As soon as some client instance (e.g. a TCL shell, python interpreter or a GUI) on some client computer creates such server object, a connection is established to that shared server.

Multiple client instances can be active on the same host. For example, a single host may be running a GUI scenario, two python scripts and an interactive Tcl session at the same time. Similarly, a single client instance may have multiple parallel connections to the same server, by calling ByteBlower.ServerAdd() multiple times for the same server URL or IP.

The server’s physical interfaces are statically configured on the server machine and can be retrieved using InterfacesGet(). They are shared among all connected clients.

Client connections are identified by the client’s hostname. This means that all server connections from all client instances on a single host will all be different ‘users’, but will have the same string representation. If they use the same interfaces, that hostname will simply appear multiple times.

As soon as a specific ByteBlowerServer (representing a client connection) creates a first ByteBlowerPort on some interface, it is ‘using’ that interface. The interface is no longer used when all all ports created by that server on it are destroyed. Ports can be destroyed in the following ways:

Explicitly, by calling PortRemove on the ByteBlowerServer
By destroying the ByteBlowerServer for that port. This is also what happens when a GUI finishes or cancels a scenario.
By destroying that client instances root ByteBlower object. This is also what happens when a client process (GUI or API) is killed.

Returns:	A list of name value pairs, one for each physical ByteBlower interface with one or more ports configured on it. The name is the string representation of the interface, the value is a list of the server connections (represented by their client’s hostname) which have created ports on that interface.

Example

Assume three client instances are currently connected to this server. The first runs on John’s PC, the second runs on Jane’s PC and the last one is a second client instance connecting John’s PC. Note the non-trunking interface is used by multiple client instances!

userList = server.UsersGet()

exception byteblowerll.byteblower.ByteBlowerServerIncompatible(*args)¶: Bases: byteblowerll.byteblower.DomainError

class byteblowerll.byteblower.ByteBlowerServerList(*args)¶

Bases: object

append(x)¶

assign(n, x)¶

back()¶

begin()¶

capacity()¶

clear()¶

empty()¶

end()¶

erase(*args)¶

front()¶

get_allocator()¶

insert(*args)¶

iterator()¶

pop()¶

pop_back()¶

push_back(x)¶

rbegin()¶

rend()¶

reserve(n)¶

resize(*args)¶

size()¶

swap(v)¶

class byteblowerll.byteblower.ByteBlowerServerServiceInfo(*args, **kwargs)¶

Bases: byteblowerll.byteblower.ServiceInfo

This class contains information on the ByteBlower System.

With this object you can get information concerning the Type / version / IP or hostname etc… information.

Example

from byteblowerll.byteblower import ByteBlower
server = ByteBlower.ServerAdd('byteblower-1.lab.byteblower.com')
service_info = server.ServiceInfoGet()

New in version 2.6.0.

ConnectionHostGet()¶

Returns the host (either registered name or IP address) used to connect to the ByteBlower server.

Example

print(service_info.ConnectionHostGet())
# prints 'bytblower-1.lab.byteblower.com'

ConnectionIPAddressGet()¶

Returns the IP address used to connect to the ByteBlower server.

Example

from byteblowerll.byteblower import ByteBlower
server = ByteBlower.ServerAdd('byteblower-1.lab.byteblower.com')
server.PortCreate('trunk-1-1')
service_info = server.ServiceInfoGet()
print(service_info.ConnectionIPAddressGet())
# prints ip address

ConnectionPortNumberGet()¶

Returns the TCP port number of the connected ByteBlower server.

Example

print(service_info.ConnectionPortNumberGet())

LicenseGet()¶

Returns the License information for this ByteBlower server.

New in version 2.6.0.

Deprecated since version 2.10.

Each physical ByteBlower server (represented by this type of object) has a specific ByteBlower License.

Returns:	`ByteBlowerLicense`

ManagementIPAddressGet()¶

Returns all management IP addresses of the connected ByteBlower server.

New in version 2.6.0.

Returns:	List of management IP addresses

Example

print(service_info.ManagementIPAddressGet())

exception byteblowerll.byteblower.ByteBlowerServerUnreachable(*args)¶: Bases: byteblowerll.byteblower.DomainError

byteblowerll.byteblower.ByteBlower_InstanceGet()¶

Creates or returns the ByteBlower API singleton instance.

This object is the entry point to start working with the ByteBlower Python API.

If no ByteBlower instance is created yet, this method creates one and returns the object. If the instance exists already, it is simply returned. Any other static call will implicitly instantiate this singleton object.

Returns:	ByteBlower singleton instance.

Example

instance = bb.InstanceGet()

class byteblowerll.byteblower.CHAPProtocol(*args, **kwargs)¶

Bases: byteblowerll.byteblower.PPPAuthProtocol

Represents the Challenge-Handshake Authentication Protocol

PPP defines an extensible Link Control Protocol, which allows negotiation of an Authentication Protocol for authenticating its peer before allowing Network Layer protocols to transmit over the link.

This class provides the Password Authentication protocol as described per :rfc:1334, section 3

The Challenge-Handshake Authentication Protocol (CHAP) is used to periodically verify the identity of the peer using a 3-way handshake. This is done upon initial link establishment, and MAY be repeated anytime after the link has been established.

After the Link Establishment phase is complete, the authenticator sends a “challenge” message to the peer. The peer responds with a value calculated using a “one-way hash” function. The authenticator checks the response against its own calculation of the expected hash value. If the values match, the authentication is acknowledged, otherwise the connection SHOULD be terminated.

CHAP provides protection against playback attack through the use of an incrementally changing identifier and a variable challenge value. The use of repeated challenges is intended to limit the time of exposure to any single attack. The authenticator is in control of the frequency and timing of the challenges.

This authentication method depends upon a “secret” known only to the authenticator and that peer. The secret is not sent over the link. This method is most likely used where the same secret is easily accessed from both ends of the link.

By default, authentication is not mandatory. If authentication of the link is desired, an implementation MUST specify the Authentication-Protocol Configuration Option during Link Establishment phase.

New in version 2.5.0.

GetPPPProtocol(*args)¶

SecretGet()¶

Returns the configured Secret.

Returns:	Secret value

# TODO

SecretSet(secret)¶

Configures the Secret on the Challenge Handshake Authentication Protocol (CHAP)

Parameters:	secret – The secret for authenticating to the PPP server.

# TODO

class byteblowerll.byteblower.CHAPProtocolList(*args)¶

Bases: object

append(x)¶

assign(n, x)¶

back()¶

begin()¶

capacity()¶

clear()¶

empty()¶

end()¶

erase(*args)¶

front()¶

get_allocator()¶

insert(*args)¶

iterator()¶

pop()¶

pop_back()¶

push_back(x)¶

rbegin()¶

rend()¶

reserve(n)¶

resize(*args)¶

size()¶

swap(v)¶

class byteblowerll.byteblower.Capability(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

Represents a capability, A feature it supports or not.

Using this class, you can check if e.g. a WirelessEndpoint supports latency measurements or not

Available Capabilities: - TODO - TODO

Example

 from byteblowerll.byteblower import ByteBlower
 server = ByteBlower.ServerAdd('byteblower-1.lab.byteblower.com')
 port = server.PortCreate('trunk-1-1')
 capability_list = port.CapabilityListGet()
 capability = capability_list[0]
 # print version
 print(capability.VersionAddedGet())

CapabilityDescriptionGet()¶

Returns a human-readable description of the capability.

Returns:	A human readable description
Return type:	str

Example

print(capability.CapabilityDescriptionGet())

NameGet()¶

Returns a human-readable name of the capability.

Returns:	The human readable name of the capability.
Rtype str:

Example

print(capability.NameGet())

ValueGet()¶

Returns a CapabilityValue object.

Returns:	the value of the capability
Return type:	`CapabilityValue`

Example

capabilityValue = capability.ValueGet()

VersionAddedGet()¶

Returns the ByteBlower Server/ByteBlower MeetingPoint version since when this capability is added.

Returns:	The server/meetingpoint version the capability was added
Return type:	string

Example

     print(capability.VersionAddedGet())

class byteblowerll.byteblower.CapabilityList(*args)¶

Bases: object

append(x)¶

assign(n, x)¶

back()¶

begin()¶

capacity()¶

clear()¶

empty()¶

end()¶

erase(*args)¶

front()¶

get_allocator()¶

insert(*args)¶

iterator()¶

pop()¶

pop_back()¶

push_back(x)¶

rbegin()¶

rend()¶

reserve(n)¶

resize(*args)¶

size()¶

swap(v)¶

class byteblowerll.byteblower.CapabilityValue(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

The Capability Value class.

A capability ( Capability ) can have a different type of value (INTEGER, BOOLEAN, STRING). Using TypeGet() you can discover the value-type and then use the corresponding getter to get the real value

BooleanGet()¶

Returns the value as a boolean.

Returns:	The value of the capability as a boolean (if possible)
Return type:	bool

Example

 capabilityType = capabilityValue.TypeGet()
 if capabilityType==0:
     print(capabilityValue.BooleanGet())
 elif capabilityType==1:
     print(capabilityValue.IntegerGet())
 else:
     print(capabilityValue.StringGet())

IntegerGet()¶

Returns the value as an integer.

Returns:	The value of the capability as an integer
Return type:	long

Example

 capabilityType = capabilityValue.TypeGet()
 if capabilityType==0:
     print(capabilityValue.BooleanGet())
 elif capabilityType==1:
     print(capabilityValue.IntegerGet())
 else:
     print(capabilityValue.StringGet())

StringGet()¶

Returns the value as a string.

Returns:	The capability value as a string
Return type:	str

Example

 capabilityType = capabilityValue.TypeGet()
 if capabilityType==0:
     print(capabilityValue.BooleanGet())
 elif capabilityType==1:
     print(capabilityValue.IntegerGet())
 else:
     print(capabilityValue.StringGet())

TypeGet()¶

Returns the type of value.

Returns:	The type of the value
Return type:	TODO

Example

 capabilityType = capabilityValue.TypeGet()
 if capabilityType==0:
     print(capabilityValue.BooleanGet())
 elif capabilityType==1:
     print(capabilityValue.IntegerGet())
 else:
     print(capabilityValue.StringGet())

Type_BOOLEAN = 0¶

Type_INTEGER = 1¶

Type_STRING = 2¶

class byteblowerll.byteblower.Capture(*args, **kwargs)¶

Bases: byteblowerll.byteblower.Rx

FileNameRemoteGet()¶

ResultGet()¶

Start()¶

Stop()¶

class byteblowerll.byteblower.CaptureRawPacket(*args, **kwargs)¶

Bases: byteblowerll.byteblower.Capture

This class is used to capture the raw packet data that is received on the Physical interface that is associated with a ByteBlowerPort.

With an CaptureRawpacket you can capture the data that is received by the ByteBlower Port and save this to a pcap file on your pc. You can also apply a filter (BPF-style) to only capture the packets of your interest.

Example

captureRaw = bbPort2.RxCaptureBasicAdd()
captureRaw.FilterSet('ip dst 1.1.1.2')
captureRaw.Start()
#...
captureRaw.Stop()
result = captureRaw.ResultGet()
print(result.DescriptionGet())

FileNameRemoteGet()¶

FilterGet()¶

Returns the current installed BPF filter string.

The filter string can be configured using FilterSet()

Returns:	The current BPF filter string

Example

Suppose we configured the trigger with filter string: where ipv4_1 and ipv4_2 are IPv4Configuration objects and frameSize is the (layer2) size of the frames (without CRC!). The BPF filter string would then become for example:

 print(captureRaw.FilterGet())

FilterSet(inFilter)¶

Sets a BPF filter on a RX object.

Note

Configuring a new filter string does not reset the counter values which were triggered by a previous filter string.

Parameters:	bpfString – Valid BPF filter string. For creating valid BPF filter strings, please have a look at http://www.tcpdump.org/#documentation for more information.
Raises:	ByteBlower.Rx.Filter.CompilationFailed - When an invalid BPF filter string is given.
Raises:	ByteBlower.InvalidFilter - When an invalid BPF filter string is given.

Example

This will filter only UDP traffic. Set the filter on packets that match:

source and destination IPv4 address
UDP traffic with given destination and source UDP port
(layer2) frame length (without CRC!)

 captureRaw.FilterSet('ip dst 1.1.1.2')

ResultGet()¶

Returns the capture result.

Returns:	`CaptureResultSnapshot`

Example

     result = captureRaw.ResultGet()

Start()¶

Start capturing.

Note

Calling Start while already running does not throw an exception.

Example

 captureRaw.Start()

Stop()¶

Stop capturing.

Note

Calling Stop while not running does not throw an exception.

Example

     captureRaw.Stop()

class byteblowerll.byteblower.CaptureRawPacketList(*args)¶

Bases: object

append(x)¶

assign(n, x)¶

back()¶

begin()¶

capacity()¶

clear()¶

empty()¶

end()¶

erase(*args)¶

front()¶

get_allocator()¶

insert(*args)¶

iterator()¶

pop()¶

pop_back()¶

push_back(x)¶

rbegin()¶

rend()¶

reserve(n)¶

resize(*args)¶

size()¶

swap(v)¶

class byteblowerll.byteblower.CaptureResultSnapshot(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractRefreshableResult

This class represents the result of a CaptureRawpacket.

It contains the metrics and the frames that are captured. To get an update of the values use ::Refresh.

Example

captureRaw = bbPort2.RxCaptureBasicAdd()
captureRaw.FilterSet('ip dst 1.1.1.2')
captureRaw.Start()
...
captureRaw.Stop()
resultSnapshot = captureRaw.ResultGet()

ByteCountGet()¶

Returns the number of bytes captured.

Returns:	The number of bytes captured

Example

This example returns the number of bytes captured

 print(resultSnapshot.ByteCountGet())

CaptureDurationGet()¶

Returns the duration of the capture.

Returns:	The duration of the capture in nanoseconds

Example

This example returns the duration of the capture

     print(resultSnapshot.CaptureDurationGet())

Clear()¶

Clears the counters and deletes the captured packets from the capture.

Example

This example returns the captured frames

 resultSnapshot.Clear()

ErrorCountGet()¶

Returns Error count.

Returns:	Returns the number of packets with incorrect CRC

Example

This example returns the number of corrupt frames

 print(resultSnapshot.ErrorCountGet())

FramesGet()¶

Returns a list of CapturedFrameList.

Returns:	`CapturedFrameList`

Example

This example returns the captured frames

     framesResult = resultSnapshot.FramesGet()
 for frame in framesResult:
             print(frame.DescriptionGet())

FramesGetByIndex(index)¶

Returns a Rx.Capture.Frame at the provided index.

Returns:	a `CapturedFrame`

Example

This example returns the captured frame given by the index

 frame = resultSnapshot.FramesGetByIndex(0)

PacketCountGet()¶

Returns the number of packets captured.

Returns:	The number of packets this capture captured

Example

This example returns the number of packets captured

     print(resultSnapshot.PacketCountGet())

PcapLastFileNameGet()¶

The fileName where the last pcap was saved to.

Example

 print(resultSnapshot.PcapLastFileNameGet())
     # prints: pcapResult.pcap

PcapNanoSave(filename)¶

Stores the captured frames into a pcap file.

The stored capture file can be opened by e.g. wireshark.

Param:	Destination filename for the capture file.
Raises:	<python_error> - No pcap support found: When the pcap library is not installed on the ByteBlower client PC.
Raises:	ByteBlower.Rx.Capture.GetFailed - When no results are available or when an exception occurred while obtaining the results.
Raises:	ByteBlower.Rx.Capture.GetFramesFailed - Invalid captured packet offset.

Example

Stores all packets captured by filter to c:pcap which is in PcapNano format

from byteblowerll.byteblower import ByteBlower
server = ByteBlower.ServerAdd('byteblower-1.lab.byteblower.com')
server.PortCreate('trunk-1-1')
# TODO??

PcapSave(filename)¶

Stores the captured frames into a pcap file.

The stored capture file can be opened by e.g. wireshark.

Parameters:	fileName – Destination filename for the capture file.
Raises:	<python_error> - No pcap support found: When the pcap library is not installed on the ByteBlower client PC.
Raises:	ByteBlower.Rx.Capture.GetFailed - When no results are available or when an exception occurred while obtaining the results.
Raises:	ByteBlower.Rx.Capture.GetFramesFailed - Invalid captured packet offset.

Example

Stores all packets captured by filter to c:pcap

     resultSnapshot.PcapSave('resultPcap.pcap')

RefreshTimestampGet()¶

Returns the timestamp when the counters of this object where last refreshed.

Example

     print(resultSnapshot.RefreshTimestampGet())

StateNameGet()¶

Returns the status of the current capture.

Returns:	Returns current state of this capture.

Possible values are: - unknown - unavailable - inactive - active}

Example

 print(resultSnapshot.StateNameGet())

class byteblowerll.byteblower.CapturedFrame(inAbstractObject, inTimestamp, bytes)¶

Bases: byteblowerll.byteblower.AbstractObject

A representation of a Captured Frame captured using a CaptureRawPacket.

Example

result = captureRaw.ResultGet()
frame = result.FramesGetByIndex(0)
print(frame.LengthGet())

BufferGet()¶

BytesGet()¶

Gets the bytes in HEX format of this CapturedFrame.

Returns:	hex representation of the content of the captured frame

Example

This example gets the bytes in HEX

     print(frame.BytesGet())

LengthGet()¶

Gets the packet length of this CapturedFrame. This is the length without CRC.

Returns:	Lenght of the packet without CRC

Example

 print(frame.LengthGet())

TimestampGet()¶

Gets timestamp [NS] of this CapturedFrame.

Returns:	Timestamp in nanoseconds

Example

This example gets the timestamp of the captured frame

 print(frame.TimestampGet())

class byteblowerll.byteblower.CapturedFrameList(*args)¶

Bases: object

append(x)¶

assign(n, x)¶

back()¶

begin()¶

capacity()¶

clear()¶

empty()¶

end()¶

erase(*args)¶

front()¶

get_allocator()¶

insert(*args)¶

iterator()¶

pop()¶

pop_back()¶

push_back(x)¶

rbegin()¶

rend()¶

reserve(n)¶

resize(*args)¶

size()¶

swap(v)¶

class byteblowerll.byteblower.CapturedHTTPData(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

This class represents captured HTTP data.

The HTTP data is a local snapshot of the HTTP data received in a HTTP session at the ByteBlower Server.

HTTP data capture is currently supported on HTTP Client objects. .. code-block:: python

emphasize-lines:

2

captureData = httpClient.CaptureGet() print(captureData.HttpSizeGet())

HttpBytesGet()¶

Returns the captured HTTP data.

The data includes both HTTP header and payload.

Note

This only outputs the local cached HTTP data. The local cached HTTP data is a snapshot of the HTTP data received at the ByteBlower server. If no local snapshot was available yet, an initial one will be obtained from the server. You may want to synchronize the local cached data using the Refresh() method.

Returns:	Captured HTTP data as string.
Raises:	ByteBlower.Protocol.NotSupported - When the ByteBlower Server does not support HTTP Client captures

Example

Suppose we sent a HTTP GET request for an ‘index.html’ test page

print(captureData.HttpBytesGet())

HTTP/1.1 200 OK
Date: Wed, 12 Feb 2014 13:23:32 GMT
Server: Apache/2.2.22 (Debian)
Last-Modified: Thu, 10 Feb 2011 11:32:16 GMT
ETag: "27c083-b1-49bebeefcb000"
Accept-Ranges: bytes
Content-Length: 177
Vary: Accept-Encoding
Content-Type: text/html
X-Pad: avoid browser bug
<html><body><h1>It works!</h1>
<p>This is the default web page for this server.</p>
<p>The web server software is running but no content has been added,
yet.</p>
</body></html>

HttpBytesSave(inFileName)¶

Saves the captured HTTP data to file.

Note

This only outputs the local cached HTTP data. The local cached HTTP data is a snapshot of the HTTP data received at the ByteBlower server. If no local snapshot was available yet, an initial one will be obtained from the server. You may want to synchronize the local cached data using the Refresh() method.

Parameters:	fileName – Destination filename for the captured HTTP data.
Raises:	ByteBlower.Protocol.NotSupported - When the ByteBlower Server does not support HTTP Client captures

Example

Stores all HTTP data captured to c:.txt

captureData.HttpBytesSave('httpResults.txt')

HttpSizeGet()¶

Returns the number of captured bytes of HTTP data.

The value includes the size of both HTTP header and payload.

Note

This only outputs the local cached HTTP data. The local cached HTTP data is a snapshot of the HTTP data received at the ByteBlower server. If no local snapshot was available yet, an initial one will be obtained from the server. You may want to synchronize the local cached data using the ::Refresh method.

Returns:	Size of captured HTTP data in Bytes.
Raises:	ByteBlower.Protocol.NotSupported - When the ByteBlower Server does not support HTTP Client captures

Example

Suppose we sent a HTTP GET request for an index.html test page

     print(captureData.HttpSizeGet())

exception byteblowerll.byteblower.ConfigError(*args)¶: Bases: byteblowerll.byteblower.DomainError

exception byteblowerll.byteblower.DHCPFailed(*args)¶: Bases: byteblowerll.byteblower.InitializationError

class byteblowerll.byteblower.DHCPv4Protocol(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

The DHCPv4Protocol is the entry point to configure the DHCP client behavior of a ByteBlowerPort.

A ByteBlowerPort can perform DHCP the get an IP address, gateway and netmask. Currently, no other options are supported but this will change in the future.

Users can configure the timing parameters used in the different stages of the DHCP protocol: - Discover

During the discover stage the ByteBlower port will broadcast discover messages.

Request

Once one or more offers are received the ByteBlower port will broadcast its request message. If acknowledge the ByteBlower port will start using this address.
Renew

When half of the lease time received in the acknowledge message of the request has passed, a ByteBlowerPort will sent a renew message to the server to extend its lease.

Although DHCP allows clients to use unicast messages in the Request stage, ByteBlower currently only supports broadcast messages in this stage.

A DHCPv4Protocol object also supports different retransmission strategies:

Fixed: This policy will use the same timeout value for each timeout.
RFCSuggested: This policy implements the policy described in :rfc:2131.

BroadcastFlagEnable(inValue)¶

Enables the DHCP broadcast flag

New in version 2.11.2.

When a ByteBlower port performs DHCP, the port will use the unicast DHCP method as described in the DHCP RFC. Pre-2.11.2 ByteBlower servers used the legacy broadcast technique, which is sometimes detected by devices as a broadcast storm.

Parameters:	enable (bool) – Whether or not to enable the Broadcast flag

Example

This example will enable the Broadcast flag and thus the legacy behavour of the ByteBlower server

     dhcp_protocol = port_layer3_config.ProtocolDhcpGet()
     dhcp_protocol.BroadcastFlagEnable(True)
     print(dhcp_protocol.BroadcastFlagIsEnabled())

BroadcastFlagIsEnabled()¶

Returns whether or not the broadcast flag is enabled.

New in version 2.11.2.

When a ByteBlower port performs DHCP, the port will use the unicast DHCP method as described in the DHCP RFC. Pre-2.11.2 ByteBlower servers used the legacy broadcast technique, which is sometimes detected by devices as a broadcast storm.

Returns:	Whether or not the flag is enabled
Return type:	bool

Example

This example will enable the Broadcast flag and thus the legacy behavour of the ByteBlower server

     dhcp_protocol = port_layer3_config.ProtocolDhcpGet()
     dhcp_protocol.BroadcastFlagEnable(True)
     print(dhcp_protocol.BroadcastFlagIsEnabled())

DHCPv4SessionInfoGet()¶

Returns the sessionInfo object for this DHCP Session.

This object contains all the DHCP sessionInfo like Tx,Rx, current leaseTime, giaddr etc…

Returns:	`DHCPv4SessionInfo`

Example

This example will return the DHCPv4SessionInfo object for this DHCP session.

print(dhcpProtocol.DHCPv4SessionInfoGet().DescriptionGet())

DiscoverInitialTimeoutGet()¶

Returns the current <InitialTimeout> for the DHCP discover stage.

During the Discover stage, one ore more discover messages will be sent by the DHCP client to get an offer message from one or more DHCP servers. The <InitialTimeout> is the timeout used to decide if the discover message must be retransmitted or not. The next timeout value will be calculated using the configured retransmission policy.

Returns:	Current ‘<InitialTimeout> value for the discover stage. The unit is nanosecond (ns).

Example

This example will get the current <InitialTimeout> for the discover stage.

     print(dhcp_protocol.DiscoverInitialTimeoutGet())

DiscoverInitialTimeoutSet(inValue)¶

Sets the <InitialTimeout> for the DHCP discover stage.

During the Discover stage, one ore more discover messages will be sent by the DHCP client to get an offer message from one or more DHCP servers. The <InitialTimeout> is the timeout used to decide if the discover message must be retransmitted or not. The next timeout value will be calculated using the configured retransmission policy.

Parameters:	InitialTimeout – New value for the initial timeout. The unit is in nanosecond (ns), but the unit

Example

This example will set the <InitialTimeout> for the discover stage.

     dhcp_protocol.DiscoverInitialTimeoutSet(2000000000)

DiscoverMaxRetriesGet()¶

Returns the current maximum retries for the DHCP discover stage.

During the Discover stage, one ore more discover messages will be sent by the DHCP client to get an offer message from one or more DHCP servers. The maximum number of times the DHCP client will retransmit the discover message is returned by this method.

Returns:	Current value for the number of retries in the discover stage.

Example

This example will get the current maximum number of retries for the discover stage.

     print(dhcp_protocol.DiscoverMaxRetriesGet())

DiscoverMaxRetriesSet(inValue)¶

Sets the maximum retries for the DHCP discover stage.

During the Discover stage, one ore more discover messages will be sent by the DHCP client to get an offer message from one or more DHCP servers. The maximum number of times the DHCP client will retransmit the discover message is configured by this method.

Parameters:	maxRetries – The new value for the maximum number of retransmission of the discover message.

Example

This example will set the maximum number of retries for the discover stage to 3 times.

     dhcp_protocol.DiscoverMaxRetriesSet(3)

Perform()¶

Start DHCP and wait for the result.

This method will force the DHCP client on the ByteBlower port to send a first DHCP discover message. It the client is already active, a new discover message will be sent. This is a synchronous call, so the full DHCPv6 solicit and request will be done once this call returns, or an error have occurred.

Returns:	This method will return nothing, but will return after DHCP is performed successfully. If DHCP fails, and exception is thrown.
Raises:	`DHCPFailed` when no offer was received during the DHCP discover stage or when no DHCPAck was received during DHCPRequest stage

Example

This example will perform DHCP on the specified ByteBlowerPort.

     dhcp_protocol.Perform()

PerformAsync()¶

Will start DHCP and return immediately.

This method will force the DHCP client on the ByteBlower port to send a first DHCP discover message. If the client is already active, a new discover message will be sent. This is a asynchronous call, so it will return immediately. If you want to see if there an exception occurred during this async, call the Perform() method.

Returns:	This method will return nothing and return immediately

New in version 2.2.

Example

This example will perform DHCP on the specified ByteBlowerPort.

     dhcp_protocol.PerformAsync()

Release()¶

Release the DHCP lease.

This method will release the address previously received using DHCP. After this, the address will not be used anymore by the ByteBlower port and the DHCP server can reuse the address for other DHCP clients. Of course, packets sent by the ByteBlower port as part of streams can still use the address.

Returns:	This method will return nothing, but will return after DHCP Release is performed

Example

This example will release the DHCP address.

     dhcp_protocol.Release()

ReleaseEnable(inValue)¶

Enable/disable sending DHCP release during destruction.

When a ByteBlowerPort is destructed and this port has performed DHCP, such a port should release its address. If this behavior is prefered, then this should be done by using the Release.Enable method to indicate the ByteBlowerPort should release its address if possible. A ByteBlowerPort is able to release its address at destruction time if the destination mac address is in the ByteBlowerPort’s ARP cache. If not, the DHCP release messages will not be sent out, because it could delay the whole cleanup.

If you want to force the release of an address received through DHCP, use Release().

Parameters:	enable – Boolean to enable or disable the release of the address at the end of the test. Default: `True`

Example

This example will disable the automatic release of the DHCP address at the end of the test.

     dhcp_protocol.ReleaseEnable(False)

ReleaseIsEnabled()¶

Return whether sending DHCP release during destruction is enabled.

When a ByteBlowerPort is destructed and this port has performed DHCP, it should release its address. If this behavior is prefered, then this should be done by using the ReleaseEnable() method to inidicate the ByteBlowerPort should release its address if possible. A ByteBlowerPort is able to release its address at destruction time if the destination mac address is in the ByteBlowerPort’s ARP cache. If not, the DHCP release messages will not be sent out, because it could delay the whole cleanup.

If you want to force the release of an address received through DHCP, use Release().

Returns:	If the port will release its IP at destruction

Example

This example will disable the automatic release of the DHCP address at the end of the test.

     dhcp_protocol = port_layer3_config.ProtocolDhcpGet()
     print(dhcp_protocol.ReleaseIsEnabled())

RequestInitialTimeoutGet()¶

Returns the current <InitialTimeout> for the DHCP request stage.

During the Request stage, one ore more request messages will be sent by the DHCP client to get an ack message from the DHCP server. The <InitialTimeout> is the timeout used to decide if the request message must be retransmitted or not. The next timeout value will be calculated using the configured retransmission policy.

Returns:	Current <InitialTimeout> value for the request stage. The unit is nanosecond (ns).

Example

This example will get the current <InitialTimeout> for the request stage.

     print(dhcp_protocol.RequestInitialTimeoutGet())

RequestInitialTimeoutSet(inTime)¶

Sets the <InitialTimeout> for the DHCP request stage.

During the Request stage, one ore more request messages will be sent by the DHCP client to get an ack message from the DHCP server. The <InitialTimeout> is the timeout used to decide if the request message must be retransmitted or not. The next timeout value will be calculated using the configured retransmission policy.

Parameters:	InitialTimeout – New value for the initial timeout. The unit is in nanosecond (ns).

Example

This example will set the <InitialTimeout> for the request stage.

     dhcp_protocol.RequestInitialTimeoutSet(3000000000)

RequestMaxRetriesGet()¶

Returns the current maximum retries for the DHCP Request stage.

During the Request stage, one ore more request messages will be sent by the DHCP client to get an ack message from the DHCP server. The maximum number of times the DHCP client will retransmit the request message is returned by this method.

Returns:	Current value for the number of retries in the request stage.

Example

This example will get the current maximum number of retries to 10 for the request stage.

     dhcp_protocol.RequestMaxRetriesSet(10)

RequestMaxRetriesSet(inValue)¶

Sets the maximum retries for the DHCP Request stage.

During the Request stage, one ore more request messages will be sent by the DHCP client to get an ack message from the DHCP server. The maximum number of times the DHCP client will retransmit the request message is configured by this method.

Parameters:	maxRetries – The new value for the maximum number of retransmissions of the request message.

Default value is 5 times

Example

This example will set the current maximum number of retries to 10 for the request stage.

     dhcp_protocol.RequestMaxRetriesSet(10)  

RetransmissionPolicyGet()¶: Deprecated since version TODO: This method has been renamed, use RetransmissionPolicyStringGet() now.

RetransmissionPolicySet(policy)¶: Deprecated since version TODO: This method has been renamed, use RetransmissionPolicy.Set.FromString now.

class byteblowerll.byteblower.DHCPv4SessionInfo(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

Class containing the info about the DHCPSession.

This class represents the session info gathered from a DHCPSession. It will contain counters of the amount of DHCPMessages transmitted and received. It also contains some values of the obtained lease ( leasetime, GiAddr, SiAddr, OptionValues )

session_info = protocol.DHCPv4SessionInfoGet()
for option in info.DHCPOptionGet():
         print(option)

AckTimestampLastGet()¶

Returns the timestamp when the last DHCP Ack message is received.

New in version 2.11.2.

Returns:	The timestamp in nanoseconds since epoch
Return type:	int

Example

print(session_info.AckTimestampLastGet())

DHCPOptionGet()¶

Returns a list if received DHCPOptions.

Returns:	List of DHCPOptions in the form of OptionNumber-Value

Example

for option in session_info.DHCPOptionGet:
             print(option)

DHCPServerAddrGet()¶

Returns the ipAddress of the DHCPServer.

This address is parsed out of DHCPServerIdentifier option ( Option 54 )

Returns:	Address of the DHCP server
Return type:	str

Example

print(session_info.DHCPServerAddrGet())

DiscoverTimestampLastGet()¶

Returns the timestamp when the last DHCP Discover message is sent.

New in version 2.11.2.

Returns:	The timestamp in nanoseconds since epoch
Return type:	int

Example

print(session_info.DiscoverTimestampLastGet())

GiAddrGet()¶

Returns the ipAddress of the relay agent, used in booting via a relay agent.

Returns:	Relay agent IP address
Return type:	str

Example

print(session_info.GiAddrGet())

LeaseTimeGet()¶

Returns IP Address lease time.

Returns:	The leasetime in NanoSeconds
Return type:	int

Example

print(session_info.LeaseTimeGet())

OfferTimestampLastGet()¶

Returns the timestamp when the last DHCP Offer message is received.

New in version 2.11.2.

Returns:	The timestamp in nanoseconds since epoch
Return type:	int

Example

print(session_info.OfferTimestampLastGet())

RefreshTimestampGet()¶

Returns the timestamp when the counters of this object where last refreshed.

Returns:	RefreshTimestamp in nanoseconds
Return type:	int

Example

print(session_info.RefreshTimestampGet())

RequestTimestampLastGet()¶

Returns the timestamp when the last DHCP Request message is sent.

New in version 2.11.2.

Returns:	The timestamp in nanoseconds since epoch
Return type:	int

Example

print(session_info.RequestTimestampLastGet())

RxGet()¶

Returns the number of DHCPMessages recieved.

Returns:	Number of DHCP messages received
Return type:	int

Example

print(session_info)

SiAddrGet()¶

Returns the IP address of next server to use in bootstrap.

Returns:	next server IP address
Return type:	str

Example

     print(session_info.SiAddrGet())

TransactionIDGet()¶

TxGet()¶

Returns the number of DHCPMessages transmitted.

Returns:	Number of DHCP messages transmitted
Return type:	int

Example

print(session_info)

class byteblowerll.byteblower.DHCPv6Protocol(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

The DHCPv6Protocol is the entry point to configure the DHCPv6 client: behavior of a ByteBlowerPort.

A ByteBlowerPort can perform DHCPv6 for configuring IP addresses, IP prefixes and/or other parameters required to operate on an IPv6 network.

A ByteBlowerPort can acquire and combine IP addresses using stateless address autoconfiguration, or by using DHCPv6 or static configuration. DHCP tends to be preferred at sites where central management of hosts is valued; stateless autoconfiguration does not require any sort of central management, and is therefore preferable in networks where no management is readily available, such as a typical home network.

IPv6 hosts that use stateless autoconfiguration may require information other than an IP address. DHCPv6 can be used to acquire this information, even though it is not being used to configure IP addresses.

DHCPv6 can also be used to deligate prefix information to e.g. home gateways. Such gateways require not only an IPv6 address for use in communicating with upstream routers, but also an IPv6 prefix for use in configuring devices on the downstream side of the router. DHCPv6 Prefix delegation provides a mechanism for configuring such routers. ByteBlower currently doesn’t support prefix delegation yet, but can only be used as a host.

ByteBlower allows full control of the timing parameters of the DHCPv6 client side. The retransmission policy used for DHCPv6 is the one suggested in the rfc:3315.

Configurable timing parameters are:

Initial Timeout
Maximum Duration
Maximum Retries
Maximum Timeout

These timing parameters can be applied to the following stages of DHCPv6:

Solicit
Request
Renew
Inform
Confirm

For each state the parameters do the following:: ByteBlower will send up to <MaxRetries> messages. The total duration of the the state may take up the <MaxDuration>. For the first attempt, a ByteBlowerPort will wait up to <InitialTimeout> nanoseconds before retrying. Each attempt will wait for maximum ‘<MaxTimeout> nanoseconds before concluding that the messages has timed out.

ConfirmInitialTimeoutGet()¶

Getter for <InitialTimeout> when in the Confirm state.

Returns:	Current value for <InitialTimeout> for stage Confirm. This is a time value, in nanosecond units.

Example

This example demonstrates how to get the value for <InitialTimeout> in the Confirm stage.

     print(dhcp_protocol.ConfirmInitialTimeoutGet())

ConfirmInitialTimeoutSet(arg2)¶

Setter for <InitialTimeout> when in the Confirm state.

Parameters:	value – New value for <InitialTimeout> for stage Confirm. This is a time value, in nanosecond units.

Example

This example demonstrates how to set the value for <InitialTimeout> in the Confirm stage.

     dhcp_protocol.ConfirmInitialTimeoutSet(100000)

ConfirmMaxDurationGet()¶

Getter for <MaxDuration> when in the Confirm state.

Returns:	Current value for <MaxDuration> for stage Confirm. This is a time value, in nanosecond units.

Example

This example demonstrates how to get the value for <MaxDuration> in the Confirm stage.

     print(dhcp_protocol.ConfirmMaxDurationGet())

ConfirmMaxDurationSet(arg2)¶

Setter for <MaxDuration> when in the Confirm state.

Parameters:	value – New value for <MaxDuration> for stage Confirm. This is a time value, in nanosecond units.

Example

This example demonstrates how to set the value for <MaxDuration> in the Confirm stage.

     dhcp_protocol.ConfirmMaxDurationSet(100000)

ConfirmMaxRetriesGet()¶

Getter for <MaxRetries> when in the Confirm state.

Returns:	Current value for <MaxRetries> for stage Confirm. This is a positive integer value, indicating the number of times the ByteBlowerPort will resend its Confirm message.

Example

This example demonstrates how to get the value for <MaxRetries> in the Confirm stage.

     print(dhcpv6.ConfirmMaxRetriesGet())

ConfirmMaxRetriesSet(arg2)¶

Setter for <MaxRetries> when in the Confirm state.

Parameters:	value – New value for <MaxRetries> for stage Confirm. This must be a positive integer value, indicating the number of times the ByteBlowerPort will resend its Confirmmessage.

Example This example demonstrates how to set the value for <MaxRetries> to 12 in the Confirm stage.

     dhcp_protocol.ConfirmMaxRetriesSet(12)

ConfirmMaxTimeoutGet()¶

Getter for <MaxTimeout> when in the Confirm state.

Returns:	Current value for <MaxTimeout> for stage Confirm. This is a time value, in nanosecond units.

Example

This example demonstrates how to get the value for <MaxTimeout> in the Confirm stage.

     print(dhcp_protocol.ConfirmMaxTimeoutGet())

ConfirmMaxTimeoutSet(arg2)¶

Setter for <MaxTimeout> when in the Confirm state.

Parameters:	value – New value for <MaxTimeout> for stage Confirm. This is a time value, in nanosecond inits.

Example

This example demonstrates how to set the value for <MaxTimeout> in the Confirm stage.

     dhcp_protocol.ConfirmMaxTimeoutSet(5000000000)

DHCPv6SessionInfoGet()¶

Returns the sessionInfo object for this DHCP Session.

This object contains all the DHCP sessionInfo like Tx,Rx

Returns:	The `DHCPv6SessionInfo` object for this DHCP session

Example

This example will return the DHCPv6SessionInfo object for this DHCP session.

     print(dhcp_protocol.DHCPv6SessionInfoGet().DescriptionGet())

InformInitialTimeoutGet()¶

Getter for <InitialTimeout> when in the Inform state.

Returns:	Current value for <InitialTimeout> for stage Inform. This is a time value, in nanosecond units.

Example

This example demonstrates how to get the value for <InitialTimeout> in the Inform stage.

     print(dhcp_protocol.InformInitialTimeoutGet())

InformInitialTimeoutSet(arg2)¶

Setter for <InitialTimeout> when in the Inform state.

Parameters:	value – New value for <InitialTimeout> for stage Inform. This is a time value, in nanosecond units.

Example

This example demonstrates how to set the value for <InitialTimeout> in the Inform stage.

     dhcp_protocol.InformInitialTimeoutSet()

InformMaxDurationGet()¶

Getter for <MaxDuration> when in the Inform state.

Returns:	Current value for <MaxDuration> for stage Inform. This is a time value, in nanosecond units.

Example

This example demonstrates how to get the value for <MaxDuration> in the Inform stage.

     print(dhcp_protocol.InformMaxDurationGet())

InformMaxDurationSet(arg2)¶

Setter for <MaxDuration> when in the Inform state.

Parameters:	value – New value for <MaxDuration> for stage Inform. This is a time value, in nanosecond units.

Example

This example demonstrates how to set the value for <MaxDuration> to 100000 in the Inform stage.

     dhcp_protocol.InformMaxDurationSet(100000)

InformMaxRetriesGet()¶

Getter for <MaxRetries> when in the Inform state.

Returns:	Current value for <MaxRetries> for stage Inform. This is a positive integer value, indicating the number of times the ByteBlowerPort will resend its Inform message.

Example

This example demonstrates how to get the value for <MaxRetries> in the Inform stage.

     print(dhcp_protocol.InformMaxRetriesGet())

InformMaxRetriesSet(arg2)¶

Setter for <MaxRetries> when in the Inform state.

Parameters:	value – New value for <MaxRetries> for stage Inform. This must be a positive integer value, indicating the number of times the ByteBlowerPort will resend its Inform message.

Example

This example demonstrates how to set the value for <MaxRetries> to 5 in the Inform stage.

     dhcp_protocol.InformMaxRetriesSet(5)

InformMaxTimeoutGet()¶

Getter for <MaxTimeout> when in the Inform state.

Returns:	Current value for <MaxTimeout> for stage Inform. This is a time value, in nanosecond units.

Example

This example demonstrates how to get the value for <MaxTimeout> in the Inform stage.

     print(dhcp_protocol.InformMaxTimeoutGet())

InformMaxTimeoutSet(arg2)¶

Setter for <MaxTimeout> when in the Inform state.

Parameters:	value – New value for <MaxTimeout> for stage Inform. This is a time value, in nanosecond units.

Example

This example demonstrates how to set the value for <MaxTimeout> in the Inform stage.

     dhcp_protocol.InformMaxTimeoutSet(100000)

Perform()¶

This method will bootstrap the DHCPv6 process.

The client will start with sending DHCPv6 solicit messages. This is a synchronous call, so the full DHCPv6 solicit and request will be done once this call returns, or an error have occurred.

Returns:	This method will return nothing, but will return after DHCP is performed successfully. If DHCP fails, and exception is thrown.
Raises:	`DHCPFailed` Thrown if no offer was received during the DHCP solicit stage or no DHCPReply during DHCPRequest stage

Example

This example will start the DHCPv6 process.

     dhcp_protocol.Perform()

PerformAsync()¶

This method will bootstrap the DHCPv6 process.

The client will start with sending DHCPv6 solicit messages. This is a asynchronous call, so it will return immediately. If you want to see if there an exception occured during this async, call the perform method.

Returns:	This method will return nothing and return immediately

New in version 2.2.

Example

This example will start the DHCPv6 process.

     dhcp_protocol.PerformAsync()

Release()¶

Release the address previously received using DHCPv6

This method will release the address previously received using DHCP. After this, the address will not be used anymore by the ByteBlower port and the DHCP server can reuse the address for other DHCP clients. Offcourse, packets sent by the ByteBlower port as part of streams can still use the address.

Returns:	This method will return nothing, but will return after DHCP Release is performed

Example

This example will release the DHCP address.

dhcp_protocol.Release()

ReleaseEnable(inValue)¶

Enable automatical release when the ByteBlower port is destroyed

When a ByteBlowerPort is destructed and this port has performed DHCP, such a port should release its address. If this behavior is prefered, then this should be done by using the ReleaseEnable() method to inidicate the ByteBlowerPort should release its address if possible. A ByteBlowerPort is able to release its address at destruction time if the destination mac address is in the ByteBlowerPort’s ARP cache. If not, the DHCP release messages will not be sent out, because it could delay the whole cleanup.

If you want to force the release of an address received through DHCP, use Release().

Parameters:	enable – bool True to enable the automatic release of the address Default: `true`

Example

This example will disable the automatic release of the DHCP address at the end of the test.

     dhcp_protocol.ReleaseEnable()

ReleaseIsEnabled()¶

Returns True when automatic release is enabled

When a ByteBlowerPort is destructed and this port has performed DHCP, it should release its address. If this behavior is prefered, then this should be done by using the Release.Enable method to inidicate the ByteBlowerPort should release its address if possible. A ByteBlowerPort is able to release its address at destruction time if the destination mac address is in the ByteBlowerPort’s ARP cache. If not, the DHCP release messages will not be sent out, because it could delay the whole cleanup.

If you want to force the release of an address received through DHCP, use Release()

Returns:	If the port will release its IP at destruction

Example

This example will disable the automatic release of the DHCP address at the end of the test.

     print(dhcp_protocol.ReleaseIsEnabled())

RenewInitialTimeoutGet()¶

Getter for <InitialTimeout> when in the Renew state.

Returns:	Current value for <InitialTimeout> for stage Renew. This is a time value, in nanosecond units.

Example

This example demonstrates how to get the value for <InitialTimeout> in the Renew stage.

     print(dhcp_protocol.RenewInitialTimeoutGet())

RenewInitialTimeoutSet(arg2)¶

Setter for <InitialTimeout> when in the Renew state.

Parameters:	value – New value for <InitialTimeout> for stage Renew. This is a time value, in nanosecond units.

Example

This example demonstrates how to set the value for <InitialTimeout> to 10000 in the Renew stage.

     dhcp_protocol.RenewInitialTimeoutSet(10000)

RenewMaxDurationGet()¶

Getter for <MaxDuration> when in the Renew state.

Returns:	Current value for <MaxDuration> for stage Renew. This is a time value, in nanosecond units.

Example

This example demonstrates how to get the value for <MaxDuration> in the Renew stage.

     print(dhcp_protocol.RenewMaxDurationGet())

RenewMaxDurationSet(arg2)¶

Setter for <MaxDuration> when in the Renew state.

Parameters:	value – New value for <MaxDuration> for stage Renew. This is a time value, in nanosecond units.

Example

This example demonstrates how to set the value for <MaxDuration> in the Renew stage.

     dhcp_protocol.RenewMaxDurationSet(100000)

RenewMaxRetriesGet()¶

Getter for <MaxRetries> when in the Renew state.

Returns:	Current value for <MaxRetries> for stage Renew. This is a positive integer value, indicating the number of times the ByteBlowerPort will resend its Renew message.

Example

This example demonstrates how to get the value for <MaxRetries> in the Renew stage.

     print(dhcp_protocol.RenewMaxRetriesGet())

RenewMaxRetriesSet(arg2)¶

Setter for <MaxRetries> when in the Renew state.

Parameters:	value – New value for <MaxRetries> for stage Renew. This must be a positive integer value, indicating the number of times the ByteBlowerPort will resend its Renew message.

Example

This example demonstrates how to set the value for <MaxRetries> to 12in the Renew stage.

     dhcp_protocol.RenewMaxRetriesSet(12)

RenewMaxTimeoutGet()¶

Getter for <MaxTimeout> when in the Renew state.

Returns:	Current value for <MaxTimeout> for stage Renew. This is a time value, in nanosecond units.

Example

This example demonstrates how to get the value for <MaxTimeout> in the Renew stage.

     print(dhcp_protocol.RenewMaxTimeoutGet())

RenewMaxTimeoutSet(arg2)¶

Setter for <MaxTimeout> when in the Renew state.

Parameters:	value – New value for <MaxTimeout> for stage Renew. This is a time value, in nanosecond units.

Example

This example demonstrates how to set the value for <MaxTimeout> in the Renew stage.

     dhcpv6.RenewMaxTimeoutSet(5000)

RequestInitialTimeoutGet()¶

Getter for <InitialTimeout> when in the Request state.

Returns:	Current value for <InitialTimeout> for stage Request. This is a time value, in nanosecond units.

Example

This example demonstrates how to get the value for <InitialTimeout> in the Request stage.

     print(dhcp_protocol.RequestInitialTimeoutGet())

RequestInitialTimeoutSet(arg2)¶

Setter for <InitialTimeout> when in the Request state.

Parameters:	value – New value for <InitialTimeout> for stage Request. This is a time value, in nanosecond units.

Example

This example demonstrates how to set the value for <InitialTimeout> in the Request stage.

     dhcp_protocol.RequestInitialTimeoutSet(1000000)

RequestMaxDurationGet()¶

Getter for <MaxDuration> when in the Request state.

Returns:	Current value for <MaxDuration> for stage Request. This is a time value, in nanosecond units.

Example

This example demonstrates how to get the value for <MaxDuration> in the Request stage.

     print(dhcp_protocol.RequestMaxDurationGet())

RequestMaxDurationSet(arg2)¶

Setter for <MaxDuration> when in the Request state.

Parameters:	value – New value for <MaxDuration> for stage Request. This is a time value, in nanosecond units.

Example

This example demonstrates how to set the value for <MaxDuration> to 10 in the Request stage.

     dhcp_protocol.RequestMaxDurationSet(1000000)

RequestMaxRetriesGet()¶

Getter for <MaxRetries> when in the Request state.

Returns:	Current value for <MaxRetries> for stage Request. This is a positive integer value, indicating the number of times the ByteBlowerPort will resend its Request message.

Example

This example demonstrates how to get the value for <MaxRetries> in the Request stage.

     print(dhcp_protocol.RequestMaxRetriesGet())

RequestMaxRetriesSet(arg2)¶

Setter for <MaxRetries> when in the Request state.

Parameters:	value – New value for <MaxRetries> for stage Request. This must be a positive integer value, indicating the number of times the ByteBlowerPort will resend its Request message.

Example

This example demonstrates how to set the value for <MaxRetries> to 10 in the Request stage.

     dhcp_protocol.RequestMaxRetriesSet(10)

RequestMaxTimeoutGet()¶

Getter for <MaxTimeout> when in the Request state.

Returns:	Current value for <MaxTimeout> for stage Request. This is a time value, in nanosecond units.

Example

This example demonstrates how to get the value for <MaxTimeout> in the Request stage.

     print(dhcp_protocol.RequestMaxTimeoutGet())

RequestMaxTimeoutSet(arg2)¶

Setter for <MaxTimeout> when in the Request state.

Parameters:	value – New value for <MaxTimeout> for stage Request. This is a time value, in nanosecond units

Example

This example demonstrates how to set the value for <MaxTimeout> in the Request stage.

     dhcp_protocol.RequestMaxTimeoutSet(1000000)

RetransmissionPolicyGet()¶

RetransmissionPolicySet(policy)¶

SolicitInitialTimeoutGet()¶

Getter for <InitialTimeout> when in the Solicit state.

Returns:	Current value for <InitialTimeout> for stage Solicit. This is a time value, in nanosecond units.

Example

This example demonstrates how to get the value for <InitialTimeout> in the Solicit stage.

     print(dhcp_protocol.SolicitInitialTimeoutGet())

SolicitInitialTimeoutSet(arg2)¶

Setter for <InitialTimeout> when in the Solicit state.

Parameters:	value – New value for <InitialTimeout> for stage Solicit. This is a time value, in nanosecond units.

Example

This example demonstrates how to set the value for <InitialTimeout> in the Solicit stage.

     dhcp_protocol.SolicitInitialTimeoutSet(100000)

SolicitMaxDurationGet()¶

Getter for <MaxDuration> when in the Solicit state.

Returns:	Current value for <MaxDuration> for stage Solicit. This is a time value, in nanosecond units.

Example

This example demonstrates how to get the value for <MaxDuration> in the Solicit stage.

     print(dhcp_protocol.SolicitMaxDurationGet())

SolicitMaxDurationSet(arg2)¶

Setter for <MaxDuration> when in the Solicit state.

Parameters:	value – New value for <MaxDuration> for stage Solicit. This is a time value, in nanosecond units.

Example This example demonstrates how to set the value for <MaxDuration> to 1000000 in the Solicit stage.

     dhcp_protocol.SolicitMaxDurationSet(1000000)

SolicitMaxRetriesGet()¶

Getter for <MaxRetries> when in the Solicit state.

Returns:	Current value for <MaxRetries> for stage Solicit. This is a positive integer value, indicating the number of times the ByteBlowerPort will resend its Solicit message.

Example

This example demonstrates how to get the value for <MaxRetries> in the Solicit stage.

     print(dhcp_protocol.SolicitMaxRetriesGet())

SolicitMaxRetriesSet(arg2)¶

Setter for <MaxRetries> when in the Solicit state.

Parameters:	value – New value for <MaxRetries> for stage Solicit. This must be a positive integer value, indicating the number of times the ByteBlowerPort will resend its Solicit message.

Example

This example demonstrates how to set the value for <MaxRetries> in the Solicit stage.

     print(dhcp_protocol.SolicitMaxRetriesGet())

SolicitMaxTimeoutGet()¶

Getter for <MaxTimeout> when in the Solicit state.

Returns:	Current value for <MaxTimeout> for stage Solicit. This is a time value, in nanosecond units.

Example This example demonstrates how to get the value for <MaxTimeout> in the Solicit stage.

     print(dhcp_protocol.SolicitMaxTimeoutGet())

SolicitMaxTimeoutSet(arg2)¶

Setter for <MaxTimeout> when in the Solicit state.

Parameters:	value – New value for <MaxTimeout> for stage Solicit. This is a time value, in nanosecond units.

This example demonstrates how to set the value for <MaxTimeout> in the Solicit stage.

Example

     dhcp_protocol.SolicitMaxTimeoutSet(10000)

class byteblowerll.byteblower.DHCPv6SessionInfo(*args, **kwargs)¶

Bases: byteblowerll.byteblower.AbstractObject

Class containing the info about the DHCPSession.

This class represents the session info gathered from a DHCPv6Session. It will contain counters of the amount of DHCPMesseage transmitted and received.

AdvertiseTimestampLastGet()¶

RefreshTimestampGet()¶

Returns the timestamp when the results are last retrieved from the server

Returns:	The timestamp in nanoseconds since epoch
Return type:	int

Example

print(session_info.RefreshTimestampGet())

ReplyTimestampLastGet()¶

RequestTimestampLastGet()¶

RxGet()¶

Returns the number of DHCPMessages recieved.

Returns:	Number of DHCP messages received
Return type:	int

Example

     print(dhcpSessionInfo.RxGet())

SolicitTimestampLastGet()¶

TxGet()¶

Returns the number of DHCPMessages transmitted.

Returns:	Number of DHCP messages transmitted
Return type:	int

Example

     print(dhcpSessionInfo.TxGet())

class byteblowerll.byteblower.DataRate(inSize, inDuration)¶

Bases: object

Represents a data rate. The datarate can be expressed in multiple formats.

Example

httpResultData = httpClient.ResultHistoryGet().CumulativeLatestGet()
dataRate = httpResultData.RxByteCountRateGet()

BitRateGet()¶

Returns the bits per second of the http session

Returns:	The speed in bits per second
Return type:	long