ipsec_strerror()

Error messages for IPsec policy manipulation library

Synopsis:

#include <netinet6/ipsec.h>

const char *ipsec_strerror( void );

Library:

libipsec

Use the -l ipsec option to qcc to link against this library.

Description:

The ipsec_strerror() function obtains the error message for the last IPsec call that failed. If you program includes the declaration:

extern int ipsec_errcode;

you can access the error code from the IPsec policy manipulation library. You can use ipsec_strerror() to obtain the error message corresponding to the error code.

Returns:

A pointer to a C string.


Caution: Don't modify the string that this function returns. Since ipsec_strerror() uses strerror() as its underlying function, calling strerror() after calling ipsec_strerror() overwites or invalidates the return value from ipsec_strerror().

Examples:

See the example of ipsec_set_policy().

Classification:

Unix

Safety:
Cancellation point No
Interrupt handler Yes
Signal handler Yes
Thread No

See also:

IPsec, ipsec_dump_policy(), ipsec_get_policylen(), ipsec_set_policy()

setkey in the Utilities Reference