[glibc.git] / iconv / gconv_int.h

/* Copyright (C) 1997-2024 Free Software Foundation, Inc.
   This file is part of the GNU C Library.

   The GNU C Library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2.1 of the License, or (at your option) any later version.

   The GNU C Library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with the GNU C Library; if not, see
   <https://www.gnu.org/licenses/>.  */

#ifndef _GCONV_INT_H
#define _GCONV_INT_H	1

#include "gconv.h"
#include <stdlib.h>		/* For alloca used in macro below.  */
#include <ctype.h>		/* For __toupper_l used in macro below.  */
#include <string.h>		/* For strlen et al used in macro below.  */
#include <libc-lock.h>

__BEGIN_DECLS

/* We have to provide support for machines which are not able to handled
   unaligned memory accesses.  Some of the character encodings have
   representations with a fixed width of 2 or 4 bytes.  */
#define get16(addr)							\
({									\
  const struct { uint16_t r; } __attribute__ ((__packed__)) *__ptr	\
    = (__typeof(__ptr))(addr);						\
  __ptr->r;								\
})
#define get32(addr)							\
({									\
  const struct { uint32_t r; } __attribute__ ((__packed__)) *__ptr	\
    = (__typeof(__ptr))(addr);						\
  __ptr->r;								\
})

#define put16(addr, val)						\
do {									\
   struct { uint16_t r; } __attribute__ ((__packed__)) *__ptr		\
    = (__typeof(__ptr))(addr);						\
   __ptr->r = val;							\
} while (0)
#define put32(addr, val)						\
do {									\
   struct { uint32_t r; } __attribute__ ((__packed__)) *__ptr		\
    = (__typeof(__ptr))(addr);						\
   __ptr->r = val;							\
} while (0)

/* Structure for alias definition.  Simply two strings.  */
struct gconv_alias
{
  char *fromname;
  char *toname;
};


/* Structure describing one loaded shared object.  This normally are
   objects to perform conversation but as a special case the db shared
   object is also handled.  */
struct __gconv_loaded_object
{
  /* Name of the object.  It must be the first structure element.  */
  const char *name;

  /* Reference counter for the db functionality.  If no conversion is
     needed we unload the db library.  */
  int counter;

  /* The handle for the shared object.  */
  void *handle;

  /* Pointer to the functions the module defines.  */
  __gconv_fct fct;
  __gconv_init_fct init_fct;
  __gconv_end_fct end_fct;
};


/* Description for an available conversion module.  */
struct gconv_module
{
  const char *from_string;
  const char *to_string;

  int cost_hi;
  int cost_lo;

  const char *module_name;

  struct gconv_module *left;	/* Prefix smaller.  */
  struct gconv_module *same;	/* List of entries with identical prefix.  */
  struct gconv_module *right;	/* Prefix larger.  */
};


/* The specification of the conversion that needs to be performed.  */
struct gconv_spec
{
  char *fromcode;
  char *tocode;
  bool translit;
  bool ignore;
};

/* Flags for `gconv_open'.  */
enum
{
  GCONV_AVOID_NOCONV = 1 << 0
};

/* When GCONV_AVOID_NOCONV is set and no conversion is needed,
   __GCONV_NULCONV should be returned.  */
enum
{
  __GCONV_NULCONV = -1
};

/* Global variables.  */

/* Database of alias names.  */
extern void *__gconv_alias_db attribute_hidden;

/* Array with available modules.  */
extern struct gconv_module *__gconv_modules_db attribute_hidden;

/* Value of the GCONV_PATH environment variable.  */
extern const char *__gconv_path_envvar attribute_hidden;

/* Lock for the conversion database content.  */
__libc_lock_define (extern, __gconv_lock attribute_hidden)


/* The gconv functions expects the name to be in upper case and complete,
   including the trailing slashes if necessary.  */
