Creating a Custom Configuration File - UG1739

If none of the sample configuration files meet your needs, you can instead create your own custom configuration file.

Configuration files use a simple INI file format:

• Each parameter-value pair is a single line, with ‘=’ used as the delimiter.
• Parameters must be grouped under labeled sections enclosed in square brackets. For example:

  [global]

  Currently all content must be in a single [global] section.
• Any line beginning with a semi-colon is treated as a comment.
• Line endings can be LF or CR/LF.
• The file must use only the 7 bit ASCII subset of UTF-8.
• The maximum size of the file is 4 KB.

To create a configuration file, do one of the following:

• Get the current configuration (see Getting the Current Configuration) and save it to a file. For example:

  # mkdir -p /usr/lib/firmware/x4-config
  # devlink health diagnose pci/0000:e1:00.0 reporter nvcfg-active \
            | sudo tee /usr/lib/firmware/x4-config/active.ini

  Then edit the file to make the changes you require.

• Copy the sample_template.ini from the sample configuration files. This has all available parameters present but commented out. Uncomment the parameters you require and set their values.
• Create a new file using a text editor.