[ARM] Fix assembly comment syntax in -mprint-tune-info
[official-gcc.git] / gcc / gimple-ssa-sprintf.c
blobe6cc31d1c4831ee49b40b0b4b7609eecc90f9ce0
1 /* Copyright (C) 2016-2017 Free Software Foundation, Inc.
2 Contributed by Martin Sebor <msebor@redhat.com>.
4 This file is part of GCC.
6 GCC is free software; you can redistribute it and/or modify it under
7 the terms of the GNU General Public License as published by the Free
8 Software Foundation; either version 3, or (at your option) any later
9 version.
11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 for more details.
16 You should have received a copy of the GNU General Public License
17 along with GCC; see the file COPYING3. If not see
18 <http://www.gnu.org/licenses/>. */
20 /* This file implements the printf-return-value pass. The pass does
21 two things: 1) it analyzes calls to formatted output functions like
22 sprintf looking for possible buffer overflows and calls to bounded
23 functions like snprintf for early truncation (and under the control
24 of the -Wformat-length option issues warnings), and 2) under the
25 control of the -fprintf-return-value option it folds the return
26 value of safe calls into constants, making it possible to eliminate
27 code that depends on the value of those constants.
29 For all functions (bounded or not) the pass uses the size of the
30 destination object. That means that it will diagnose calls to
31 snprintf not on the basis of the size specified by the function's
32 second argument but rathger on the basis of the size the first
33 argument points to (if possible). For bound-checking built-ins
34 like __builtin___snprintf_chk the pass uses the size typically
35 determined by __builtin_object_size and passed to the built-in
36 by the Glibc inline wrapper.
38 The pass handles all forms standard sprintf format directives,
39 including character, integer, floating point, pointer, and strings,
40 with the standard C flags, widths, and precisions. For integers
41 and strings it computes the length of output itself. For floating
42 point it uses MPFR to fornmat known constants with up and down
43 rounding and uses the resulting range of output lengths. For
44 strings it uses the length of string literals and the sizes of
45 character arrays that a character pointer may point to as a bound
46 on the longest string. */
48 #include "config.h"
49 #include "system.h"
50 #include "coretypes.h"
51 #include "backend.h"
52 #include "tree.h"
53 #include "gimple.h"
54 #include "tree-pass.h"
55 #include "ssa.h"
56 #include "gimple-fold.h"
57 #include "gimple-pretty-print.h"
58 #include "diagnostic-core.h"
59 #include "fold-const.h"
60 #include "gimple-iterator.h"
61 #include "tree-ssa.h"
62 #include "tree-object-size.h"
63 #include "params.h"
64 #include "tree-cfg.h"
65 #include "tree-ssa-propagate.h"
66 #include "calls.h"
67 #include "cfgloop.h"
68 #include "intl.h"
70 #include "builtins.h"
71 #include "stor-layout.h"
73 #include "realmpfr.h"
74 #include "target.h"
76 #include "cpplib.h"
77 #include "input.h"
78 #include "toplev.h"
79 #include "substring-locations.h"
80 #include "diagnostic.h"
82 /* The likely worst case value of MB_LEN_MAX for the target, large enough
83 for UTF-8. Ideally, this would be obtained by a target hook if it were
84 to be used for optimization but it's good enough as is for warnings. */
85 #define target_mb_len_max() 6
87 /* The maximum number of bytes a single non-string directive can result
88 in. This is the result of printf("%.*Lf", INT_MAX, -LDBL_MAX) for
89 LDBL_MAX_10_EXP of 4932. */
90 #define IEEE_MAX_10_EXP 4932
91 #define target_dir_max() (target_int_max () + IEEE_MAX_10_EXP + 2)
93 namespace {
95 const pass_data pass_data_sprintf_length = {
96 GIMPLE_PASS, // pass type
97 "printf-return-value", // pass name
98 OPTGROUP_NONE, // optinfo_flags
99 TV_NONE, // tv_id
100 PROP_cfg, // properties_required
101 0, // properties_provided
102 0, // properties_destroyed
103 0, // properties_start
104 0, // properties_finish
107 /* Set to the warning level for the current function which is equal
108 either to warn_format_trunc for bounded functions or to
109 warn_format_overflow otherwise. */
111 static int warn_level;
113 struct format_result;
115 class pass_sprintf_length : public gimple_opt_pass
117 bool fold_return_value;
119 public:
120 pass_sprintf_length (gcc::context *ctxt)
121 : gimple_opt_pass (pass_data_sprintf_length, ctxt),
122 fold_return_value (false)
125 opt_pass * clone () { return new pass_sprintf_length (m_ctxt); }
127 virtual bool gate (function *);
129 virtual unsigned int execute (function *);
131 void set_pass_param (unsigned int n, bool param)
133 gcc_assert (n == 0);
134 fold_return_value = param;
137 bool handle_gimple_call (gimple_stmt_iterator *);
139 struct call_info;
140 bool compute_format_length (call_info &, format_result *);
143 bool
144 pass_sprintf_length::gate (function *)
146 /* Run the pass iff -Warn-format-overflow or -Warn-format-truncation
147 is specified and either not optimizing and the pass is being invoked
148 early, or when optimizing and the pass is being invoked during
149 optimization (i.e., "late"). */
150 return ((warn_format_overflow > 0
151 || warn_format_trunc > 0
152 || flag_printf_return_value)
153 && (optimize > 0) == fold_return_value);
156 /* The minimum, maximum, likely, and unlikely maximum number of bytes
157 of output either a formatting function or an individual directive
158 can result in. */
160 struct result_range
162 /* The absolute minimum number of bytes. The result of a successful
163 conversion is guaranteed to be no less than this. (An erroneous
164 conversion can be indicated by MIN > HOST_WIDE_INT_MAX.) */
165 unsigned HOST_WIDE_INT min;
166 /* The likely maximum result that is used in diagnostics. In most
167 cases MAX is the same as the worst case UNLIKELY result. */
168 unsigned HOST_WIDE_INT max;
169 /* The likely result used to trigger diagnostics. For conversions
170 that result in a range of bytes [MIN, MAX], LIKELY is somewhere
171 in that range. */
172 unsigned HOST_WIDE_INT likely;
173 /* In rare cases (e.g., for nultibyte characters) UNLIKELY gives
174 the worst cases maximum result of a directive. In most cases
175 UNLIKELY == MAX. UNLIKELY is used to control the return value
176 optimization but not in diagnostics. */
177 unsigned HOST_WIDE_INT unlikely;
180 /* The result of a call to a formatted function. */
182 struct format_result
184 /* Range of characters written by the formatted function.
185 Setting the minimum to HOST_WIDE_INT_MAX disables all
186 length tracking for the remainder of the format string. */
187 result_range range;
189 /* True when the range above is obtained from known values of
190 directive arguments, or bounds on the amount of output such
191 as width and precision, and not the result of heuristics that
192 depend on warning levels. It's used to issue stricter diagnostics
193 in cases where strings of unknown lengths are bounded by the arrays
194 they are determined to refer to. KNOWNRANGE must not be used for
195 the return value optimization. */
196 bool knownrange;
198 /* True if no individual directive resulted in more than 4095 bytes
199 of output (the total NUMBER_CHARS_{MIN,MAX} might be greater).
200 Implementations are not required to handle directives that produce
201 more than 4K bytes (leading to undefined behavior) and so when one
202 is found it disables the return value optimization. */
203 bool under4k;
205 /* True when a floating point directive has been seen in the format
206 string. */
207 bool floating;
209 /* True when an intermediate result has caused a warning. Used to
210 avoid issuing duplicate warnings while finishing the processing
211 of a call. WARNED also disables the return value optimization. */
212 bool warned;
214 /* Preincrement the number of output characters by 1. */
215 format_result& operator++ ()
217 return *this += 1;
220 /* Postincrement the number of output characters by 1. */
221 format_result operator++ (int)
223 format_result prev (*this);
224 *this += 1;
225 return prev;
228 /* Increment the number of output characters by N. */
229 format_result& operator+= (unsigned HOST_WIDE_INT);
232 format_result&
233 format_result::operator+= (unsigned HOST_WIDE_INT n)
235 gcc_assert (n < HOST_WIDE_INT_MAX);
237 if (range.min < HOST_WIDE_INT_MAX)
238 range.min += n;
240 if (range.max < HOST_WIDE_INT_MAX)
241 range.max += n;
243 if (range.likely < HOST_WIDE_INT_MAX)
244 range.likely += n;
246 if (range.unlikely < HOST_WIDE_INT_MAX)
247 range.unlikely += n;
249 return *this;
252 /* Return the value of INT_MIN for the target. */
254 static inline HOST_WIDE_INT
255 target_int_min ()
257 return tree_to_shwi (TYPE_MIN_VALUE (integer_type_node));
260 /* Return the value of INT_MAX for the target. */
262 static inline unsigned HOST_WIDE_INT
263 target_int_max ()
265 return tree_to_uhwi (TYPE_MAX_VALUE (integer_type_node));
268 /* Return the value of SIZE_MAX for the target. */
270 static inline unsigned HOST_WIDE_INT
271 target_size_max ()
273 return tree_to_uhwi (TYPE_MAX_VALUE (size_type_node));
276 /* Return the constant initial value of DECL if available or DECL
277 otherwise. Same as the synonymous function in c/c-typeck.c. */
279 static tree
280 decl_constant_value (tree decl)
282 if (/* Don't change a variable array bound or initial value to a constant
283 in a place where a variable is invalid. Note that DECL_INITIAL
284 isn't valid for a PARM_DECL. */
285 current_function_decl != 0
286 && TREE_CODE (decl) != PARM_DECL
287 && !TREE_THIS_VOLATILE (decl)
288 && TREE_READONLY (decl)
289 && DECL_INITIAL (decl) != 0
290 && TREE_CODE (DECL_INITIAL (decl)) != ERROR_MARK
291 /* This is invalid if initial value is not constant.
292 If it has either a function call, a memory reference,
293 or a variable, then re-evaluating it could give different results. */
294 && TREE_CONSTANT (DECL_INITIAL (decl))
295 /* Check for cases where this is sub-optimal, even though valid. */
296 && TREE_CODE (DECL_INITIAL (decl)) != CONSTRUCTOR)
297 return DECL_INITIAL (decl);
298 return decl;
301 /* Given FORMAT, set *PLOC to the source location of the format string
302 and return the format string if it is known or null otherwise. */
304 static const char*
305 get_format_string (tree format, location_t *ploc)
307 if (VAR_P (format))
309 /* Pull out a constant value if the front end didn't. */
310 format = decl_constant_value (format);
311 STRIP_NOPS (format);
314 if (integer_zerop (format))
316 /* FIXME: Diagnose null format string if it hasn't been diagnosed
317 by -Wformat (the latter diagnoses only nul pointer constants,
318 this pass can do better). */
319 return NULL;
322 HOST_WIDE_INT offset = 0;
324 if (TREE_CODE (format) == POINTER_PLUS_EXPR)
326 tree arg0 = TREE_OPERAND (format, 0);
327 tree arg1 = TREE_OPERAND (format, 1);
328 STRIP_NOPS (arg0);
329 STRIP_NOPS (arg1);
331 if (TREE_CODE (arg1) != INTEGER_CST)
332 return NULL;
334 format = arg0;
336 /* POINTER_PLUS_EXPR offsets are to be interpreted signed. */
337 if (!cst_and_fits_in_hwi (arg1))
338 return NULL;
340 offset = int_cst_value (arg1);
343 if (TREE_CODE (format) != ADDR_EXPR)
344 return NULL;
346 *ploc = EXPR_LOC_OR_LOC (format, input_location);
348 format = TREE_OPERAND (format, 0);
350 if (TREE_CODE (format) == ARRAY_REF
351 && tree_fits_shwi_p (TREE_OPERAND (format, 1))
352 && (offset += tree_to_shwi (TREE_OPERAND (format, 1))) >= 0)
353 format = TREE_OPERAND (format, 0);
355 if (offset < 0)
356 return NULL;
358 tree array_init;
359 tree array_size = NULL_TREE;
361 if (VAR_P (format)
362 && TREE_CODE (TREE_TYPE (format)) == ARRAY_TYPE
363 && (array_init = decl_constant_value (format)) != format
364 && TREE_CODE (array_init) == STRING_CST)
366 /* Extract the string constant initializer. Note that this may
367 include a trailing NUL character that is not in the array (e.g.
368 const char a[3] = "foo";). */
369 array_size = DECL_SIZE_UNIT (format);
370 format = array_init;
373 if (TREE_CODE (format) != STRING_CST)
374 return NULL;
376 if (TYPE_MAIN_VARIANT (TREE_TYPE (TREE_TYPE (format))) != char_type_node)
378 /* Wide format string. */
379 return NULL;
382 const char *fmtstr = TREE_STRING_POINTER (format);
383 unsigned fmtlen = TREE_STRING_LENGTH (format);
385 if (array_size)
387 /* Variable length arrays can't be initialized. */
388 gcc_assert (TREE_CODE (array_size) == INTEGER_CST);
390 if (tree_fits_shwi_p (array_size))
392 HOST_WIDE_INT array_size_value = tree_to_shwi (array_size);
393 if (array_size_value > 0
394 && array_size_value == (int) array_size_value
395 && fmtlen > array_size_value)
396 fmtlen = array_size_value;
399 if (offset)
401 if (offset >= fmtlen)
402 return NULL;
404 fmtstr += offset;
405 fmtlen -= offset;
408 if (fmtlen < 1 || fmtstr[--fmtlen] != 0)
410 /* FIXME: Diagnose an unterminated format string if it hasn't been
411 diagnosed by -Wformat. Similarly to a null format pointer,
412 -Wformay diagnoses only nul pointer constants, this pass can
413 do better). */
414 return NULL;
417 return fmtstr;
420 /* The format_warning_at_substring function is not used here in a way
421 that makes using attribute format viable. Suppress the warning. */
423 #pragma GCC diagnostic push
424 #pragma GCC diagnostic ignored "-Wsuggest-attribute=format"
426 /* For convenience and brevity. */
428 static bool
429 (* const fmtwarn) (const substring_loc &, const source_range *,
430 const char *, int, const char *, ...)
431 = format_warning_at_substring;
433 /* Format length modifiers. */
435 enum format_lengths
437 FMT_LEN_none,
438 FMT_LEN_hh, // char argument
439 FMT_LEN_h, // short
440 FMT_LEN_l, // long
441 FMT_LEN_ll, // long long
442 FMT_LEN_L, // long double (and GNU long long)
443 FMT_LEN_z, // size_t
444 FMT_LEN_t, // ptrdiff_t
445 FMT_LEN_j // intmax_t
449 /* Description of the result of conversion either of a single directive
450 or the whole format string. */
452 struct fmtresult
454 /* Construct a FMTRESULT object with all counters initialized
455 to MIN. KNOWNRANGE is set when MIN is valid. */
456 fmtresult (unsigned HOST_WIDE_INT min = HOST_WIDE_INT_MAX)
457 : argmin (), argmax (),
458 knownrange (min < HOST_WIDE_INT_MAX),
459 nullp ()
461 range.min = min;
462 range.max = min;
463 range.likely = min;
464 range.unlikely = min;
467 /* Construct a FMTRESULT object with MIN, MAX, and LIKELY counters.
468 KNOWNRANGE is set when both MIN and MAX are valid. */
469 fmtresult (unsigned HOST_WIDE_INT min, unsigned HOST_WIDE_INT max,
470 unsigned HOST_WIDE_INT likely = HOST_WIDE_INT_MAX)
471 : argmin (), argmax (),
472 knownrange (min < HOST_WIDE_INT_MAX && max < HOST_WIDE_INT_MAX),
473 nullp ()
475 range.min = min;
476 range.max = max;
477 range.likely = max < likely ? min : likely;
478 range.unlikely = max;
481 /* Adjust result upward to reflect the RANGE of values the specified
482 width or precision is known to be in. */
483 fmtresult& adjust_for_width_or_precision (const HOST_WIDE_INT[2],
484 tree = NULL_TREE,
485 unsigned = 0, unsigned = 0);
487 /* Return the maximum number of decimal digits a value of TYPE
488 formats as on output. */
489 static unsigned type_max_digits (tree, int);
491 /* The range a directive's argument is in. */
492 tree argmin, argmax;
494 /* The minimum and maximum number of bytes that a directive
495 results in on output for an argument in the range above. */
496 result_range range;
498 /* True when the range above is obtained from a known value of
499 a directive's argument or its bounds and not the result of
500 heuristics that depend on warning levels. */
501 bool knownrange;
503 /* True when the argument is a null pointer. */
504 bool nullp;
507 /* Adjust result upward to reflect the range ADJUST of values the
508 specified width or precision is known to be in. When non-null,
509 TYPE denotes the type of the directive whose result is being
510 adjusted, BASE gives the base of the directive (octal, decimal,
511 or hex), and ADJ denotes the additional adjustment to the LIKELY
512 counter that may need to be added when ADJUST is a range. */
514 fmtresult&
515 fmtresult::adjust_for_width_or_precision (const HOST_WIDE_INT adjust[2],
516 tree type /* = NULL_TREE */,
517 unsigned base /* = 0 */,
518 unsigned adj /* = 0 */)
520 bool minadjusted = false;
522 /* Adjust the minimum and likely counters. */
523 if (adjust[0] >= 0)
525 if (range.min < (unsigned HOST_WIDE_INT)adjust[0])
527 range.min = adjust[0];
528 minadjusted = true;
531 /* Adjust the likely counter. */
532 if (range.likely < range.min)
533 range.likely = range.min;
535 else if (adjust[0] == target_int_min ()
536 && (unsigned HOST_WIDE_INT)adjust[1] == target_int_max ())
537 knownrange = false;
539 /* Adjust the maximum counter. */
540 if (adjust[1] > 0)
542 if (range.max < (unsigned HOST_WIDE_INT)adjust[1])
544 range.max = adjust[1];
546 /* Set KNOWNRANGE if both the minimum and maximum have been
547 adjusted. Otherwise leave it at what it was before. */
548 knownrange = minadjusted;
552 if (warn_level > 1 && type)
554 /* For large non-constant width or precision whose range spans
555 the maximum number of digits produced by the directive for
556 any argument, set the likely number of bytes to be at most
557 the number digits plus other adjustment determined by the
558 caller (one for sign or two for the hexadecimal "0x"
559 prefix). */
560 unsigned dirdigs = type_max_digits (type, base);
561 if (adjust[0] < dirdigs && dirdigs < adjust[1]
562 && range.likely < dirdigs)
563 range.likely = dirdigs + adj;
565 else if (range.likely < (range.min ? range.min : 1))
567 /* Conservatively, set LIKELY to at least MIN but no less than
568 1 unless MAX is zero. */
569 range.likely = (range.min
570 ? range.min
571 : range.max && (range.max < HOST_WIDE_INT_MAX
572 || warn_level > 1) ? 1 : 0);
575 /* Finally adjust the unlikely counter to be at least as large as
576 the maximum. */
577 if (range.unlikely < range.max)
578 range.unlikely = range.max;
580 return *this;
583 /* Return the maximum number of digits a value of TYPE formats in
584 BASE on output, not counting base prefix . */
586 unsigned
587 fmtresult::type_max_digits (tree type, int base)
589 unsigned prec = TYPE_PRECISION (type);
590 if (base == 8)
591 return (prec + 2) / 3;
593 if (base == 16)
594 return prec / 4;
596 /* Decimal approximation: yields 3, 5, 10, and 20 for precision
597 of 8, 16, 32, and 64 bits. */
598 return prec * 301 / 1000 + 1;
601 static bool
602 get_int_range (tree, tree, HOST_WIDE_INT *, HOST_WIDE_INT *,
603 bool, HOST_WIDE_INT);
605 /* Description of a format directive. A directive is either a plain
606 string or a conversion specification that starts with '%'. */
608 struct directive
610 /* The 1-based directive number (for debugging). */
611 unsigned dirno;
613 /* The first character of the directive and its length. */
614 const char *beg;
615 size_t len;
617 /* A bitmap of flags, one for each character. */
618 unsigned flags[256 / sizeof (int)];
620 /* The range of values of the specified width, or -1 if not specified. */
621 HOST_WIDE_INT width[2];
622 /* The range of values of the specified precision, or -1 if not
623 specified. */
624 HOST_WIDE_INT prec[2];
626 /* Length modifier. */
627 format_lengths modifier;
629 /* Format specifier character. */
630 char specifier;
632 /* The argument of the directive or null when the directive doesn't
633 take one or when none is available (such as for vararg functions). */
634 tree arg;
636 /* Format conversion function that given a directive and an argument
637 returns the formatting result. */
638 fmtresult (*fmtfunc) (const directive &, tree);
640 /* Return True when a the format flag CHR has been used. */
641 bool get_flag (char chr) const
643 unsigned char c = chr & 0xff;
644 return (flags[c / (CHAR_BIT * sizeof *flags)]
645 & (1U << (c % (CHAR_BIT * sizeof *flags))));
648 /* Make a record of the format flag CHR having been used. */
649 void set_flag (char chr)
651 unsigned char c = chr & 0xff;
652 flags[c / (CHAR_BIT * sizeof *flags)]
653 |= (1U << (c % (CHAR_BIT * sizeof *flags)));
656 /* Reset the format flag CHR. */
657 void clear_flag (char chr)
659 unsigned char c = chr & 0xff;
660 flags[c / (CHAR_BIT * sizeof *flags)]
661 &= ~(1U << (c % (CHAR_BIT * sizeof *flags)));
664 /* Set both bounds of the width range to VAL. */
665 void set_width (HOST_WIDE_INT val)
667 width[0] = width[1] = val;
670 /* Set the width range according to ARG, with both bounds being
671 no less than 0. For a constant ARG set both bounds to its value
672 or 0, whichever is greater. For a non-constant ARG in some range
673 set width to its range adjusting each bound to -1 if it's less.
674 For an indeterminate ARG set width to [0, INT_MAX]. */
675 void set_width (tree arg)
677 get_int_range (arg, integer_type_node, width, width + 1, true, 0);
680 /* Set both bounds of the precision range to VAL. */
681 void set_precision (HOST_WIDE_INT val)
683 prec[0] = prec[1] = val;
686 /* Set the precision range according to ARG, with both bounds being
687 no less than -1. For a constant ARG set both bounds to its value
688 or -1 whichever is greater. For a non-constant ARG in some range
689 set precision to its range adjusting each bound to -1 if it's less.
690 For an indeterminate ARG set precision to [-1, INT_MAX]. */
691 void set_precision (tree arg)
693 get_int_range (arg, integer_type_node, prec, prec + 1, false, -1);
697 /* Return the logarithm of X in BASE. */
699 static int
700 ilog (unsigned HOST_WIDE_INT x, int base)
702 int res = 0;
705 ++res;
706 x /= base;
707 } while (x);
708 return res;
711 /* Return the number of bytes resulting from converting into a string
712 the INTEGER_CST tree node X in BASE with a minimum of PREC digits.
713 PLUS indicates whether 1 for a plus sign should be added for positive
714 numbers, and PREFIX whether the length of an octal ('O') or hexadecimal
715 ('0x') prefix should be added for nonzero numbers. Return -1 if X cannot
716 be represented. */
718 static HOST_WIDE_INT
719 tree_digits (tree x, int base, HOST_WIDE_INT prec, bool plus, bool prefix)
721 unsigned HOST_WIDE_INT absval;
723 HOST_WIDE_INT res;
725 if (TYPE_UNSIGNED (TREE_TYPE (x)))
727 if (tree_fits_uhwi_p (x))
729 absval = tree_to_uhwi (x);
730 res = plus;
732 else
733 return -1;
735 else
737 if (tree_fits_shwi_p (x))
739 HOST_WIDE_INT i = tree_to_shwi (x);
740 if (HOST_WIDE_INT_MIN == i)
742 /* Avoid undefined behavior due to negating a minimum. */
743 absval = HOST_WIDE_INT_MAX;
744 res = 1;
746 else if (i < 0)
748 absval = -i;
749 res = 1;
751 else
753 absval = i;
754 res = plus;
757 else
758 return -1;
761 int ndigs = ilog (absval, base);
763 res += prec < ndigs ? ndigs : prec;
765 /* Adjust a non-zero value for the base prefix, either hexadecimal,
766 or, unless precision has resulted in a leading zero, also octal. */
767 if (prefix && absval && (base == 16 || prec <= ndigs))
769 if (base == 8)
770 res += 1;
771 else if (base == 16)
772 res += 2;
775 return res;
778 /* Given the formatting result described by RES and NAVAIL, the number
779 of available in the destination, return the range of bytes remaining
780 in the destination. */
782 static inline result_range
783 bytes_remaining (unsigned HOST_WIDE_INT navail, const format_result &res)
785 result_range range;
787 if (HOST_WIDE_INT_MAX <= navail)
789 range.min = range.max = range.likely = range.unlikely = navail;
790 return range;
793 /* The lower bound of the available range is the available size
794 minus the maximum output size, and the upper bound is the size
795 minus the minimum. */
796 range.max = res.range.min < navail ? navail - res.range.min : 0;
798 range.likely = res.range.likely < navail ? navail - res.range.likely : 0;
800 if (res.range.max < HOST_WIDE_INT_MAX)
801 range.min = res.range.max < navail ? navail - res.range.max : 0;
802 else
803 range.min = range.likely;
805 range.unlikely = (res.range.unlikely < navail
806 ? navail - res.range.unlikely : 0);
808 return range;
811 /* Description of a call to a formatted function. */
813 struct pass_sprintf_length::call_info
815 /* Function call statement. */
816 gimple *callstmt;
818 /* Function called. */
819 tree func;
821 /* Called built-in function code. */
822 built_in_function fncode;
824 /* Format argument and format string extracted from it. */
825 tree format;
826 const char *fmtstr;
828 /* The location of the format argument. */
829 location_t fmtloc;
831 /* The destination object size for __builtin___xxx_chk functions
832 typically determined by __builtin_object_size, or -1 if unknown. */
833 unsigned HOST_WIDE_INT objsize;
835 /* Number of the first variable argument. */
836 unsigned HOST_WIDE_INT argidx;
838 /* True for functions like snprintf that specify the size of
839 the destination, false for others like sprintf that don't. */
840 bool bounded;
842 /* True for bounded functions like snprintf that specify a zero-size
843 buffer as a request to compute the size of output without actually
844 writing any. NOWRITE is cleared in response to the %n directive
845 which has side-effects similar to writing output. */
846 bool nowrite;
848 /* Return true if the called function's return value is used. */
849 bool retval_used () const
851 return gimple_get_lhs (callstmt);
854 /* Return the warning option corresponding to the called function. */
855 int warnopt () const
857 return bounded ? OPT_Wformat_truncation_ : OPT_Wformat_overflow_;
861 /* Return the result of formatting a no-op directive (such as '%n'). */
863 static fmtresult
864 format_none (const directive &, tree)
866 fmtresult res (0);
867 return res;
870 /* Return the result of formatting the '%%' directive. */
872 static fmtresult
873 format_percent (const directive &, tree)
875 fmtresult res (1);
876 return res;
880 /* Compute intmax_type_node and uintmax_type_node similarly to how
881 tree.c builds size_type_node. */
883 static void
884 build_intmax_type_nodes (tree *pintmax, tree *puintmax)
886 if (strcmp (UINTMAX_TYPE, "unsigned int") == 0)
888 *pintmax = integer_type_node;
889 *puintmax = unsigned_type_node;
891 else if (strcmp (UINTMAX_TYPE, "long unsigned int") == 0)
893 *pintmax = long_integer_type_node;
894 *puintmax = long_unsigned_type_node;
896 else if (strcmp (UINTMAX_TYPE, "long long unsigned int") == 0)
898 *pintmax = long_long_integer_type_node;
899 *puintmax = long_long_unsigned_type_node;
901 else
903 for (int i = 0; i < NUM_INT_N_ENTS; i++)
904 if (int_n_enabled_p[i])
906 char name[50];
907 sprintf (name, "__int%d unsigned", int_n_data[i].bitsize);
909 if (strcmp (name, UINTMAX_TYPE) == 0)
911 *pintmax = int_n_trees[i].signed_type;
912 *puintmax = int_n_trees[i].unsigned_type;
913 return;
916 gcc_unreachable ();
920 /* Determine the range [*PMIN, *PMAX] that the expression ARG of TYPE
921 is in. Return true when the range is a subrange of that of TYPE.
922 Whn ARG is null it is as if it had the full range of TYPE.
923 When ABSOLUTE is true the range reflects the absolute value of
924 the argument. When ABSOLUTE is false, negative bounds of
925 the determined range are replaced with NEGBOUND. */
927 static bool
928 get_int_range (tree arg, tree type, HOST_WIDE_INT *pmin, HOST_WIDE_INT *pmax,
929 bool absolute, HOST_WIDE_INT negbound)
931 bool knownrange = false;
933 if (!arg)
935 *pmin = (TYPE_UNSIGNED (type)
936 ? tree_to_uhwi (TYPE_MIN_VALUE (type))
937 : tree_to_shwi (TYPE_MIN_VALUE (type)));
938 *pmax = tree_to_uhwi (TYPE_MAX_VALUE (type));
940 else if (TREE_CODE (arg) == INTEGER_CST)
942 /* For a constant argument return its value adjusted as specified
943 by NEGATIVE and NEGBOUND and return true to indicate that the
944 result is known. */
945 *pmin = tree_fits_shwi_p (arg) ? tree_to_shwi (arg) : tree_to_uhwi (arg);
946 *pmax = *pmin;
947 knownrange = true;
949 else
951 /* True if the argument's range cannot be determined. */
952 bool unknown = true;
954 type = TREE_TYPE (arg);
956 if (TREE_CODE (arg) == SSA_NAME
957 && TREE_CODE (type) == INTEGER_TYPE)
959 /* Try to determine the range of values of the integer argument. */
960 wide_int min, max;
961 enum value_range_type range_type = get_range_info (arg, &min, &max);
962 if (range_type == VR_RANGE)
964 HOST_WIDE_INT type_min
965 = (TYPE_UNSIGNED (type)
966 ? tree_to_uhwi (TYPE_MIN_VALUE (type))
967 : tree_to_shwi (TYPE_MIN_VALUE (type)));
969 HOST_WIDE_INT type_max = tree_to_uhwi (TYPE_MAX_VALUE (type));
971 *pmin = min.to_shwi ();
972 *pmax = max.to_shwi ();
974 /* Return true if the adjusted range is a subrange of
975 the full range of the argument's type. */
976 knownrange = type_min < *pmin || *pmax < type_max;
978 unknown = false;
982 /* Handle an argument with an unknown range as if none had been
983 provided. */
984 if (unknown)
985 return get_int_range (NULL_TREE, type, pmin, pmax, absolute, negbound);
988 /* Adjust each bound as specified by ABSOLUTE and NEGBOUND. */
989 if (absolute)
991 if (*pmin < 0)
993 if (*pmin == *pmax)
994 *pmin = *pmax = -*pmin;
995 else
997 HOST_WIDE_INT tmp = -*pmin;
998 *pmin = 0;
999 if (*pmax < tmp)
1000 *pmax = tmp;
1004 else if (*pmin < negbound)
1005 *pmin = negbound;
1007 return knownrange;
1010 /* With the range [*ARGMIN, *ARGMAX] of an integer directive's actual
1011 argument, due to the conversion from either *ARGMIN or *ARGMAX to
1012 the type of the directive's formal argument it's possible for both
1013 to result in the same number of bytes or a range of bytes that's
1014 less than the number of bytes that would result from formatting
1015 some other value in the range [*ARGMIN, *ARGMAX]. This can be
1016 determined by checking for the actual argument being in the range
1017 of the type of the directive. If it isn't it must be assumed to
1018 take on the full range of the directive's type.
1019 Return true when the range has been adjusted to the full range
1020 of DIRTYPE, and false otherwise. */
1022 static bool
1023 adjust_range_for_overflow (tree dirtype, tree *argmin, tree *argmax)
1025 tree argtype = TREE_TYPE (*argmin);
1026 unsigned argprec = TYPE_PRECISION (argtype);
1027 unsigned dirprec = TYPE_PRECISION (dirtype);
1029 /* If the actual argument and the directive's argument have the same
1030 precision and sign there can be no overflow and so there is nothing
1031 to adjust. */
1032 if (argprec == dirprec && TYPE_SIGN (argtype) == TYPE_SIGN (dirtype))
1033 return false;
1035 /* The logic below was inspired/lifted from the CONVERT_EXPR_CODE_P
1036 branch in the extract_range_from_unary_expr function in tree-vrp.c. */
1038 if (TREE_CODE (*argmin) == INTEGER_CST
1039 && TREE_CODE (*argmax) == INTEGER_CST
1040 && (dirprec >= argprec
1041 || integer_zerop (int_const_binop (RSHIFT_EXPR,
1042 int_const_binop (MINUS_EXPR,
1043 *argmax,
1044 *argmin),
1045 size_int (dirprec)))))
1047 *argmin = force_fit_type (dirtype, wi::to_widest (*argmin), 0, false);
1048 *argmax = force_fit_type (dirtype, wi::to_widest (*argmax), 0, false);
1050 /* If *ARGMIN is still less than *ARGMAX the conversion above
1051 is safe. Otherwise, it has overflowed and would be unsafe. */
1052 if (tree_int_cst_le (*argmin, *argmax))
1053 return false;
1056 *argmin = TYPE_MIN_VALUE (dirtype);
1057 *argmax = TYPE_MAX_VALUE (dirtype);
1058 return true;
1061 /* Return a range representing the minimum and maximum number of bytes
1062 that the format directive DIR will output for any argument given
1063 the WIDTH and PRECISION (extracted from DIR). This function is
1064 used when the directive argument or its value isn't known. */
1066 static fmtresult
1067 format_integer (const directive &dir, tree arg)
1069 tree intmax_type_node;
1070 tree uintmax_type_node;
1072 /* Base to format the number in. */
1073 int base;
1075 /* True when a conversion is preceded by a prefix indicating the base
1076 of the argument (octal or hexadecimal). */
1077 bool maybebase = dir.get_flag ('#');
1079 /* True when a signed conversion is preceded by a sign or space. */
1080 bool maybesign = false;
1082 /* True for signed conversions (i.e., 'd' and 'i'). */
1083 bool sign = false;
1085 switch (dir.specifier)
1087 case 'd':
1088 case 'i':
1089 /* Space and '+' are only meaningful for signed conversions. */
1090 maybesign = dir.get_flag (' ') | dir.get_flag ('+');
1091 sign = true;
1092 base = 10;
1093 break;
1094 case 'u':
1095 base = 10;
1096 break;
1097 case 'o':
1098 base = 8;
1099 break;
1100 case 'X':
1101 case 'x':
1102 base = 16;
1103 break;
1104 default:
1105 gcc_unreachable ();
1108 /* The type of the "formal" argument expected by the directive. */
1109 tree dirtype = NULL_TREE;
1111 /* Determine the expected type of the argument from the length
1112 modifier. */
1113 switch (dir.modifier)
1115 case FMT_LEN_none:
1116 if (dir.specifier == 'p')
1117 dirtype = ptr_type_node;
1118 else
1119 dirtype = sign ? integer_type_node : unsigned_type_node;
1120 break;
1122 case FMT_LEN_h:
1123 dirtype = sign ? short_integer_type_node : short_unsigned_type_node;
1124 break;
1126 case FMT_LEN_hh:
1127 dirtype = sign ? signed_char_type_node : unsigned_char_type_node;
1128 break;
1130 case FMT_LEN_l:
1131 dirtype = sign ? long_integer_type_node : long_unsigned_type_node;
1132 break;
1134 case FMT_LEN_L:
1135 case FMT_LEN_ll:
1136 dirtype = (sign
1137 ? long_long_integer_type_node
1138 : long_long_unsigned_type_node);
1139 break;
1141 case FMT_LEN_z:
1142 dirtype = signed_or_unsigned_type_for (!sign, size_type_node);
1143 break;
1145 case FMT_LEN_t:
1146 dirtype = signed_or_unsigned_type_for (!sign, ptrdiff_type_node);
1147 break;
1149 case FMT_LEN_j:
1150 build_intmax_type_nodes (&intmax_type_node, &uintmax_type_node);
1151 dirtype = sign ? intmax_type_node : uintmax_type_node;
1152 break;
1154 default:
1155 return fmtresult ();
1158 /* The type of the argument to the directive, either deduced from
1159 the actual non-constant argument if one is known, or from
1160 the directive itself when none has been provided because it's
1161 a va_list. */
1162 tree argtype = NULL_TREE;
1164 if (!arg)
1166 /* When the argument has not been provided, use the type of
1167 the directive's argument as an approximation. This will
1168 result in false positives for directives like %i with
1169 arguments with smaller precision (such as short or char). */
1170 argtype = dirtype;
1172 else if (TREE_CODE (arg) == INTEGER_CST)
1174 /* When a constant argument has been provided use its value
1175 rather than type to determine the length of the output. */
1176 fmtresult res;
1178 if ((dir.prec[0] <= 0 && dir.prec[1] >= 0) && integer_zerop (arg))
1180 /* As a special case, a precision of zero with a zero argument
1181 results in zero bytes except in base 8 when the '#' flag is
1182 specified, and for signed conversions in base 8 and 10 when
1183 flags when either the space or '+' flag has been specified
1184 when it results in just one byte (with width having the normal
1185 effect). This must extend to the case of a specified precision
1186 with an unknown value because it can be zero. */
1187 res.range.min = ((base == 8 && dir.get_flag ('#')) || maybesign);
1188 if (res.range.min == 0 && dir.prec[0] != dir.prec[1])
1190 res.range.max = 1;
1191 res.range.likely = 1;
1193 else
1195 res.range.max = res.range.min;
1196 res.range.likely = res.range.min;
1199 else
1201 /* Convert the argument to the type of the directive. */
1202 arg = fold_convert (dirtype, arg);
1204 res.range.min = tree_digits (arg, base, dir.prec[0],
1205 maybesign, maybebase);
1206 if (dir.prec[0] == dir.prec[1])
1207 res.range.max = res.range.min;
1208 else
1209 res.range.max = tree_digits (arg, base, dir.prec[1],
1210 maybesign, maybebase);
1211 res.range.likely = res.range.min;
1214 res.range.unlikely = res.range.max;
1216 /* Bump up the counters if WIDTH is greater than LEN. */
1217 res.adjust_for_width_or_precision (dir.width, dirtype, base,
1218 (sign | maybebase) + (base == 16));
1219 /* Bump up the counters again if PRECision is greater still. */
1220 res.adjust_for_width_or_precision (dir.prec, dirtype, base,
1221 (sign | maybebase) + (base == 16));
1223 return res;
1225 else if (TREE_CODE (TREE_TYPE (arg)) == INTEGER_TYPE
1226 || TREE_CODE (TREE_TYPE (arg)) == POINTER_TYPE)
1227 /* Determine the type of the provided non-constant argument. */
1228 argtype = TREE_TYPE (arg);
1229 else
1230 /* Don't bother with invalid arguments since they likely would
1231 have already been diagnosed, and disable any further checking
1232 of the format string by returning [-1, -1]. */
1233 return fmtresult ();
1235 /* True if the LIKELY counter should be adjusted upward from the MIN
1236 counter to account for arguments with unknown values. */
1237 bool likely_adjust = false;
1239 fmtresult res;
1241 /* Using either the range the non-constant argument is in, or its
1242 type (either "formal" or actual), create a range of values that
1243 constrain the length of output given the warning level. */
1244 tree argmin = NULL_TREE;
1245 tree argmax = NULL_TREE;
1247 if (arg
1248 && TREE_CODE (arg) == SSA_NAME
1249 && TREE_CODE (argtype) == INTEGER_TYPE)
1251 /* Try to determine the range of values of the integer argument
1252 (range information is not available for pointers). */
1253 wide_int min, max;
1254 enum value_range_type range_type = get_range_info (arg, &min, &max);
1255 if (range_type == VR_RANGE)
1257 argmin = wide_int_to_tree (argtype, min);
1258 argmax = wide_int_to_tree (argtype, max);
1260 /* Set KNOWNRANGE if the argument is in a known subrange
1261 of the directive's type (KNOWNRANGE may be reset below). */
1262 res.knownrange
1263 = (!tree_int_cst_equal (TYPE_MIN_VALUE (dirtype), argmin)
1264 || !tree_int_cst_equal (TYPE_MAX_VALUE (dirtype), argmax));
1266 res.argmin = argmin;
1267 res.argmax = argmax;
1269 /* Set the adjustment for an argument whose range includes
1270 zero since that doesn't include the octal or hexadecimal
1271 base prefix. */
1272 wide_int wzero = wi::zero (wi::get_precision (min));
1273 if (wi::le_p (min, wzero, SIGNED)
1274 && !wi::neg_p (max))
1275 likely_adjust = true;
1277 else if (range_type == VR_ANTI_RANGE)
1279 /* Handle anti-ranges if/when bug 71690 is resolved. */
1281 else if (range_type == VR_VARYING)
1283 /* The argument here may be the result of promoting the actual
1284 argument to int. Try to determine the type of the actual
1285 argument before promotion and narrow down its range that
1286 way. */
1287 gimple *def = SSA_NAME_DEF_STMT (arg);
1288 if (is_gimple_assign (def))
1290 tree_code code = gimple_assign_rhs_code (def);
1291 if (code == INTEGER_CST)
1293 arg = gimple_assign_rhs1 (def);
1294 return format_integer (dir, arg);
1297 if (code == NOP_EXPR)
1299 tree type = TREE_TYPE (gimple_assign_rhs1 (def));
1300 if (TREE_CODE (type) == INTEGER_TYPE
1301 || TREE_CODE (type) == POINTER_TYPE)
1302 argtype = type;
1308 if (!argmin)
1310 /* Set the adjustment for an argument whose range includes
1311 zero since that doesn't include the octal or hexadecimal
1312 base prefix. */
1313 likely_adjust = true;
1315 if (TREE_CODE (argtype) == POINTER_TYPE)
1317 argmin = build_int_cst (pointer_sized_int_node, 0);
1318 argmax = build_all_ones_cst (pointer_sized_int_node);
1320 else
1322 argmin = TYPE_MIN_VALUE (argtype);
1323 argmax = TYPE_MAX_VALUE (argtype);
1327 /* Clear KNOWNRANGE if the range has been adjusted to the maximum
1328 of the directive. If it has been cleared then since ARGMIN and/or
1329 ARGMAX have been adjusted also adjust the corresponding ARGMIN and
1330 ARGMAX in the result to include in diagnostics. */
1331 if (adjust_range_for_overflow (dirtype, &argmin, &argmax))
1333 res.knownrange = false;
1334 res.argmin = argmin;
1335 res.argmax = argmax;
1338 /* Recursively compute the minimum and maximum from the known range. */
1339 if (TYPE_UNSIGNED (dirtype) || tree_int_cst_sgn (argmin) >= 0)
1341 /* For unsigned conversions/directives or signed when
1342 the minimum is positive, use the minimum and maximum to compute
1343 the shortest and longest output, respectively. */
1344 res.range.min = format_integer (dir, argmin).range.min;
1345 res.range.max = format_integer (dir, argmax).range.max;
1347 else if (tree_int_cst_sgn (argmax) < 0)
1349 /* For signed conversions/directives if maximum is negative,
1350 use the minimum as the longest output and maximum as the
1351 shortest output. */
1352 res.range.min = format_integer (dir, argmax).range.min;
1353 res.range.max = format_integer (dir, argmin).range.max;
1355 else
1357 /* Otherwise, 0 is inside of the range and minimum negative. Use 0
1358 as the shortest output and for the longest output compute the
1359 length of the output of both minimum and maximum and pick the
1360 longer. */
1361 unsigned HOST_WIDE_INT max1 = format_integer (dir, argmin).range.max;
1362 unsigned HOST_WIDE_INT max2 = format_integer (dir, argmax).range.max;
1363 res.range.min = format_integer (dir, integer_zero_node).range.min;
1364 res.range.max = MAX (max1, max2);
1367 /* Add the adjustment for an argument whose range includes zero
1368 since it doesn't include the octal or hexadecimal base prefix. */
1369 if (res.knownrange)
1370 res.range.likely = res.range.max;
1371 else
1373 res.range.likely = res.range.min;
1374 if (likely_adjust && maybebase && base != 10)
1376 if (res.range.min == 1)
1377 res.range.likely += base == 8 ? 1 : 2;
1378 else if (res.range.min == 2
1379 && base == 16
1380 && (dir.width[0] == 2 || dir.prec[0] == 2))
1381 ++res.range.likely;
1385 res.range.unlikely = res.range.max;
1386 res.adjust_for_width_or_precision (dir.width, dirtype, base,
1387 (sign | maybebase) + (base == 16));
1388 res.adjust_for_width_or_precision (dir.prec, dirtype, base,
1389 (sign | maybebase) + (base == 16));
1391 return res;
1394 /* Return the number of bytes that a format directive consisting of FLAGS,
1395 PRECision, format SPECification, and MPFR rounding specifier RNDSPEC,
1396 would result for argument X under ideal conditions (i.e., if PREC
1397 weren't excessive). MPFR 3.1 allocates large amounts of memory for
1398 values of PREC with large magnitude and can fail (see MPFR bug #21056).
1399 This function works around those problems. */
1401 static unsigned HOST_WIDE_INT
1402 get_mpfr_format_length (mpfr_ptr x, const char *flags, HOST_WIDE_INT prec,
1403 char spec, char rndspec)
1405 char fmtstr[40];
1407 HOST_WIDE_INT len = strlen (flags);
1409 fmtstr[0] = '%';
1410 memcpy (fmtstr + 1, flags, len);
1411 memcpy (fmtstr + 1 + len, ".*R", 3);
1412 fmtstr[len + 4] = rndspec;
1413 fmtstr[len + 5] = spec;
1414 fmtstr[len + 6] = '\0';
1416 spec = TOUPPER (spec);
1417 if (spec == 'E' || spec == 'F')
1419 /* For %e, specify the precision explicitly since mpfr_sprintf
1420 does its own thing just to be different (see MPFR bug 21088). */
1421 if (prec < 0)
1422 prec = 6;
1424 else
1426 /* Avoid passing negative precisions with larger magnitude to MPFR
1427 to avoid exposing its bugs. (A negative precision is supposed
1428 to be ignored.) */
1429 if (prec < 0)
1430 prec = -1;
1433 HOST_WIDE_INT p = prec;
1435 if (spec == 'G')
1437 /* For G/g, precision gives the maximum number of significant
1438 digits which is bounded by LDBL_MAX_10_EXP, or, for a 128
1439 bit IEEE extended precision, 4932. Using twice as much
1440 here should be more than sufficient for any real format. */
1441 if ((IEEE_MAX_10_EXP * 2) < prec)
1442 prec = IEEE_MAX_10_EXP * 2;
1443 p = prec;
1445 else
1447 /* Cap precision arbitrarily at 1KB and add the difference
1448 (if any) to the MPFR result. */
1449 if (prec > 1024)
1450 p = 1024;
1453 len = mpfr_snprintf (NULL, 0, fmtstr, (int)p, x);
1455 /* Handle the unlikely (impossible?) error by returning more than
1456 the maximum dictated by the function's return type. */
1457 if (len < 0)
1458 return target_dir_max () + 1;
1460 /* Adjust the return value by the difference. */
1461 if (p < prec)
1462 len += prec - p;
1464 return len;
1467 /* Return the number of bytes to format using the format specifier
1468 SPEC and the precision PREC the largest value in the real floating
1469 TYPE. */
1471 static unsigned HOST_WIDE_INT
1472 format_floating_max (tree type, char spec, HOST_WIDE_INT prec)
1474 machine_mode mode = TYPE_MODE (type);
1476 /* IBM Extended mode. */
1477 if (MODE_COMPOSITE_P (mode))
1478 mode = DFmode;
1480 /* Get the real type format desription for the target. */
1481 const real_format *rfmt = REAL_MODE_FORMAT (mode);
1482 REAL_VALUE_TYPE rv;
1484 real_maxval (&rv, 0, mode);
1486 /* Convert the GCC real value representation with the precision
1487 of the real type to the mpfr_t format with the GCC default
1488 round-to-nearest mode. */
1489 mpfr_t x;
1490 mpfr_init2 (x, rfmt->p);
1491 mpfr_from_real (x, &rv, GMP_RNDN);
1493 /* Return a value one greater to account for the leading minus sign. */
1494 unsigned HOST_WIDE_INT r
1495 = 1 + get_mpfr_format_length (x, "", prec, spec, 'D');
1496 mpfr_clear (x);
1497 return r;
1500 /* Return a range representing the minimum and maximum number of bytes
1501 that the directive DIR will output for any argument. This function
1502 is used when the directive argument or its value isn't known. */
1504 static fmtresult
1505 format_floating (const directive &dir)
1507 tree type;
1509 switch (dir.modifier)
1511 case FMT_LEN_l:
1512 case FMT_LEN_none:
1513 type = double_type_node;
1514 break;
1516 case FMT_LEN_L:
1517 type = long_double_type_node;
1518 break;
1520 case FMT_LEN_ll:
1521 type = long_double_type_node;
1522 break;
1524 default:
1525 return fmtresult ();
1528 /* The minimum and maximum number of bytes produced by the directive. */
1529 fmtresult res;
1531 /* The minimum output as determined by flags. It's always at least 1.
1532 When plus or space are set the output is preceded by either a sign
1533 or a space. */
1534 int flagmin = (1 /* for the first digit */
1535 + (dir.get_flag ('+') | dir.get_flag (' ')));
1537 /* When the pound flag is set the decimal point is included in output
1538 regardless of precision. Whether or not a decimal point is included
1539 otherwise depends on the specification and precision. */
1540 bool radix = dir.get_flag ('#');
1542 switch (dir.specifier)
1544 case 'A':
1545 case 'a':
1547 HOST_WIDE_INT minprec = 6 + !radix /* decimal point */;
1548 if (dir.prec[0] <= 0)
1549 minprec = 0;
1550 else if (dir.prec[0] > 0)
1551 minprec = dir.prec[0] + !radix /* decimal point */;
1553 res.range.min = (2 /* 0x */
1554 + flagmin
1555 + radix
1556 + minprec
1557 + 3 /* p+0 */);
1559 res.range.max = format_floating_max (type, 'a', dir.prec[1]);
1560 res.range.likely = res.range.min;
1562 /* The unlikely maximum accounts for the longest multibyte
1563 decimal point character. */
1564 res.range.unlikely = res.range.max;
1565 if (dir.prec[0] != dir.prec[1]
1566 || dir.prec[0] == -1 || dir.prec[0] > 0)
1567 res.range.unlikely += target_mb_len_max () - 1;
1569 break;
1572 case 'E':
1573 case 'e':
1575 /* The minimum output is "[-+]1.234567e+00" regardless
1576 of the value of the actual argument. */
1577 HOST_WIDE_INT minprec = 6 + !radix /* decimal point */;
1578 if ((dir.prec[0] < 0 && dir.prec[1] > -1) || dir.prec[0] == 0)
1579 minprec = 0;
1580 else if (dir.prec[0] > 0)
1581 minprec = dir.prec[0] + !radix /* decimal point */;
1583 res.range.min = (flagmin
1584 + radix
1585 + minprec
1586 + 2 /* e+ */ + 2);
1587 /* MPFR uses a precision of 16 by default for some reason.
1588 Set it to the C default of 6. */
1589 int maxprec = dir.prec[1] < 0 ? 6 : dir.prec[1];
1590 res.range.max = format_floating_max (type, 'e', maxprec);
1592 res.range.likely = res.range.min;
1594 /* The unlikely maximum accounts for the longest multibyte
1595 decimal point character. */
1596 if (dir.prec[0] != dir.prec[1]
1597 || dir.prec[0] == -1 || dir.prec[0] > 0)
1598 res.range.unlikely = res.range.max + target_mb_len_max () -1;
1599 else
1600 res.range.unlikely = res.range.max;
1601 break;
1604 case 'F':
1605 case 'f':
1607 /* The lower bound when precision isn't specified is 8 bytes
1608 ("1.23456" since precision is taken to be 6). When precision
1609 is zero, the lower bound is 1 byte (e.g., "1"). Otherwise,
1610 when precision is greater than zero, then the lower bound
1611 is 2 plus precision (plus flags). */
1612 HOST_WIDE_INT minprec = 0;
1613 if (dir.prec[0] < 0)
1614 minprec = dir.prec[1] < 0 ? 6 + !radix /* decimal point */ : 0;
1615 else if (dir.prec[0])
1616 minprec = dir.prec[0] + !radix /* decimal point */;
1618 res.range.min = flagmin + radix + minprec;
1620 /* Compute the upper bound for -TYPE_MAX. */
1621 res.range.max = format_floating_max (type, 'f', dir.prec[1]);
1623 res.range.likely = res.range.min;
1625 /* The unlikely maximum accounts for the longest multibyte
1626 decimal point character. */
1627 if (dir.prec[0] != dir.prec[1]
1628 || dir.prec[0] == -1 || dir.prec[0] > 0)
1629 res.range.unlikely = res.range.max + target_mb_len_max () - 1;
1630 break;
1633 case 'G':
1634 case 'g':
1636 /* The %g output depends on precision and the exponent of
1637 the argument. Since the value of the argument isn't known
1638 the lower bound on the range of bytes (not counting flags
1639 or width) is 1. */
1640 res.range.min = flagmin;
1641 res.range.max = format_floating_max (type, 'g', dir.prec[1]);
1642 res.range.likely = res.range.max;
1644 /* The unlikely maximum accounts for the longest multibyte
1645 decimal point character. */
1646 res.range.unlikely = res.range.max + target_mb_len_max () - 1;
1647 break;
1650 default:
1651 return fmtresult ();
1654 /* Bump up the byte counters if WIDTH is greater. */
1655 res.adjust_for_width_or_precision (dir.width);
1656 return res;
1659 /* Return a range representing the minimum and maximum number of bytes
1660 that the directive DIR will write on output for the floating argument
1661 ARG. */
1663 static fmtresult
1664 format_floating (const directive &dir, tree arg)
1666 if (!arg || TREE_CODE (arg) != REAL_CST)
1667 return format_floating (dir);
1669 HOST_WIDE_INT prec[] = { dir.prec[0], dir.prec[1] };
1671 if (TOUPPER (dir.specifier) == 'A')
1673 /* For %a, leave the minimum precision unspecified to let
1674 MFPR trim trailing zeros (as it and many other systems
1675 including Glibc happen to do) and set the maximum
1676 precision to reflect what it would be with trailing zeros
1677 present (as Solaris and derived systems do). */
1678 if (prec[0] < 0)
1679 prec[0] = -1;
1680 if (prec[1] < 0)
1682 unsigned fmtprec
1683 = REAL_MODE_FORMAT (TYPE_MODE (TREE_TYPE (arg)))->p;
1685 /* The precision of the IEEE 754 double format is 53.
1686 The precision of all other GCC binary double formats
1687 is 56 or less. */
1688 prec[1] = fmtprec <= 56 ? 13 : 15;
1692 /* The minimum and maximum number of bytes produced by the directive. */
1693 fmtresult res;
1695 /* Get the real type format desription for the target. */
1696 const REAL_VALUE_TYPE *rvp = TREE_REAL_CST_PTR (arg);
1697 const real_format *rfmt = REAL_MODE_FORMAT (TYPE_MODE (TREE_TYPE (arg)));
1699 char fmtstr [40];
1700 char *pfmt = fmtstr;
1702 /* Append flags. */
1703 for (const char *pf = "-+ #0"; *pf; ++pf)
1704 if (dir.get_flag (*pf))
1705 *pfmt++ = *pf;
1707 *pfmt = '\0';
1710 /* Set up an array to easily iterate over. */
1711 unsigned HOST_WIDE_INT* const minmax[] = {
1712 &res.range.min, &res.range.max
1715 for (int i = 0; i != sizeof minmax / sizeof *minmax; ++i)
1717 /* Convert the GCC real value representation with the precision
1718 of the real type to the mpfr_t format rounding down in the
1719 first iteration that computes the minimm and up in the second
1720 that computes the maximum. This order is arbibtrary because
1721 rounding in either direction can result in longer output. */
1722 mpfr_t mpfrval;
1723 mpfr_init2 (mpfrval, rfmt->p);
1724 mpfr_from_real (mpfrval, rvp, i ? GMP_RNDU : GMP_RNDD);
1726 /* Use the MPFR rounding specifier to round down in the first
1727 iteration and then up. In most but not all cases this will
1728 result in the same number of bytes. */
1729 char rndspec = "DU"[i];
1731 /* Format it and store the result in the corresponding member
1732 of the result struct. */
1733 *minmax[i] = get_mpfr_format_length (mpfrval, fmtstr, prec[i],
1734 dir.specifier, rndspec);
1735 mpfr_clear (mpfrval);
1739 /* Make sure the minimum is less than the maximum (MPFR rounding
1740 in the call to mpfr_snprintf can result in the reverse. */
1741 if (res.range.max < res.range.min)
1743 unsigned HOST_WIDE_INT tmp = res.range.min;
1744 res.range.min = res.range.max;
1745 res.range.max = tmp;
1748 res.knownrange = true;
1750 /* For the same floating point constant use the longer output
1751 as the likely maximum since with round to nearest either is
1752 equally likely. */
1753 res.range.likely = res.range.max;
1754 res.range.unlikely = res.range.max;
1756 if (res.range.max > 2 && (prec[0] != 0 || prec[1] != 0))
1758 /* Unless the precision is zero output longer than 2 bytes may
1759 include the decimal point which must be a single character
1760 up to MB_LEN_MAX in length. This is overly conservative
1761 since in some conversions some constants result in no decimal
1762 point (e.g., in %g). */
1763 res.range.unlikely += target_mb_len_max () - 1;
1766 res.adjust_for_width_or_precision (dir.width);
1767 return res;
1770 /* Return a FMTRESULT struct set to the lengths of the shortest and longest
1771 strings referenced by the expression STR, or (-1, -1) when not known.
1772 Used by the format_string function below. */
1774 static fmtresult
1775 get_string_length (tree str)
1777 if (!str)
1778 return fmtresult ();
1780 if (tree slen = c_strlen (str, 1))
1782 /* Simply return the length of the string. */
1783 fmtresult res (tree_to_shwi (slen));
1784 return res;
1787 /* Determine the length of the shortest and longest string referenced
1788 by STR. Strings of unknown lengths are bounded by the sizes of
1789 arrays that subexpressions of STR may refer to. Pointers that
1790 aren't known to point any such arrays result in LENRANGE[1] set
1791 to SIZE_MAX. */
1792 tree lenrange[2];
1793 bool flexarray = get_range_strlen (str, lenrange);
1795 if (lenrange [0] || lenrange [1])
1797 HOST_WIDE_INT min
1798 = (tree_fits_uhwi_p (lenrange[0])
1799 ? tree_to_uhwi (lenrange[0])
1800 : 0);
1802 HOST_WIDE_INT max
1803 = (tree_fits_uhwi_p (lenrange[1])
1804 ? tree_to_uhwi (lenrange[1])
1805 : HOST_WIDE_INT_M1U);
1807 /* get_range_strlen() returns the target value of SIZE_MAX for
1808 strings of unknown length. Bump it up to HOST_WIDE_INT_M1U
1809 which may be bigger. */
1810 if ((unsigned HOST_WIDE_INT)min == target_size_max ())
1811 min = HOST_WIDE_INT_M1U;
1812 if ((unsigned HOST_WIDE_INT)max == target_size_max ())
1813 max = HOST_WIDE_INT_M1U;
1815 fmtresult res (min, max);
1817 /* Set RES.KNOWNRANGE to true if and only if all strings referenced
1818 by STR are known to be bounded (though not necessarily by their
1819 actual length but perhaps by their maximum possible length). */
1820 if (res.range.max < target_int_max ())
1822 res.knownrange = true;
1823 /* When the the length of the longest string is known and not
1824 excessive use it as the likely length of the string(s). */
1825 res.range.likely = res.range.max;
1827 else
1829 /* When the upper bound is unknown (it can be zero or excessive)
1830 set the likely length to the greater of 1 and the length of
1831 the shortest string and reset the lower bound to zero. */
1832 res.range.likely = res.range.min ? res.range.min : warn_level > 1;
1833 res.range.min = 0;
1836 /* If the range of string length has been estimated from the size
1837 of an array at the end of a struct assume that it's longer than
1838 the array bound says it is in case it's used as a poor man's
1839 flexible array member, such as in struct S { char a[4]; }; */
1840 res.range.unlikely = flexarray ? HOST_WIDE_INT_MAX : res.range.max;
1842 return res;
1845 return get_string_length (NULL_TREE);
1848 /* Return the minimum and maximum number of characters formatted
1849 by the '%c' format directives and its wide character form for
1850 the argument ARG. ARG can be null (for functions such as
1851 vsprinf). */
1853 static fmtresult
1854 format_character (const directive &dir, tree arg)
1856 fmtresult res;
1858 res.knownrange = true;
1860 if (dir.modifier == FMT_LEN_l)
1862 /* A wide character can result in as few as zero bytes. */
1863 res.range.min = 0;
1865 HOST_WIDE_INT min, max;
1866 if (get_int_range (arg, integer_type_node, &min, &max, false, 0))
1868 if (min == 0 && max == 0)
1870 /* The NUL wide character results in no bytes. */
1871 res.range.max = 0;
1872 res.range.likely = 0;
1873 res.range.unlikely = 0;
1875 else if (min > 0 && min < 128)
1877 /* A wide character in the ASCII range most likely results
1878 in a single byte, and only unlikely in up to MB_LEN_MAX. */
1879 res.range.max = 1;
1880 res.range.likely = 1;
1881 res.range.unlikely = target_mb_len_max ();
1883 else
1885 /* A wide character outside the ASCII range likely results
1886 in up to two bytes, and only unlikely in up to MB_LEN_MAX. */
1887 res.range.max = target_mb_len_max ();
1888 res.range.likely = 2;
1889 res.range.unlikely = res.range.max;
1892 else
1894 /* An unknown wide character is treated the same as a wide
1895 character outside the ASCII range. */
1896 res.range.max = target_mb_len_max ();
1897 res.range.likely = 2;
1898 res.range.unlikely = res.range.max;
1901 else
1903 /* A plain '%c' directive. Its ouput is exactly 1. */
1904 res.range.min = res.range.max = 1;
1905 res.range.likely = res.range.unlikely = 1;
1906 res.knownrange = true;
1909 /* Bump up the byte counters if WIDTH is greater. */
1910 return res.adjust_for_width_or_precision (dir.width);
1913 /* Return the minimum and maximum number of characters formatted
1914 by the '%s' format directive and its wide character form for
1915 the argument ARG. ARG can be null (for functions such as
1916 vsprinf). */
1918 static fmtresult
1919 format_string (const directive &dir, tree arg)
1921 fmtresult res;
1923 /* Compute the range the argument's length can be in. */
1924 fmtresult slen = get_string_length (arg);
1925 if (slen.range.min == slen.range.max
1926 && slen.range.min < HOST_WIDE_INT_MAX)
1928 /* The argument is either a string constant or it refers
1929 to one of a number of strings of the same length. */
1931 /* A '%s' directive with a string argument with constant length. */
1932 res.range = slen.range;
1934 if (dir.modifier == FMT_LEN_l)
1936 /* In the worst case the length of output of a wide string S
1937 is bounded by MB_LEN_MAX * wcslen (S). */
1938 res.range.max *= target_mb_len_max ();
1939 res.range.unlikely = res.range.max;
1940 /* It's likely that the the total length is not more that
1941 2 * wcslen (S).*/
1942 res.range.likely = res.range.min * 2;
1944 if (dir.prec[1] >= 0
1945 && (unsigned HOST_WIDE_INT)dir.prec[1] < res.range.max)
1947 res.range.max = dir.prec[1];
1948 res.range.likely = dir.prec[1];
1949 res.range.unlikely = dir.prec[1];
1952 if (dir.prec[0] < 0 && dir.prec[1] > -1)
1953 res.range.min = 0;
1954 else if (dir.prec[0] >= 0)
1955 res.range.likely = dir.prec[0];
1957 /* Even a non-empty wide character string need not convert into
1958 any bytes. */
1959 res.range.min = 0;
1961 else
1963 res.knownrange = true;
1965 if (dir.prec[0] < 0 && dir.prec[1] > -1)
1966 res.range.min = 0;
1967 else if ((unsigned HOST_WIDE_INT)dir.prec[0] < res.range.min)
1968 res.range.min = dir.prec[0];
1970 if ((unsigned HOST_WIDE_INT)dir.prec[1] < res.range.max)
1972 res.range.max = dir.prec[1];
1973 res.range.likely = dir.prec[1];
1974 res.range.unlikely = dir.prec[1];
1978 else if (arg && integer_zerop (arg))
1980 /* Handle null pointer argument. */
1982 fmtresult res (0);
1983 res.nullp = true;
1984 return res;
1986 else
1988 /* For a '%s' and '%ls' directive with a non-constant string (either
1989 one of a number of strings of known length or an unknown string)
1990 the minimum number of characters is lesser of PRECISION[0] and
1991 the length of the shortest known string or zero, and the maximum
1992 is the lessser of the length of the longest known string or
1993 PTRDIFF_MAX and PRECISION[1]. The likely length is either
1994 the minimum at level 1 and the greater of the minimum and 1
1995 at level 2. This result is adjust upward for width (if it's
1996 specified). */
1998 if (dir.modifier == FMT_LEN_l)
2000 /* A wide character converts to as few as zero bytes. */
2001 slen.range.min = 0;
2002 if (slen.range.max < target_int_max ())
2003 slen.range.max *= target_mb_len_max ();
2005 if (slen.range.likely < target_int_max ())
2006 slen.range.likely *= 2;
2008 if (slen.range.likely < target_int_max ())
2009 slen.range.unlikely *= target_mb_len_max ();
2012 res.range = slen.range;
2014 if (dir.prec[0] >= 0)
2016 /* Adjust the minimum to zero if the string length is unknown,
2017 or at most the lower bound of the precision otherwise. */
2018 if (slen.range.min >= target_int_max ())
2019 res.range.min = 0;
2020 else if ((unsigned HOST_WIDE_INT)dir.prec[0] < slen.range.min)
2021 res.range.min = dir.prec[0];
2023 /* Make both maxima no greater than the upper bound of precision. */
2024 if ((unsigned HOST_WIDE_INT)dir.prec[1] < slen.range.max
2025 || slen.range.max >= target_int_max ())
2027 res.range.max = dir.prec[1];
2028 res.range.unlikely = dir.prec[1];
2031 /* If precision is constant, set the likely counter to the lesser
2032 of it and the maximum string length. Otherwise, if the lower
2033 bound of precision is greater than zero, set the likely counter
2034 to the minimum. Otherwise set it to zero or one based on
2035 the warning level. */
2036 if (dir.prec[0] == dir.prec[1])
2037 res.range.likely
2038 = ((unsigned HOST_WIDE_INT)dir.prec[0] < slen.range.max
2039 ? dir.prec[0] : slen.range.max);
2040 else if (dir.prec[0] > 0)
2041 res.range.likely = res.range.min;
2042 else
2043 res.range.likely = warn_level > 1;
2045 else if (dir.prec[1] >= 0)
2047 res.range.min = 0;
2048 if ((unsigned HOST_WIDE_INT)dir.prec[1] < slen.range.max)
2049 res.range.max = dir.prec[1];
2050 res.range.likely = dir.prec[1] ? warn_level > 1 : 0;
2052 else if (slen.range.min >= target_int_max ())
2054 res.range.min = 0;
2055 res.range.max = HOST_WIDE_INT_MAX;
2056 /* At level 1 strings of unknown length are assumed to be
2057 empty, while at level 1 they are assumed to be one byte
2058 long. */
2059 res.range.likely = warn_level > 1;
2061 else
2063 /* A string of unknown length unconstrained by precision is
2064 assumed to be empty at level 1 and just one character long
2065 at higher levels. */
2066 if (res.range.likely >= target_int_max ())
2067 res.range.likely = warn_level > 1;
2070 res.range.unlikely = res.range.max;
2073 /* Bump up the byte counters if WIDTH is greater. */
2074 return res.adjust_for_width_or_precision (dir.width);
2077 /* Format plain string (part of the format string itself). */
2079 static fmtresult
2080 format_plain (const directive &dir, tree)
2082 fmtresult res (dir.len);
2083 return res;
2086 /* Return true if the RESULT of a directive in a call describe by INFO
2087 should be diagnosed given the AVAILable space in the destination. */
2089 static bool
2090 should_warn_p (const pass_sprintf_length::call_info &info,
2091 const result_range &avail, const result_range &result)
2093 if (result.max <= avail.min)
2095 /* The least amount of space remaining in the destination is big
2096 enough for the longest output. */
2097 return false;
2100 if (info.bounded)
2102 if (warn_format_trunc == 1 && result.min <= avail.max
2103 && info.retval_used ())
2105 /* The likely amount of space remaining in the destination is big
2106 enough for the least output and the return value is used. */
2107 return false;
2110 if (warn_format_trunc == 1 && result.likely <= avail.likely
2111 && !info.retval_used ())
2113 /* The likely amount of space remaining in the destination is big
2114 enough for the likely output and the return value is unused. */
2115 return false;
2118 if (warn_format_trunc == 2
2119 && result.likely <= avail.min
2120 && (result.max <= avail.min
2121 || result.max > HOST_WIDE_INT_MAX))
2123 /* The minimum amount of space remaining in the destination is big
2124 enough for the longest output. */
2125 return false;
2128 else
2130 if (warn_level == 1 && result.likely <= avail.likely)
2132 /* The likely amount of space remaining in the destination is big
2133 enough for the likely output. */
2134 return false;
2137 if (warn_level == 2
2138 && result.likely <= avail.min
2139 && (result.max <= avail.min
2140 || result.max > HOST_WIDE_INT_MAX))
2142 /* The minimum amount of space remaining in the destination is big
2143 enough for the longest output. */
2144 return false;
2148 return true;
2151 /* At format string location describe by DIRLOC in a call described
2152 by INFO, issue a warning for a directive DIR whose output may be
2153 in excess of the available space AVAIL_RANGE in the destination
2154 given the formatting result FMTRES. This function does nothing
2155 except decide whether to issue a warning for a possible write
2156 past the end or truncation and, if so, format the warning.
2157 Return true if a warning has been issued. */
2159 static bool
2160 maybe_warn (substring_loc &dirloc, source_range *pargrange,
2161 const pass_sprintf_length::call_info &info,
2162 const result_range &avail_range, const result_range &res,
2163 const directive &dir)
2165 if (!should_warn_p (info, avail_range, res))
2166 return false;
2168 /* A warning will definitely be issued below. */
2170 /* The maximum byte count to reference in the warning. Larger counts
2171 imply that the upper bound is unknown (and could be anywhere between
2172 RES.MIN + 1 and SIZE_MAX / 2) are printed as "N or more bytes" rather
2173 than "between N and X" where X is some huge number. */
2174 unsigned HOST_WIDE_INT maxbytes = target_dir_max ();
2176 /* True when there is enough room in the destination for the least
2177 amount of a directive's output but not enough for its likely or
2178 maximum output. */
2179 bool maybe = (res.min <= avail_range.max
2180 && (avail_range.min < res.likely
2181 || (res.max < HOST_WIDE_INT_MAX
2182 && avail_range.min < res.max)));
2184 if (avail_range.min == avail_range.max)
2186 /* The size of the destination region is exact. */
2187 unsigned HOST_WIDE_INT navail = avail_range.max;
2189 if (*dir.beg != '%')
2191 /* For plain character directives (i.e., the format string itself)
2192 but not others, point the caret at the first character that's
2193 past the end of the destination. */
2194 dirloc.set_caret_index (dirloc.get_caret_idx () + navail);
2197 if (*dir.beg == '\0')
2199 /* This is the terminating nul. */
2200 gcc_assert (res.min == 1 && res.min == res.max);
2202 const char *fmtstr
2203 = (info.bounded
2204 ? (maybe
2205 ? G_("%qE output may be truncated before the last format "
2206 "character")
2207 : G_("%qE output truncated before the last format character"))
2208 : (maybe
2209 ? G_("%qE may write a terminating nul past the end "
2210 "of the destination")
2211 : G_("%qE writing a terminating nul past the end "
2212 "of the destination")));
2214 return fmtwarn (dirloc, NULL, NULL, info.warnopt (), fmtstr,
2215 info.func);
2218 if (res.min == res.max)
2220 const char* fmtstr
2221 = (res.min == 1
2222 ? (info.bounded
2223 ? (maybe
2224 ? G_("%<%.*s%> directive output may be truncated writing "
2225 "%wu byte into a region of size %wu")
2226 : G_("%<%.*s%> directive output truncated writing "
2227 "%wu byte into a region of size %wu"))
2228 : G_("%<%.*s%> directive writing %wu byte "
2229 "into a region of size %wu"))
2230 : (info.bounded
2231 ? (maybe
2232 ? G_("%<%.*s%> directive output may be truncated writing "
2233 "%wu bytes into a region of size %wu")
2234 : G_("%<%.*s%> directive output truncated writing "
2235 "%wu bytes into a region of size %wu"))
2236 : G_("%<%.*s%> directive writing %wu bytes "
2237 "into a region of size %wu")));
2238 return fmtwarn (dirloc, pargrange, NULL,
2239 info.warnopt (), fmtstr,
2240 dir.len, dir.beg, res.min,
2241 navail);
2244 if (res.min == 0 && res.max < maxbytes)
2246 const char* fmtstr
2247 = (info.bounded
2248 ? (maybe
2249 ? G_("%<%.*s%> directive output may be truncated writing "
2250 "up to %wu bytes into a region of size %wu")
2251 : G_("%<%.*s%> directive output truncated writing "
2252 "up to %wu bytes into a region of size %wu"))
2253 : G_("%<%.*s%> directive writing up to %wu bytes "
2254 "into a region of size %wu"));
2255 return fmtwarn (dirloc, pargrange, NULL,
2256 info.warnopt (), fmtstr,
2257 dir.len, dir.beg,
2258 res.max, navail);
2261 if (res.min == 0 && maxbytes <= res.max)
2263 /* This is a special case to avoid issuing the potentially
2264 confusing warning:
2265 writing 0 or more bytes into a region of size 0. */
2266 const char* fmtstr
2267 = (info.bounded
2268 ? (maybe
2269 ? G_("%<%.*s%> directive output may be truncated writing "
2270 "likely %wu or more bytes into a region of size %wu")
2271 : G_("%<%.*s%> directive output truncated writing "
2272 "likely %wu or more bytes into a region of size %wu"))
2273 : G_("%<%.*s%> directive writing likely %wu or more bytes "
2274 "into a region of size %wu"));
2275 return fmtwarn (dirloc, pargrange, NULL,
2276 info.warnopt (), fmtstr,
2277 dir.len, dir.beg,
2278 res.likely, navail);
2281 if (res.max < maxbytes)
2283 const char* fmtstr
2284 = (info.bounded
2285 ? (maybe
2286 ? G_("%<%.*s%> directive output may be truncated writing "
2287 "between %wu and %wu bytes into a region of size %wu")
2288 : G_("%<%.*s%> directive output truncated writing "
2289 "between %wu and %wu bytes into a region of size %wu"))
2290 : G_("%<%.*s%> directive writing between %wu and "
2291 "%wu bytes into a region of size %wu"));
2292 return fmtwarn (dirloc, pargrange, NULL,
2293 info.warnopt (), fmtstr,
2294 dir.len, dir.beg,
2295 res.min, res.max,
2296 navail);
2299 const char* fmtstr
2300 = (info.bounded
2301 ? (maybe
2302 ? G_("%<%.*s%> directive output may be truncated writing "
2303 "%wu or more bytes into a region of size %wu")
2304 : G_("%<%.*s%> directive output truncated writing "
2305 "%wu or more bytes into a region of size %wu"))
2306 : G_("%<%.*s%> directive writing %wu or more bytes "
2307 "into a region of size %wu"));
2308 return fmtwarn (dirloc, pargrange, NULL,
2309 info.warnopt (), fmtstr,
2310 dir.len, dir.beg,
2311 res.min, navail);
2314 /* The size of the destination region is a range. */
2316 if (*dir.beg != '%')
2318 unsigned HOST_WIDE_INT navail = avail_range.max;
2320 /* For plain character directives (i.e., the format string itself)
2321 but not others, point the caret at the first character that's
2322 past the end of the destination. */
2323 dirloc.set_caret_index (dirloc.get_caret_idx () + navail);
2326 if (*dir.beg == '\0')
2328 gcc_assert (res.min == 1 && res.min == res.max);
2330 const char *fmtstr
2331 = (info.bounded
2332 ? (maybe
2333 ? G_("%qE output may be truncated before the last format "
2334 "character")
2335 : G_("%qE output truncated before the last format character"))
2336 : (maybe
2337 ? G_("%qE may write a terminating nul past the end "
2338 "of the destination")
2339 : G_("%qE writing a terminating nul past the end "
2340 "of the destination")));
2342 return fmtwarn (dirloc, NULL, NULL, info.warnopt (), fmtstr,
2343 info.func);
2346 if (res.min == res.max)
2348 const char* fmtstr
2349 = (res.min == 1
2350 ? (info.bounded
2351 ? (maybe
2352 ? G_("%<%.*s%> directive output may be truncated writing "
2353 "%wu byte into a region of size between %wu and %wu")
2354 : G_("%<%.*s%> directive output truncated writing "
2355 "%wu byte into a region of size between %wu and %wu"))
2356 : G_("%<%.*s%> directive writing %wu byte "
2357 "into a region of size between %wu and %wu"))
2358 : (info.bounded
2359 ? (maybe
2360 ? G_("%<%.*s%> directive output may be truncated writing "
2361 "%wu bytes into a region of size between %wu and %wu")
2362 : G_("%<%.*s%> directive output truncated writing "
2363 "%wu bytes into a region of size between %wu and %wu"))
2364 : G_("%<%.*s%> directive writing %wu bytes "
2365 "into a region of size between %wu and %wu")));
2367 return fmtwarn (dirloc, pargrange, NULL,
2368 info.warnopt (), fmtstr,
2369 dir.len, dir.beg, res.min,
2370 avail_range.min, avail_range.max);
2373 if (res.min == 0 && res.max < maxbytes)
2375 const char* fmtstr
2376 = (info.bounded
2377 ? (maybe
2378 ? G_("%<%.*s%> directive output may be truncated writing "
2379 "up to %wu bytes into a region of size between "
2380 "%wu and %wu")
2381 : G_("%<%.*s%> directive output truncated writing "
2382 "up to %wu bytes into a region of size between "
2383 "%wu and %wu"))
2384 : G_("%<%.*s%> directive writing up to %wu bytes "
2385 "into a region of size between %wu and %wu"));
2386 return fmtwarn (dirloc, pargrange, NULL,
2387 info.warnopt (), fmtstr,
2388 dir.len, dir.beg, res.max,
2389 avail_range.min, avail_range.max);
2392 if (res.min == 0 && maxbytes <= res.max)
2394 /* This is a special case to avoid issuing the potentially confusing
2395 warning:
2396 writing 0 or more bytes into a region of size between 0 and N. */
2397 const char* fmtstr
2398 = (info.bounded
2399 ? (maybe
2400 ? G_("%<%.*s%> directive output may be truncated writing "
2401 "likely %wu or more bytes into a region of size between "
2402 "%wu and %wu")
2403 : G_("%<%.*s%> directive output truncated writing likely "
2404 "%wu or more bytes into a region of size between "
2405 "%wu and %wu"))
2406 : G_("%<%.*s%> directive writing likely %wu or more bytes "
2407 "into a region of size between %wu and %wu"));
2408 return fmtwarn (dirloc, pargrange, NULL,
2409 info.warnopt (), fmtstr,
2410 dir.len, dir.beg, res.likely,
2411 avail_range.min, avail_range.max);
2414 if (res.max < maxbytes)
2416 const char* fmtstr
2417 = (info.bounded
2418 ? (maybe
2419 ? G_("%<%.*s%> directive output may be truncated writing "
2420 "between %wu and %wu bytes into a region of size "
2421 "between %wu and %wu")
2422 : G_("%<%.*s%> directive output truncated writing "
2423 "between %wu and %wu bytes into a region of size "
2424 "between %wu and %wu"))
2425 : G_("%<%.*s%> directive writing between %wu and "
2426 "%wu bytes into a region of size between %wu and %wu"));
2427 return fmtwarn (dirloc, pargrange, NULL,
2428 info.warnopt (), fmtstr,
2429 dir.len, dir.beg,
2430 res.min, res.max,
2431 avail_range.min, avail_range.max);
2434 const char* fmtstr
2435 = (info.bounded
2436 ? (maybe
2437 ? G_("%<%.*s%> directive output may be truncated writing "
2438 "%wu or more bytes into a region of size between "
2439 "%wu and %wu")
2440 : G_("%<%.*s%> directive output truncated writing "
2441 "%wu or more bytes into a region of size between "
2442 "%wu and %wu"))
2443 : G_("%<%.*s%> directive writing %wu or more bytes "
2444 "into a region of size between %wu and %wu"));
2445 return fmtwarn (dirloc, pargrange, NULL,
2446 info.warnopt (), fmtstr,
2447 dir.len, dir.beg,
2448 res.min,
2449 avail_range.min, avail_range.max);
2452 /* Compute the length of the output resulting from the directive DIR
2453 in a call described by INFO and update the overall result of the call
2454 in *RES. Return true if the directive has been handled. */
2456 static bool
2457 format_directive (const pass_sprintf_length::call_info &info,
2458 format_result *res, const directive &dir)
2460 /* Offset of the beginning of the directive from the beginning
2461 of the format string. */
2462 size_t offset = dir.beg - info.fmtstr;
2463 size_t start = offset;
2464 size_t length = offset + dir.len - !!dir.len;
2466 /* Create a location for the whole directive from the % to the format
2467 specifier. */
2468 substring_loc dirloc (info.fmtloc, TREE_TYPE (info.format),
2469 offset, start, length);
2471 /* Also create a location range for the argument if possible.
2472 This doesn't work for integer literals or function calls. */
2473 source_range argrange;
2474 source_range *pargrange;
2475 if (dir.arg && CAN_HAVE_LOCATION_P (dir.arg))
2477 argrange = EXPR_LOCATION_RANGE (dir.arg);
2478 pargrange = &argrange;
2480 else
2481 pargrange = NULL;
2483 /* Bail when there is no function to compute the output length,
2484 or when minimum length checking has been disabled. */
2485 if (!dir.fmtfunc || res->range.min >= HOST_WIDE_INT_MAX)
2486 return false;
2488 /* Compute the range of lengths of the formatted output. */
2489 fmtresult fmtres = dir.fmtfunc (dir, dir.arg);
2491 /* Record whether the output of all directives is known to be
2492 bounded by some maximum, implying that their arguments are
2493 either known exactly or determined to be in a known range
2494 or, for strings, limited by the upper bounds of the arrays
2495 they refer to. */
2496 res->knownrange &= fmtres.knownrange;
2498 if (!fmtres.knownrange)
2500 /* Only when the range is known, check it against the host value
2501 of INT_MAX + (the number of bytes of the "%.*Lf" directive with
2502 INT_MAX precision, which is the longest possible output of any
2503 single directive). That's the largest valid byte count (though
2504 not valid call to a printf-like function because it can never
2505 return such a count). Otherwise, the range doesn't correspond
2506 to known values of the argument. */
2507 if (fmtres.range.max > target_dir_max ())
2509 /* Normalize the MAX counter to avoid having to deal with it
2510 later. The counter can be less than HOST_WIDE_INT_M1U
2511 when compiling for an ILP32 target on an LP64 host. */
2512 fmtres.range.max = HOST_WIDE_INT_M1U;
2513 /* Disable exact and maximum length checking after a failure
2514 to determine the maximum number of characters (for example
2515 for wide characters or wide character strings) but continue
2516 tracking the minimum number of characters. */
2517 res->range.max = HOST_WIDE_INT_M1U;
2520 if (fmtres.range.min > target_dir_max ())
2522 /* Disable exact length checking after a failure to determine
2523 even the minimum number of characters (it shouldn't happen
2524 except in an error) but keep tracking the minimum and maximum
2525 number of characters. */
2526 return true;
2530 int dirlen = dir.len;
2532 if (fmtres.nullp)
2534 fmtwarn (dirloc, pargrange, NULL, info.warnopt (),
2535 "%<%.*s%> directive argument is null",
2536 dirlen, dir.beg);
2538 /* Don't bother processing the rest of the format string. */
2539 res->warned = true;
2540 res->range.min = HOST_WIDE_INT_M1U;
2541 res->range.max = HOST_WIDE_INT_M1U;
2542 return false;
2545 /* Compute the number of available bytes in the destination. There
2546 must always be at least one byte of space for the terminating
2547 NUL that's appended after the format string has been processed. */
2548 result_range avail_range = bytes_remaining (info.objsize, *res);
2550 bool warned = res->warned;
2552 if (!warned)
2553 warned = maybe_warn (dirloc, pargrange, info, avail_range,
2554 fmtres.range, dir);
2556 /* Bump up the total maximum if it isn't too big. */
2557 if (res->range.max < HOST_WIDE_INT_MAX
2558 && fmtres.range.max < HOST_WIDE_INT_MAX)
2559 res->range.max += fmtres.range.max;
2561 /* Raise the total unlikely maximum by the larger of the maximum
2562 and the unlikely maximum. It doesn't matter if the unlikely
2563 maximum overflows. */
2564 if (fmtres.range.max < fmtres.range.unlikely)
2565 res->range.unlikely += fmtres.range.unlikely;
2566 else
2567 res->range.unlikely += fmtres.range.max;
2569 res->range.min += fmtres.range.min;
2570 res->range.likely += fmtres.range.likely;
2572 /* Has the minimum directive output length exceeded the maximum
2573 of 4095 bytes required to be supported? */
2574 bool minunder4k = fmtres.range.min < 4096;
2575 bool maxunder4k = fmtres.range.max < 4096;
2576 /* Clear UNDER4K in the overall result if the maximum has exceeded
2577 the 4k (this is necessary to avoid the return valuye optimization
2578 that may not be safe in the maximum case). */
2579 if (!maxunder4k)
2580 res->under4k = false;
2582 if (!warned
2583 /* Only warn at level 2. */
2584 && 1 < warn_level
2585 && (!minunder4k
2586 || (!maxunder4k && fmtres.range.max < HOST_WIDE_INT_MAX)))
2588 /* The directive output may be longer than the maximum required
2589 to be handled by an implementation according to 7.21.6.1, p15
2590 of C11. Warn on this only at level 2 but remember this and
2591 prevent folding the return value when done. This allows for
2592 the possibility of the actual libc call failing due to ENOMEM
2593 (like Glibc does under some conditions). */
2595 if (fmtres.range.min == fmtres.range.max)
2596 warned = fmtwarn (dirloc, pargrange, NULL,
2597 info.warnopt (),
2598 "%<%.*s%> directive output of %wu bytes exceeds "
2599 "minimum required size of 4095",
2600 dirlen, dir.beg, fmtres.range.min);
2601 else
2603 const char *fmtstr
2604 = (minunder4k
2605 ? G_("%<%.*s%> directive output between %wu and %wu "
2606 "bytes may exceed minimum required size of 4095")
2607 : G_("%<%.*s%> directive output between %wu and %wu "
2608 "bytes exceeds minimum required size of 4095"));
2610 warned = fmtwarn (dirloc, pargrange, NULL,
2611 info.warnopt (), fmtstr,
2612 dirlen, dir.beg,
2613 fmtres.range.min, fmtres.range.max);
2617 /* Has the likely and maximum directive output exceeded INT_MAX? */
2618 bool likelyximax = *dir.beg && res->range.likely > target_int_max ();
2619 bool maxximax = *dir.beg && res->range.max > target_int_max ();
2621 if (!warned
2622 /* Warn for the likely output size at level 1. */
2623 && (likelyximax
2624 /* But only warn for the maximum at level 2. */
2625 || (1 < warn_level
2626 && maxximax
2627 && fmtres.range.max < HOST_WIDE_INT_MAX)))
2629 /* The directive output causes the total length of output
2630 to exceed INT_MAX bytes. */
2632 if (fmtres.range.min == fmtres.range.max)
2633 warned = fmtwarn (dirloc, pargrange, NULL, info.warnopt (),
2634 "%<%.*s%> directive output of %wu bytes causes "
2635 "result to exceed %<INT_MAX%>",
2636 dirlen, dir.beg, fmtres.range.min);
2637 else
2639 const char *fmtstr
2640 = (fmtres.range.min > target_int_max ()
2641 ? G_ ("%<%.*s%> directive output between %wu and %wu "
2642 "bytes causes result to exceed %<INT_MAX%>")
2643 : G_ ("%<%.*s%> directive output between %wu and %wu "
2644 "bytes may cause result to exceed %<INT_MAX%>"));
2645 warned = fmtwarn (dirloc, pargrange, NULL,
2646 info.warnopt (), fmtstr,
2647 dirlen, dir.beg,
2648 fmtres.range.min, fmtres.range.max);
2652 if (warned && fmtres.range.min < fmtres.range.likely
2653 && fmtres.range.likely < fmtres.range.max)
2655 inform (info.fmtloc,
2656 (1 == fmtres.range.likely
2657 ? G_("assuming directive output of %wu byte")
2658 : G_("assuming directive output of %wu bytes")),
2659 fmtres.range.likely);
2662 if (warned && fmtres.argmin)
2664 if (fmtres.argmin == fmtres.argmax)
2665 inform (info.fmtloc, "directive argument %qE", fmtres.argmin);
2666 else if (fmtres.knownrange)
2667 inform (info.fmtloc, "directive argument in the range [%E, %E]",
2668 fmtres.argmin, fmtres.argmax);
2669 else
2670 inform (info.fmtloc,
2671 "using the range [%E, %E] for directive argument",
2672 fmtres.argmin, fmtres.argmax);
2675 res->warned |= warned;
2677 if (!dir.beg[0] && res->warned && info.objsize < HOST_WIDE_INT_MAX)
2679 /* If a warning has been issued for buffer overflow or truncation
2680 (but not otherwise) help the user figure out how big a buffer
2681 they need. */
2683 location_t callloc = gimple_location (info.callstmt);
2685 unsigned HOST_WIDE_INT min = res->range.min;
2686 unsigned HOST_WIDE_INT max = res->range.max;
2688 if (min == max)
2689 inform (callloc,
2690 (min == 1
2691 ? G_("%qE output %wu byte into a destination of size %wu")
2692 : G_("%qE output %wu bytes into a destination of size %wu")),
2693 info.func, min, info.objsize);
2694 else if (max < HOST_WIDE_INT_MAX)
2695 inform (callloc,
2696 "%qE output between %wu and %wu bytes into "
2697 "a destination of size %wu",
2698 info.func, min, max, info.objsize);
2699 else if (min < res->range.likely && res->range.likely < max)
2700 inform (callloc,
2701 "%qE output %wu or more bytes (assuming %wu) into "
2702 "a destination of size %wu",
2703 info.func, min, res->range.likely, info.objsize);
2704 else
2705 inform (callloc,
2706 "%qE output %wu or more bytes into a destination of size %wu",
2707 info.func, min, info.objsize);
2710 if (dump_file && *dir.beg)
2712 fprintf (dump_file, " Result: %lli, %lli, %lli, %lli "
2713 "(%lli, %lli, %lli, %lli)\n",
2714 (long long)fmtres.range.min,
2715 (long long)fmtres.range.likely,
2716 (long long)fmtres.range.max,
2717 (long long)fmtres.range.unlikely,
2718 (long long)res->range.min,
2719 (long long)res->range.likely,
2720 (long long)res->range.max,
2721 (long long)res->range.unlikely);
2724 return true;
2727 #pragma GCC diagnostic pop
2729 /* Parse a format directive in function call described by INFO starting
2730 at STR and populate DIR structure. Bump up *ARGNO by the number of
2731 arguments extracted for the directive. Return the length of
2732 the directive. */
2734 static size_t
2735 parse_directive (pass_sprintf_length::call_info &info,
2736 directive &dir, format_result *res,
2737 const char *str, unsigned *argno)
2739 const char *pcnt = strchr (str, '%');
2740 dir.beg = str;
2742 if (size_t len = pcnt ? pcnt - str : *str ? strlen (str) : 1)
2744 /* This directive is either a plain string or the terminating nul
2745 (which isn't really a directive but it simplifies things to
2746 handle it as if it were). */
2747 dir.len = len;
2748 dir.fmtfunc = format_plain;
2750 if (dump_file)
2752 fprintf (dump_file, " Directive %u at offset %llu: \"%.*s\", "
2753 "length = %llu\n",
2754 dir.dirno,
2755 (unsigned long long)(size_t)(dir.beg - info.fmtstr),
2756 (int)dir.len, dir.beg, (unsigned long long)dir.len);
2759 return len - !*str;
2762 const char *pf = pcnt + 1;
2764 /* POSIX numbered argument index or zero when none. */
2765 unsigned dollar = 0;
2767 /* With and precision. -1 when not specified, HOST_WIDE_INT_MIN
2768 when given by a va_list argument, and a non-negative value
2769 when specified in the format string itself. */
2770 HOST_WIDE_INT width = -1;
2771 HOST_WIDE_INT precision = -1;
2773 /* Width specified via the asterisk. Need not be INTEGER_CST.
2774 For vararg functions set to void_node. */
2775 tree star_width = NULL_TREE;
2777 /* Width specified via the asterisk. Need not be INTEGER_CST.
2778 For vararg functions set to void_node. */
2779 tree star_precision = NULL_TREE;
2781 if (ISDIGIT (*pf))
2783 /* This could be either a POSIX positional argument, the '0'
2784 flag, or a width, depending on what follows. Store it as
2785 width and sort it out later after the next character has
2786 been seen. */
2787 char *end;
2788 width = strtol (pf, &end, 10);
2789 pf = end;
2791 else if ('*' == *pf)
2793 /* Similarly to the block above, this could be either a POSIX
2794 positional argument or a width, depending on what follows. */
2795 if (*argno < gimple_call_num_args (info.callstmt))
2796 star_width = gimple_call_arg (info.callstmt, (*argno)++);
2797 else
2798 star_width = void_node;
2799 ++pf;
2802 if (*pf == '$')
2804 /* Handle the POSIX dollar sign which references the 1-based
2805 positional argument number. */
2806 if (width != -1)
2807 dollar = width + info.argidx;
2808 else if (star_width
2809 && TREE_CODE (star_width) == INTEGER_CST)
2810 dollar = width + tree_to_shwi (star_width);
2812 /* Bail when the numbered argument is out of range (it will
2813 have already been diagnosed by -Wformat). */
2814 if (dollar == 0
2815 || dollar == info.argidx
2816 || dollar > gimple_call_num_args (info.callstmt))
2817 return false;
2819 --dollar;
2821 star_width = NULL_TREE;
2822 width = -1;
2823 ++pf;
2826 if (dollar || !star_width)
2828 if (width != -1)
2830 if (width == 0)
2832 /* The '0' that has been interpreted as a width above is
2833 actually a flag. Reset HAVE_WIDTH, set the '0' flag,
2834 and continue processing other flags. */
2835 width = -1;
2836 dir.set_flag ('0');
2838 else if (!dollar)
2840 /* (Non-zero) width has been seen. The next character
2841 is either a period or a digit. */
2842 goto start_precision;
2845 /* When either '$' has been seen, or width has not been seen,
2846 the next field is the optional flags followed by an optional
2847 width. */
2848 for ( ; ; ) {
2849 switch (*pf)
2851 case ' ':
2852 case '0':
2853 case '+':
2854 case '-':
2855 case '#':
2856 dir.set_flag (*pf++);
2857 break;
2859 default:
2860 goto start_width;
2864 start_width:
2865 if (ISDIGIT (*pf))
2867 char *end;
2868 width = strtol (pf, &end, 10);
2869 pf = end;
2871 else if ('*' == *pf)
2873 if (*argno < gimple_call_num_args (info.callstmt))
2874 star_width = gimple_call_arg (info.callstmt, (*argno)++);
2875 else
2877 /* This is (likely) a va_list. It could also be an invalid
2878 call with insufficient arguments. */
2879 star_width = void_node;
2881 ++pf;
2883 else if ('\'' == *pf)
2885 /* The POSIX apostrophe indicating a numeric grouping
2886 in the current locale. Even though it's possible to
2887 estimate the upper bound on the size of the output
2888 based on the number of digits it probably isn't worth
2889 continuing. */
2890 return 0;
2894 start_precision:
2895 if ('.' == *pf)
2897 ++pf;
2899 if (ISDIGIT (*pf))
2901 char *end;
2902 precision = strtol (pf, &end, 10);
2903 pf = end;
2905 else if ('*' == *pf)
2907 if (*argno < gimple_call_num_args (info.callstmt))
2908 star_precision = gimple_call_arg (info.callstmt, (*argno)++);
2909 else
2911 /* This is (likely) a va_list. It could also be an invalid
2912 call with insufficient arguments. */
2913 star_precision = void_node;
2915 ++pf;
2917 else
2919 /* The decimal precision or the asterisk are optional.
2920 When neither is dirified it's taken to be zero. */
2921 precision = 0;
2925 switch (*pf)
2927 case 'h':
2928 if (pf[1] == 'h')
2930 ++pf;
2931 dir.modifier = FMT_LEN_hh;
2933 else
2934 dir.modifier = FMT_LEN_h;
2935 ++pf;
2936 break;
2938 case 'j':
2939 dir.modifier = FMT_LEN_j;
2940 ++pf;
2941 break;
2943 case 'L':
2944 dir.modifier = FMT_LEN_L;
2945 ++pf;
2946 break;
2948 case 'l':
2949 if (pf[1] == 'l')
2951 ++pf;
2952 dir.modifier = FMT_LEN_ll;
2954 else
2955 dir.modifier = FMT_LEN_l;
2956 ++pf;
2957 break;
2959 case 't':
2960 dir.modifier = FMT_LEN_t;
2961 ++pf;
2962 break;
2964 case 'z':
2965 dir.modifier = FMT_LEN_z;
2966 ++pf;
2967 break;
2970 switch (*pf)
2972 /* Handle a sole '%' character the same as "%%" but since it's
2973 undefined prevent the result from being folded. */
2974 case '\0':
2975 --pf;
2976 res->range.min = res->range.max = HOST_WIDE_INT_M1U;
2977 /* FALLTHRU */
2978 case '%':
2979 dir.fmtfunc = format_percent;
2980 break;
2982 case 'a':
2983 case 'A':
2984 case 'e':
2985 case 'E':
2986 case 'f':
2987 case 'F':
2988 case 'g':
2989 case 'G':
2990 res->floating = true;
2991 dir.fmtfunc = format_floating;
2992 break;
2994 case 'd':
2995 case 'i':
2996 case 'o':
2997 case 'u':
2998 case 'x':
2999 case 'X':
3000 dir.fmtfunc = format_integer;
3001 break;
3003 case 'p':
3004 /* The %p output is implementation-defined. It's possible
3005 to determine this format but due to extensions (edirially
3006 those of the Linux kernel -- see bug 78512) the first %p
3007 in the format string disables any further processing. */
3008 return false;
3010 case 'n':
3011 /* %n has side-effects even when nothing is actually printed to
3012 any buffer. */
3013 info.nowrite = false;
3014 dir.fmtfunc = format_none;
3015 break;
3017 case 'c':
3018 dir.fmtfunc = format_character;
3019 break;
3021 case 'S':
3022 case 's':
3023 dir.fmtfunc = format_string;
3024 break;
3026 default:
3027 /* Unknown conversion specification. */
3028 return 0;
3031 dir.specifier = *pf++;
3033 if (star_width)
3035 if (TREE_CODE (TREE_TYPE (star_width)) == INTEGER_TYPE)
3036 dir.set_width (star_width);
3037 else
3039 /* Width specified by a va_list takes on the range [0, -INT_MIN]
3040 (width is the absolute value of that specified). */
3041 dir.width[0] = 0;
3042 dir.width[1] = target_int_max () + 1;
3045 else
3046 dir.set_width (width);
3048 if (star_precision)
3050 if (TREE_CODE (TREE_TYPE (star_precision)) == INTEGER_TYPE)
3051 dir.set_precision (star_precision);
3052 else
3054 /* Precision specified by a va_list takes on the range [-1, INT_MAX]
3055 (unlike width, negative precision is ignored). */
3056 dir.prec[0] = -1;
3057 dir.prec[1] = target_int_max ();
3060 else
3061 dir.set_precision (precision);
3063 /* Extract the argument if the directive takes one and if it's
3064 available (e.g., the function doesn't take a va_list). Treat
3065 missing arguments the same as va_list, even though they will
3066 have likely already been diagnosed by -Wformat. */
3067 if (dir.specifier != '%'
3068 && *argno < gimple_call_num_args (info.callstmt))
3069 dir.arg = gimple_call_arg (info.callstmt, dollar ? dollar : (*argno)++);
3071 /* Return the length of the format directive. */
3072 dir.len = pf - pcnt;
3074 if (dump_file)
3076 fprintf (dump_file, " Directive %u at offset %llu: \"%.*s\"",
3077 dir.dirno, (unsigned long long)(size_t)(dir.beg - info.fmtstr),
3078 (int)dir.len, dir.beg);
3079 if (star_width)
3081 if (dir.width[0] == dir.width[1])
3082 fprintf (dump_file, ", width = %lli", (long long)dir.width[0]);
3083 else
3084 fprintf (dump_file, ", width in range [%lli, %lli]",
3085 (long long)dir.width[0], (long long)dir.width[1]);
3088 if (star_precision)
3090 if (dir.prec[0] == dir.prec[1])
3091 fprintf (dump_file, ", precision = %lli", (long long)dir.prec[0]);
3092 else
3093 fprintf (dump_file, ", precision in range [%lli, %lli]",
3094 (long long)dir.prec[0], (long long)dir.prec[1]);
3096 fputc ('\n', dump_file);
3099 return dir.len;
3102 /* Compute the length of the output resulting from the call to a formatted
3103 output function described by INFO and store the result of the call in
3104 *RES. Issue warnings for detected past the end writes. Return true
3105 if the complete format string has been processed and *RES can be relied
3106 on, false otherwise (e.g., when a unknown or unhandled directive was seen
3107 that caused the processing to be terminated early). */
3109 bool
3110 pass_sprintf_length::compute_format_length (call_info &info,
3111 format_result *res)
3113 if (dump_file)
3115 location_t callloc = gimple_location (info.callstmt);
3116 fprintf (dump_file, "%s:%i: ",
3117 LOCATION_FILE (callloc), LOCATION_LINE (callloc));
3118 print_generic_expr (dump_file, info.func, dump_flags);
3120 fprintf (dump_file, ": objsize = %llu, fmtstr = \"%s\"\n",
3121 (unsigned long long)info.objsize, info.fmtstr);
3124 /* Reset the minimum and maximum byte counters. */
3125 res->range.min = res->range.max = 0;
3127 /* No directive has been seen yet so the length of output is bounded
3128 by the known range [0, 0] (with no conversion producing more than
3129 4K bytes) until determined otherwise. */
3130 res->knownrange = true;
3131 res->under4k = true;
3132 res->floating = false;
3133 res->warned = false;
3135 /* 1-based directive counter. */
3136 unsigned dirno = 1;
3138 /* The variadic argument counter. */
3139 unsigned argno = info.argidx;
3141 for (const char *pf = info.fmtstr; ; ++dirno)
3143 directive dir = directive ();
3144 dir.dirno = dirno;
3146 size_t n = parse_directive (info, dir, res, pf, &argno);
3148 /* Return failure if the format function fails. */
3149 if (!format_directive (info, res, dir))
3150 return false;
3152 /* Return success the directive is zero bytes long and it's
3153 the last think in the format string (i.e., it's the terminating
3154 nul, which isn't really a directive but handling it as one makes
3155 things simpler). */
3156 if (!n)
3157 return *pf == '\0';
3159 pf += n;
3162 /* The complete format string was processed (with or without warnings). */
3163 return true;
3166 /* Return the size of the object referenced by the expression DEST if
3167 available, or -1 otherwise. */
3169 static unsigned HOST_WIDE_INT
3170 get_destination_size (tree dest)
3172 /* Initialize object size info before trying to compute it. */
3173 init_object_sizes ();
3175 /* Use __builtin_object_size to determine the size of the destination
3176 object. When optimizing, determine the smallest object (such as
3177 a member array as opposed to the whole enclosing object), otherwise
3178 use type-zero object size to determine the size of the enclosing
3179 object (the function fails without optimization in this type). */
3180 int ost = optimize > 0;
3181 unsigned HOST_WIDE_INT size;
3182 if (compute_builtin_object_size (dest, ost, &size))
3183 return size;
3185 return HOST_WIDE_INT_M1U;
3188 /* Given a suitable result RES of a call to a formatted output function
3189 described by INFO, substitute the result for the return value of
3190 the call. The result is suitable if the number of bytes it represents
3191 is known and exact. A result that isn't suitable for substitution may
3192 have its range set to the range of return values, if that is known.
3193 Return true if the call is removed and gsi_next should not be performed
3194 in the caller. */
3196 static bool
3197 try_substitute_return_value (gimple_stmt_iterator *gsi,
3198 const pass_sprintf_length::call_info &info,
3199 const format_result &res)
3201 tree lhs = gimple_get_lhs (info.callstmt);
3203 /* Set to true when the entire call has been removed. */
3204 bool removed = false;
3206 /* The minimum return value. */
3207 unsigned HOST_WIDE_INT minretval = res.range.min;
3209 /* The maximum return value is in most cases bounded by RES.RANGE.MAX
3210 but in cases involving multibyte characters could be as large as
3211 RES.RANGE.UNLIKELY. */
3212 unsigned HOST_WIDE_INT maxretval
3213 = res.range.unlikely < res.range.max ? res.range.max : res.range.unlikely;
3215 /* Adjust the number of bytes which includes the terminating nul
3216 to reflect the return value of the function which does not.
3217 Because the valid range of the function is [INT_MIN, INT_MAX],
3218 a valid range before the adjustment below is [0, INT_MAX + 1]
3219 (the functions only return negative values on error or undefined
3220 behavior). */
3221 if (minretval <= target_int_max () + 1)
3222 --minretval;
3223 if (maxretval <= target_int_max () + 1)
3224 --maxretval;
3226 /* Avoid the return value optimization when the behavior of the call
3227 is undefined either because any directive may have produced 4K or
3228 more of output, or the return value exceeds INT_MAX, or because
3229 the output overflows the destination object (but leave it enabled
3230 when the function is bounded because then the behavior is well-
3231 defined). */
3232 if (res.under4k
3233 && minretval == maxretval
3234 && (info.bounded || minretval < info.objsize)
3235 && minretval <= target_int_max ()
3236 /* Not prepared to handle possibly throwing calls here; they shouldn't
3237 appear in non-artificial testcases, except when the __*_chk routines
3238 are badly declared. */
3239 && !stmt_ends_bb_p (info.callstmt))
3241 tree cst = build_int_cst (integer_type_node, minretval);
3243 if (lhs == NULL_TREE
3244 && info.nowrite)
3246 /* Remove the call to the bounded function with a zero size
3247 (e.g., snprintf(0, 0, "%i", 123)) if there is no lhs. */
3248 unlink_stmt_vdef (info.callstmt);
3249 gsi_remove (gsi, true);
3250 removed = true;
3252 else if (info.nowrite)
3254 /* Replace the call to the bounded function with a zero size
3255 (e.g., snprintf(0, 0, "%i", 123) with the constant result
3256 of the function. */
3257 if (!update_call_from_tree (gsi, cst))
3258 gimplify_and_update_call_from_tree (gsi, cst);
3259 gimple *callstmt = gsi_stmt (*gsi);
3260 update_stmt (callstmt);
3262 else if (lhs)
3264 /* Replace the left-hand side of the call with the constant
3265 result of the formatted function. */
3266 gimple_call_set_lhs (info.callstmt, NULL_TREE);
3267 gimple *g = gimple_build_assign (lhs, cst);
3268 gsi_insert_after (gsi, g, GSI_NEW_STMT);
3269 update_stmt (info.callstmt);
3272 if (dump_file)
3274 if (removed)
3275 fprintf (dump_file, " Removing call statement.");
3276 else
3278 fprintf (dump_file, " Substituting ");
3279 print_generic_expr (dump_file, cst, dump_flags);
3280 fprintf (dump_file, " for %s.\n",
3281 info.nowrite ? "statement" : "return value");
3285 else if (lhs)
3287 bool setrange = false;
3289 if ((info.bounded || maxretval < info.objsize)
3290 && res.under4k
3291 && (minretval < target_int_max ()
3292 && maxretval < target_int_max ()))
3294 /* If the result is in a valid range bounded by the size of
3295 the destination set it so that it can be used for subsequent
3296 optimizations. */
3297 int prec = TYPE_PRECISION (integer_type_node);
3299 wide_int min = wi::shwi (minretval, prec);
3300 wide_int max = wi::shwi (maxretval, prec);
3301 set_range_info (lhs, VR_RANGE, min, max);
3303 setrange = true;
3306 if (dump_file)
3308 const char *inbounds
3309 = (minretval < info.objsize
3310 ? (maxretval < info.objsize
3311 ? "in" : "potentially out-of")
3312 : "out-of");
3314 const char *what = setrange ? "Setting" : "Discarding";
3315 if (minretval != maxretval)
3316 fprintf (dump_file,
3317 " %s %s-bounds return value range [%llu, %llu].\n",
3318 what, inbounds,
3319 (unsigned long long)minretval,
3320 (unsigned long long)maxretval);
3321 else
3322 fprintf (dump_file, " %s %s-bounds return value %llu.\n",
3323 what, inbounds, (unsigned long long)minretval);
3327 if (dump_file)
3328 fputc ('\n', dump_file);
3330 return removed;
3333 /* Determine if a GIMPLE CALL is to one of the sprintf-like built-in
3334 functions and if so, handle it. Return true if the call is removed
3335 and gsi_next should not be performed in the caller. */
3337 bool
3338 pass_sprintf_length::handle_gimple_call (gimple_stmt_iterator *gsi)
3340 call_info info = call_info ();
3342 info.callstmt = gsi_stmt (*gsi);
3343 if (!gimple_call_builtin_p (info.callstmt, BUILT_IN_NORMAL))
3344 return false;
3346 info.func = gimple_call_fndecl (info.callstmt);
3347 info.fncode = DECL_FUNCTION_CODE (info.func);
3349 /* The size of the destination as in snprintf(dest, size, ...). */
3350 unsigned HOST_WIDE_INT dstsize = HOST_WIDE_INT_M1U;
3352 /* The size of the destination determined by __builtin_object_size. */
3353 unsigned HOST_WIDE_INT objsize = HOST_WIDE_INT_M1U;
3355 /* Buffer size argument number (snprintf and vsnprintf). */
3356 unsigned HOST_WIDE_INT idx_dstsize = HOST_WIDE_INT_M1U;
3358 /* Object size argument number (snprintf_chk and vsnprintf_chk). */
3359 unsigned HOST_WIDE_INT idx_objsize = HOST_WIDE_INT_M1U;
3361 /* Format string argument number (valid for all functions). */
3362 unsigned idx_format;
3364 switch (info.fncode)
3366 case BUILT_IN_SPRINTF:
3367 // Signature:
3368 // __builtin_sprintf (dst, format, ...)
3369 idx_format = 1;
3370 info.argidx = 2;
3371 break;
3373 case BUILT_IN_SPRINTF_CHK:
3374 // Signature:
3375 // __builtin___sprintf_chk (dst, ost, objsize, format, ...)
3376 idx_objsize = 2;
3377 idx_format = 3;
3378 info.argidx = 4;
3379 break;
3381 case BUILT_IN_SNPRINTF:
3382 // Signature:
3383 // __builtin_snprintf (dst, size, format, ...)
3384 idx_dstsize = 1;
3385 idx_format = 2;
3386 info.argidx = 3;
3387 info.bounded = true;
3388 break;
3390 case BUILT_IN_SNPRINTF_CHK:
3391 // Signature:
3392 // __builtin___snprintf_chk (dst, size, ost, objsize, format, ...)
3393 idx_dstsize = 1;
3394 idx_objsize = 3;
3395 idx_format = 4;
3396 info.argidx = 5;
3397 info.bounded = true;
3398 break;
3400 case BUILT_IN_VSNPRINTF:
3401 // Signature:
3402 // __builtin_vsprintf (dst, size, format, va)
3403 idx_dstsize = 1;
3404 idx_format = 2;
3405 info.argidx = -1;
3406 info.bounded = true;
3407 break;
3409 case BUILT_IN_VSNPRINTF_CHK:
3410 // Signature:
3411 // __builtin___vsnprintf_chk (dst, size, ost, objsize, format, va)
3412 idx_dstsize = 1;
3413 idx_objsize = 3;
3414 idx_format = 4;
3415 info.argidx = -1;
3416 info.bounded = true;
3417 break;
3419 case BUILT_IN_VSPRINTF:
3420 // Signature:
3421 // __builtin_vsprintf (dst, format, va)
3422 idx_format = 1;
3423 info.argidx = -1;
3424 break;
3426 case BUILT_IN_VSPRINTF_CHK:
3427 // Signature:
3428 // __builtin___vsprintf_chk (dst, ost, objsize, format, va)
3429 idx_format = 3;
3430 idx_objsize = 2;
3431 info.argidx = -1;
3432 break;
3434 default:
3435 return false;
3438 /* Set the global warning level for this function. */
3439 warn_level = info.bounded ? warn_format_trunc : warn_format_overflow;
3441 /* The first argument is a pointer to the destination. */
3442 tree dstptr = gimple_call_arg (info.callstmt, 0);
3444 info.format = gimple_call_arg (info.callstmt, idx_format);
3446 if (idx_dstsize == HOST_WIDE_INT_M1U)
3448 /* For non-bounded functions like sprintf, determine the size
3449 of the destination from the object or pointer passed to it
3450 as the first argument. */
3451 dstsize = get_destination_size (dstptr);
3453 else if (tree size = gimple_call_arg (info.callstmt, idx_dstsize))
3455 /* For bounded functions try to get the size argument. */
3457 if (TREE_CODE (size) == INTEGER_CST)
3459 dstsize = tree_to_uhwi (size);
3460 /* No object can be larger than SIZE_MAX bytes (half the address
3461 space) on the target.
3462 The functions are defined only for output of at most INT_MAX
3463 bytes. Specifying a bound in excess of that limit effectively
3464 defeats the bounds checking (and on some implementations such
3465 as Solaris cause the function to fail with EINVAL). */
3466 if (dstsize > target_size_max () / 2)
3468 /* Avoid warning if -Wstringop-overflow is specified since
3469 it also warns for the same thing though only for the
3470 checking built-ins. */
3471 if ((idx_objsize == HOST_WIDE_INT_M1U
3472 || !warn_stringop_overflow))
3473 warning_at (gimple_location (info.callstmt), info.warnopt (),
3474 "specified bound %wu exceeds maximum object size "
3475 "%wu",
3476 dstsize, target_size_max () / 2);
3478 else if (dstsize > target_int_max ())
3479 warning_at (gimple_location (info.callstmt), info.warnopt (),
3480 "specified bound %wu exceeds %<INT_MAX %>",
3481 dstsize);
3483 else if (TREE_CODE (size) == SSA_NAME)
3485 /* Try to determine the range of values of the argument
3486 and use the greater of the two at -Wformat-level 1 and
3487 the smaller of them at level 2. */
3488 wide_int min, max;
3489 enum value_range_type range_type
3490 = get_range_info (size, &min, &max);
3491 if (range_type == VR_RANGE)
3493 dstsize
3494 = (warn_level < 2
3495 ? wi::fits_uhwi_p (max) ? max.to_uhwi () : max.to_shwi ()
3496 : wi::fits_uhwi_p (min) ? min.to_uhwi () : min.to_shwi ());
3501 if (idx_objsize != HOST_WIDE_INT_M1U)
3502 if (tree size = gimple_call_arg (info.callstmt, idx_objsize))
3503 if (tree_fits_uhwi_p (size))
3504 objsize = tree_to_uhwi (size);
3506 if (info.bounded && !dstsize)
3508 /* As a special case, when the explicitly specified destination
3509 size argument (to a bounded function like snprintf) is zero
3510 it is a request to determine the number of bytes on output
3511 without actually producing any. Pretend the size is
3512 unlimited in this case. */
3513 info.objsize = HOST_WIDE_INT_MAX;
3514 info.nowrite = true;
3516 else
3518 /* For calls to non-bounded functions or to those of bounded
3519 functions with a non-zero size, warn if the destination
3520 pointer is null. */
3521 if (integer_zerop (dstptr))
3523 /* This is diagnosed with -Wformat only when the null is a constant
3524 pointer. The warning here diagnoses instances where the pointer
3525 is not constant. */
3526 location_t loc = gimple_location (info.callstmt);
3527 warning_at (EXPR_LOC_OR_LOC (dstptr, loc),
3528 info.warnopt (), "null destination pointer");
3529 return false;
3532 /* Set the object size to the smaller of the two arguments
3533 of both have been specified and they're not equal. */
3534 info.objsize = dstsize < objsize ? dstsize : objsize;
3536 if (info.bounded
3537 && dstsize < target_size_max () / 2 && objsize < dstsize
3538 /* Avoid warning if -Wstringop-overflow is specified since
3539 it also warns for the same thing though only for the
3540 checking built-ins. */
3541 && (idx_objsize == HOST_WIDE_INT_M1U
3542 || !warn_stringop_overflow))
3544 warning_at (gimple_location (info.callstmt), info.warnopt (),
3545 "specified bound %wu exceeds the size %wu "
3546 "of the destination object", dstsize, objsize);
3550 if (integer_zerop (info.format))
3552 /* This is diagnosed with -Wformat only when the null is a constant
3553 pointer. The warning here diagnoses instances where the pointer
3554 is not constant. */
3555 location_t loc = gimple_location (info.callstmt);
3556 warning_at (EXPR_LOC_OR_LOC (info.format, loc),
3557 info.warnopt (), "null format string");
3558 return false;
3561 info.fmtstr = get_format_string (info.format, &info.fmtloc);
3562 if (!info.fmtstr)
3563 return false;
3565 /* The result is the number of bytes output by the formatted function,
3566 including the terminating NUL. */
3567 format_result res = format_result ();
3569 bool success = compute_format_length (info, &res);
3571 /* When optimizing and the printf return value optimization is enabled,
3572 attempt to substitute the computed result for the return value of
3573 the call. Avoid this optimization when -frounding-math is in effect
3574 and the format string contains a floating point directive. */
3575 if (success
3576 && optimize > 0
3577 && flag_printf_return_value
3578 && (!flag_rounding_math || !res.floating))
3579 return try_substitute_return_value (gsi, info, res);
3581 return false;
3584 /* Execute the pass for function FUN. */
3586 unsigned int
3587 pass_sprintf_length::execute (function *fun)
3589 basic_block bb;
3590 FOR_EACH_BB_FN (bb, fun)
3592 for (gimple_stmt_iterator si = gsi_start_bb (bb); !gsi_end_p (si); )
3594 /* Iterate over statements, looking for function calls. */
3595 gimple *stmt = gsi_stmt (si);
3597 if (is_gimple_call (stmt) && handle_gimple_call (&si))
3598 /* If handle_gimple_call returns true, the iterator is
3599 already pointing to the next statement. */
3600 continue;
3602 gsi_next (&si);
3606 /* Clean up object size info. */
3607 fini_object_sizes ();
3609 return 0;
3612 } /* Unnamed namespace. */
3614 /* Return a pointer to a pass object newly constructed from the context
3615 CTXT. */
3617 gimple_opt_pass *
3618 make_pass_sprintf_length (gcc::context *ctxt)
3620 return new pass_sprintf_length (ctxt);