#define norm_add_slashes(str,suffix) \
  ({									      \
    const char *cp = (str);						      \
    char *result;							      \
    char *tmp;								      \
    size_t cnt = 0;							      \
    const size_t suffix_len = strlen (suffix);				      \
									      \
    while (*cp != '\0')							      \
      if (*cp++ == '/')							      \
	++cnt;								      \
									      \
    tmp = result = __alloca (cp - (str) + 3 + suffix_len);		      \
    cp = (str);								      \
    while (*cp != '\0')							      \
      *tmp++ = __toupper_l (*cp++, _nl_C_locobj_ptr);			      \
    if (cnt < 2)							      \
      {									      \
	*tmp++ = '/';							      \
	if (cnt < 1)							      \
	  {								      \
	    *tmp++ = '/';						      \
	    if (suffix_len != 0)					      \
	      tmp = __mempcpy (tmp, suffix, suffix_len);		      \
	  }								      \
      }									      \
    *tmp = '\0';							      \
    result;								      \
  })


/* Return in *HANDLE, a descriptor for the transformation.  The function expects
   the specification of the transformation in the structure pointed to by
   CONV_SPEC.  It only reads *CONV_SPEC and does not take ownership of it.  */
extern int __gconv_open (struct gconv_spec *conv_spec,
                         __gconv_t *handle, int flags);
libc_hidden_proto (__gconv_open)

/* This function accepts the charset names of the source and destination of the
   conversion and populates *conv_spec with an equivalent conversion
   specification that may later be used by __gconv_open.  The charset names
   might contain options in the form of suffixes that alter the conversion,
   e.g. "ISO-10646/UTF-8/TRANSLIT".  It processes the charset names, ignoring
   and truncating any suffix options in fromcode, and processing and truncating
   any suffix options in tocode.  Supported suffix options ("TRANSLIT" or
   "IGNORE") when found in tocode lead to the corresponding flag in *conv_spec
   to be set to true.  Unrecognized suffix options are silently discarded.  If
   the function succeeds, it returns conv_spec back to the caller.  It returns
   NULL upon failure.  */
extern struct gconv_spec *
__gconv_create_spec (struct gconv_spec *conv_spec, const char *fromcode,
                     const char *tocode);
libc_hidden_proto (__gconv_create_spec)

/* This function frees all heap memory allocated by __gconv_create_spec.  */
extern void
__gconv_destroy_spec (struct gconv_spec *conv_spec);
libc_hidden_proto (__gconv_destroy_spec)

/* Free resources associated with transformation descriptor CD.  */
extern int __gconv_close (__gconv_t cd)
     attribute_hidden;

/* Transform at most *INBYTESLEFT bytes from buffer starting at *INBUF
   according to rules described by CD and place up to *OUTBYTESLEFT
   bytes in buffer starting at *OUTBUF.  Return number of non-identical
   conversions in *IRREVERSIBLE if this pointer is not null.  */
extern int __gconv (__gconv_t cd, const unsigned char **inbuf,
		    const unsigned char *inbufend, unsigned char **outbuf,
		    unsigned char *outbufend, size_t *irreversible)
     attribute_hidden;

/* Return in *HANDLE a pointer to an array with *NSTEPS elements describing
   the single steps necessary for transformation from FROMSET to TOSET.  */
extern int __gconv_find_transform (const char *toset, const char *fromset,
				   struct __gconv_step **handle,
				   size_t *nsteps, int flags)
     attribute_hidden;

/* Search for transformation in cache data.  */
extern int __gconv_lookup_cache (const char *toset, const char *fromset,
				 struct __gconv_step **handle, size_t *nsteps,
				 int flags)
     attribute_hidden;

/* Compare the two name for whether they are after alias expansion the
   same.  This function uses the cache and fails if none is
   loaded.  */
extern int __gconv_compare_alias_cache (const char *name1, const char *name2,
					int *result)
     attribute_hidden;

/* Free data associated with a step's structure.  */
extern void __gconv_release_step (struct __gconv_step *step)
     attribute_hidden;

/* Read all the configuration data and cache it if not done so already.  */
extern void __gconv_load_conf (void) attribute_hidden;

/* Try to read module cache file.  */
extern int __gconv_load_cache (void) attribute_hidden;

/* Retrieve pointer to internal cache.  */
extern void *__gconv_get_cache (void);

