8.3.2.1. Module

This module contains the L47 module classes.


class M4_CAPTURE_FILE_DELETE[source]

Bases: object

Command to delete a Capture File (.pcap file) in the Capture File directory (/var/ftp/pub/replay/pcap/). For information about the location and directory structure for the Capture Files, see: M4_REPLAY_PARSE_START

set(filename)[source]

Delete a Capture File in the Capture File directory.

Parameters:

filename (str) – file name (including relative path and excluding the .pcap extension).

class M4_CAPTURE_FILE_LIST[source]

Bases: object

Returns a list of Capture Files (.pcap files) in the ‘user’ Capture File directory (/var/ftp/pub/replay/pcap/user/).

get()[source]

Generate a list of Capture Files in BSON document on the tester.

Returns:

list of Capture Files in BSON document on the tester

Return type:

M4_CAPTURE_FILE_LIST.GetDataAttr

class M4_CAPTURE_FILE_LIST_BSON[source]

Bases: object

Works as M4_CAPTURE_FILE_LIST, but returns the file list formatted as a BSON document.

get()[source]

Get the capture file list in BSON document.

Returns:

the capture file list in BSON document

Return type:

M4_CAPTURE_FILE_LIST_BSON.GetDataAttr

class M4_CAPTURE_SIZE[source]

Bases: object

Specify whether to capture whole packets(large) or truncated packets. When truncated (small) is selected only the first 128 bytes of the packet are saved.

get()[source]

Get whether to capture whole packets(large) or truncated packets.

Returns:

whether to capture whole packets(large) or truncated packets.

Return type:

M4_CAPTURE_SIZE.GetDataAttr

set(size)[source]

Set whether to capture whole packets(large) or truncated packets.

Parameters:

size (CaptureSize) – specifying whether to capture whole packets or truncated packets.

set_full()

Capture whole packets

set_small()

Capture truncated packets

class M4_COMPATIBLE_CLIENT_VERSION[source]

Bases: object

Returns the recommended and required VulcanMananger client version.

get()[source]

Get the recommended and required VulcanMananger client version.

Returns:

the recommended and required VulcanMananger client version.

Return type:

M4_COMPATIBLE_CLIENT_VERSION.GetDataAttr

class M4_LICENSE_INFO[source]

Bases: object

Returns the number of available and free PE licenses. Only ‘available’ number of PEs can simultaneously be assigned to reserved ports.

get()[source]

Get the number of available and free PE licenses.

Returns:

the number of available and free PE licenses

Return type:

M4_LICENSE_INFO.GetDataAttr

class M4_MEM_INFO[source]

Bases: object

Return the system memory information.

get()[source]

Get the system memory information.

Returns:

the system memory information.

Return type:

M4_MEM_INFO.GetDataAttr

class M4_REPLAY_FILE_DELETE[source]

Bases: object

Command to delete a Replay File (.bson file) in the Replay File directory (/var/ftp/pub/replay/bson/). For information about the location and directory structure for the Replay Files, see: M4_REPLAY_PARSE_START

set(filename)[source]

Delete a Replay File in the Replay File directory.

Parameters:

filename (str) – file name (including relative path and excluding the .bson extension).

class M4_REPLAY_FILE_LIST[source]

Bases: object

Returns a list of Replay Files (.bson files) in the ‘user’ Replay File directory (/var/ftp/pub/replay/bson/user/).

get()[source]

Generate a list of Replay Files in BSON document on the tester.

Returns:

a list of Replay Files in BSON document on the tester

Return type:

M4_REPLAY_FILE_LIST.GetDataAttr

class M4_REPLAY_FILE_LIST_BSON[source]

Bases: object

Works as M4_REPLAY_FILE_LIST, but returns the file list formatted as a BSON document.

get()[source]

Get the replay file list in BSON document format.

Returns:

the replay file list in BSON format

Return type:

M4_REPLAY_FILE_LIST_BSON.GetDataAttr

class M4_REPLAY_PARSER_PARAMS[source]

Bases: object

Configuration of parameters for the parsing of pcap files.

