Manual Pages for UNIX Operating System command usage for man SSAOidCmp

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 



     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






SunOS 5.11          Last change: 30 Apr 2006                    1






SNMP Library Functions                           SSAOidCmp(3SNMP)



     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  mes-
     sage 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  attri-
     butes:








SunOS 5.11          Last change: 30 Apr 2006                    2






SNMP Library Functions                           SSAOidCmp(3SNMP)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Obsolete                    |
    |_____________________________|_____________________________|
    | MT-Level                    | Unsafe                      |
    |_____________________________|_____________________________|


SEE ALSO
     attributes(5)












































SunOS 5.11          Last change: 30 Apr 2006                    3