byteblowerll.byteblower.Frame

class byteblowerll.byteblower.Frame(*args, **kwargs)

Class: Frame

A ByteBlower Frame is an object representing a Frame which can be used in a Stream for transmission by a ByteBlower Port.

A Frame is used in stateless traffic testing. It will be sent by a ByteBlowerPort. For each Frame, different options can be enabled:

  1. Tagging
    • Sequence: Defines if a sequence number must be set. This is used for out-of-sequence detection.
    • Timestamping: Defines if the timestamp of transmission must be set in the frame. This is used for latency measurements.
  2. Checksumming
    • L3: IPv4/IPv6 automatic header checksumming.
    • L4: UDP/TCP automatic checksumming.
  3. Length field correction
    • L3: Automatic correction of the IPv4 length field. This is usefull when using a FrameSizeModifier.
    • L7: Automatic correction of the UDP/TCP length field. This is usefull when using a FrameSizeModifier.

Also the frame can be modified during the test using modifiers:

  1. Field
    • Incremental: A field in the frame will be incremented every time the frame is sent out. The field’s position and size is configurable.
    • Random: A field in the frame will be a random value every time the frame is sent out. The field’s position and size is configurable.
  2. Size
    • GrowingSize: The frame will grow between a minimum and a maximum value. When the maximum value is reached, the frame resizes to the given minimum.
    • RandomSize: The frame will have a different size every time it is sent out. The sizes will be random between a given minimum and maximum size.
__init__(*args, **kwargs)

Initialize self. See help(type(self)) for accurate signature.

Methods

BytesGet() A method which returns the current content of a Frame in a hexadecimal format.
BytesSet(frameString) A method which sets the content of a Frame in a hexadecimal format.
DescriptionGet(*args) Gets a textual description for the current object
FrameTagSequenceGet() Returns the FrameTag.Tx object related to the sequence number injection for this frame.
FrameTagTimeGet() Returns the FrameTagTx object related to the timestamp injection for this frame.
IsL3AutoChecksumEnabled()
IsL3AutoLengthEnabled()
IsL4AutoChecksumEnabled()
IsL4AutoLengthEnabled()
L3AutoChecksumEnable(value) Enable or disable the automatic checksum calculation of the Layer3 header of this frame.
L3AutoChecksumGet() Method returning the current configuration of the automatic checksum calculation option.
L3AutoLengthEnable(value) Enable or disable the automatic Layer3 header length field calculation of this frame.
L3AutoLengthGet() Method returning the current configuration of the automatic Layer3 length field adaption option.
L4AutoChecksumEnable(value) Enable or disable the automatic Layer4 checksum calculation of this frame.
L4AutoChecksumGet() Method returning the current configuration of the automatic Layer4 checksum recalculation option.
L4AutoLengthEnable(value) Enable or disable the automatic Layer4 header length field calculation of this frame.
L4AutoLengthGet() Method returning the current configuration of the automatic Layer4 length field adaption option.
ModifierFieldIncrementalAdd() Adds an incremental frame field modifier.
ModifierFieldIncrementalDestroy(inModifier)
ModifierFieldIncrementalGet() Returns the active incremental frame field modifier(s).
ModifierFieldRandomAdd() Adds a random frame field modifier.
ModifierFieldRandomDestroy(inModifier)
ModifierFieldRandomGet() Returns the active random frame field modifier(s).
ModifierSizeGet()
ModifierSizeGrowingDestroy(arg2)
ModifierSizeGrowingGet() Returns the active frame growing size modifier.
ModifierSizeGrowingSet() Sets a growing frame size modifier.
ModifierSizeRandomDestroy(arg2)
ModifierSizeRandomGet() Returns the active frame random size modifier.
ModifierSizeRandomSet() Sets a random frame size modifier.
ParentGet() Returns the parent object.
Refresh() Retrieves the latest data from the server for this object.
ResultClear() Resets the current transmit counters to zero.
ResultGet() Returns the current transmit counters.
ResultHistoryGet()
SetL3AutoChecksum(b)
SetL3AutoLength(set)
SetL4AutoChecksum(set)
SetL4AutoLength(set)
StreamGet()
__init__(*args, **kwargs) Initialize self.

Attributes

thisown The membership flag