/* Retrieve pointer to internal module database.  */
extern struct gconv_module *__gconv_get_modules_db (void);

/* Retrieve pointer to internal alias database.  */
extern void *__gconv_get_alias_db (void);

/* Comparison function to search alias.  */
extern int __gconv_alias_compare (const void *p1, const void *p2)
     attribute_hidden;

/* Clear reference to transformation step implementations which might
   cause the code to be unloaded.  */
extern int __gconv_close_transform (struct __gconv_step *steps,
				    size_t nsteps)
     attribute_hidden;

/* Free all resources allocated for the transformation record when
   using the cache.  */
extern void __gconv_release_cache (struct __gconv_step *steps, size_t nsteps)
     attribute_hidden;

/* Load shared object named by NAME.  If already loaded increment reference
   count.  */
extern struct __gconv_loaded_object *__gconv_find_shlib (const char *name)
     attribute_hidden;

/* Release shared object.  If no further reference is available unload
   the object.  */
extern void __gconv_release_shlib (struct __gconv_loaded_object *handle)
     attribute_hidden;

/* Fill STEP with information about builtin module with NAME.  */
extern void __gconv_get_builtin_trans (const char *name,
				       struct __gconv_step *step)
     attribute_hidden;

/* Transliteration using the locale's data.  */
extern int __gconv_transliterate (struct __gconv_step *step,
                                  struct __gconv_step_data *step_data,
                                  const unsigned char *inbufstart,
                                  const unsigned char **inbufp,
                                  const unsigned char *inbufend,
                                  unsigned char **outbufstart,
                                  size_t *irreversible);
libc_hidden_proto (__gconv_transliterate)

/* If NAME is an codeset alias expand it.  */
extern int __gconv_compare_alias (const char *name1, const char *name2)
     attribute_hidden;


/* Builtin transformations.  */
#ifdef _LIBC
# define __BUILTIN_TRANSFORM(Name) \
  extern int Name (struct __gconv_step *step,				      \
		   struct __gconv_step_data *data,			      \
		   const unsigned char **inbuf,				      \
		   const unsigned char *inbufend,			      \
		   unsigned char **outbufstart, size_t *irreversible,	      \
		   int do_flush, int consume_incomplete)

__BUILTIN_TRANSFORM (__gconv_transform_ascii_internal);
__BUILTIN_TRANSFORM (__gconv_transform_internal_ascii);
__BUILTIN_TRANSFORM (__gconv_transform_utf8_internal);
__BUILTIN_TRANSFORM (__gconv_transform_internal_utf8);
__BUILTIN_TRANSFORM (__gconv_transform_ucs2_internal);
__BUILTIN_TRANSFORM (__gconv_transform_internal_ucs2);
__BUILTIN_TRANSFORM (__gconv_transform_ucs2reverse_internal);
__BUILTIN_TRANSFORM (__gconv_transform_internal_ucs2reverse);
__BUILTIN_TRANSFORM (__gconv_transform_internal_ucs4);
__BUILTIN_TRANSFORM (__gconv_transform_ucs4_internal);
__BUILTIN_TRANSFORM (__gconv_transform_internal_ucs4le);
__BUILTIN_TRANSFORM (__gconv_transform_ucs4le_internal);
__BUILTIN_TRANSFORM (__gconv_transform_internal_utf16);
__BUILTIN_TRANSFORM (__gconv_transform_utf16_internal);
# undef __BUITLIN_TRANSFORM

/* Specialized conversion function for a single byte to INTERNAL, recognizing
   only ASCII characters.  */
extern wint_t __gconv_btwoc_ascii (struct __gconv_step *step, unsigned char c);

#endif

__END_DECLS

