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

SEE ALSO

netmgt_set_value(3N), netmgt_request_set(3N), netmgt_fetch_error(3N)