Configuration Stream

Reference Documentation

Napatech SmartNIC
Reference Information

Configuration streams are used to read and write configuration data and to set the filter configuration using NTPL commands. This includes everything that can be changed on the fly. All static configuration is done in the ntservice.ini file.

All configuration parameters are organized in a parameter tree structure NtConfig_t where some parameters are read only (static configuration parameters) and some parameters are read and write (dynamic configuration parameters).

To open a configuration stream call NT_ConfigOpen. Once the configuration stream is open use NT_ConfigRead and NT_ConfigWrite with the NtConfig_t structure to retrieve and change the configuration. When done, call NT_ConfigClose to close the stream.


Changing a configuration setting will trigger an NT_EVENT_SOURCE_CONFIG when the changes have been made.

The configuration parameter types currently supported are:
  • Port settings - retrieves or changes link speed, IFG, MDI mode

  • Time stamp type Retrieves or changes time stamp configuration

  • Time synchronization Retrieves or changes time synchronization configuration

  • Sensor min/max alarm settings Retrieves or changes sensor min/max alarm limits configuration

  • Coordinated time synchronized transmit Sets the coordinated time synchronized transmit configuration

To set up or change filter configuration using NTPL commands use the NT_NTPL function call on an open configuration stream. For a complete description of the NTPL syntax see NTPL Overview.

For an example of using the configuration stream see config/config_example.c.


The config stream is not thread-safe. If the same stream handle is to be used by multiple threads, it must be mutex protected in the application.