#endif /* gconv_int.h */
Commit	Line	Data
dff8da6b	1	/* Copyright (C) 1997-2024 Free Software Foundation, Inc.
e62c19f1	2	This file is part of the GNU C Library.
e62c19f1 UD	3
e62c19f1 UD	4	The GNU C Library is free software; you can redistribute it and/or
41bdb6e2 AJ	5	modify it under the terms of the GNU Lesser General Public
	6	License as published by the Free Software Foundation; either
	7	version 2.1 of the License, or (at your option) any later version.
e62c19f1 UD	8
	9	The GNU C Library is distributed in the hope that it will be useful,
	10	but WITHOUT ANY WARRANTY; without even the implied warranty of
	11	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
41bdb6e2	12	Lesser General Public License for more details.
e62c19f1	13
41bdb6e2	14	You should have received a copy of the GNU Lesser General Public
59ba27a6	15	License along with the GNU C Library; if not, see
5a82c748	16	<https://www.gnu.org/licenses/>. */
e62c19f1 UD	17
	18	#ifndef _GCONV_INT_H
	19	#define _GCONV_INT_H 1
	20
	21	#include "gconv.h"
c5738211	22	#include <stdlib.h> /* For alloca used in macro below. */
6111babe RM	23	#include <ctype.h> /* For __toupper_l used in macro below. */
6111babe RM	24	#include <string.h> /* For strlen et al used in macro below. */
ec999b8e	25	#include <libc-lock.h>
e62c19f1 UD	26
	27	__BEGIN_DECLS
	28
5729e0e9 AZ	29	/* We have to provide support for machines which are not able to handled
	30	unaligned memory accesses. Some of the character encodings have
	31	representations with a fixed width of 2 or 4 bytes. */
	32	#define get16(addr) \
	33	({ \
	34	const struct { uint16_t r; } __attribute__ ((__packed__)) *__ptr \
	35	= (__typeof(__ptr))(addr); \
	36	__ptr->r; \
	37	})
	38	#define get32(addr) \
	39	({ \
	40	const struct { uint32_t r; } __attribute__ ((__packed__)) *__ptr \
	41	= (__typeof(__ptr))(addr); \
	42	__ptr->r; \
	43	})
	44
	45	#define put16(addr, val) \
	46	do { \
	47	struct { uint16_t r; } __attribute__ ((__packed__)) *__ptr \
	48	= (__typeof(__ptr))(addr); \
	49	__ptr->r = val; \
	50	} while (0)
	51	#define put32(addr, val) \
	52	do { \
	53	struct { uint32_t r; } __attribute__ ((__packed__)) *__ptr \
	54	= (__typeof(__ptr))(addr); \
	55	__ptr->r = val; \
	56	} while (0)
e62c19f1	57
9a321276	58	/* Structure for alias definition. Simply two strings. */
e62c19f1 UD	59	struct gconv_alias
e62c19f1 UD	60	{
17427edd UD	61	char *fromname;
17427edd UD	62	char *toname;
e62c19f1 UD	63	};
	64
	65
0d9f6793 UD	66	/* Structure describing one loaded shared object. This normally are
	67	objects to perform conversation but as a special case the db shared
	68	object is also handled. */
d64b6ad0	69	struct __gconv_loaded_object
0d9f6793	70	{
b79f74cd	71	/* Name of the object. It must be the first structure element. */
0d9f6793 UD	72	const char *name;
	73
	74	/* Reference counter for the db functionality. If no conversion is
	75	needed we unload the db library. */
	76	int counter;
	77
	78	/* The handle for the shared object. */
b3fc5f84	79	void *handle;
0d9f6793 UD	80
0d9f6793 UD	81	/* Pointer to the functions the module defines. */
d64b6ad0 UD	82	__gconv_fct fct;
	83	__gconv_init_fct init_fct;
	84	__gconv_end_fct end_fct;
0d9f6793 UD	85	};
	86
	87
e62c19f1 UD	88	/* Description for an available conversion module. */
	89	struct gconv_module
	90	{
d2dfc5de	91	const char *from_string;
0d9f6793	92	const char *to_string;
e62c19f1	93
fab6d621 UD	94	int cost_hi;
fab6d621 UD	95	int cost_lo;
e62c19f1	96
0d9f6793	97	const char *module_name;
2bd60880 UD	98
	99	struct gconv_module left; / Prefix smaller. */
	100	struct gconv_module same; / List of entries with identical prefix. */
2bd60880	101	struct gconv_module right; / Prefix larger. */
e62c19f1 UD	102	};
	103
	104
