ipsec_strerror(3)

ipsec_strerror3

Error messages for the ipsec policy manipulation library

Usage

#include <netipsec/ipsec.h>

const char *

ipsec_strerror();

Overview

⟨netipsec/ipsec.h⟩ declares

extern int ipsec_errcode;

which is used to pass an error code from IPsec policy manipulation library to a user program. The ipsec_strerror() function can be used to obtain the error message string for the error code.

The array pointed to is not to be modified by the program. Since ipsec_strerror() uses strerror(3) as an underlying function, calling strerror(3) after ipsec_strerror() would overwrite the return value from ipsec_strerror() and make it invalid.

Return values

The ipsec_strerror() function always returns a pointer to C string. The C string must not be overwritten by the caller.

Releases

70 releases since FreeBSD 4.0-RELEASE; the text changed 43 times.

  1. 4.0
  2. 4.1–4.2
  3. 4.3
  4. 4.4
  5. 4.5
  6. 4.6–4.11
  7. 5.0
  8. 5.1
  9. 5.2–5.4
  10. 5.5
  11. 6.0
  12. 6.1–6.3
  13. 6.4
  14. 7.0
  15. 7.1
  16. 7.2
  17. 7.3
  18. 7.4
  19. 8.0
  20. 8.1
  21. 8.2
  22. 8.3
  23. 8.4
  24. 9.0
  25. 9.1
  26. 9.2
  27. 9.3
  28. 10.0
  29. 10.1
  30. 10.2
  31. 10.3
  32. 10.4
  33. 11.0
  34. 11.1
  35. 11.2
  36. 11.3
  37. 11.4
  38. 12.0
  39. 12.1
  40. 12.2
  41. 12.3
  42. 12.4
  43. 13.0–13.2
  44. 13.3–16.0

History

The ipsec_strerror() function first appeared in WIDE/KAME IPv6 protocol stack kit.

Bugs

The ipsec_strerror() function will return its result which may be overwritten by subsequent calls.

ipsec_errcode is not thread safe.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.