ssaoidnew(3snmp) [sunos man page]

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 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 encoun-
       tered, 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	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       attributes(5)

SunOS 5.10							    17 Dec 1996 						  SSAOidCmp(3SNMP)

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 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 encoun-
       tered, 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	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       attributes(5)

SunOS 5.10							    17 Dec 1996 						  SSAOidCmp(3SNMP)