kiconv(3)

kiconv3

Kernel side iconv library

Usage

#include <sys/iconv.h>

int

kiconv_add_xlat16_cspair(const char *tocode, const char *fromcode, int flag);

int

kiconv_add_xlat16_cspairs(const char *foreigncode, const char *localcode);

int

kiconv_add_xlat16_table(const char *tocode, const char *fromcode, const void *data, int datalen);

Library

library “libkiconv”

Overview

The kiconv library provides multi-byte character conversion tables for kernel side iconv service.

The kiconv_add_xlat16_cspair() function defines a conversion table using iconv(3) between fromcode charset and tocode charset. You can specify flag to determine if tolower(3) / toupper(3) conversion is included in the table. The flag has following values.

KICONV_LOWER
KICONV_FROM_LOWER

It generates a tolower table in addition to a character conversion table. The difference between two is tolower tocode or tolower fromcode.

KICONV_UPPER
KICONV_FROM_UPPER

It generates a toupper table in addition to a character conversion table. The difference between two is toupper tocode or toupper fromcode.

A tolower/toupper conversion is limited to single-byte characters.

The kiconv_add_xlat16_cspairs() function defines two conversion tables which are from localcode to foreigncode and from foreigncode to localcode. These conversion tables also contain both tolower and toupper tables.

The kiconv_add_xlat16_table() function defines a conversion table directly pointed by data whose length is datalen, not using iconv(3).

Releases

54 releases since FreeBSD 5.2-RELEASE; the text changed 33 times.

  1. 5.2–5.2.1
  2. 5.3–6.3
  3. 6.4
  4. 7.0
  5. 7.1
  6. 7.2
  7. 7.3
  8. 7.4
  9. 8.0
  10. 8.1
  11. 8.2
  12. 8.3
  13. 8.4
  14. 9.0
  15. 9.1
  16. 9.2
  17. 9.3
  18. 10.0
  19. 10.1
  20. 10.2
  21. 10.3
  22. 10.4
  23. 11.0
  24. 11.1
  25. 11.2
  26. 11.3
  27. 11.4
  28. 12.0
  29. 12.1
  30. 12.2
  31. 12.3
  32. 12.4
  33. 13.0–13.2
  34. 13.3–16.0

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