Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
SNMP Library FunctionsSSAOidCmp(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 TYPEATTRIBUTE VALUE
MT-LevelUnsafe

SEE ALSO

 

attributes(5)


SunOS 5.9Go To TopLast Changed 17 Dec 1996

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.