get()[source]

Get the configuration of parameters for the parsing of pcap files.

Returns:

the configuration of parameters for the parsing of pcap files

Return type:

M4_REPLAY_PARSER_PARAMS.GetDataAttr

set(tcp_port)[source]

Set the configuration of parameters for the parsing of pcap files.

Parameters:

tcp_port (int) – server-side TCP port of the dummy TCP connection inserted in UDP.

class M4_REPLAY_PARSE_START[source]

Bases: object

Command to start parsing an uploaded Capture File (in PCAP format) intended for use in a replay test scenario. The result of the parsing - if successful - is a Replay File (in BSON format) with the same name as the Capture File, which can be used as parameter to P4G_REPLAY_filename command. If parsing is unsuccessful, a Replay File is created containing the parse result. The M4_REPLAY_FILE_INFO_BSON command can be used to get information about a Replay File - including the parse result. PCAP Capture Files can be uploaded to the L47 chassis using FTP. The ‘root’ location of Capture Files uploaded manually by the user is /var/ftp/pub/replay/pcap/. Three subdirectories exist: cache/, user/ and xena/. cache / and xena/ is used by Vulcan Manager, and user/ is intended for manual upload and parsing of Capture Files. A similar directory structure is present for Replay Files generated by the parsing, and the ‘root’ location is /var/ftp/pub/replay/bson/.

set(filename)[source]

Start parsing an uploaded Capture File

Parameters:

filename (str) – filename (including relative path and excluding the ‘.pcap’ extension).

class M4_REPLAY_PARSE_STATE[source]

Bases: object

Only one Capture File can be parsed at a time. This command returns the state of the parser, which can be PARSING or OFF. M4_REPLAY_PARSE_START command is only accepted when the parser state is OFF.

get()[source]

Get capture file parsing state.

Returns:

capture file parsing state

Return type:

M4_REPLAY_PARSE_STATE.GetDataAttr

class M4_REPLAY_PARSE_STOP[source]

Bases: object

Command to stop parsing a Capture File. Parsing of very large Capture Files may take several seconds, and may be aborted using this command. No parameters

set()[source]

Stop parsing a Capture File.

class M4_SYSTEMID[source]

Bases: object

Return the system identifier of a L47 module.

get()[source]

Get the system identifier of a L47 module.

Returns:

the system identifier of a L47 module.

Return type:

M4_SYSTEMID.GetDataAttr

class M4_SYSTEM_STATUS[source]

Bases: object

Returns the L47 module system status in a text string.

get()[source]

Get the L47 module system status in a text string

Returns:

the L47 module system status in a text string

Return type:

M4_SYSTEM_STATUS.GetDataAttr

class M4_SYSTEM_TIME[source]

Bases: object

Sets or returns the modules system time in UTC.

get()[source]

Get the modules system time in UTC.

Returns:

the modules system time in UTC.

Return type:

M4_SYSTEM_TIME.GetDataAttr

set(year, month, day, hour, minute, second)[source]

Set the modules system time in UTC.

Parameters:
  • year (int) – the year

  • month (int) – the month

  • day (int) – the day of the month

  • hour (int) – the hour

  • minute (int) – the minute

  • second (int) – the second

class M4_TIME[source]

Bases: object

Returns the module time in millisecond.

get()[source]

Get the module time in millisecond.

Returns:

the module time in millisecond.

Return type:

M4_TIME.GetDataAttr

class M4_TLS_CIPHER_SUITES[source]

Bases: object

Returns a list of supported TLS Cipher Suites.

get()[source]

Get a list of supported TLS Cipher Suites.

Returns:

list of IANA values of supported cipher suites

Return type:

M4_TLS_CIPHER_SUITES.GetDataAttr

class M4_VERSIONNO[source]

Bases: object

Returns a version string containing a combination of information regarding the software version and the build environment. The first part of the string is the software build version.

get()[source]

Get a version string containing a combination of information regarding the software version and the build environment.

Returns:

a version string containing a combination of information regarding the software version and the build environment

Return type:

M4_VERSIONNO.GetDataAttr