C++ify gdb/common/environ.c
[deliverable/binutils-gdb.git] / gdb / charset.c
CommitLineData
234b45d4 1/* Character set conversion support for GDB.
1bac305b 2
61baf725 3 Copyright (C) 2001-2017 Free Software Foundation, Inc.
234b45d4
KB
4
5 This file is part of GDB.
6
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
a9762ec7 9 the Free Software Foundation; either version 3 of the License, or
234b45d4
KB
10 (at your option) any later version.
11
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
a9762ec7 18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
234b45d4
KB
19
20#include "defs.h"
21#include "charset.h"
22#include "gdbcmd.h"
6c7a06a3 23#include "gdb_obstack.h"
732f6a93 24#include "gdb_wait.h"
6c7a06a3
TT
25#include "charset-list.h"
26#include "vec.h"
40b5c9fb 27#include "environ.h"
f870a310 28#include "arch-utils.h"
fa864999 29#include "gdb_vecs.h"
234b45d4
KB
30#include <ctype.h>
31
43484f03
DJ
32#ifdef USE_WIN32API
33#include <windows.h>
34#endif
234b45d4
KB
35\f
36/* How GDB's character set support works
37
6c7a06a3 38 GDB has three global settings:
234b45d4
KB
39
40 - The `current host character set' is the character set GDB should
41 use in talking to the user, and which (hopefully) the user's
6c7a06a3
TT
42 terminal knows how to display properly. Most users should not
43 change this.
234b45d4
KB
44
45 - The `current target character set' is the character set the
46 program being debugged uses.
47
6c7a06a3
TT
48 - The `current target wide character set' is the wide character set
49 the program being debugged uses, that is, the encoding used for
50 wchar_t.
51
234b45d4
KB
52 There are commands to set each of these, and mechanisms for
53 choosing reasonable default values. GDB has a global list of
54 character sets that it can use as its host or target character
55 sets.
56
57 The header file `charset.h' declares various functions that
58 different pieces of GDB need to perform tasks like:
59
60 - printing target strings and characters to the user's terminal
61 (mostly target->host conversions),
62
63 - building target-appropriate representations of strings and
64 characters the user enters in expressions (mostly host->target
65 conversions),
66
6c7a06a3
TT
67 and so on.
68
69 To avoid excessive code duplication and maintenance efforts,
70 GDB simply requires a capable iconv function. Users on platforms
71 without a suitable iconv can use the GNU iconv library. */
234b45d4
KB
72
73\f
6c7a06a3 74#ifdef PHONY_ICONV
234b45d4 75
6c7a06a3
TT
76/* Provide a phony iconv that does as little as possible. Also,
77 arrange for there to be a single available character set. */
234b45d4 78
6c7a06a3 79#undef GDB_DEFAULT_HOST_CHARSET
f74f61cb
SL
80#ifdef USE_WIN32API
81# define GDB_DEFAULT_HOST_CHARSET "CP1252"
82#else
83# define GDB_DEFAULT_HOST_CHARSET "ISO-8859-1"
84#endif
85#define GDB_DEFAULT_TARGET_CHARSET GDB_DEFAULT_HOST_CHARSET
86#define GDB_DEFAULT_TARGET_WIDE_CHARSET "UTF-32"
6c7a06a3
TT
87#undef DEFAULT_CHARSET_NAMES
88#define DEFAULT_CHARSET_NAMES GDB_DEFAULT_HOST_CHARSET ,
89
90#undef iconv_t
91#define iconv_t int
92#undef iconv_open
62234ccc 93#define iconv_open phony_iconv_open
6c7a06a3 94#undef iconv
62234ccc 95#define iconv phony_iconv
6c7a06a3 96#undef iconv_close
62234ccc 97#define iconv_close phony_iconv_close
6c7a06a3 98
0dd7fb99
TT
99#undef ICONV_CONST
100#define ICONV_CONST const
101
f74f61cb
SL
102/* We allow conversions from UTF-32, wchar_t, and the host charset.
103 We allow conversions to wchar_t and the host charset.
104 Return 1 if we are converting from UTF-32BE, 2 if from UTF32-LE,
105 0 otherwise. This is used as a flag in calls to iconv. */
106
a95babbf 107static iconv_t
62234ccc 108phony_iconv_open (const char *to, const char *from)
6c7a06a3 109{
6c7a06a3
TT
110 if (strcmp (to, "wchar_t") && strcmp (to, GDB_DEFAULT_HOST_CHARSET))
111 return -1;
234b45d4 112
f74f61cb
SL
113 if (!strcmp (from, "UTF-32BE") || !strcmp (from, "UTF-32"))
114 return 1;
115
116 if (!strcmp (from, "UTF-32LE"))
117 return 2;
118
119 if (strcmp (from, "wchar_t") && strcmp (from, GDB_DEFAULT_HOST_CHARSET))
120 return -1;
121
122 return 0;
6c7a06a3 123}
234b45d4 124
a95babbf 125static int
62234ccc 126phony_iconv_close (iconv_t arg)
6c7a06a3
TT
127{
128 return 0;
129}
234b45d4 130
a95babbf 131static size_t
62234ccc
TT
132phony_iconv (iconv_t utf_flag, const char **inbuf, size_t *inbytesleft,
133 char **outbuf, size_t *outbytesleft)
6c7a06a3 134{
b8899f2b 135 if (utf_flag)
6c7a06a3 136 {
f74f61cb
SL
137 enum bfd_endian endian
138 = utf_flag == 1 ? BFD_ENDIAN_BIG : BFD_ENDIAN_LITTLE;
6c7a06a3
TT
139 while (*inbytesleft >= 4)
140 {
f74f61cb
SL
141 unsigned long c
142 = extract_unsigned_integer ((const gdb_byte *)*inbuf, 4, endian);
6c7a06a3
TT
143
144 if (c >= 256)
145 {
146 errno = EILSEQ;
147 return -1;
148 }
f74f61cb
SL
149 if (*outbytesleft < 1)
150 {
151 errno = E2BIG;
152 return -1;
153 }
6c7a06a3
TT
154 **outbuf = c & 0xff;
155 ++*outbuf;
156 --*outbytesleft;
157
f74f61cb 158 *inbuf += 4;
6c7a06a3
TT
159 *inbytesleft -= 4;
160 }
f74f61cb 161 if (*inbytesleft)
6c7a06a3 162 {
f74f61cb 163 /* Partial sequence on input. */
6c7a06a3
TT
164 errno = EINVAL;
165 return -1;
166 }
167 }
168 else
169 {
170 /* In all other cases we simply copy input bytes to the
171 output. */
172 size_t amt = *inbytesleft;
c5504eaf 173
6c7a06a3
TT
174 if (amt > *outbytesleft)
175 amt = *outbytesleft;
176 memcpy (*outbuf, *inbuf, amt);
177 *inbuf += amt;
178 *outbuf += amt;
179 *inbytesleft -= amt;
180 *outbytesleft -= amt;
f74f61cb
SL
181 if (*inbytesleft)
182 {
183 errno = E2BIG;
184 return -1;
185 }
6c7a06a3 186 }
234b45d4 187
6c7a06a3
TT
188 /* The number of non-reversible conversions -- but they were all
189 reversible. */
190 return 0;
191}
234b45d4 192
83030110
PA
193#else /* PHONY_ICONV */
194
195/* On systems that don't have EILSEQ, GNU iconv's iconv.h defines it
196 to ENOENT, while gnulib defines it to a different value. Always
197 map ENOENT to gnulib's EILSEQ, leaving callers agnostic. */
198
199static size_t
200gdb_iconv (iconv_t utf_flag, ICONV_CONST char **inbuf, size_t *inbytesleft,
201 char **outbuf, size_t *outbytesleft)
202{
203 size_t ret;
204
205 ret = iconv (utf_flag, inbuf, inbytesleft, outbuf, outbytesleft);
206 if (errno == ENOENT)
207 errno = EILSEQ;
208 return ret;
209}
210
211#undef iconv
212#define iconv gdb_iconv
234b45d4 213
83030110 214#endif /* PHONY_ICONV */
234b45d4
KB
215
216\f
217/* The global lists of character sets and translations. */
218
219
e33d66ec
EZ
220#ifndef GDB_DEFAULT_TARGET_CHARSET
221#define GDB_DEFAULT_TARGET_CHARSET "ISO-8859-1"
222#endif
223
6c7a06a3 224#ifndef GDB_DEFAULT_TARGET_WIDE_CHARSET
b8899f2b 225#define GDB_DEFAULT_TARGET_WIDE_CHARSET "UTF-32"
6c7a06a3
TT
226#endif
227
228static const char *auto_host_charset_name = GDB_DEFAULT_HOST_CHARSET;
229static const char *host_charset_name = "auto";
920d2a44
AC
230static void
231show_host_charset_name (struct ui_file *file, int from_tty,
232 struct cmd_list_element *c,
233 const char *value)
234{
6c7a06a3
TT
235 if (!strcmp (value, "auto"))
236 fprintf_filtered (file,
237 _("The host character set is \"auto; currently %s\".\n"),
238 auto_host_charset_name);
239 else
240 fprintf_filtered (file, _("The host character set is \"%s\".\n"), value);
920d2a44
AC
241}
242
f870a310 243static const char *target_charset_name = "auto";
920d2a44
AC
244static void
245show_target_charset_name (struct ui_file *file, int from_tty,
246 struct cmd_list_element *c, const char *value)
247{
f870a310
TT
248 if (!strcmp (value, "auto"))
249 fprintf_filtered (file,
250 _("The target character set is \"auto; "
251 "currently %s\".\n"),
252 gdbarch_auto_charset (get_current_arch ()));
253 else
254 fprintf_filtered (file, _("The target character set is \"%s\".\n"),
255 value);
920d2a44
AC
256}
257
f870a310 258static const char *target_wide_charset_name = "auto";
6c7a06a3 259static void
aff410f1
MS
260show_target_wide_charset_name (struct ui_file *file,
261 int from_tty,
262 struct cmd_list_element *c,
263 const char *value)
e33d66ec 264{
f870a310
TT
265 if (!strcmp (value, "auto"))
266 fprintf_filtered (file,
267 _("The target wide character set is \"auto; "
268 "currently %s\".\n"),
269 gdbarch_auto_wide_charset (get_current_arch ()));
270 else
271 fprintf_filtered (file, _("The target wide character set is \"%s\".\n"),
272 value);
6c7a06a3 273}
e33d66ec 274
6c7a06a3 275static const char *default_charset_names[] =
e33d66ec 276{
6c7a06a3 277 DEFAULT_CHARSET_NAMES
e33d66ec
EZ
278 0
279};
234b45d4 280
6c7a06a3 281static const char **charset_enum;
234b45d4 282
6c7a06a3
TT
283\f
284/* If the target wide character set has big- or little-endian
285 variants, these are the corresponding names. */
286static const char *target_wide_charset_be_name;
287static const char *target_wide_charset_le_name;
234b45d4 288
f870a310
TT
289/* The architecture for which the BE- and LE-names are valid. */
290static struct gdbarch *be_le_arch;
291
292/* A helper function which sets the target wide big- and little-endian
293 character set names, if possible. */
234b45d4 294
6c7a06a3 295static void
f870a310 296set_be_le_names (struct gdbarch *gdbarch)
234b45d4 297{
6c7a06a3 298 int i, len;
f870a310
TT
299 const char *target_wide;
300
301 if (be_le_arch == gdbarch)
302 return;
303 be_le_arch = gdbarch;
234b45d4 304
f74f61cb
SL
305#ifdef PHONY_ICONV
306 /* Match the wide charset names recognized by phony_iconv_open. */
307 target_wide_charset_le_name = "UTF-32LE";
308 target_wide_charset_be_name = "UTF-32BE";
309#else
6c7a06a3
TT
310 target_wide_charset_le_name = NULL;
311 target_wide_charset_be_name = NULL;
234b45d4 312
f870a310
TT
313 target_wide = target_wide_charset_name;
314 if (!strcmp (target_wide, "auto"))
315 target_wide = gdbarch_auto_wide_charset (gdbarch);
316
317 len = strlen (target_wide);
6c7a06a3
TT
318 for (i = 0; charset_enum[i]; ++i)
319 {
f870a310 320 if (strncmp (target_wide, charset_enum[i], len))
6c7a06a3
TT
321 continue;
322 if ((charset_enum[i][len] == 'B'
323 || charset_enum[i][len] == 'L')
324 && charset_enum[i][len + 1] == 'E'
325 && charset_enum[i][len + 2] == '\0')
326 {
327 if (charset_enum[i][len] == 'B')
328 target_wide_charset_be_name = charset_enum[i];
329 else
330 target_wide_charset_le_name = charset_enum[i];
331 }
332 }
f74f61cb 333# endif /* PHONY_ICONV */
234b45d4
KB
334}
335
6c7a06a3
TT
336/* 'Set charset', 'set host-charset', 'set target-charset', 'set
337 target-wide-charset', 'set charset' sfunc's. */
234b45d4
KB
338
339static void
f870a310 340validate (struct gdbarch *gdbarch)
234b45d4 341{
6c7a06a3
TT
342 iconv_t desc;
343 const char *host_cset = host_charset ();
f870a310
TT
344 const char *target_cset = target_charset (gdbarch);
345 const char *target_wide_cset = target_wide_charset_name;
c5504eaf 346
f870a310
TT
347 if (!strcmp (target_wide_cset, "auto"))
348 target_wide_cset = gdbarch_auto_wide_charset (gdbarch);
234b45d4 349
f870a310 350 desc = iconv_open (target_wide_cset, host_cset);
6c7a06a3 351 if (desc == (iconv_t) -1)
a73c6dcd 352 error (_("Cannot convert between character sets `%s' and `%s'"),
f870a310 353 target_wide_cset, host_cset);
6c7a06a3 354 iconv_close (desc);
234b45d4 355
f870a310 356 desc = iconv_open (target_cset, host_cset);
6c7a06a3 357 if (desc == (iconv_t) -1)
a73c6dcd 358 error (_("Cannot convert between character sets `%s' and `%s'"),
f870a310 359 target_cset, host_cset);
6c7a06a3 360 iconv_close (desc);
234b45d4 361
f870a310
TT
362 /* Clear the cache. */
363 be_le_arch = NULL;
234b45d4
KB
364}
365
6c7a06a3
TT
366/* This is the sfunc for the 'set charset' command. */
367static void
aff410f1
MS
368set_charset_sfunc (char *charset, int from_tty,
369 struct cmd_list_element *c)
234b45d4 370{
aff410f1 371 /* CAREFUL: set the target charset here as well. */
6c7a06a3 372 target_charset_name = host_charset_name;
f870a310 373 validate (get_current_arch ());
234b45d4
KB
374}
375
6c7a06a3
TT
376/* 'set host-charset' command sfunc. We need a wrapper here because
377 the function needs to have a specific signature. */
378static void
379set_host_charset_sfunc (char *charset, int from_tty,
380 struct cmd_list_element *c)
234b45d4 381{
f870a310 382 validate (get_current_arch ());
234b45d4
KB
383}
384
6c7a06a3
TT
385/* Wrapper for the 'set target-charset' command. */
386static void
387set_target_charset_sfunc (char *charset, int from_tty,
388 struct cmd_list_element *c)
234b45d4 389{
f870a310 390 validate (get_current_arch ());
234b45d4
KB
391}
392
6c7a06a3
TT
393/* Wrapper for the 'set target-wide-charset' command. */
394static void
395set_target_wide_charset_sfunc (char *charset, int from_tty,
396 struct cmd_list_element *c)
234b45d4 397{
f870a310 398 validate (get_current_arch ());
234b45d4
KB
399}
400
6c7a06a3
TT
401/* sfunc for the 'show charset' command. */
402static void
aff410f1
MS
403show_charset (struct ui_file *file, int from_tty,
404 struct cmd_list_element *c,
6c7a06a3 405 const char *name)
234b45d4 406{
6c7a06a3
TT
407 show_host_charset_name (file, from_tty, c, host_charset_name);
408 show_target_charset_name (file, from_tty, c, target_charset_name);
aff410f1
MS
409 show_target_wide_charset_name (file, from_tty, c,
410 target_wide_charset_name);
234b45d4
KB
411}
412
234b45d4 413\f
6c7a06a3 414/* Accessor functions. */
234b45d4 415
6c7a06a3
TT
416const char *
417host_charset (void)
234b45d4 418{
6c7a06a3
TT
419 if (!strcmp (host_charset_name, "auto"))
420 return auto_host_charset_name;
421 return host_charset_name;
234b45d4
KB
422}
423
6c7a06a3 424const char *
f870a310 425target_charset (struct gdbarch *gdbarch)
234b45d4 426{
f870a310
TT
427 if (!strcmp (target_charset_name, "auto"))
428 return gdbarch_auto_charset (gdbarch);
6c7a06a3 429 return target_charset_name;
234b45d4 430}
234b45d4 431
6c7a06a3 432const char *
f870a310 433target_wide_charset (struct gdbarch *gdbarch)
234b45d4 434{
f870a310
TT
435 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
436
437 set_be_le_names (gdbarch);
e17a4113 438 if (byte_order == BFD_ENDIAN_BIG)
234b45d4 439 {
6c7a06a3
TT
440 if (target_wide_charset_be_name)
441 return target_wide_charset_be_name;
234b45d4 442 }
6c7a06a3 443 else
234b45d4 444 {
6c7a06a3
TT
445 if (target_wide_charset_le_name)
446 return target_wide_charset_le_name;
234b45d4
KB
447 }
448
f870a310
TT
449 if (!strcmp (target_wide_charset_name, "auto"))
450 return gdbarch_auto_wide_charset (gdbarch);
451
6c7a06a3 452 return target_wide_charset_name;
234b45d4
KB
453}
454
234b45d4 455\f
6c7a06a3
TT
456/* Host character set management. For the time being, we assume that
457 the host character set is some superset of ASCII. */
234b45d4 458
6c7a06a3
TT
459char
460host_letter_to_control_character (char c)
234b45d4 461{
6c7a06a3
TT
462 if (c == '?')
463 return 0177;
464 return c & 0237;
234b45d4
KB
465}
466
6c7a06a3
TT
467/* Convert a host character, C, to its hex value. C must already have
468 been validated using isxdigit. */
234b45d4 469
6c7a06a3
TT
470int
471host_hex_value (char c)
234b45d4 472{
6c7a06a3
TT
473 if (isdigit (c))
474 return c - '0';
475 if (c >= 'a' && c <= 'f')
476 return 10 + c - 'a';
477 gdb_assert (c >= 'A' && c <= 'F');
478 return 10 + c - 'A';
234b45d4
KB
479}
480
234b45d4 481\f
6c7a06a3 482/* Public character management functions. */
234b45d4 483
80a3b8c5 484class iconv_wrapper
234b45d4 485{
80a3b8c5
TT
486public:
487
488 iconv_wrapper (const char *to, const char *from)
489 {
490 m_desc = iconv_open (to, from);
491 if (m_desc == (iconv_t) -1)
492 perror_with_name (_("Converting character sets"));
493 }
494
495 ~iconv_wrapper ()
496 {
497 iconv_close (m_desc);
498 }
499
500 size_t convert (ICONV_CONST char **inp, size_t *inleft, char **outp,
501 size_t *outleft)
502 {
503 return iconv (m_desc, inp, inleft, outp, outleft);
504 }
505
506private:
507
508 iconv_t m_desc;
509};
234b45d4 510
6c7a06a3
TT
511void
512convert_between_encodings (const char *from, const char *to,
513 const gdb_byte *bytes, unsigned int num_bytes,
514 int width, struct obstack *output,
515 enum transliterations translit)
516{
6c7a06a3 517 size_t inleft;
39086a0e 518 ICONV_CONST char *inp;
6c7a06a3
TT
519 unsigned int space_request;
520
521 /* Often, the host and target charsets will be the same. */
522 if (!strcmp (from, to))
523 {
524 obstack_grow (output, bytes, num_bytes);
525 return;
526 }
234b45d4 527
80a3b8c5 528 iconv_wrapper desc (to, from);
234b45d4 529
6c7a06a3 530 inleft = num_bytes;
39086a0e 531 inp = (ICONV_CONST char *) bytes;
234b45d4 532
6c7a06a3 533 space_request = num_bytes;
234b45d4 534
6c7a06a3 535 while (inleft > 0)
234b45d4 536 {
6c7a06a3
TT
537 char *outp;
538 size_t outleft, r;
539 int old_size;
540
541 old_size = obstack_object_size (output);
542 obstack_blank (output, space_request);
543
241fd515 544 outp = (char *) obstack_base (output) + old_size;
6c7a06a3
TT
545 outleft = space_request;
546
80a3b8c5 547 r = desc.convert (&inp, &inleft, &outp, &outleft);
6c7a06a3
TT
548
549 /* Now make sure that the object on the obstack only includes
550 bytes we have converted. */
ee11262d 551 obstack_blank_fast (output, -outleft);
6c7a06a3
TT
552
553 if (r == (size_t) -1)
554 {
555 switch (errno)
556 {
557 case EILSEQ:
558 {
559 int i;
560
561 /* Invalid input sequence. */
562 if (translit == translit_none)
3e43a32a
MS
563 error (_("Could not convert character "
564 "to `%s' character set"), to);
6c7a06a3
TT
565
566 /* We emit escape sequence for the bytes, skip them,
567 and try again. */
568 for (i = 0; i < width; ++i)
569 {
570 char octal[5];
571
08850b56 572 xsnprintf (octal, sizeof (octal), "\\%.3o", *inp & 0xff);
6c7a06a3
TT
573 obstack_grow_str (output, octal);
574
575 ++inp;
576 --inleft;
577 }
578 }
579 break;
580
581 case E2BIG:
582 /* We ran out of space in the output buffer. Make it
583 bigger next time around. */
584 space_request *= 2;
585 break;
586
587 case EINVAL:
588 /* Incomplete input sequence. FIXME: ought to report this
589 to the caller somehow. */
590 inleft = 0;
591 break;
592
593 default:
9b20d036
MS
594 perror_with_name (_("Internal error while "
595 "converting character sets"));
6c7a06a3
TT
596 }
597 }
234b45d4 598 }
234b45d4
KB
599}
600
e33d66ec 601\f
e33d66ec 602
6c7a06a3 603/* Create a new iterator. */
cda6c55b
TT
604wchar_iterator::wchar_iterator (const gdb_byte *input, size_t bytes,
605 const char *charset, size_t width)
606: m_input (input),
607 m_bytes (bytes),
608 m_width (width),
609 m_out (1)
234b45d4 610{
cda6c55b
TT
611 m_desc = iconv_open (INTERMEDIATE_ENCODING, charset);
612 if (m_desc == (iconv_t) -1)
9b20d036 613 perror_with_name (_("Converting character sets"));
234b45d4
KB
614}
615
cda6c55b 616wchar_iterator::~wchar_iterator ()
e33d66ec 617{
cda6c55b
TT
618 if (m_desc != (iconv_t) -1)
619 iconv_close (m_desc);
e33d66ec 620}
234b45d4 621
6c7a06a3 622int
cda6c55b
TT
623wchar_iterator::iterate (enum wchar_iterate_result *out_result,
624 gdb_wchar_t **out_chars,
625 const gdb_byte **ptr,
626 size_t *len)
6c7a06a3
TT
627{
628 size_t out_request;
629
630 /* Try to convert some characters. At first we try to convert just
631 a single character. The reason for this is that iconv does not
632 necessarily update its outgoing arguments when it encounters an
633 invalid input sequence -- but we want to reliably report this to
634 our caller so it can emit an escape sequence. */
635 out_request = 1;
cda6c55b 636 while (m_bytes > 0)
e33d66ec 637 {
cda6c55b
TT
638 ICONV_CONST char *inptr = (ICONV_CONST char *) m_input;
639 char *outptr = (char *) m_out.data ();
640 const gdb_byte *orig_inptr = m_input;
641 size_t orig_in = m_bytes;
6c7a06a3
TT
642 size_t out_avail = out_request * sizeof (gdb_wchar_t);
643 size_t num;
cda6c55b 644 size_t r = iconv (m_desc, &inptr, &m_bytes, &outptr, &out_avail);
39086a0e 645
cda6c55b 646 m_input = (gdb_byte *) inptr;
c5504eaf 647
6c7a06a3
TT
648 if (r == (size_t) -1)
649 {
650 switch (errno)
651 {
652 case EILSEQ:
aff410f1
MS
653 /* Invalid input sequence. We still might have
654 converted a character; if so, return it. */
1558ab4c
JK
655 if (out_avail < out_request * sizeof (gdb_wchar_t))
656 break;
657
aff410f1
MS
658 /* Otherwise skip the first invalid character, and let
659 the caller know about it. */
6c7a06a3 660 *out_result = wchar_iterate_invalid;
cda6c55b
TT
661 *ptr = m_input;
662 *len = m_width;
663 m_input += m_width;
664 m_bytes -= m_width;
6c7a06a3
TT
665 return 0;
666
667 case E2BIG:
668 /* We ran out of space. We still might have converted a
669 character; if so, return it. Otherwise, grow the
670 buffer and try again. */
671 if (out_avail < out_request * sizeof (gdb_wchar_t))
672 break;
673
674 ++out_request;
cda6c55b 675 if (out_request > m_out.size ())
d5722aa2 676 m_out.resize (out_request);
6c7a06a3
TT
677 continue;
678
679 case EINVAL:
680 /* Incomplete input sequence. Let the caller know, and
681 arrange for future calls to see EOF. */
682 *out_result = wchar_iterate_incomplete;
cda6c55b
TT
683 *ptr = m_input;
684 *len = m_bytes;
685 m_bytes = 0;
6c7a06a3
TT
686 return 0;
687
688 default:
9b20d036
MS
689 perror_with_name (_("Internal error while "
690 "converting character sets"));
6c7a06a3
TT
691 }
692 }
693
694 /* We converted something. */
695 num = out_request - out_avail / sizeof (gdb_wchar_t);
696 *out_result = wchar_iterate_ok;
cda6c55b 697 *out_chars = m_out.data ();
6c7a06a3 698 *ptr = orig_inptr;
cda6c55b 699 *len = orig_in - m_bytes;
6c7a06a3 700 return num;
e33d66ec 701 }
6c7a06a3
TT
702
703 /* Really done. */
704 *out_result = wchar_iterate_eof;
705 return -1;
234b45d4
KB
706}
707
e33d66ec 708\f
6c7a06a3 709/* The charset.c module initialization function. */
234b45d4 710
6c7a06a3 711extern initialize_file_ftype _initialize_charset; /* -Wmissing-prototype */
234b45d4 712
6c7a06a3 713static VEC (char_ptr) *charsets;
234b45d4 714
6c7a06a3 715#ifdef PHONY_ICONV
234b45d4 716
6c7a06a3
TT
717static void
718find_charset_names (void)
234b45d4 719{
a121b7c1
PA
720 /* Cast is fine here, because CHARSETS is never released. Note that
721 the vec does not hold "const char *" pointers instead of "char *"
722 because the non-phony version stores heap-allocated strings in
723 it. */
724 VEC_safe_push (char_ptr, charsets, (char *) GDB_DEFAULT_HOST_CHARSET);
6c7a06a3 725 VEC_safe_push (char_ptr, charsets, NULL);
234b45d4
KB
726}
727
6c7a06a3 728#else /* PHONY_ICONV */
fc3b640d
TT
729
730/* Sometimes, libiconv redefines iconvlist as libiconvlist -- but
731 provides different symbols in the static and dynamic libraries.
732 So, configure may see libiconvlist but not iconvlist. But, calling
733 iconvlist is the right thing to do and will work. Hence we do a
734 check here but unconditionally call iconvlist below. */
735#if defined (HAVE_ICONVLIST) || defined (HAVE_LIBICONVLIST)
234b45d4 736
6c7a06a3
TT
737/* A helper function that adds some character sets to the vector of
738 all character sets. This is a callback function for iconvlist. */
739
740static int
741add_one (unsigned int count, const char *const *names, void *data)
234b45d4 742{
6c7a06a3 743 unsigned int i;
234b45d4 744
6c7a06a3
TT
745 for (i = 0; i < count; ++i)
746 VEC_safe_push (char_ptr, charsets, xstrdup (names[i]));
234b45d4 747
6c7a06a3 748 return 0;
234b45d4
KB
749}
750
6c7a06a3
TT
751static void
752find_charset_names (void)
234b45d4 753{
6c7a06a3
TT
754 iconvlist (add_one, NULL);
755 VEC_safe_push (char_ptr, charsets, NULL);
234b45d4
KB
756}
757
6c7a06a3 758#else
234b45d4 759
40b5c9fb
DE
760/* Return non-zero if LINE (output from iconv) should be ignored.
761 Older iconv programs (e.g. 2.2.2) include the human readable
762 introduction even when stdout is not a tty. Newer versions omit
763 the intro if stdout is not a tty. */
764
765static int
766ignore_line_p (const char *line)
767{
768 /* This table is used to filter the output. If this text appears
769 anywhere in the line, it is ignored (strstr is used). */
770 static const char * const ignore_lines[] =
771 {
772 "The following",
773 "not necessarily",
774 "the FROM and TO",
775 "listed with several",
776 NULL
777 };
778 int i;
779
780 for (i = 0; ignore_lines[i] != NULL; ++i)
781 {
782 if (strstr (line, ignore_lines[i]) != NULL)
783 return 1;
784 }
785
786 return 0;
787}
788
6c7a06a3
TT
789static void
790find_charset_names (void)
234b45d4 791{
732f6a93 792 struct pex_obj *child;
a121b7c1 793 const char *args[3];
732f6a93
TT
794 int err, status;
795 int fail = 1;
478aac75 796 int flags;
9a6c7d9c 797 gdb_environ iconv_env = gdb_environ::from_host_environ ();
478aac75 798 char *iconv_program;
40b5c9fb 799
aff410f1
MS
800 /* Older iconvs, e.g. 2.2.2, don't omit the intro text if stdout is
801 not a tty. We need to recognize it and ignore it. This text is
802 subject to translation, so force LANGUAGE=C. */
9a6c7d9c
SDJ
803 iconv_env.set ("LANGUAGE", "C");
804 iconv_env.set ("LC_ALL", "C");
732f6a93 805
40618926 806 child = pex_init (PEX_USE_PIPES, "iconv", NULL);
732f6a93 807
478aac75
DE
808#ifdef ICONV_BIN
809 {
810 char *iconv_dir = relocate_gdb_directory (ICONV_BIN,
811 ICONV_BIN_RELOCATABLE);
812 iconv_program = concat (iconv_dir, SLASH_STRING, "iconv", NULL);
813 xfree (iconv_dir);
814 }
815#else
816 iconv_program = xstrdup ("iconv");
817#endif
818 args[0] = iconv_program;
732f6a93
TT
819 args[1] = "-l";
820 args[2] = NULL;
478aac75
DE
821 flags = PEX_STDERR_TO_STDOUT;
822#ifndef ICONV_BIN
823 flags |= PEX_SEARCH;
824#endif
732f6a93 825 /* Note that we simply ignore errors here. */
478aac75 826 if (!pex_run_in_environment (child, flags,
a121b7c1 827 args[0], const_cast<char **> (args),
9a6c7d9c 828 iconv_env.envp (),
40b5c9fb 829 NULL, NULL, &err))
732f6a93
TT
830 {
831 FILE *in = pex_read_output (child, 0);
832
833 /* POSIX says that iconv -l uses an unspecified format. We
834 parse the glibc and libiconv formats; feel free to add others
835 as needed. */
40b5c9fb 836
1d6b2d2b 837 while (in != NULL && !feof (in))
732f6a93
TT
838 {
839 /* The size of buf is chosen arbitrarily. */
840 char buf[1024];
841 char *start, *r;
8ea13695 842 int len;
732f6a93
TT
843
844 r = fgets (buf, sizeof (buf), in);
845 if (!r)
846 break;
847 len = strlen (r);
848 if (len <= 3)
849 continue;
40b5c9fb
DE
850 if (ignore_line_p (r))
851 continue;
852
732f6a93
TT
853 /* Strip off the newline. */
854 --len;
855 /* Strip off one or two '/'s. glibc will print lines like
856 "8859_7//", but also "10646-1:1993/UCS4/". */
857 if (buf[len - 1] == '/')
858 --len;
859 if (buf[len - 1] == '/')
860 --len;
861 buf[len] = '\0';
862
863 /* libiconv will print multiple entries per line, separated
aff410f1
MS
864 by spaces. Older iconvs will print multiple entries per
865 line, indented by two spaces, and separated by ", "
40b5c9fb 866 (i.e. the human readable form). */
732f6a93
TT
867 start = buf;
868 while (1)
869 {
870 int keep_going;
871 char *p;
872
40b5c9fb
DE
873 /* Skip leading blanks. */
874 for (p = start; *p && *p == ' '; ++p)
875 ;
876 start = p;
877 /* Find the next space, comma, or end-of-line. */
878 for ( ; *p && *p != ' ' && *p != ','; ++p)
732f6a93
TT
879 ;
880 /* Ignore an empty result. */
881 if (p == start)
882 break;
883 keep_going = *p;
884 *p = '\0';
885 VEC_safe_push (char_ptr, charsets, xstrdup (start));
886 if (!keep_going)
887 break;
888 /* Skip any extra spaces. */
889 for (start = p + 1; *start && *start == ' '; ++start)
890 ;
891 }
892 }
234b45d4 893
732f6a93
TT
894 if (pex_get_status (child, 1, &status)
895 && WIFEXITED (status) && !WEXITSTATUS (status))
896 fail = 0;
234b45d4 897
6c7a06a3 898 }
234b45d4 899
478aac75 900 xfree (iconv_program);
732f6a93 901 pex_free (child);
234b45d4 902
732f6a93
TT
903 if (fail)
904 {
905 /* Some error occurred, so drop the vector. */
e4ab2fad
JK
906 free_char_ptr_vec (charsets);
907 charsets = NULL;
732f6a93
TT
908 }
909 else
910 VEC_safe_push (char_ptr, charsets, NULL);
6c7a06a3 911}
234b45d4 912
fc3b640d 913#endif /* HAVE_ICONVLIST || HAVE_LIBICONVLIST */
6c7a06a3 914#endif /* PHONY_ICONV */
234b45d4 915
f870a310
TT
916/* The "auto" target charset used by default_auto_charset. */
917static const char *auto_target_charset_name = GDB_DEFAULT_TARGET_CHARSET;
918
919const char *
920default_auto_charset (void)
921{
922 return auto_target_charset_name;
923}
924
925const char *
926default_auto_wide_charset (void)
927{
928 return GDB_DEFAULT_TARGET_WIDE_CHARSET;
929}
930
bcb28afc
PM
931
932#ifdef USE_INTERMEDIATE_ENCODING_FUNCTION
933/* Macro used for UTF or UCS endianness suffix. */
934#if WORDS_BIGENDIAN
935#define ENDIAN_SUFFIX "BE"
936#else
937#define ENDIAN_SUFFIX "LE"
938#endif
939
940/* The code below serves to generate a compile time error if
941 gdb_wchar_t type is not of size 2 nor 4, despite the fact that
942 macro __STDC_ISO_10646__ is defined.
943 This is better than a gdb_assert call, because GDB cannot handle
944 strings correctly if this size is different. */
945
946extern char your_gdb_wchar_t_is_bogus[(sizeof (gdb_wchar_t) == 2
947 || sizeof (gdb_wchar_t) == 4)
948 ? 1 : -1];
949
ee34b3f9 950/* intermediate_encoding returns the charset used internally by
bcb28afc
PM
951 GDB to convert between target and host encodings. As the test above
952 compiled, sizeof (gdb_wchar_t) is either 2 or 4 bytes.
953 UTF-16/32 is tested first, UCS-2/4 is tested as a second option,
954 otherwise an error is generated. */
955
956const char *
957intermediate_encoding (void)
958{
959 iconv_t desc;
960 static const char *stored_result = NULL;
961 char *result;
bcb28afc
PM
962
963 if (stored_result)
964 return stored_result;
965 result = xstrprintf ("UTF-%d%s", (int) (sizeof (gdb_wchar_t) * 8),
966 ENDIAN_SUFFIX);
967 /* Check that the name is supported by iconv_open. */
968 desc = iconv_open (result, host_charset ());
969 if (desc != (iconv_t) -1)
970 {
971 iconv_close (desc);
972 stored_result = result;
973 return result;
974 }
975 /* Not valid, free the allocated memory. */
976 xfree (result);
977 /* Second try, with UCS-2 type. */
978 result = xstrprintf ("UCS-%d%s", (int) sizeof (gdb_wchar_t),
979 ENDIAN_SUFFIX);
980 /* Check that the name is supported by iconv_open. */
981 desc = iconv_open (result, host_charset ());
982 if (desc != (iconv_t) -1)
983 {
984 iconv_close (desc);
985 stored_result = result;
986 return result;
987 }
988 /* Not valid, free the allocated memory. */
989 xfree (result);
990 /* No valid charset found, generate error here. */
991 error (_("Unable to find a vaild charset for string conversions"));
992}
993
994#endif /* USE_INTERMEDIATE_ENCODING_FUNCTION */
995
234b45d4
KB
996void
997_initialize_charset (void)
998{
f870a310 999 /* The first element is always "auto". */
732f6a93 1000 VEC_safe_push (char_ptr, charsets, xstrdup ("auto"));
6c7a06a3
TT
1001 find_charset_names ();
1002
1003 if (VEC_length (char_ptr, charsets) > 1)
1004 charset_enum = (const char **) VEC_address (char_ptr, charsets);
1005 else
1006 charset_enum = default_charset_names;
1007
1008#ifndef PHONY_ICONV
1009#ifdef HAVE_LANGINFO_CODESET
f870a310
TT
1010 /* The result of nl_langinfo may be overwritten later. This may
1011 leak a little memory, if the user later changes the host charset,
1012 but that doesn't matter much. */
1013 auto_host_charset_name = xstrdup (nl_langinfo (CODESET));
aff410f1
MS
1014 /* Solaris will return `646' here -- but the Solaris iconv then does
1015 not accept this. Darwin (and maybe FreeBSD) may return "" here,
06be6983
TG
1016 which GNU libiconv doesn't like (infinite loop). */
1017 if (!strcmp (auto_host_charset_name, "646") || !*auto_host_charset_name)
58720494 1018 auto_host_charset_name = "ASCII";
f870a310
TT
1019 auto_target_charset_name = auto_host_charset_name;
1020#elif defined (USE_WIN32API)
1021 {
3e43a32a
MS
1022 /* "CP" + x<=5 digits + paranoia. */
1023 static char w32_host_default_charset[16];
f870a310
TT
1024
1025 snprintf (w32_host_default_charset, sizeof w32_host_default_charset,
1026 "CP%d", GetACP());
1027 auto_host_charset_name = w32_host_default_charset;
1028 auto_target_charset_name = auto_host_charset_name;
1029 }
6c7a06a3
TT
1030#endif
1031#endif
e33d66ec 1032
7ab04401 1033 add_setshow_enum_cmd ("charset", class_support,
f870a310 1034 charset_enum, &host_charset_name, _("\
7ab04401
AC
1035Set the host and target character sets."), _("\
1036Show the host and target character sets."), _("\
3d263c1d
BI
1037The `host character set' is the one used by the system GDB is running on.\n\
1038The `target character set' is the one used by the program being debugged.\n\
1039You may only use supersets of ASCII for your host character set; GDB does\n\
1040not support any others.\n\
1041To see a list of the character sets GDB supports, type `set charset <TAB>'."),
7ab04401
AC
1042 /* Note that the sfunc below needs to set
1043 target_charset_name, because the 'set
1044 charset' command sets two variables. */
1045 set_charset_sfunc,
1046 show_charset,
1047 &setlist, &showlist);
1048
1049 add_setshow_enum_cmd ("host-charset", class_support,
6c7a06a3 1050 charset_enum, &host_charset_name, _("\
7ab04401
AC
1051Set the host character set."), _("\
1052Show the host character set."), _("\
3d263c1d
BI
1053The `host character set' is the one used by the system GDB is running on.\n\
1054You may only use supersets of ASCII for your host character set; GDB does\n\
ac74f770
MS
1055not support any others.\n\
1056To see a list of the character sets GDB supports, type `set host-charset <TAB>'."),
7ab04401 1057 set_host_charset_sfunc,
920d2a44 1058 show_host_charset_name,
7ab04401
AC
1059 &setlist, &showlist);
1060
1061 add_setshow_enum_cmd ("target-charset", class_support,
f870a310 1062 charset_enum, &target_charset_name, _("\
7ab04401
AC
1063Set the target character set."), _("\
1064Show the target character set."), _("\
3d263c1d
BI
1065The `target character set' is the one used by the program being debugged.\n\
1066GDB translates characters and strings between the host and target\n\
b670013c 1067character sets as needed.\n\
ac74f770 1068To see a list of the character sets GDB supports, type `set target-charset'<TAB>"),
7ab04401 1069 set_target_charset_sfunc,
920d2a44 1070 show_target_charset_name,
7ab04401 1071 &setlist, &showlist);
6c7a06a3
TT
1072
1073 add_setshow_enum_cmd ("target-wide-charset", class_support,
f870a310 1074 charset_enum, &target_wide_charset_name,
6c7a06a3
TT
1075 _("\
1076Set the target wide character set."), _("\
1077Show the target wide character set."), _("\
3e43a32a
MS
1078The `target wide character set' is the one used by the program being debugged.\
1079\nIn particular it is the encoding used by `wchar_t'.\n\
6c7a06a3
TT
1080GDB translates characters and strings between the host and target\n\
1081character sets as needed.\n\
1082To see a list of the character sets GDB supports, type\n\
1083`set target-wide-charset'<TAB>"),
1084 set_target_wide_charset_sfunc,
1085 show_target_wide_charset_name,
1086 &setlist, &showlist);
234b45d4 1087}
This page took 0.922714 seconds and 4 git commands to generate.