91927b7c AS	105	/* The specification of the conversion that needs to be performed. */
	106	struct gconv_spec
	107	{
	108	char *fromcode;
	109	char *tocode;
	110	bool translit;
	111	bool ignore;
	112	};
	113
c90a2db6 UD	114	/* Flags for `gconv_open'. */
	115	enum
	116	{
	117	GCONV_AVOID_NOCONV = 1 << 0
	118	};
	119
7b503bcc UD	120	/* When GCONV_AVOID_NOCONV is set and no conversion is needed,
	121	__GCONV_NULCONV should be returned. */
	122	enum
	123	{
	124	__GCONV_NULCONV = -1
	125	};
c90a2db6	126
e62c19f1 UD	127	/* Global variables. */
	128
	129	/* Database of alias names. */
230491f0	130	extern void *__gconv_alias_db attribute_hidden;
e62c19f1 UD	131
e62c19f1 UD	132	/* Array with available modules. */
230491f0	133	extern struct gconv_module *__gconv_modules_db attribute_hidden;
e62c19f1	134
6b98979f	135	/* Value of the GCONV_PATH environment variable. */
aa32f798	136	extern const char *__gconv_path_envvar attribute_hidden;
6b98979f	137
9e26f129	138	/* Lock for the conversion database content. */
6f8a7dff	139	__libc_lock_define (extern, __gconv_lock attribute_hidden)
9e26f129	140
e62c19f1	141
17c389fc UD	142	/* The gconv functions expects the name to be in upper case and complete,
17c389fc UD	143	including the trailing slashes if necessary. */
323fb88d	144	#define norm_add_slashes(str,suffix) \
17c389fc UD	145	({ \
	146	const char *cp = (str); \
	147	char *result; \
	148	char *tmp; \
	149	size_t cnt = 0; \
db2f05ba	150	const size_t suffix_len = strlen (suffix); \
17c389fc UD	151	\
	152	while (*cp != '\0') \
	153	if (*cp++ == '/') \
	154	++cnt; \
	155	\
c5738211	156	tmp = result = __alloca (cp - (str) + 3 + suffix_len); \
17c389fc UD	157	cp = (str); \
17c389fc UD	158	while (*cp != '\0') \
4b5b009c	159	tmp++ = __toupper_l (cp++, _nl_C_locobj_ptr); \
17c389fc UD	160	if (cnt < 2) \
	161	{ \
	162	*tmp++ = '/'; \
	163	if (cnt < 1) \
323fb88d UD	164	{ \
323fb88d UD	165	*tmp++ = '/'; \
db2f05ba	166	if (suffix_len != 0) \
323fb88d UD	167	tmp = __mempcpy (tmp, suffix, suffix_len); \
323fb88d UD	168	} \
17c389fc UD	169	} \
	170	*tmp = '\0'; \
	171	result; \
	172	})
	173
	174
f58a8c1c	175	/* Return in *HANDLE, a descriptor for the transformation. The function expects
91927b7c AS	176	the specification of the transformation in the structure pointed to by
	177	CONV_SPEC. It only reads CONV_SPEC and does not take ownership of it. /
	178	extern int __gconv_open (struct gconv_spec *conv_spec,
	179	__gconv_t *handle, int flags);
	180	libc_hidden_proto (__gconv_open)
e62c19f1	181
7d4ec75e AS	182	/* This function accepts the charset names of the source and destination of the
	183	conversion and populates *conv_spec with an equivalent conversion
	184	specification that may later be used by __gconv_open. The charset names
	185	might contain options in the form of suffixes that alter the conversion,
	186	e.g. "ISO-10646/UTF-8/TRANSLIT". It processes the charset names, ignoring
	187	and truncating any suffix options in fromcode, and processing and truncating
	188	any suffix options in tocode. Supported suffix options ("TRANSLIT" or
	189	"IGNORE") when found in tocode lead to the corresponding flag in *conv_spec
	190	to be set to true. Unrecognized suffix options are silently discarded. If
	191	the function succeeds, it returns conv_spec back to the caller. It returns
	192	NULL upon failure. */
	193	extern struct gconv_spec *
	194	__gconv_create_spec (struct gconv_spec conv_spec, const char fromcode,
	195	const char *tocode);
	196	libc_hidden_proto (__gconv_create_spec)
	197
	198	/* This function frees all heap memory allocated by __gconv_create_spec. */
	199	extern void
	200	__gconv_destroy_spec (struct gconv_spec *conv_spec);
	201	libc_hidden_proto (__gconv_destroy_spec)
	202
