mstflint

Iniparser is a lightweight C library designed for parsing .ini files. It is highly portable and suitable for embedded or constrained environments.

Key characteristics:

• Small footprint: Approximately 1500 source lines of code across 4 files (2 .c and 2 .h).
• Portable: Written in -ansi -pedantic C89 with no external dependencies.
• Thread-safe: The library is fully reentrant; to make it thread-safe in a multi-threaded application, simply wrap the library calls with a mutex.

The mstreg utility exposes supported access registers on a Mellanox device. It allows users to inspect register fields and attributes, as well as perform GET and SET operations on specific registers using names, IDs, or lengths. Operations can be targeted at specific MST devices using the -d or --device flag.

mstreg [OPTIONS]

mstflint is a tool used for firmware (FW) burning and flash memory operations on Mellanox Infiniband HCAs, Ethernet NIC cards, and switch devices.

Basic Syntax: MstFlint [OPTIONS] <command> [Parameters]

Commonly used options:

• -d | --device <device>: Specifies the device the flash is connected to. Affects all commands.
• -i | --image <image>: Specifies the binary image file. Affects burn and verify commands.
• -y | --yes: Non-interactive mode; automatically assumes "yes" to all prompts.
• -s | --silent: Suppresses the burn progress flyer during the burn command.
• -v | --version: Displays version information.

The mstlink tool is used to check and debug link status and issues related to links, including passive, active, transceiver, and backplane cables. It supports both NETWORK (default) and PCIE port types.

To perform operations on a specific device and port, use the -d (device) and -p (port) options.

mstlink -d <device> -p <port_number>

The mstflint SDK is a self-contained shared library (libmstflint_sdk.so) that provides a C API (using mst* function prefixes) for interacting with devices. It is designed as the mstflint equivalent to MFT's libmft_sdk.so.

Capabilities include:

• Device discovery
• HCA capability queries
• PRM register access
• CR-space access
• I2C access
• Telemetry

The library is self-contained; all mstflint dependencies (including mtcr) are linked statically. At runtime, it only requires standard system libraries such as libstdc++, liblzma, libexpat, and libc.

The current version of Iniparser is 4.1.

Warning: Version 4.0 introduced breaking changes to the API. If you are migrating from older versions (such as 3.1 or 3.2), you will need to update your code to match the new API. Legacy versions are available via repository tags.

When accessing or modifying Yaml::Node content, always use references (&) if you do not intend to make a copy. Modifying a copied node will not affect the original node. Copying a node is a slow operation if the node contains significant content.

Yaml::Node root;

// Use a reference to modify the original node
Yaml::Node & ref = root; 
ref["key"] = "value";

// Use a copy if you want to isolate changes (slow for large nodes)
Yaml::Node copy = root;
copy["key"] = "value"; // "root" remains unchanged

Depending on your requirements for library dependencies (MFT, MSTFLINT, or RDMA_CORE), use the following compilation commands:

# Example: Compile with MSTFLINT support
make WITH_MSTFLINT=yes [install]