Networking Services Library Functions   getipsecprotobyname(3NSL)



NAME
     getipsecprotobyname, getipsecprotobynum - query IPsec proto-
     cols entries

SYNOPSIS
     cc -flag ...  file ...-lnsl [ -library ... ]
     #include 



     int getipsecprotobyname(const char *protoname


     char *getipsecprotobynum(int protonump


DESCRIPTION
     Use the getipsecprotobyname() and getipsecprotobynum() func-
     tions  to  obtain  the  IPsec  algorithm  mappings  that are
     defined by ipsecalgs(1M). You can also use the  getipsecpro-
     tobyname() and getipsecprotobynum() functions in conjunction
     with getipsecalgbyname(3NSL) and  getipsecalgbynum(3NSL)  to
     obtain information about the supported IPsec algorithms. The
     IPsec algorithms and associated  protocol  name  spaces  are
     defined by RFC 2407.


     getipsecprotobyname() takes as an argument the  name  of  an
     IPsec protocol and returns its assigned protocol number. The
     character string returned by the getipsecprotobyname() func-
     tion  must  be  freed  by  the  called  when it is no longer
     needed.


     getipsecprotobynum() takes as an argument a protocol  number
     and returns the corresponding protocol name.


     The following protocol numbers are pre-defined:

     IPSECPROTOESP    Defines   the    encryption    algorithms
                        (transforms) that can be used by IPsec to
                        provide data confidentiality.


     IPSECPROTOAH     Defines  the  authentication   algorithms
                        (transforms) that can be used by IPsec to
                        provide authentication.


PARAMETERS




SunOS 5.11          Last change: 13 Aug 2003                    1






Networking Services Library Functions   getipsecprotobyname(3NSL)



     protoname    A pointer to the name of an IPsec protocol.


     protonum     A pointer to a protocol number. conditions.


RETURN VALUES
     The getipsecprotobyname() function returns a protocol number
     upon  success,  or  -1  if  the  protocol specified does not
     exist.


      The getipsecprotobynum() function returns a  protocol  name
     upon  success,  or  the  NUL  value  if the protocol number
     specified does not exist.

ATRIBUTES
     See attributes(5)  for descriptions of the following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsl (32 bit)            
                                  SUNWcslx (64 bit)           
    
     MT Level                     MT Safe                     
    
     Interface Stability          Evolving                    
    


SEE ALSO
     ipsecalgs(1M),                      getipsecalgbyname(3NSL),
     getipsecalgbyname(3NSL), attributes(5)


     Piper, D. RFC 2407,  The  Internet  IP  Security  Domain  of
     Interpretation  for ISAKMP. Network Working Group. November,
     1998.













SunOS 5.11          Last change: 13 Aug 2003                    2