SSAOidCmp(3SNMP) SNMP Library Functions SSAOidCmp(3SNMP)NAME
SSAOidCmp, SSAOidCpy, SSAOidDup, SSAOidFree, SSAOidInit, SSAOidNew,
SSAOidString, SSAOidStrToOid, SSAOidZero - Sun Solstice Enterprise
Agent OID helper functions
SYNOPSIS
cc [ flag ... ] file ... -lssasnmp [ library .. ]
#include <impl.h>
int SSAOidCmp(Oid *oid1, Oid *oid2);
int SSAOidCpy(Oid *oid1, Oid *oid2, char *error_label);
Oid *SSAOidDup(Oid *oid, char *error_label);
void SSAOidFree(Oid *oid);
int SSAOidInit(Oid *oid, Subid *subids, int len, char *error_label);
Oid *SSAOidNew();
char *SSAOidString(Oid *oid);
Oid *SSAOidStrToOid(char* name, char *error_label);
void SSAOidZero(Oid *oid);
DESCRIPTION
The SSAOidCmp() function performs a comparison of the given OIDs. This
function returns:
0 if oid1 is equal to oid2
1 if oid1 is greater than oid2
−1 if oid1 is less than oid2
The SSAOidCpy() function makes a deep copy of oid2 to oid1. This func‐
tion assumes oid1 has been processed by the SSAOidZero() function.
Memory is allocated inside oid1 and the contents of oid2, not just the
pointer, is copied to oid1. If an error is encountered, an error mes‐
sage is stored in the error_label buffer.
The SSAOidDup() function returns a clone of oid, by using the deep
copy. Error information is stored in the error_label buffer.
The SSAOidFree() function frees the OID instance, with its content.
The SSAOidNew() function returns a new OID.
The SSAOidInit() function copies the Subid array from subids to the OID
instance with the specified length len. This function assumes that the
OID instance has been processed by the SSAOidZero() function or no mem‐
ory is allocated inside the OID instance. If an error is encountered,
an error message is stored in the error_label buffer.
The SSAOidString() function returns a char pointer for the printable
form of the given oid.
The SSAOidStrToOid() function returns a new OID instance from name. If
an error is encountered, an error message is stored in the error_label
buffer.
The SSAOidZero() function frees the memory used by the OID object for
buffers, but not the OID instance itself.
RETURN VALUES
The SSAOidNew() and SSAOidStrToOid() functions return 0 if an error is
detected.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Obsolete │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │Unsafe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOattributes(5)SunOS 5.11 30 Apr 2006 SSAOidCmp(3SNMP)