First created at:						9/6/2007
Last updated at:						9/6/2007

Uconv functions at libc
-----------------------

OVERVIEW

PSARC/2005/446 introduced six Unicode enconding conversion functions at
the kernel as Consolidation Private interfaces and then PSARC/2007/038 updated
the interface stability to Committed.

Based on the requirement from CIFS Server project team, this project proposes
to make the same functions also available at the user space and in particular
at libc.

The user land interfaces proposed will provide the same functionalities
as the kernel functions have and the man page is also pretty much the same
as shown at [1]. The only differences are man page section name changes and
such minor editorial changes to make the section 9F man page into
the section 3C man page. The function prototypes will be listed in a user land
specific header file, <sys/u8_textprep.h>.


INTERFACE STABILITY AND RELEASE BINDING

There is no notable imported interfaces. The following are the exported
interfaces:

	Interface		Stability		Reference

	uconv_u16tou32(),	Committed		[1]
	uconv_u16tou8(),
	uconv_u32tou16(),
	uconv_u32tou8(),
	uconv_u8tou16(),
	uconv_u8tou32()

	UCONV_* macros		Committed		[1]

	<sys/u8_textprep.h>	Committed		A header file that has
							function prototypes
							and macros.

The project team asks for Micro/Patch release binding.


REFERENCES

[1] A man page at the case directory in flat text file:
    materials/uconv_functions.3c
[2] The Unicode standard:
    http://www.unicode.org/standard/standard.html