| .TH "snmp_session" 3 "31 May 2012" "Version 5.5.2.rc2" "net-snmp" \" -*- nroff -*- |
| .ad l |
| .nh |
| .SH NAME |
| snmp_session \- |
| .PP |
| The snmp session structure. |
| |
| .SH SYNOPSIS |
| .br |
| .PP |
| .PP |
| \fC#include <types.h>\fP |
| .SS "Data Fields" |
| |
| .in +1c |
| .ti -1c |
| .RI "long \fBversion\fP" |
| .br |
| .RI "\fIsnmp version \fP" |
| .ti -1c |
| .RI "int \fBretries\fP" |
| .br |
| .RI "\fINumber of retries before timeout. \fP" |
| .ti -1c |
| .RI "long \fBtimeout\fP" |
| .br |
| .RI "\fINumber of uS until first timeout, then exponential backoff. \fP" |
| .ti -1c |
| .RI "u_long \fBflags\fP" |
| .br |
| .ti -1c |
| .RI "struct \fBsnmp_session\fP * \fBsubsession\fP" |
| .br |
| .ti -1c |
| .RI "struct \fBsnmp_session\fP * \fBnext\fP" |
| .br |
| .ti -1c |
| .RI "char * \fBpeername\fP" |
| .br |
| .RI "\fIname or address of default peer (may include transport specifier and/or port number) \fP" |
| .ti -1c |
| .RI "u_short \fBremote_port\fP" |
| .br |
| .RI "\fIUDP port number of peer. \fP" |
| .ti -1c |
| .RI "char * \fBlocalname\fP" |
| .br |
| .RI "\fIMy Domain name or dotted IP address, 0 for default. \fP" |
| .ti -1c |
| .RI "u_short \fBlocal_port\fP" |
| .br |
| .RI "\fIMy UDP port number, 0 for default, picked randomly. \fP" |
| .ti -1c |
| .RI "u_char *(* \fBauthenticator\fP )(u_char *, size_t *, u_char *, size_t)" |
| .br |
| .RI "\fIAuthentication function or NULL if null authentication is used. \fP" |
| .ti -1c |
| .RI "netsnmp_callback \fBcallback\fP" |
| .br |
| .RI "\fIFunction to interpret incoming data. \fP" |
| .ti -1c |
| .RI "void * \fBcallback_magic\fP" |
| .br |
| .RI "\fIPointer to data that the callback function may consider important. \fP" |
| .ti -1c |
| .RI "int \fBs_errno\fP" |
| .br |
| .RI "\fIcopy of system errno \fP" |
| .ti -1c |
| .RI "int \fBs_snmp_errno\fP" |
| .br |
| .RI "\fIcopy of library errno \fP" |
| .ti -1c |
| .RI "long \fBsessid\fP" |
| .br |
| .RI "\fISession id - AgentX only. \fP" |
| .ti -1c |
| .RI "u_char * \fBcommunity\fP" |
| .br |
| .RI "\fIcommunity for outgoing requests. \fP" |
| .ti -1c |
| .RI "size_t \fBcommunity_len\fP" |
| .br |
| .RI "\fILength of community name. \fP" |
| .ti -1c |
| .RI "size_t \fBrcvMsgMaxSize\fP" |
| .br |
| .RI "\fILargest message to try to receive. \fP" |
| .ti -1c |
| .RI "size_t \fBsndMsgMaxSize\fP" |
| .br |
| .RI "\fILargest message to try to send. \fP" |
| .ti -1c |
| .RI "u_char \fBisAuthoritative\fP" |
| .br |
| .RI "\fIare we the authoritative engine? \fP" |
| .ti -1c |
| .RI "u_char * \fBcontextEngineID\fP" |
| .br |
| .RI "\fIauthoritative snmpEngineID \fP" |
| .ti -1c |
| .RI "size_t \fBcontextEngineIDLen\fP" |
| .br |
| .RI "\fILength of contextEngineID. \fP" |
| .ti -1c |
| .RI "u_int \fBengineBoots\fP" |
| .br |
| .RI "\fIinitial engineBoots for remote engine \fP" |
| .ti -1c |
| .RI "u_int \fBengineTime\fP" |
| .br |
| .RI "\fIinitial engineTime for remote engine \fP" |
| .ti -1c |
| .RI "char * \fBcontextName\fP" |
| .br |
| .RI "\fIauthoritative contextName \fP" |
| .ti -1c |
| .RI "size_t \fBcontextNameLen\fP" |
| .br |
| .RI "\fILength of contextName. \fP" |
| .ti -1c |
| .RI "u_char * \fBsecurityEngineID\fP" |
| .br |
| .RI "\fIauthoritative snmpEngineID \fP" |
| .ti -1c |
| .RI "size_t \fBsecurityEngineIDLen\fP" |
| .br |
| .RI "\fILength of contextEngineID. \fP" |
| .ti -1c |
| .RI "char * \fBsecurityName\fP" |
| .br |
| .RI "\fIon behalf of this principal \fP" |
| .ti -1c |
| .RI "size_t \fBsecurityNameLen\fP" |
| .br |
| .RI "\fILength of securityName. \fP" |
| .ti -1c |
| .RI "oid * \fBsecurityAuthProto\fP" |
| .br |
| .RI "\fIauth protocol oid \fP" |
| .ti -1c |
| .RI "size_t \fBsecurityAuthProtoLen\fP" |
| .br |
| .RI "\fILength of auth protocol oid. \fP" |
| .ti -1c |
| .RI "u_char \fBsecurityAuthKey\fP [USM_AUTH_KU_LEN]" |
| .br |
| .RI "\fIKu for auth protocol XXX. \fP" |
| .ti -1c |
| .RI "size_t \fBsecurityAuthKeyLen\fP" |
| .br |
| .RI "\fILength of Ku for auth protocol. \fP" |
| .ti -1c |
| .RI "u_char * \fBsecurityAuthLocalKey\fP" |
| .br |
| .RI "\fIKul for auth protocol. \fP" |
| .ti -1c |
| .RI "size_t \fBsecurityAuthLocalKeyLen\fP" |
| .br |
| .RI "\fILength of Kul for auth protocol XXX. \fP" |
| .ti -1c |
| .RI "oid * \fBsecurityPrivProto\fP" |
| .br |
| .RI "\fIpriv protocol oid \fP" |
| .ti -1c |
| .RI "size_t \fBsecurityPrivProtoLen\fP" |
| .br |
| .RI "\fILength of priv protocol oid. \fP" |
| .ti -1c |
| .RI "u_char \fBsecurityPrivKey\fP [USM_PRIV_KU_LEN]" |
| .br |
| .RI "\fIKu for privacy protocol XXX. \fP" |
| .ti -1c |
| .RI "size_t \fBsecurityPrivKeyLen\fP" |
| .br |
| .RI "\fILength of Ku for priv protocol. \fP" |
| .ti -1c |
| .RI "u_char * \fBsecurityPrivLocalKey\fP" |
| .br |
| .RI "\fIKul for priv protocol. \fP" |
| .ti -1c |
| .RI "size_t \fBsecurityPrivLocalKeyLen\fP" |
| .br |
| .RI "\fILength of Kul for priv protocol XXX. \fP" |
| .ti -1c |
| .RI "int \fBsecurityModel\fP" |
| .br |
| .RI "\fIsnmp security model, v1, v2c, usm \fP" |
| .ti -1c |
| .RI "int \fBsecurityLevel\fP" |
| .br |
| .RI "\fInoAuthNoPriv, authNoPriv, authPriv \fP" |
| .ti -1c |
| .RI "char * \fBparamName\fP" |
| .br |
| .RI "\fItarget param name \fP" |
| .ti -1c |
| .RI "void * \fBsecurityInfo\fP" |
| .br |
| .RI "\fIsecurity \fBmodule\fP specific \fP" |
| .ti -1c |
| .RI "void * \fBmyvoid\fP" |
| .br |
| .RI "\fIuse as you want data \fP" |
| .in -1c |
| .SH "Detailed Description" |
| .PP |
| The snmp session structure. |
| .PP |
| Definition at line 287 of file types.h. |
| .SH "Field Documentation" |
| .PP |
| .SS "u_char*(* \fBsnmp_session::authenticator\fP)(u_char *, size_t *, u_char *, size_t)" |
| .PP |
| Authentication function or NULL if null authentication is used. |
| .SS "netsnmp_callback \fBsnmp_session::callback\fP" |
| .PP |
| Function to interpret incoming data. |
| .PP |
| Definition at line 314 of file types.h. |
| .SS "void* \fBsnmp_session::callback_magic\fP" |
| .PP |
| Pointer to data that the callback function may consider important. |
| .PP |
| Definition at line 318 of file types.h. |
| .SS "u_char* \fBsnmp_session::community\fP" |
| .PP |
| community for outgoing requests. |
| .PP |
| Definition at line 330 of file types.h. |
| .SS "size_t \fBsnmp_session::community_len\fP" |
| .PP |
| Length of community name. |
| .PP |
| Definition at line 332 of file types.h. |
| .SS "u_char* \fBsnmp_session::contextEngineID\fP" |
| .PP |
| authoritative snmpEngineID |
| .PP |
| Definition at line 344 of file types.h. |
| .SS "size_t \fBsnmp_session::contextEngineIDLen\fP" |
| .PP |
| Length of contextEngineID. |
| .PP |
| Definition at line 346 of file types.h. |
| .SS "char* \fBsnmp_session::contextName\fP" |
| .PP |
| authoritative contextName |
| .PP |
| Definition at line 352 of file types.h. |
| .SS "size_t \fBsnmp_session::contextNameLen\fP" |
| .PP |
| Length of contextName. |
| .PP |
| Definition at line 354 of file types.h. |
| .SS "u_int \fBsnmp_session::engineBoots\fP" |
| .PP |
| initial engineBoots for remote engine |
| .PP |
| Definition at line 348 of file types.h. |
| .SS "u_int \fBsnmp_session::engineTime\fP" |
| .PP |
| initial engineTime for remote engine |
| .PP |
| Definition at line 350 of file types.h. |
| .SS "u_char \fBsnmp_session::isAuthoritative\fP" |
| .PP |
| are we the authoritative engine? |
| .PP |
| Definition at line 342 of file types.h. |
| .SS "u_short \fBsnmp_session::local_port\fP" |
| .PP |
| My UDP port number, 0 for default, picked randomly. |
| .PP |
| Definition at line 308 of file types.h. |
| .SS "char* \fBsnmp_session::localname\fP" |
| .PP |
| My Domain name or dotted IP address, 0 for default. |
| .PP |
| Definition at line 306 of file types.h. |
| .SS "void* \fBsnmp_session::myvoid\fP" |
| .PP |
| use as you want data used by 'SNMP_FLAGS_RESP_CALLBACK' handling in the agent XXX: or should we add a new field into this structure? |
| .PP |
| Definition at line 408 of file types.h. |
| .SS "char* \fBsnmp_session::paramName\fP" |
| .PP |
| target param name |
| .PP |
| Definition at line 395 of file types.h. |
| .SS "char* \fBsnmp_session::peername\fP" |
| .PP |
| name or address of default peer (may include transport specifier and/or port number) |
| .PP |
| Definition at line 302 of file types.h. |
| .SS "size_t \fBsnmp_session::rcvMsgMaxSize\fP" |
| .PP |
| Largest message to try to receive. |
| .PP |
| Definition at line 334 of file types.h. |
| .SS "u_short \fBsnmp_session::remote_port\fP" |
| .PP |
| UDP port number of peer. (NO LONGER USED - USE peername INSTEAD) |
| .PP |
| Definition at line 304 of file types.h. |
| .SS "int \fBsnmp_session::retries\fP" |
| .PP |
| Number of retries before timeout. |
| .PP |
| Definition at line 294 of file types.h. |
| .SS "int \fBsnmp_session::s_errno\fP" |
| .PP |
| copy of system errno |
| .PP |
| Definition at line 320 of file types.h. |
| .SS "int \fBsnmp_session::s_snmp_errno\fP" |
| .PP |
| copy of library errno |
| .PP |
| Definition at line 322 of file types.h. |
| .SS "u_char \fBsnmp_session::securityAuthKey\fP[USM_AUTH_KU_LEN]" |
| .PP |
| Ku for auth protocol XXX. |
| .PP |
| Definition at line 369 of file types.h. |
| .SS "size_t \fBsnmp_session::securityAuthKeyLen\fP" |
| .PP |
| Length of Ku for auth protocol. |
| .PP |
| Definition at line 371 of file types.h. |
| .SS "u_char* \fBsnmp_session::securityAuthLocalKey\fP" |
| .PP |
| Kul for auth protocol. |
| .PP |
| Definition at line 373 of file types.h. |
| .SS "size_t \fBsnmp_session::securityAuthLocalKeyLen\fP" |
| .PP |
| Length of Kul for auth protocol XXX. |
| .PP |
| Definition at line 375 of file types.h. |
| .SS "oid* \fBsnmp_session::securityAuthProto\fP" |
| .PP |
| auth protocol oid |
| .PP |
| Definition at line 365 of file types.h. |
| .SS "size_t \fBsnmp_session::securityAuthProtoLen\fP" |
| .PP |
| Length of auth protocol oid. |
| .PP |
| Definition at line 367 of file types.h. |
| .SS "u_char* \fBsnmp_session::securityEngineID\fP" |
| .PP |
| authoritative snmpEngineID |
| .PP |
| Definition at line 356 of file types.h. |
| .SS "size_t \fBsnmp_session::securityEngineIDLen\fP" |
| .PP |
| Length of contextEngineID. |
| .PP |
| Definition at line 358 of file types.h. |
| .SS "void* \fBsnmp_session::securityInfo\fP" |
| .PP |
| security \fBmodule\fP specific |
| .PP |
| Definition at line 400 of file types.h. |
| .SS "int \fBsnmp_session::securityLevel\fP" |
| .PP |
| noAuthNoPriv, authNoPriv, authPriv |
| .PP |
| Definition at line 393 of file types.h. |
| .SS "int \fBsnmp_session::securityModel\fP" |
| .PP |
| snmp security model, v1, v2c, usm |
| .PP |
| Definition at line 391 of file types.h. |
| .SS "char* \fBsnmp_session::securityName\fP" |
| .PP |
| on behalf of this principal |
| .PP |
| Definition at line 360 of file types.h. |
| .SS "size_t \fBsnmp_session::securityNameLen\fP" |
| .PP |
| Length of securityName. |
| .PP |
| Definition at line 362 of file types.h. |
| .SS "u_char \fBsnmp_session::securityPrivKey\fP[USM_PRIV_KU_LEN]" |
| .PP |
| Ku for privacy protocol XXX. |
| .PP |
| Definition at line 382 of file types.h. |
| .SS "size_t \fBsnmp_session::securityPrivKeyLen\fP" |
| .PP |
| Length of Ku for priv protocol. |
| .PP |
| Definition at line 384 of file types.h. |
| .SS "u_char* \fBsnmp_session::securityPrivLocalKey\fP" |
| .PP |
| Kul for priv protocol. |
| .PP |
| Definition at line 386 of file types.h. |
| .SS "size_t \fBsnmp_session::securityPrivLocalKeyLen\fP" |
| .PP |
| Length of Kul for priv protocol XXX. |
| .PP |
| Definition at line 388 of file types.h. |
| .SS "oid* \fBsnmp_session::securityPrivProto\fP" |
| .PP |
| priv protocol oid |
| .PP |
| Definition at line 378 of file types.h. |
| .SS "size_t \fBsnmp_session::securityPrivProtoLen\fP" |
| .PP |
| Length of priv protocol oid. |
| .PP |
| Definition at line 380 of file types.h. |
| .SS "long \fBsnmp_session::sessid\fP" |
| .PP |
| Session id - AgentX only. |
| .PP |
| Definition at line 324 of file types.h. |
| .SS "size_t \fBsnmp_session::sndMsgMaxSize\fP" |
| .PP |
| Largest message to try to send. |
| .PP |
| Definition at line 336 of file types.h. |
| .SS "long \fBsnmp_session::timeout\fP" |
| .PP |
| Number of uS until first timeout, then exponential backoff. |
| .PP |
| Definition at line 296 of file types.h. |
| .SS "long \fBsnmp_session::version\fP" |
| .PP |
| snmp version |
| .PP |
| Definition at line 292 of file types.h. |
| |
| .SH "Author" |
| .PP |
| Generated automatically by Doxygen for net-snmp from the source code. |