e62c19f1	203	/* Free resources associated with transformation descriptor CD. */
8bcdb7e0 L	204	extern int __gconv_close (__gconv_t cd)
8bcdb7e0 L	205	attribute_hidden;
e62c19f1 UD	206
	207	/* Transform at most INBYTESLEFT bytes from buffer starting at INBUF
	208	according to rules described by CD and place up to *OUTBYTESLEFT
63e04088	209	bytes in buffer starting at *OUTBUF. Return number of non-identical
38677ace	210	conversions in IRREVERSIBLE if this pointer is not null. /
55985355 UD	211	extern int __gconv (__gconv_t cd, const unsigned char **inbuf,
55985355 UD	212	const unsigned char inbufend, unsigned char *outbuf,
8bcdb7e0 L	213	unsigned char outbufend, size_t irreversible)
8bcdb7e0 L	214	attribute_hidden;
e62c19f1 UD	215
	216	/* Return in HANDLE a pointer to an array with NSTEPS elements describing
	217	the single steps necessary for transformation from FROMSET to TOSET. */
55985355 UD	218	extern int __gconv_find_transform (const char toset, const char fromset,
55985355 UD	219	struct __gconv_step **handle,
8bcdb7e0 L	220	size_t *nsteps, int flags)
8bcdb7e0 L	221	attribute_hidden;
e62c19f1	222
6b98979f UD	223	/* Search for transformation in cache data. */
	224	extern int __gconv_lookup_cache (const char toset, const char fromset,
	225	struct __gconv_step *handle, size_t nsteps,
8bcdb7e0 L	226	int flags)
8bcdb7e0 L	227	attribute_hidden;
6b98979f	228
9a018f6c UD	229	/* Compare the two name for whether they are after alias expansion the
	230	same. This function uses the cache and fails if none is
	231	loaded. */
	232	extern int __gconv_compare_alias_cache (const char name1, const char name2,
8bcdb7e0 L	233	int *result)
8bcdb7e0 L	234	attribute_hidden;
9a018f6c	235
6b98979f	236	/* Free data associated with a step's structure. */
8bcdb7e0 L	237	extern void __gconv_release_step (struct __gconv_step *step)
8bcdb7e0 L	238	attribute_hidden;
6b98979f	239
c5288d37 AS	240	/* Read all the configuration data and cache it if not done so already. */
c5288d37 AS	241	extern void __gconv_load_conf (void) attribute_hidden;
e62c19f1	242
6b98979f	243	/* Try to read module cache file. */
8bcdb7e0	244	extern int __gconv_load_cache (void) attribute_hidden;
6b98979f	245
230491f0 UD	246	/* Retrieve pointer to internal cache. */
	247	extern void *__gconv_get_cache (void);
	248
	249	/* Retrieve pointer to internal module database. */
	250	extern struct gconv_module *__gconv_get_modules_db (void);
	251
	252	/* Retrieve pointer to internal alias database. */
	253	extern void *__gconv_get_alias_db (void);
	254
e62c19f1	255	/* Comparison function to search alias. */
dff07c4b UD	256	extern int __gconv_alias_compare (const void p1, const void p2)
dff07c4b UD	257	attribute_hidden;
e62c19f1 UD	258
	259	/* Clear reference to transformation step implementations which might
	260	cause the code to be unloaded. */
