TsctlSystemMapAddDesc

The System object provides a "Map" which associates string names to integer values. This is used to store DIO names, attributes, and other information. This information is automatically populated by reading /etc/dioctl.config at startup.

This function adds the specified string:value mapping to the system mapping table. If the given string already has it value in the mapping it will be replaced by the new value. A positive values is returned on success. The string str is internally copied, so the caller is responsible for freeing it as needed.

Note: When invoked in direct mode (i.e. with no host argument and no tsctl server running locally) the System Map does not persist after the current invocation of tsctl and so any additions to the default Map will be lost.