Tribblix: manual page: getipsecprotobyname.3nsl

GETIPSECPROTOBYNAME(3NSL) Networking Services Library Functions

NAME

getipsecprotobyname, getipsecprotobynum - query IPsec protocols
entries

SYNOPSIS

cc -flag ... file ...-lnsl [ -library ... ]
#include <netdb.h>

int getipsecprotobyname(const char *proto_name);

char *getipsecprotobynum(int proto_num);

DESCRIPTION

Use the getipsecprotobyname() and getipsecprotobynum() functions to
obtain the IPsec algorithm mappings that are defined by ipsecalgs(8).
You can also use the getipsecprotobyname() 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() function 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

proto_name
A pointer to the name of an IPsec protocol.

proto_num
A pointer to a protocol number.

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.