55985355	261	extern int __gconv_close_transform (struct __gconv_step *steps,
8bcdb7e0 L	262	size_t nsteps)
8bcdb7e0 L	263	attribute_hidden;
e62c19f1	264
0db59742 UD	265	/* Free all resources allocated for the transformation record when
0db59742 UD	266	using the cache. */
8bcdb7e0 L	267	extern void __gconv_release_cache (struct __gconv_step *steps, size_t nsteps)
8bcdb7e0 L	268	attribute_hidden;
0db59742	269
e62c19f1 UD	270	/* Load shared object named by NAME. If already loaded increment reference
e62c19f1 UD	271	count. */
8bcdb7e0 L	272	extern struct __gconv_loaded_object __gconv_find_shlib (const char name)
8bcdb7e0 L	273	attribute_hidden;
e62c19f1 UD	274
	275	/* Release shared object. If no further reference is available unload
	276	the object. */
8bcdb7e0 L	277	extern void __gconv_release_shlib (struct __gconv_loaded_object *handle)
8bcdb7e0 L	278	attribute_hidden;
e62c19f1 UD	279
e62c19f1 UD	280	/* Fill STEP with information about builtin module with NAME. */
55985355	281	extern void __gconv_get_builtin_trans (const char *name,
8bcdb7e0 L	282	struct __gconv_step *step)
8bcdb7e0 L	283	attribute_hidden;
e62c19f1	284
7ac6fad9 FW	285	/* Transliteration using the locale's data. */
	286	extern int __gconv_transliterate (struct __gconv_step *step,
	287	struct __gconv_step_data *step_data,
	288	const unsigned char *inbufstart,
	289	const unsigned char **inbufp,
	290	const unsigned char *inbufend,
	291	unsigned char **outbufstart,
	292	size_t *irreversible);
ba7b4d29	293	libc_hidden_proto (__gconv_transliterate)
e62c19f1	294
dd9423a6	295	/* If NAME is an codeset alias expand it. */
8bcdb7e0 L	296	extern int __gconv_compare_alias (const char name1, const char name2)
8bcdb7e0 L	297	attribute_hidden;
dd9423a6 UD	298
dd9423a6 UD	299
e62c19f1 UD	300	/* Builtin transformations. */
e62c19f1 UD	301	#ifdef _LIBC
f9ad060c	302	# define __BUILTIN_TRANSFORM(Name) \
55985355 UD	303	extern int Name (struct __gconv_step *step, \
	304	struct __gconv_step_data *data, \
	305	const unsigned char **inbuf, \
f1d5c60d UD	306	const unsigned char *inbufend, \
	307	unsigned char *outbufstart, size_t irreversible, \
	308	int do_flush, int consume_incomplete)
e62c19f1	309
f9ad060c UD	310	__BUILTIN_TRANSFORM (__gconv_transform_ascii_internal);
	311	__BUILTIN_TRANSFORM (__gconv_transform_internal_ascii);
	312	__BUILTIN_TRANSFORM (__gconv_transform_utf8_internal);
	313	__BUILTIN_TRANSFORM (__gconv_transform_internal_utf8);
	314	__BUILTIN_TRANSFORM (__gconv_transform_ucs2_internal);
	315	__BUILTIN_TRANSFORM (__gconv_transform_internal_ucs2);
	316	__BUILTIN_TRANSFORM (__gconv_transform_ucs2reverse_internal);
	317	__BUILTIN_TRANSFORM (__gconv_transform_internal_ucs2reverse);
	318	__BUILTIN_TRANSFORM (__gconv_transform_internal_ucs4);
	319	__BUILTIN_TRANSFORM (__gconv_transform_ucs4_internal);
	320	__BUILTIN_TRANSFORM (__gconv_transform_internal_ucs4le);
	321	__BUILTIN_TRANSFORM (__gconv_transform_ucs4le_internal);
	322	__BUILTIN_TRANSFORM (__gconv_transform_internal_utf16);
	323	__BUILTIN_TRANSFORM (__gconv_transform_utf16_internal);
	324	# undef __BUITLIN_TRANSFORM
	325
	326	/* Specialized conversion function for a single byte to INTERNAL, recognizing
	327	only ASCII characters. */
	328	extern wint_t __gconv_btwoc_ascii (struct __gconv_step *step, unsigned char c);
e62c19f1	329
e62c19f1 UD	330	#endif
	331
	332	__END_DECLS
	333
	334	#endif /* gconv_int.h */