NAME

netmgt_fetch_argument - fetch a request argument

SYNOPSIS

bool_t

netmgt_fetch_argument(argname, arg)
        char            * argname;
        Netmgt_arg      * arg;

DESCRIPTION

netmgt_fetch_argument gets the optional request argument that corresponds with argname. The information is returned in the buffer pointed to by arg. If no argument with name argname exists in the options list, an error is returned.

INPUT ARGUMENTS

argname

        argument name. The two supplied manager applications snm(1) and
        snm_cmd(1) tag their arguments with an argname of NETMGT_OPTSTRING
        (defined in netmgt_arglist.h). The agent should use this value.

arg

pointer to a structure that gets filled in with the following fields:

name

argument name. The agent can use this value to verify it got what it requested.

type

argument type code, as defined in the header file netmgt_arglist.h.

length

length (in bytes) of the argument value.

value

pointer to the 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)