netmgt_save_request manual page
Table of Contents

NAME

netmgt_save_request, netmgt_restore_request - save and restore current request state

SYNOPSIS

bool_t
netmgt_save_request (request_info)
Netmgt_request *request_info;
bool_t
netmgt_restore_request (request_info)
Netmgt_request *request_info;

DESCRIPTION

netmgt_save_request copies information about the current request state into the buffer pointed to by `request_info'.

netmgt_restore_request sets the current request state from the contents of the buffer pointed to by `request_info'.

typedef struct
{

struct in_addr manager_addr ;
/* manager IP address */
struct timeval request_time ;
/* request timestamp */
u_int type ;
/* request type */
u_int manager_id ;
/* manager ID */
u_int flags ;
/* request flags */
u_int priority ;
/* request priority */
struct in_addr rendez_addr ;
/* rendezvous IP address */
u_long rendez_prog ;
/* rendezvous RPC program number */
u_long rendez_vers ;
/* rendezvous RPC version number */
u_long proto;
/* transport protocol */
struct timeval interval ;
/* reporting interval */
u_int count ;
/* reporting count */
char system [NETMGT_NAMESIZ] ;
/* system */
char group [NETMGT_NAMESIZ] ;
/* group */
char key [NETMGT_NAMESIZ] ;
/* key */
u_int num_arguments ;
/* number of optional arguments */
u_int num_thresholds ;
/* number of event thresholds or data attributes */
u_int num_setvals ;
/* number of set arguments */
}
Netmgt_request ;

The members of this structure are:

manager_addr
IP address of manager that sent the request

request_time
Time when the manager sent the request

type Request type. See netmgt_arglist.h
manager_id
ID of the manager that sent the request

flags
Request flags. See netmgt_msg.h and netmgt_request.h

priority
Request priority (currently unused)

rendez_addr
IP address of report rendezvous

rendez_prog
RPC program number of report rendezvous

rendez_vers
RPC version number of report rendezvous

proto
Transport protocol used to send the request (either IPPROTO_UDP or IPPROTO_TCP)

interval
Report interval

count
Report count

system
Target system name

group
Schema group if a data or event request

key Table key if a data or event request for tabular group

num_arguments
Number of optional arguments

num_thresholds
Number of thresholds if an event request or number of attributes in case of a data request

num_setvals
Number of set arguments if a set request

RETURN VALUE

TRUE if successful, otherwise FALSE.

DIAGNOSTICS

If false is returned, global variable netmgt_errno indicates the error. The caller can get the reason for the error with netmgt_fetch_error(3n).

FILES

netmgt_arglist.h, netmgt_msg.h, netmgt_request.h

SEE ALSO

netmgt_fetch_error(3n),
netmgt_save_argument(3n), netmgt_save_threshold(3n)

NOTES

Only agents may call this function.


Table of Contents