NAME
netmgt_fetch_setval - fetch set request argument
SYNOPSIS
bool_t
netmgt_fetch_setval(setval)
Netmgt_setval *setval;
DESCRIPTION
netmgt_fetch_setval gets the next set request argument from a set request and places it into a local buffer pointed to by setval. When an agent receives a set request, the first call to this function gets the first set request argument in the request. Successive calls get successive arguments.
The string NETMGT_ENDOFARGS marks the end of the request arguments. This string is defined in netmgt_arglist.h. The caller can repeatedly call this function until NETMGT_ENDOFARGS is seen.
INPUT ARGUMENTS
setval
pointer to a buffer where individual set request arguments are placed. It has the following fields:
group
name of the group or table containing the attribute to set.
key table key. A key is only required when setting an attribute in one row of a table.
name attribute name.
type argument type code, as defined in netmgt_arglist.h.
length
length of the argument value, in bytes.
value
argument value buffer. The value's internal representation is described by type.
RETURN VALUE
TRUE if successful, otherwise FALSE.
DIAGNOSTICS
If FALSE is returned, global variable netmgt_error indicates the error. The caller can get the reason for the error with netmgt_fetch_error(3n).
FILES
netmgt_arglist.h