netmgt_fetch_setval manual page
Table of Contents

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)


Table of Contents