NUTSCAN_ADD_OPTION_T(3)

NAME
nutscan_add_option_to_device - Add option data to the specified device.

SYNOPSIS

#include <nut-scan.h>

void nutscan_add_option_to_device(
       nutscan_device_t * device,
       char * option_name,
       char * value);

DESCRIPTION

The nutscan_device_t contains the following variables:

    nutscan_device_type_t   type;
    char *          driver;
    char *          port;
    nutscan_options_t       opt;
    struct nutscan_device * prev;
    struct nutscan_device * next;

This is a double linked list of device. Each device is described by its type, its driver name, its port and any number of optional data.

The nutscan_add_option_to_device() adds an optional data in the given device. Optional data are made of an option_name and an associated value. Copies of option_name and value are stored in the device, so the caller can safely free both of the original strings used as arguments.

Such options and their values may be further sanity-checked and reported as warnings by nutscan_display_sanity_check() dispatcher and its related methods which implement the logic of particular checks. This is used for example when generating ups.conf file content suggestions with nutscan_display_ups_conf_with_sanity_check() method.

NOTES

Technically, the function is currently defined in nutscan-device.h file.

SEE ALSO

nutscan_scan_usb(3), nutscan_scan_xml_http_range(3), nutscan_scan_nut(3), nutscan_scan_avahi(3), nutscan_scan_ipmi(3), nutscan_scan_snmp(3), nutscan_display_sanity_check(3), nutscan_display_sanity_check_serial(3), nutscan_display_ups_conf_with_sanity_check(3), nutscan_display_ups_conf(3), nutscan_display_parsable(3), nutscan_new_device(3), nutscan_free_device(3), nutscan_add_device_to_device(3)