Manual Pages for UNIX Operating System command usage for man getipsecprotobyname

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 *proto_name


     char *getipsecprotobynum(int proto_nump


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:

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


     IPSEC_PROTO_AH     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)



     proto_name    A pointer to the name of an IPsec protocol.


     proto_num     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  NULL  value  if the protocol number
     specified does not exist.

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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | system/library (32 bit)     |
    |                             | SUNWcslx (64 bit)           |
    |_____________________________|_____________________________|
    | MT Level                    | MT Safe                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


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