netmgt_set_argument manual page
Table of Contents

NAME

netmgt_set_argument - append an argument to the request

SYNOPSIS

bool_t
netmgt_set_argument(arg)
Netmgt_arg
*arg;

DESCRIPTION

 netmgt_set_argument specifies optional request arguments to be sent to the agent. arg points to the buffer that contains the request arguments.

These optional request arguments are agent - specific, for directing the agent to perform actions not accounted for by the standard request mechanisms. For example, the na.ping(8) agent uses them to set packet size, time to wait for echo replies, etc.

INPUT ARGUMENTS

arg pointer to a structure with the following fields:

name argument name. Since snm(1) and snm_cmd(1) use the argument string NETMGT_OPTSTRING (as defined in netmgt_arglist.h) and agents look for that string, other manager applications should use it as well, unless selected managers and agents have agreed to use different (or additional) argument strings.

type argument type code, as defined in netmgt_arglist.h. Again, to be compatible with snm(1), snm_cmd(1) and the supplied agents, you should use NETMGT_STRING.

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_fetch_error(3n)

Table of Contents