Go to main content

man pages section 3: Extended Library Functions, Volume 4

Exit Print View

Updated: July 2017
 
 

SSAOidString(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 function 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 message 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 memory 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 Also

attributes(5)