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
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
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. */
50 #include "coretypes.h"
54 #include "tree-pass.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"
62 #include "tree-object-size.h"
65 #include "tree-ssa-propagate.h"
71 #include "stor-layout.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)
95 const pass_data pass_data_sprintf_length
= {
96 GIMPLE_PASS
, // pass type
97 "printf-return-value", // pass name
98 OPTGROUP_NONE
, // optinfo_flags
100 PROP_cfg
, // properties_required
101 0, // properties_provided
102 0, // properties_destroyed
103 0, // properties_start
104 0, // properties_finish
107 struct format_result
;
109 class pass_sprintf_length
: public gimple_opt_pass
111 bool fold_return_value
;
114 pass_sprintf_length (gcc::context
*ctxt
)
115 : gimple_opt_pass (pass_data_sprintf_length
, ctxt
),
116 fold_return_value (false)
119 opt_pass
* clone () { return new pass_sprintf_length (m_ctxt
); }
121 virtual bool gate (function
*);
123 virtual unsigned int execute (function
*);
125 void set_pass_param (unsigned int n
, bool param
)
128 fold_return_value
= param
;
131 void handle_gimple_call (gimple_stmt_iterator
*);
134 bool compute_format_length (call_info
&, format_result
*);
138 pass_sprintf_length::gate (function
*)
140 /* Run the pass iff -Warn-format-length is specified and either
141 not optimizing and the pass is being invoked early, or when
142 optimizing and the pass is being invoked during optimization
144 return ((warn_format_length
> 0 || flag_printf_return_value
)
145 && (optimize
> 0) == fold_return_value
);
148 /* The result of a call to a formatted function. */
152 /* Number of characters written by the formatted function, exact,
153 minimum and maximum when an exact number cannot be determined.
154 Setting the minimum to HOST_WIDE_INT_MAX disables all length
155 tracking for the remainder of the format string.
156 Setting either of the other two members to HOST_WIDE_INT_MAX
157 disables the exact or maximum length tracking, respectively,
158 but continues to track the maximum. */
159 unsigned HOST_WIDE_INT number_chars
;
160 unsigned HOST_WIDE_INT number_chars_min
;
161 unsigned HOST_WIDE_INT number_chars_max
;
163 /* True when the range given by NUMBER_CHARS_MIN and NUMBER_CHARS_MAX
164 can be relied on for value range propagation, false otherwise.
165 This means that BOUNDED must not be set if the number of bytes
166 produced by any directive is unspecified or implementation-
167 defined (unless the implementation's behavior is known and
168 determined via a target hook).
169 Note that BOUNDED only implies that the length of a function's
170 output is known to be within some range, not that it's constant
171 and a candidate for string folding. BOUNDED is a stronger
172 guarantee than KNOWNRANGE. */
175 /* True when the range above is obtained from known values of
176 directive arguments or their bounds and not the result of
177 heuristics that depend on warning levels. It is used to
178 issue stricter diagnostics in cases where strings of unknown
179 lengths are bounded by the arrays they are determined to
180 refer to. KNOWNRANGE must not be used to set the range of
181 the return value of a call. */
184 /* True when the output of the formatted call is constant (and
185 thus a candidate for string constant folding). This is rare
186 and typically requires that the arguments of all directives
187 are also constant. CONSTANT implies BOUNDED. */
190 /* True if no individual directive resulted in more than 4095 bytes
191 of output (the total NUMBER_CHARS might be greater). */
194 /* True when a floating point directive has been seen in the format
198 /* True when an intermediate result has caused a warning. Used to
199 avoid issuing duplicate warnings while finishing the processing
203 /* Preincrement the number of output characters by 1. */
204 format_result
& operator++ ()
209 /* Postincrement the number of output characters by 1. */
210 format_result
operator++ (int)
212 format_result
prev (*this);
217 /* Increment the number of output characters by N. */
218 format_result
& operator+= (unsigned HOST_WIDE_INT n
)
220 gcc_assert (n
< HOST_WIDE_INT_MAX
);
222 if (number_chars
< HOST_WIDE_INT_MAX
)
224 if (number_chars_min
< HOST_WIDE_INT_MAX
)
225 number_chars_min
+= n
;
226 if (number_chars_max
< HOST_WIDE_INT_MAX
)
227 number_chars_max
+= n
;
232 /* Return the value of INT_MIN for the target. */
234 static inline HOST_WIDE_INT
237 return tree_to_shwi (TYPE_MIN_VALUE (integer_type_node
));
240 /* Return the value of INT_MAX for the target. */
242 static inline unsigned HOST_WIDE_INT
245 return tree_to_uhwi (TYPE_MAX_VALUE (integer_type_node
));
248 /* Return the value of SIZE_MAX for the target. */
250 static inline unsigned HOST_WIDE_INT
253 return tree_to_uhwi (TYPE_MAX_VALUE (size_type_node
));
256 /* Return the constant initial value of DECL if available or DECL
257 otherwise. Same as the synonymous function in c/c-typeck.c. */
260 decl_constant_value (tree decl
)
262 if (/* Don't change a variable array bound or initial value to a constant
263 in a place where a variable is invalid. Note that DECL_INITIAL
264 isn't valid for a PARM_DECL. */
265 current_function_decl
!= 0
266 && TREE_CODE (decl
) != PARM_DECL
267 && !TREE_THIS_VOLATILE (decl
)
268 && TREE_READONLY (decl
)
269 && DECL_INITIAL (decl
) != 0
270 && TREE_CODE (DECL_INITIAL (decl
)) != ERROR_MARK
271 /* This is invalid if initial value is not constant.
272 If it has either a function call, a memory reference,
273 or a variable, then re-evaluating it could give different results. */
274 && TREE_CONSTANT (DECL_INITIAL (decl
))
275 /* Check for cases where this is sub-optimal, even though valid. */
276 && TREE_CODE (DECL_INITIAL (decl
)) != CONSTRUCTOR
)
277 return DECL_INITIAL (decl
);
281 /* Given FORMAT, set *PLOC to the source location of the format string
282 and return the format string if it is known or null otherwise. */
285 get_format_string (tree format
, location_t
*ploc
)
289 /* Pull out a constant value if the front end didn't. */
290 format
= decl_constant_value (format
);
294 if (integer_zerop (format
))
296 /* FIXME: Diagnose null format string if it hasn't been diagnosed
297 by -Wformat (the latter diagnoses only nul pointer constants,
298 this pass can do better). */
302 HOST_WIDE_INT offset
= 0;
304 if (TREE_CODE (format
) == POINTER_PLUS_EXPR
)
306 tree arg0
= TREE_OPERAND (format
, 0);
307 tree arg1
= TREE_OPERAND (format
, 1);
311 if (TREE_CODE (arg1
) != INTEGER_CST
)
316 /* POINTER_PLUS_EXPR offsets are to be interpreted signed. */
317 if (!cst_and_fits_in_hwi (arg1
))
320 offset
= int_cst_value (arg1
);
323 if (TREE_CODE (format
) != ADDR_EXPR
)
326 *ploc
= EXPR_LOC_OR_LOC (format
, input_location
);
328 format
= TREE_OPERAND (format
, 0);
330 if (TREE_CODE (format
) == ARRAY_REF
331 && tree_fits_shwi_p (TREE_OPERAND (format
, 1))
332 && (offset
+= tree_to_shwi (TREE_OPERAND (format
, 1))) >= 0)
333 format
= TREE_OPERAND (format
, 0);
339 tree array_size
= NULL_TREE
;
342 && TREE_CODE (TREE_TYPE (format
)) == ARRAY_TYPE
343 && (array_init
= decl_constant_value (format
)) != format
344 && TREE_CODE (array_init
) == STRING_CST
)
346 /* Extract the string constant initializer. Note that this may
347 include a trailing NUL character that is not in the array (e.g.
348 const char a[3] = "foo";). */
349 array_size
= DECL_SIZE_UNIT (format
);
353 if (TREE_CODE (format
) != STRING_CST
)
356 if (TYPE_MAIN_VARIANT (TREE_TYPE (TREE_TYPE (format
))) != char_type_node
)
358 /* Wide format string. */
362 const char *fmtstr
= TREE_STRING_POINTER (format
);
363 unsigned fmtlen
= TREE_STRING_LENGTH (format
);
367 /* Variable length arrays can't be initialized. */
368 gcc_assert (TREE_CODE (array_size
) == INTEGER_CST
);
370 if (tree_fits_shwi_p (array_size
))
372 HOST_WIDE_INT array_size_value
= tree_to_shwi (array_size
);
373 if (array_size_value
> 0
374 && array_size_value
== (int) array_size_value
375 && fmtlen
> array_size_value
)
376 fmtlen
= array_size_value
;
381 if (offset
>= fmtlen
)
388 if (fmtlen
< 1 || fmtstr
[--fmtlen
] != 0)
390 /* FIXME: Diagnose an unterminated format string if it hasn't been
391 diagnosed by -Wformat. Similarly to a null format pointer,
392 -Wformay diagnoses only nul pointer constants, this pass can
400 /* The format_warning_at_substring function is not used here in a way
401 that makes using attribute format viable. Suppress the warning. */
403 #pragma GCC diagnostic push
404 #pragma GCC diagnostic ignored "-Wsuggest-attribute=format"
406 /* For convenience and brevity. */
409 (* const fmtwarn
) (const substring_loc
&, const source_range
*,
410 const char *, int, const char *, ...)
411 = format_warning_at_substring
;
413 /* Format length modifiers. */
418 FMT_LEN_hh
, // char argument
421 FMT_LEN_ll
, // long long
422 FMT_LEN_L
, // long double (and GNU long long)
424 FMT_LEN_t
, // ptrdiff_t
425 FMT_LEN_j
// intmax_t
429 /* A minimum and maximum number of bytes. */
433 unsigned HOST_WIDE_INT min
, max
;
436 /* Description of the result of conversion either of a single directive
437 or the whole format string. */
442 : argmin (), argmax (), knownrange (), bounded (), constant (), nullp ()
444 range
.min
= range
.max
= HOST_WIDE_INT_MAX
;
447 /* The range a directive's argument is in. */
450 /* The minimum and maximum number of bytes that a directive
451 results in on output for an argument in the range above. */
454 /* True when the range above is obtained from a known value of
455 a directive's argument or its bounds and not the result of
456 heuristics that depend on warning levels. */
459 /* True when the range is the result of an argument determined
460 to be bounded to a subrange of its type or value (such as by
461 value range propagation or the width of the formt directive),
465 /* True when the output of a directive is constant. This is rare
466 and typically requires that the argument(s) of the directive
467 are also constant (such as determined by constant propagation,
468 though not value range propagation). */
471 /* True when the argument is a null pointer. */
475 /* Description of a conversion specification. */
477 struct conversion_spec
479 /* A bitmap of flags, one for each character. */
480 unsigned flags
[256 / sizeof (int)];
481 /* Numeric width as in "%8x". */
483 /* Numeric precision as in "%.32s". */
486 /* Width specified via the '*' character. Need not be INTEGER_CST.
487 For vararg functions set to void_node. */
489 /* Precision specified via the asterisk. Need not be INTEGER_CST.
490 For vararg functions set to void_node. */
493 /* Length modifier. */
494 format_lengths modifier
;
496 /* Format specifier character. */
499 /* Numeric width was given. */
500 unsigned have_width
: 1;
501 /* Numeric precision was given. */
502 unsigned have_precision
: 1;
503 /* Non-zero when certain flags should be interpreted even for a directive
504 that normally doesn't accept them (used when "%p" with flags such as
505 space or plus is interepreted as a "%x". */
506 unsigned force_flags
: 1;
508 /* Format conversion function that given a conversion specification
509 and an argument returns the formatting result. */
510 fmtresult (*fmtfunc
) (const conversion_spec
&, tree
);
512 /* Return True when a the format flag CHR has been used. */
513 bool get_flag (char chr
) const
515 unsigned char c
= chr
& 0xff;
516 return (flags
[c
/ (CHAR_BIT
* sizeof *flags
)]
517 & (1U << (c
% (CHAR_BIT
* sizeof *flags
))));
520 /* Make a record of the format flag CHR having been used. */
521 void set_flag (char chr
)
523 unsigned char c
= chr
& 0xff;
524 flags
[c
/ (CHAR_BIT
* sizeof *flags
)]
525 |= (1U << (c
% (CHAR_BIT
* sizeof *flags
)));
528 /* Reset the format flag CHR. */
529 void clear_flag (char chr
)
531 unsigned char c
= chr
& 0xff;
532 flags
[c
/ (CHAR_BIT
* sizeof *flags
)]
533 &= ~(1U << (c
% (CHAR_BIT
* sizeof *flags
)));
537 /* Return the logarithm of X in BASE. */
540 ilog (unsigned HOST_WIDE_INT x
, int base
)
551 /* Return the number of bytes resulting from converting into a string
552 the INTEGER_CST tree node X in BASE with a minimum of PREC digits.
553 PLUS indicates whether 1 for a plus sign should be added for positive
554 numbers, and PREFIX whether the length of an octal ('O') or hexadecimal
555 ('0x') prefix should be added for nonzero numbers. Return -1 if X cannot
559 tree_digits (tree x
, int base
, HOST_WIDE_INT prec
, bool plus
, bool prefix
)
561 unsigned HOST_WIDE_INT absval
;
565 if (TYPE_UNSIGNED (TREE_TYPE (x
)))
567 if (tree_fits_uhwi_p (x
))
569 absval
= tree_to_uhwi (x
);
577 if (tree_fits_shwi_p (x
))
579 HOST_WIDE_INT i
= tree_to_shwi (x
);
595 int ndigs
= ilog (absval
, base
);
597 res
+= prec
< ndigs
? ndigs
: prec
;
599 if (prefix
&& absval
)
610 /* Given the formatting result described by RES and NAVAIL, the number
611 of available in the destination, return the number of bytes remaining
612 in the destination. */
614 static inline result_range
615 bytes_remaining (unsigned HOST_WIDE_INT navail
, const format_result
&res
)
619 if (HOST_WIDE_INT_MAX
<= navail
)
621 range
.min
= range
.max
= navail
;
625 if (res
.number_chars
< navail
)
627 range
.min
= range
.max
= navail
- res
.number_chars
;
629 else if (res
.number_chars_min
< navail
)
631 range
.max
= navail
- res
.number_chars_min
;
636 if (res
.number_chars_max
< navail
)
637 range
.min
= navail
- res
.number_chars_max
;
644 /* Given the formatting result described by RES and NAVAIL, the number
645 of available in the destination, return the minimum number of bytes
646 remaining in the destination. */
648 static inline unsigned HOST_WIDE_INT
649 min_bytes_remaining (unsigned HOST_WIDE_INT navail
, const format_result
&res
)
651 if (HOST_WIDE_INT_MAX
<= navail
)
654 if (1 < warn_format_length
|| res
.knownrange
)
656 /* At level 2, or when all directives output an exact number
657 of bytes or when their arguments were bounded by known
658 ranges, use the greater of the two byte counters if it's
659 valid to compute the result. */
660 if (res
.number_chars_max
< HOST_WIDE_INT_MAX
)
661 navail
-= res
.number_chars_max
;
662 else if (res
.number_chars
< HOST_WIDE_INT_MAX
)
663 navail
-= res
.number_chars
;
664 else if (res
.number_chars_min
< HOST_WIDE_INT_MAX
)
665 navail
-= res
.number_chars_min
;
669 /* At level 1 use the smaller of the byte counters to compute
671 if (res
.number_chars
< HOST_WIDE_INT_MAX
)
672 navail
-= res
.number_chars
;
673 else if (res
.number_chars_min
< HOST_WIDE_INT_MAX
)
674 navail
-= res
.number_chars_min
;
675 else if (res
.number_chars_max
< HOST_WIDE_INT_MAX
)
676 navail
-= res
.number_chars_max
;
679 if (navail
> HOST_WIDE_INT_MAX
)
685 /* Description of a call to a formatted function. */
687 struct pass_sprintf_length::call_info
689 /* Function call statement. */
692 /* Function called. */
695 /* Called built-in function code. */
696 built_in_function fncode
;
698 /* Format argument and format string extracted from it. */
702 /* The location of the format argument. */
705 /* The destination object size for __builtin___xxx_chk functions
706 typically determined by __builtin_object_size, or -1 if unknown. */
707 unsigned HOST_WIDE_INT objsize
;
709 /* Number of the first variable argument. */
710 unsigned HOST_WIDE_INT argidx
;
712 /* True for functions like snprintf that specify the size of
713 the destination, false for others like sprintf that don't. */
716 /* True for bounded functions like snprintf that specify a zero-size
717 buffer as a request to compute the size of output without actually
718 writing any. NOWRITE is cleared in response to the %n directive
719 which has side-effects similar to writing output. */
722 /* Return true if the called function's return value is used. */
723 bool retval_used () const
725 return gimple_get_lhs (callstmt
);
728 /* Return the warning option corresponding to the called function. */
731 return bounded
? OPT_Wformat_truncation_
: OPT_Wformat_length_
;
735 /* Return the result of formatting the '%%' directive. */
738 format_percent (const conversion_spec
&, tree
)
741 res
.argmin
= res
.argmax
= NULL_TREE
;
742 res
.range
.min
= res
.range
.max
= 1;
743 res
.bounded
= res
.constant
= true;
748 /* Compute intmax_type_node and uintmax_type_node similarly to how
749 tree.c builds size_type_node. */
752 build_intmax_type_nodes (tree
*pintmax
, tree
*puintmax
)
754 if (strcmp (UINTMAX_TYPE
, "unsigned int") == 0)
756 *pintmax
= integer_type_node
;
757 *puintmax
= unsigned_type_node
;
759 else if (strcmp (UINTMAX_TYPE
, "long unsigned int") == 0)
761 *pintmax
= long_integer_type_node
;
762 *puintmax
= long_unsigned_type_node
;
764 else if (strcmp (UINTMAX_TYPE
, "long long unsigned int") == 0)
766 *pintmax
= long_long_integer_type_node
;
767 *puintmax
= long_long_unsigned_type_node
;
771 for (int i
= 0; i
< NUM_INT_N_ENTS
; i
++)
772 if (int_n_enabled_p
[i
])
775 sprintf (name
, "__int%d unsigned", int_n_data
[i
].bitsize
);
777 if (strcmp (name
, UINTMAX_TYPE
) == 0)
779 *pintmax
= int_n_trees
[i
].signed_type
;
780 *puintmax
= int_n_trees
[i
].unsigned_type
;
788 /* Set *PWIDTH and *PPREC according to the width and precision specified
789 in SPEC. Each is set to HOST_WIDE_INT_MIN when the corresponding
790 field is specified but unknown, to zero for width and -1 for precision,
791 respectively when it's not specified, or to a non-negative value
792 corresponding to the known value. */
795 get_width_and_precision (const conversion_spec
&spec
,
796 HOST_WIDE_INT
*pwidth
, HOST_WIDE_INT
*pprec
)
798 HOST_WIDE_INT width
= spec
.have_width
? spec
.width
: 0;
799 HOST_WIDE_INT prec
= spec
.have_precision
? spec
.precision
: -1;
803 if (TREE_CODE (spec
.star_width
) == INTEGER_CST
)
805 width
= tree_to_shwi (spec
.star_width
);
808 if (width
== HOST_WIDE_INT_MIN
)
810 /* Avoid undefined behavior due to negating a minimum.
811 This case will be diagnosed since it will result in
812 more than INT_MAX bytes on output, either by the
813 directive itself (when INT_MAX < HOST_WIDE_INT_MAX)
814 or by the format function itself. */
815 width
= HOST_WIDE_INT_MAX
;
822 width
= HOST_WIDE_INT_MIN
;
825 if (spec
.star_precision
)
827 if (TREE_CODE (spec
.star_precision
) == INTEGER_CST
)
829 prec
= tree_to_shwi (spec
.star_precision
);
834 prec
= HOST_WIDE_INT_MIN
;
841 /* With the range [*ARGMIN, *ARGMAX] of an integer directive's actual
842 argument, due to the conversion from either *ARGMIN or *ARGMAX to
843 the type of the directive's formal argument it's possible for both
844 to result in the same number of bytes or a range of bytes that's
845 less than the number of bytes that would result from formatting
846 some other value in the range [*ARGMIN, *ARGMAX]. This can be
847 determined by checking for the actual argument being in the range
848 of the type of the directive. If it isn't it must be assumed to
849 take on the full range of the directive's type.
850 Return true when the range has been adjusted to the full unsigned
851 range of DIRTYPE, or [0, DIRTYPE_MAX], and false otherwise. */
854 adjust_range_for_overflow (tree dirtype
, tree
*argmin
, tree
*argmax
)
856 tree argtype
= TREE_TYPE (*argmin
);
857 unsigned argprec
= TYPE_PRECISION (argtype
);
858 unsigned dirprec
= TYPE_PRECISION (dirtype
);
860 /* If the actual argument and the directive's argument have the same
861 precision and sign there can be no overflow and so there is nothing
863 if (argprec
== dirprec
&& TYPE_SIGN (argtype
) == TYPE_SIGN (dirtype
))
866 /* The logic below was inspired/lifted from the CONVERT_EXPR_CODE_P
867 branch in the extract_range_from_unary_expr function in tree-vrp.c. */
869 if (TREE_CODE (*argmin
) == INTEGER_CST
870 && TREE_CODE (*argmax
) == INTEGER_CST
871 && (dirprec
>= argprec
872 || integer_zerop (int_const_binop (RSHIFT_EXPR
,
873 int_const_binop (MINUS_EXPR
,
876 size_int (dirprec
)))))
878 *argmin
= force_fit_type (dirtype
, wi::to_widest (*argmin
), 0, false);
879 *argmax
= force_fit_type (dirtype
, wi::to_widest (*argmax
), 0, false);
881 /* If *ARGMIN is still less than *ARGMAX the conversion above
882 is safe. Otherwise, it has overflowed and would be unsafe. */
883 if (tree_int_cst_le (*argmin
, *argmax
))
887 tree dirmin
= TYPE_MIN_VALUE (dirtype
);
888 tree dirmax
= TYPE_MAX_VALUE (dirtype
);
890 if (TYPE_UNSIGNED (dirtype
))
897 *argmin
= integer_zero_node
;
904 /* Return a range representing the minimum and maximum number of bytes
905 that the conversion specification SPEC will write on output for the
906 integer argument ARG when non-null. ARG may be null (for vararg
910 format_integer (const conversion_spec
&spec
, tree arg
)
912 tree intmax_type_node
;
913 tree uintmax_type_node
;
915 /* Set WIDTH and PRECISION based on the specification. */
918 get_width_and_precision (spec
, &width
, &prec
);
920 bool sign
= spec
.specifier
== 'd' || spec
.specifier
== 'i';
922 /* The type of the "formal" argument expected by the directive. */
923 tree dirtype
= NULL_TREE
;
925 /* Determine the expected type of the argument from the length
927 switch (spec
.modifier
)
930 if (spec
.specifier
== 'p')
931 dirtype
= ptr_type_node
;
933 dirtype
= sign
? integer_type_node
: unsigned_type_node
;
937 dirtype
= sign
? short_integer_type_node
: short_unsigned_type_node
;
941 dirtype
= sign
? signed_char_type_node
: unsigned_char_type_node
;
945 dirtype
= sign
? long_integer_type_node
: long_unsigned_type_node
;
951 ? long_long_integer_type_node
952 : long_long_unsigned_type_node
);
956 dirtype
= signed_or_unsigned_type_for (!sign
, size_type_node
);
960 dirtype
= signed_or_unsigned_type_for (!sign
, ptrdiff_type_node
);
964 build_intmax_type_nodes (&intmax_type_node
, &uintmax_type_node
);
965 dirtype
= sign
? intmax_type_node
: uintmax_type_node
;
972 /* The type of the argument to the directive, either deduced from
973 the actual non-constant argument if one is known, or from
974 the directive itself when none has been provided because it's
976 tree argtype
= NULL_TREE
;
980 /* When the argument has not been provided, use the type of
981 the directive's argument as an approximation. This will
982 result in false positives for directives like %i with
983 arguments with smaller precision (such as short or char). */
986 else if (TREE_CODE (arg
) == INTEGER_CST
)
988 /* When a constant argument has been provided use its value
989 rather than type to determine the length of the output. */
991 /* Base to format the number in. */
994 /* True when a signed conversion is preceded by a sign or space. */
995 bool maybesign
= false;
997 switch (spec
.specifier
)
1001 /* Space and '+' are only meaningful for signed conversions. */
1002 maybesign
= spec
.get_flag (' ') | spec
.get_flag ('+');
1021 if ((prec
== HOST_WIDE_INT_MIN
|| prec
== 0) && integer_zerop (arg
))
1023 /* As a special case, a precision of zero with a zero argument
1024 results in zero bytes except in base 8 when the '#' flag is
1025 specified, and for signed conversions in base 8 and 10 when
1026 flags when either the space or '+' flag has been specified
1027 when it results in just one byte (with width having the normal
1028 effect). This must extend to the case of a specified precision
1029 with an unknown value because it can be zero. */
1030 len
= ((base
== 8 && spec
.get_flag ('#')) || maybesign
);
1034 /* Convert the argument to the type of the directive. */
1035 arg
= fold_convert (dirtype
, arg
);
1037 /* True when a conversion is preceded by a prefix indicating the base
1038 of the argument (octal or hexadecimal). */
1039 bool maybebase
= spec
.get_flag ('#');
1040 len
= tree_digits (arg
, base
, prec
, maybesign
, maybebase
);
1042 len
= HOST_WIDE_INT_MAX
;
1048 /* The minimum and maximum number of bytes produced by the directive. */
1051 res
.range
.min
= len
;
1053 /* The upper bound of the number of bytes is unlimited when either
1054 width or precision is specified but its value is unknown, and
1055 the same as the lower bound otherwise. */
1056 if (width
== HOST_WIDE_INT_MIN
|| prec
== HOST_WIDE_INT_MIN
)
1058 res
.range
.max
= HOST_WIDE_INT_MAX
;
1062 res
.range
.max
= len
;
1064 res
.constant
= true;
1065 res
.knownrange
= true;
1071 else if (TREE_CODE (TREE_TYPE (arg
)) == INTEGER_TYPE
1072 || TREE_CODE (TREE_TYPE (arg
)) == POINTER_TYPE
)
1073 /* Determine the type of the provided non-constant argument. */
1074 argtype
= TREE_TYPE (arg
);
1076 /* Don't bother with invalid arguments since they likely would
1077 have already been diagnosed, and disable any further checking
1078 of the format string by returning [-1, -1]. */
1079 return fmtresult ();
1083 /* The result is bounded unless width or precision has been specified
1084 whose value is unknown. */
1085 res
.bounded
= width
!= HOST_WIDE_INT_MIN
&& prec
!= HOST_WIDE_INT_MIN
;
1087 /* Using either the range the non-constant argument is in, or its
1088 type (either "formal" or actual), create a range of values that
1089 constrain the length of output given the warning level. */
1090 tree argmin
= NULL_TREE
;
1091 tree argmax
= NULL_TREE
;
1094 && TREE_CODE (arg
) == SSA_NAME
1095 && TREE_CODE (argtype
) == INTEGER_TYPE
)
1097 /* Try to determine the range of values of the integer argument
1098 (range information is not available for pointers). */
1100 enum value_range_type range_type
= get_range_info (arg
, &min
, &max
);
1101 if (range_type
== VR_RANGE
)
1103 argmin
= build_int_cst (argtype
, wi::fits_uhwi_p (min
)
1104 ? min
.to_uhwi () : min
.to_shwi ());
1105 argmax
= build_int_cst (argtype
, wi::fits_uhwi_p (max
)
1106 ? max
.to_uhwi () : max
.to_shwi ());
1108 /* Set KNOWNRANGE if the argument is in a known subrange
1109 of the directive's type (KNOWNRANGE may be reset below). */
1111 = (!tree_int_cst_equal (TYPE_MIN_VALUE (dirtype
), argmin
)
1112 || !tree_int_cst_equal (TYPE_MAX_VALUE (dirtype
), argmax
));
1114 res
.argmin
= argmin
;
1115 res
.argmax
= argmax
;
1117 else if (range_type
== VR_ANTI_RANGE
)
1119 /* Handle anti-ranges if/when bug 71690 is resolved. */
1121 else if (range_type
== VR_VARYING
)
1123 /* The argument here may be the result of promoting the actual
1124 argument to int. Try to determine the type of the actual
1125 argument before promotion and narrow down its range that
1127 gimple
*def
= SSA_NAME_DEF_STMT (arg
);
1128 if (is_gimple_assign (def
))
1130 tree_code code
= gimple_assign_rhs_code (def
);
1131 if (code
== INTEGER_CST
)
1133 arg
= gimple_assign_rhs1 (def
);
1134 return format_integer (spec
, arg
);
1137 if (code
== NOP_EXPR
)
1139 tree type
= TREE_TYPE (gimple_assign_rhs1 (def
));
1140 if (TREE_CODE (type
) == INTEGER_TYPE
1141 || TREE_CODE (type
) == POINTER_TYPE
)
1150 /* For an unknown argument (e.g., one passed to a vararg function)
1151 or one whose value range cannot be determined, create a T_MIN
1152 constant if the argument's type is signed and T_MAX otherwise,
1153 and use those to compute the range of bytes that the directive
1154 can output. When precision is specified but unknown, use zero
1155 as the minimum since it results in no bytes on output (unless
1156 width is specified to be greater than 0). */
1157 argmin
= build_int_cst (argtype
, prec
&& prec
!= HOST_WIDE_INT_MIN
);
1159 int typeprec
= TYPE_PRECISION (dirtype
);
1160 int argprec
= TYPE_PRECISION (argtype
);
1162 if (argprec
< typeprec
)
1164 if (POINTER_TYPE_P (argtype
))
1165 argmax
= build_all_ones_cst (argtype
);
1166 else if (TYPE_UNSIGNED (argtype
))
1167 argmax
= TYPE_MAX_VALUE (argtype
);
1169 argmax
= TYPE_MIN_VALUE (argtype
);
1173 if (POINTER_TYPE_P (dirtype
))
1174 argmax
= build_all_ones_cst (dirtype
);
1175 else if (TYPE_UNSIGNED (dirtype
))
1176 argmax
= TYPE_MAX_VALUE (dirtype
);
1178 argmax
= TYPE_MIN_VALUE (dirtype
);
1181 res
.argmin
= argmin
;
1182 res
.argmax
= argmax
;
1185 if (tree_int_cst_lt (argmax
, argmin
))
1192 /* Clear KNOWNRANGE if the range has been adjusted to the maximum
1193 of the directive. If it has been cleared then since ARGMIN and/or
1194 ARGMAX have been adjusted also adjust the corresponding ARGMIN and
1195 ARGMAX in the result to include in diagnostics. */
1196 if (adjust_range_for_overflow (dirtype
, &argmin
, &argmax
))
1198 res
.knownrange
= false;
1199 res
.argmin
= argmin
;
1200 res
.argmax
= argmax
;
1203 /* Recursively compute the minimum and maximum from the known range,
1204 taking care to swap them if the lower bound results in longer
1205 output than the upper bound (e.g., in the range [-1, 0]. */
1207 if (TYPE_UNSIGNED (dirtype
))
1209 /* For unsigned conversions/directives, use the minimum (i.e., 0
1210 or 1) and maximum to compute the shortest and longest output,
1212 res
.range
.min
= format_integer (spec
, argmin
).range
.min
;
1213 res
.range
.max
= format_integer (spec
, argmax
).range
.max
;
1217 /* For signed conversions/directives, use the maximum (i.e., 0)
1218 to compute the shortest output and the minimum (i.e., TYPE_MIN)
1219 to compute the longest output. This is important when precision
1220 is specified but unknown because otherwise both output lengths
1221 would reflect the largest possible precision (i.e., INT_MAX). */
1222 res
.range
.min
= format_integer (spec
, argmax
).range
.min
;
1223 res
.range
.max
= format_integer (spec
, argmin
).range
.max
;
1226 /* The result is bounded either when the argument is determined to be
1227 (e.g., when it's within some range) or when the minimum and maximum
1228 are the same. That can happen here for example when the specified
1229 width is as wide as the greater of MIN and MAX, as would be the case
1230 with sprintf (d, "%08x", x) with a 32-bit integer x. */
1231 res
.bounded
|= res
.range
.min
== res
.range
.max
;
1233 if (res
.range
.max
< res
.range
.min
)
1235 unsigned HOST_WIDE_INT tmp
= res
.range
.max
;
1236 res
.range
.max
= res
.range
.min
;
1237 res
.range
.min
= tmp
;
1243 /* Return the number of bytes that a format directive consisting of FLAGS,
1244 PRECision, format SPECification, and MPFR rounding specifier RNDSPEC,
1245 would result for argument X under ideal conditions (i.e., if PREC
1246 weren't excessive). MPFR 3.1 allocates large amounts of memory for
1247 values of PREC with large magnitude and can fail (see MPFR bug #21056).
1248 This function works around those problems. */
1250 static unsigned HOST_WIDE_INT
1251 get_mpfr_format_length (mpfr_ptr x
, const char *flags
, HOST_WIDE_INT prec
,
1252 char spec
, char rndspec
)
1256 HOST_WIDE_INT len
= strlen (flags
);
1259 memcpy (fmtstr
+ 1, flags
, len
);
1260 memcpy (fmtstr
+ 1 + len
, ".*R", 3);
1261 fmtstr
[len
+ 4] = rndspec
;
1262 fmtstr
[len
+ 5] = spec
;
1263 fmtstr
[len
+ 6] = '\0';
1265 spec
= TOUPPER (spec
);
1266 if (spec
== 'E' || spec
== 'F')
1268 /* For %e, specify the precision explicitly since mpfr_sprintf
1269 does its own thing just to be different (see MPFR bug 21088). */
1275 /* Avoid passing negative precisions with larger magnitude to MPFR
1276 to avoid exposing its bugs. (A negative precision is supposed
1282 HOST_WIDE_INT p
= prec
;
1286 /* For G/g, precision gives the maximum number of significant
1287 digits which is bounded by LDBL_MAX_10_EXP, or, for a 128
1288 bit IEEE extended precision, 4932. Using twice as much
1289 here should be more than sufficient for any real format. */
1290 if ((IEEE_MAX_10_EXP
* 2) < prec
)
1291 prec
= IEEE_MAX_10_EXP
* 2;
1296 /* Cap precision arbitrarily at 1KB and add the difference
1297 (if any) to the MPFR result. */
1302 len
= mpfr_snprintf (NULL
, 0, fmtstr
, (int)p
, x
);
1304 /* Handle the unlikely (impossible?) error by returning more than
1305 the maximum dictated by the function's return type. */
1307 return target_dir_max () + 1;
1309 /* Adjust the return value by the difference. */
1316 /* Return the number of bytes to format using the format specifier
1317 SPEC and the precision PREC the largest value in the real floating
1320 static unsigned HOST_WIDE_INT
1321 format_floating_max (tree type
, char spec
, HOST_WIDE_INT prec
)
1323 machine_mode mode
= TYPE_MODE (type
);
1325 /* IBM Extended mode. */
1326 if (MODE_COMPOSITE_P (mode
))
1329 /* Get the real type format desription for the target. */
1330 const real_format
*rfmt
= REAL_MODE_FORMAT (mode
);
1335 get_max_float (rfmt
, buf
, sizeof buf
);
1336 real_from_string (&rv
, buf
);
1339 /* Convert the GCC real value representation with the precision
1340 of the real type to the mpfr_t format with the GCC default
1341 round-to-nearest mode. */
1343 mpfr_init2 (x
, rfmt
->p
);
1344 mpfr_from_real (x
, &rv
, GMP_RNDN
);
1346 /* Return a value one greater to account for the leading minus sign. */
1347 return 1 + get_mpfr_format_length (x
, "", prec
, spec
, 'D');
1350 /* Return a range representing the minimum and maximum number of bytes
1351 that the conversion specification SPEC will output for any argument
1352 given the WIDTH and PRECISION (extracted from SPEC). This function
1353 is used when the directive argument or its value isn't known. */
1356 format_floating (const conversion_spec
&spec
, HOST_WIDE_INT width
,
1361 switch (spec
.modifier
)
1365 type
= double_type_node
;
1369 type
= long_double_type_node
;
1373 type
= long_double_type_node
;
1377 return fmtresult ();
1380 /* The minimum and maximum number of bytes produced by the directive. */
1383 /* The result is always bounded (though the range may be all of int). */
1386 /* The minimum output as determined by flags. It's always at least 1. */
1387 int flagmin
= (1 /* for the first digit */
1388 + (spec
.get_flag ('+') | spec
.get_flag (' '))
1389 + (prec
== 0 && spec
.get_flag ('#')));
1391 if (width
== INT_MIN
|| prec
== INT_MIN
)
1393 /* When either width or precision is specified but unknown
1394 the upper bound is the maximum. Otherwise it will be
1395 computed for each directive below. */
1396 res
.range
.max
= HOST_WIDE_INT_MAX
;
1399 res
.range
.max
= HOST_WIDE_INT_M1U
;
1401 switch (spec
.specifier
)
1406 res
.range
.min
= flagmin
+ 5 + (prec
> 0 ? prec
+ 1 : 0);
1407 if (res
.range
.max
== HOST_WIDE_INT_M1U
)
1409 /* Compute the upper bound for -TYPE_MAX. */
1410 res
.range
.max
= format_floating_max (type
, 'a', prec
);
1419 /* The minimum output is "[-+]1.234567e+00" regardless
1420 of the value of the actual argument. */
1421 res
.range
.min
= (flagmin
1423 ? 0 : prec
< 0 ? 7 : prec
? prec
+ 1 : 0)
1426 if (res
.range
.max
== HOST_WIDE_INT_M1U
)
1428 /* MPFR uses a precision of 16 by default for some reason.
1429 Set it to the C default of 6. */
1430 res
.range
.max
= format_floating_max (type
, 'e',
1431 -1 == prec
? 6 : prec
);
1439 /* The lower bound when precision isn't specified is 8 bytes
1440 ("1.23456" since precision is taken to be 6). When precision
1441 is zero, the lower bound is 1 byte (e.g., "1"). Otherwise,
1442 when precision is greater than zero, then the lower bound
1443 is 2 plus precision (plus flags). */
1444 res
.range
.min
= (flagmin
1445 + (prec
!= INT_MIN
) /* for decimal point */
1447 ? 0 : prec
< 0 ? 6 : prec
? prec
: -1));
1449 if (res
.range
.max
== HOST_WIDE_INT_M1U
)
1451 /* Compute the upper bound for -TYPE_MAX. */
1452 res
.range
.max
= format_floating_max (type
, 'f', prec
);
1460 /* The %g output depends on precision and the exponent of
1461 the argument. Since the value of the argument isn't known
1462 the lower bound on the range of bytes (not counting flags
1464 res
.range
.min
= flagmin
;
1465 if (res
.range
.max
== HOST_WIDE_INT_M1U
)
1467 /* Compute the upper bound for -TYPE_MAX which should be
1468 the lesser of %e and %f. */
1469 res
.range
.max
= format_floating_max (type
, 'g', prec
);
1475 return fmtresult ();
1480 /* If width has been specified use it to adjust the range. */
1481 if (res
.range
.min
< (unsigned)width
)
1482 res
.range
.min
= width
;
1483 if (res
.range
.max
< (unsigned)width
)
1484 res
.range
.max
= width
;
1490 /* Return a range representing the minimum and maximum number of bytes
1491 that the conversion specification SPEC will write on output for the
1492 floating argument ARG. */
1495 format_floating (const conversion_spec
&spec
, tree arg
)
1497 /* Set WIDTH to -1 when it's not specified, to HOST_WIDE_INT_MIN when
1498 it is specified by the asterisk to an unknown value, and otherwise
1499 to a non-negative value corresponding to the specified width. */
1500 HOST_WIDE_INT width
= -1;
1501 HOST_WIDE_INT prec
= -1;
1503 /* The minimum and maximum number of bytes produced by the directive. */
1505 res
.constant
= arg
&& TREE_CODE (arg
) == REAL_CST
;
1507 if (spec
.have_width
)
1509 else if (spec
.star_width
)
1511 if (TREE_CODE (spec
.star_width
) == INTEGER_CST
)
1513 width
= tree_to_shwi (spec
.star_width
);
1521 if (spec
.have_precision
)
1522 prec
= spec
.precision
;
1523 else if (spec
.star_precision
)
1525 if (TREE_CODE (spec
.star_precision
) == INTEGER_CST
)
1527 prec
= tree_to_shwi (spec
.star_precision
);
1534 else if (res
.constant
&& TOUPPER (spec
.specifier
) != 'A')
1536 /* Specify the precision explicitly since mpfr_sprintf defaults
1543 /* Get the real type format desription for the target. */
1544 const REAL_VALUE_TYPE
*rvp
= TREE_REAL_CST_PTR (arg
);
1545 const real_format
*rfmt
= REAL_MODE_FORMAT (TYPE_MODE (TREE_TYPE (arg
)));
1547 /* Convert the GCC real value representation with the precision
1548 of the real type to the mpfr_t format with the GCC default
1549 round-to-nearest mode. */
1551 mpfr_init2 (mpfrval
, rfmt
->p
);
1552 mpfr_from_real (mpfrval
, rvp
, GMP_RNDN
);
1555 char *pfmt
= fmtstr
;
1558 for (const char *pf
= "-+ #0"; *pf
; ++pf
)
1559 if (spec
.get_flag (*pf
))
1565 /* Set up an array to easily iterate over below. */
1566 unsigned HOST_WIDE_INT
* const minmax
[] = {
1567 &res
.range
.min
, &res
.range
.max
1570 for (int i
= 0; i
!= sizeof minmax
/ sizeof *minmax
; ++i
)
1572 /* Use the MPFR rounding specifier to round down in the first
1573 iteration and then up. In most but not all cases this will
1574 result in the same number of bytes. */
1575 char rndspec
= "DU"[i
];
1577 /* Format it and store the result in the corresponding member
1578 of the result struct. */
1579 unsigned HOST_WIDE_INT len
1580 = get_mpfr_format_length (mpfrval
, fmtstr
, prec
,
1581 spec
.specifier
, rndspec
);
1582 if (0 < width
&& len
< (unsigned)width
)
1589 /* Make sure the minimum is less than the maximum (MPFR rounding
1590 in the call to mpfr_snprintf can result in the reverse. */
1591 if (res
.range
.max
< res
.range
.min
)
1593 unsigned HOST_WIDE_INT tmp
= res
.range
.min
;
1594 res
.range
.min
= res
.range
.max
;
1595 res
.range
.max
= tmp
;
1598 /* The range of output is known even if the result isn't bounded. */
1599 if (width
== HOST_WIDE_INT_MIN
)
1601 res
.knownrange
= false;
1602 res
.range
.max
= HOST_WIDE_INT_MAX
;
1605 res
.knownrange
= true;
1607 /* The output of all directives except "%a" is fully specified
1608 and so the result is bounded unless it exceeds INT_MAX.
1609 For "%a" the output is fully specified only when precision
1610 is explicitly specified. */
1611 res
.bounded
= (res
.knownrange
1612 && (TOUPPER (spec
.specifier
) != 'A'
1613 || (0 <= prec
&& (unsigned) prec
< target_int_max ()))
1614 && res
.range
.min
< target_int_max ());
1619 return format_floating (spec
, width
, prec
);
1622 /* Return a FMTRESULT struct set to the lengths of the shortest and longest
1623 strings referenced by the expression STR, or (-1, -1) when not known.
1624 Used by the format_string function below. */
1627 get_string_length (tree str
)
1630 return fmtresult ();
1632 if (tree slen
= c_strlen (str
, 1))
1634 /* Simply return the length of the string. */
1636 res
.range
.min
= res
.range
.max
= tree_to_shwi (slen
);
1638 res
.constant
= true;
1639 res
.knownrange
= true;
1643 /* Determine the length of the shortest and longest string referenced
1644 by STR. Strings of unknown lengths are bounded by the sizes of
1645 arrays that subexpressions of STR may refer to. Pointers that
1646 aren't known to point any such arrays result in LENRANGE[1] set
1649 get_range_strlen (str
, lenrange
);
1651 if (lenrange
[0] || lenrange
[1])
1655 res
.range
.min
= (tree_fits_uhwi_p (lenrange
[0])
1656 ? tree_to_uhwi (lenrange
[0]) : 1 < warn_format_length
);
1657 res
.range
.max
= (tree_fits_uhwi_p (lenrange
[1])
1658 ? tree_to_uhwi (lenrange
[1]) : HOST_WIDE_INT_M1U
);
1660 /* Set RES.BOUNDED to true if and only if all strings referenced
1661 by STR are known to be bounded (though not necessarily by their
1662 actual length but perhaps by their maximum possible length). */
1663 res
.bounded
= res
.range
.max
< target_int_max ();
1664 res
.knownrange
= res
.bounded
;
1666 /* Set RES.CONSTANT to false even though that may be overly
1667 conservative in rare cases like: 'x ? a : b' where a and
1668 b have the same lengths and consist of the same characters. */
1669 res
.constant
= false;
1674 return get_string_length (NULL_TREE
);
1677 /* Return the minimum and maximum number of characters formatted
1678 by the '%c' and '%s' format directives and ther wide character
1679 forms for the argument ARG. ARG can be null (for functions
1680 such as vsprinf). */
1683 format_string (const conversion_spec
&spec
, tree arg
)
1685 /* Set WIDTH and PRECISION based on the specification. */
1686 HOST_WIDE_INT width
;
1688 get_width_and_precision (spec
, &width
, &prec
);
1692 /* The maximum number of bytes for an unknown wide character argument
1693 to a "%lc" directive adjusted for precision but not field width.
1694 6 is the longest UTF-8 sequence for a single wide character. */
1695 const unsigned HOST_WIDE_INT max_bytes_for_unknown_wc
1696 = (0 <= prec
? prec
: 1 < warn_format_length
? 6 : 1);
1698 /* The maximum number of bytes for an unknown string argument to either
1699 a "%s" or "%ls" directive adjusted for precision but not field width. */
1700 const unsigned HOST_WIDE_INT max_bytes_for_unknown_str
1701 = (0 <= prec
? prec
: 1 < warn_format_length
);
1703 /* The result is bounded unless overriddden for a non-constant string
1704 of an unknown length. */
1705 bool bounded
= true;
1707 if (spec
.specifier
== 'c')
1709 if (spec
.modifier
== FMT_LEN_l
)
1711 /* Positive if the argument is a wide NUL character? */
1712 int nul
= (arg
&& TREE_CODE (arg
) == INTEGER_CST
1713 ? integer_zerop (arg
) : -1);
1715 /* A '%lc' directive is the same as '%ls' for a two element
1716 wide string character with the second element of NUL, so
1717 when the character is unknown the minimum number of bytes
1718 is the smaller of either 0 (at level 1) or 1 (at level 2)
1719 and WIDTH, and the maximum is MB_CUR_MAX in the selected
1720 locale, which is unfortunately, unknown. */
1721 res
.range
.min
= 1 == warn_format_length
? !nul
: nul
< 1;
1722 res
.range
.max
= max_bytes_for_unknown_wc
;
1723 /* The range above is good enough to issue warnings but not
1724 for value range propagation, so clear BOUNDED. */
1725 res
.bounded
= false;
1729 /* A plain '%c' directive. Its ouput is exactly 1. */
1730 res
.range
.min
= res
.range
.max
= 1;
1732 res
.knownrange
= true;
1733 res
.constant
= arg
&& TREE_CODE (arg
) == INTEGER_CST
;
1736 else /* spec.specifier == 's' */
1738 /* Compute the range the argument's length can be in. */
1739 fmtresult slen
= get_string_length (arg
);
1742 gcc_checking_assert (slen
.range
.min
== slen
.range
.max
);
1744 /* A '%s' directive with a string argument with constant length. */
1745 res
.range
= slen
.range
;
1747 /* The output of "%s" and "%ls" directives with a constant
1748 string is in a known range unless width of an unknown value
1749 is specified. For "%s" it is the length of the string. For
1750 "%ls" it is in the range [length, length * MB_LEN_MAX].
1751 (The final range can be further constrained by width and
1752 precision but it's always known.) */
1753 res
.knownrange
= -1 < width
;
1755 if (spec
.modifier
== FMT_LEN_l
)
1759 if (warn_format_length
> 1)
1761 /* Leave the minimum number of bytes the wide string
1762 converts to equal to its length and set the maximum
1763 to the worst case length which is the string length
1764 multiplied by MB_LEN_MAX. */
1766 /* It's possible to be smarter about computing the maximum
1767 by scanning the wide string for any 8-bit characters and
1768 if it contains none, using its length for the maximum.
1769 Even though this would be simple to do it's unlikely to
1770 be worth it when dealing with wide characters. */
1771 res
.range
.max
*= target_mb_len_max
;
1774 /* For a wide character string, use precision as the maximum
1775 even if precision is greater than the string length since
1776 the number of bytes the string converts to may be greater
1777 (due to MB_CUR_MAX). */
1779 res
.range
.max
= prec
;
1781 else if (0 <= width
)
1783 /* The output of a "%s" directive with a constant argument
1784 and constant or no width is bounded. It is constant if
1785 precision is either not specified or it is specified and
1786 its value is known. */
1788 res
.constant
= prec
!= HOST_WIDE_INT_MIN
;
1790 else if (width
== HOST_WIDE_INT_MIN
)
1792 /* Specified but unknown width makes the output unbounded. */
1793 res
.range
.max
= HOST_WIDE_INT_MAX
;
1796 if (0 <= prec
&& (unsigned HOST_WIDE_INT
)prec
< res
.range
.min
)
1798 res
.range
.min
= prec
;
1799 res
.range
.max
= prec
;
1801 else if (prec
== HOST_WIDE_INT_MIN
)
1803 /* When precision is specified but not known the lower
1804 bound is assumed to be as low as zero. */
1808 else if (arg
&& integer_zerop (arg
))
1810 /* Handle null pointer argument. */
1814 res
.range
.max
= HOST_WIDE_INT_MAX
;
1820 /* For a '%s' and '%ls' directive with a non-constant string,
1821 the minimum number of characters is the greater of WIDTH
1822 and either 0 in mode 1 or the smaller of PRECISION and 1
1823 in mode 2, and the maximum is PRECISION or -1 to disable
1828 if (slen
.range
.min
>= target_int_max ())
1830 else if ((unsigned HOST_WIDE_INT
)prec
< slen
.range
.min
)
1831 slen
.range
.min
= prec
;
1833 if ((unsigned HOST_WIDE_INT
)prec
< slen
.range
.max
1834 || slen
.range
.max
>= target_int_max ())
1835 slen
.range
.max
= prec
;
1837 else if (slen
.range
.min
>= target_int_max ())
1839 slen
.range
.min
= max_bytes_for_unknown_str
;
1840 slen
.range
.max
= max_bytes_for_unknown_str
;
1844 res
.range
= slen
.range
;
1846 /* The output is considered bounded when a precision has been
1847 specified to limit the number of bytes or when the number
1848 of bytes is known or contrained to some range. */
1849 res
.bounded
= 0 <= prec
|| slen
.bounded
;
1850 res
.knownrange
= slen
.knownrange
;
1851 res
.constant
= false;
1855 /* Adjust the lengths for field width. */
1858 if (res
.range
.min
< (unsigned HOST_WIDE_INT
)width
)
1859 res
.range
.min
= width
;
1861 if (res
.range
.max
< (unsigned HOST_WIDE_INT
)width
)
1862 res
.range
.max
= width
;
1864 /* Adjust BOUNDED if width happens to make them equal. */
1865 if (res
.range
.min
== res
.range
.max
&& res
.range
.min
< target_int_max ()
1870 /* When precision is specified the range of characters on output
1871 is known to be bounded by it. */
1872 if (-1 < width
&& -1 < prec
)
1873 res
.knownrange
= true;
1878 /* Compute the length of the output resulting from the conversion
1879 specification SPEC with the argument ARG in a call described by INFO
1880 and update the overall result of the call in *RES. The format directive
1881 corresponding to SPEC starts at CVTBEG and is CVTLEN characters long. */
1884 format_directive (const pass_sprintf_length::call_info
&info
,
1885 format_result
*res
, const char *cvtbeg
, size_t cvtlen
,
1886 const conversion_spec
&spec
, tree arg
)
1888 /* Offset of the beginning of the directive from the beginning
1889 of the format string. */
1890 size_t offset
= cvtbeg
- info
.fmtstr
;
1892 /* Create a location for the whole directive from the % to the format
1894 substring_loc
dirloc (info
.fmtloc
, TREE_TYPE (info
.format
),
1895 offset
, offset
, offset
+ cvtlen
- 1);
1897 /* Also create a location range for the argument if possible.
1898 This doesn't work for integer literals or function calls. */
1899 source_range argrange
;
1900 source_range
*pargrange
;
1901 if (arg
&& CAN_HAVE_LOCATION_P (arg
))
1903 argrange
= EXPR_LOCATION_RANGE (arg
);
1904 pargrange
= &argrange
;
1909 /* Bail when there is no function to compute the output length,
1910 or when minimum length checking has been disabled. */
1911 if (!spec
.fmtfunc
|| res
->number_chars_min
>= HOST_WIDE_INT_MAX
)
1914 /* Compute the (approximate) length of the formatted output. */
1915 fmtresult fmtres
= spec
.fmtfunc (spec
, arg
);
1917 /* The overall result is bounded and constant only if the output
1918 of every directive is bounded and constant, respectively. */
1919 res
->bounded
&= fmtres
.bounded
;
1920 res
->constant
&= fmtres
.constant
;
1922 /* Record whether the output of all directives is known to be
1923 bounded by some maximum, implying that their arguments are
1924 either known exactly or determined to be in a known range
1925 or, for strings, limited by the upper bounds of the arrays
1927 res
->knownrange
&= fmtres
.knownrange
;
1929 if (!fmtres
.knownrange
)
1931 /* Only when the range is known, check it against the host value
1932 of INT_MAX + (the number of bytes of the "%.*Lf" directive with
1933 INT_MAX precision, which is the longest possible output of any
1934 single directive). That's the largest valid byte count (though
1935 not valid call to a printf-like function because it can never
1936 return such a count). Otherwise, the range doesn't correspond
1937 to known values of the argument. */
1938 if (fmtres
.range
.max
> target_dir_max ())
1940 /* Normalize the MAX counter to avoid having to deal with it
1941 later. The counter can be less than HOST_WIDE_INT_M1U
1942 when compiling for an ILP32 target on an LP64 host. */
1943 fmtres
.range
.max
= HOST_WIDE_INT_M1U
;
1944 /* Disable exact and maximum length checking after a failure
1945 to determine the maximum number of characters (for example
1946 for wide characters or wide character strings) but continue
1947 tracking the minimum number of characters. */
1948 res
->number_chars_max
= HOST_WIDE_INT_M1U
;
1949 res
->number_chars
= HOST_WIDE_INT_M1U
;
1952 if (fmtres
.range
.min
> target_dir_max ())
1954 /* Disable exact length checking after a failure to determine
1955 even the minimum number of characters (it shouldn't happen
1956 except in an error) but keep tracking the minimum and maximum
1957 number of characters. */
1958 res
->number_chars
= HOST_WIDE_INT_M1U
;
1965 fmtwarn (dirloc
, pargrange
, NULL
, info
.warnopt (),
1966 "%<%.*s%> directive argument is null",
1967 (int)cvtlen
, cvtbeg
);
1969 /* Don't bother processing the rest of the format string. */
1971 res
->number_chars
= HOST_WIDE_INT_M1U
;
1972 res
->number_chars_min
= res
->number_chars_max
= res
->number_chars
;
1976 bool warned
= res
->warned
;
1978 /* Compute the number of available bytes in the destination. There
1979 must always be at least one byte of space for the terminating
1980 NUL that's appended after the format string has been processed. */
1981 unsigned HOST_WIDE_INT navail
= min_bytes_remaining (info
.objsize
, *res
);
1983 if (fmtres
.range
.min
< fmtres
.range
.max
)
1985 /* The result is a range (i.e., it's inexact). */
1988 if (navail
< fmtres
.range
.min
)
1990 /* The minimum directive output is longer than there is
1991 room in the destination. */
1992 if (fmtres
.range
.min
== fmtres
.range
.max
)
1996 ? G_("%<%.*s%> directive output truncated writing "
1997 "%wu bytes into a region of size %wu")
1998 : G_("%<%.*s%> directive writing %wu bytes "
1999 "into a region of size %wu"));
2000 warned
= fmtwarn (dirloc
, pargrange
, NULL
, info
.warnopt (),
2002 (int)cvtlen
, cvtbeg
, fmtres
.range
.min
,
2005 else if (fmtres
.range
.max
< HOST_WIDE_INT_MAX
)
2009 ? G_("%<%.*s%> directive output truncated writing "
2010 "between %wu and %wu bytes into a region of "
2012 : G_("%<%.*s%> directive writing between %wu and "
2013 "%wu bytes into a region of size %wu"));
2014 warned
= fmtwarn (dirloc
, pargrange
, NULL
,
2015 info
.warnopt (), fmtstr
,
2016 (int)cvtlen
, cvtbeg
,
2017 fmtres
.range
.min
, fmtres
.range
.max
, navail
);
2023 ? G_("%<%.*s%> directive output truncated writing "
2024 "%wu or more bytes into a region of size %wu")
2025 : G_("%<%.*s%> directive writing %wu or more bytes "
2026 "into a region of size %wu"));
2027 warned
= fmtwarn (dirloc
, pargrange
, NULL
,
2028 info
.warnopt (), fmtstr
,
2029 (int)cvtlen
, cvtbeg
,
2030 fmtres
.range
.min
, navail
);
2033 else if (navail
< fmtres
.range
.max
2034 && (spec
.specifier
!= 's'
2035 || fmtres
.range
.max
< HOST_WIDE_INT_MAX
)
2037 && (!info
.retval_used ()
2038 || warn_format_trunc
> 1))
2040 && (spec
.specifier
== 's'
2041 || 1 < warn_format_length
))))
2043 /* The maximum directive output is longer than there is
2044 room in the destination and the output length is either
2045 explicitly constrained by the precision (for strings)
2046 or the warning level is greater than 1. */
2047 if (fmtres
.range
.max
>= HOST_WIDE_INT_MAX
)
2051 ? G_("%<%.*s%> directive output may be truncated "
2052 "writing %wu or more bytes a region of size %wu")
2053 : G_("%<%.*s%> directive writing %wu or more bytes "
2054 "into a region of size %wu"));
2055 warned
= fmtwarn (dirloc
, pargrange
, NULL
,
2056 info
.warnopt (), fmtstr
,
2057 (int)cvtlen
, cvtbeg
,
2058 fmtres
.range
.min
, navail
);
2064 ? G_("%<%.*s%> directive output may be truncated "
2065 "writing between %wu and %wu bytes into a region "
2067 : G_("%<%.*s%> directive writing between %wu and %wu "
2068 "bytes into a region of size %wu"));
2069 warned
= fmtwarn (dirloc
, pargrange
, NULL
,
2070 info
.warnopt (), fmtstr
,
2071 (int)cvtlen
, cvtbeg
,
2072 fmtres
.range
.min
, fmtres
.range
.max
,
2078 /* Disable exact length checking but adjust the minimum and maximum. */
2079 res
->number_chars
= HOST_WIDE_INT_M1U
;
2080 if (res
->number_chars_max
< HOST_WIDE_INT_MAX
2081 && fmtres
.range
.max
< HOST_WIDE_INT_MAX
)
2082 res
->number_chars_max
+= fmtres
.range
.max
;
2084 res
->number_chars_min
+= fmtres
.range
.min
;
2088 if (!warned
&& fmtres
.range
.min
> 0 && navail
< fmtres
.range
.min
)
2092 ? (1 < fmtres
.range
.min
2093 ? G_("%<%.*s%> directive output truncated while writing "
2094 "%wu bytes into a region of size %wu")
2095 : G_("%<%.*s%> directive output truncated while writing "
2096 "%wu byte into a region of size %wu"))
2097 : (1 < fmtres
.range
.min
2098 ? G_("%<%.*s%> directive writing %wu bytes "
2099 "into a region of size %wu")
2100 : G_("%<%.*s%> directive writing %wu byte "
2101 "into a region of size %wu")));
2103 warned
= fmtwarn (dirloc
, pargrange
, NULL
,
2104 info
.warnopt (), fmtstr
,
2105 (int)cvtlen
, cvtbeg
, fmtres
.range
.min
,
2108 *res
+= fmtres
.range
.min
;
2111 /* Has the minimum directive output length exceeded the maximum
2112 of 4095 bytes required to be supported? */
2113 bool minunder4k
= fmtres
.range
.min
< 4096;
2114 if (!minunder4k
|| fmtres
.range
.max
> 4095)
2115 res
->under4k
= false;
2117 if (!warned
&& 1 < warn_format_length
2118 && (!minunder4k
|| fmtres
.range
.max
> 4095))
2120 /* The directive output may be longer than the maximum required
2121 to be handled by an implementation according to 7.21.6.1, p15
2122 of C11. Warn on this only at level 2 but remember this and
2123 prevent folding the return value when done. This allows for
2124 the possibility of the actual libc call failing due to ENOMEM
2125 (like Glibc does under some conditions). */
2127 if (fmtres
.range
.min
== fmtres
.range
.max
)
2128 warned
= fmtwarn (dirloc
, pargrange
, NULL
,
2130 "%<%.*s%> directive output of %wu bytes exceeds "
2131 "minimum required size of 4095",
2132 (int)cvtlen
, cvtbeg
, fmtres
.range
.min
);
2137 ? G_("%<%.*s%> directive output between %qu and %wu "
2138 "bytes may exceed minimum required size of 4095")
2139 : G_("%<%.*s%> directive output between %qu and %wu "
2140 "bytes exceeds minimum required size of 4095"));
2142 warned
= fmtwarn (dirloc
, pargrange
, NULL
,
2143 info
.warnopt (), fmtstr
,
2144 (int)cvtlen
, cvtbeg
,
2145 fmtres
.range
.min
, fmtres
.range
.max
);
2149 /* Has the minimum directive output length exceeded INT_MAX? */
2150 bool exceedmin
= res
->number_chars_min
> target_int_max ();
2154 || (1 < warn_format_length
2155 && res
->number_chars_max
> target_int_max ())))
2157 /* The directive output causes the total length of output
2158 to exceed INT_MAX bytes. */
2160 if (fmtres
.range
.min
== fmtres
.range
.max
)
2161 warned
= fmtwarn (dirloc
, pargrange
, NULL
, info
.warnopt (),
2162 "%<%.*s%> directive output of %wu bytes causes "
2163 "result to exceed %<INT_MAX%>",
2164 (int)cvtlen
, cvtbeg
, fmtres
.range
.min
);
2169 ? G_ ("%<%.*s%> directive output between %wu and %wu "
2170 "bytes causes result to exceed %<INT_MAX%>")
2171 : G_ ("%<%.*s%> directive output between %wu and %wu "
2172 "bytes may cause result to exceed %<INT_MAX%>"));
2173 warned
= fmtwarn (dirloc
, pargrange
, NULL
,
2174 info
.warnopt (), fmtstr
,
2175 (int)cvtlen
, cvtbeg
,
2176 fmtres
.range
.min
, fmtres
.range
.max
);
2180 if (warned
&& fmtres
.argmin
)
2182 if (fmtres
.argmin
== fmtres
.argmax
)
2183 inform (info
.fmtloc
, "directive argument %qE", fmtres
.argmin
);
2184 else if (fmtres
.knownrange
)
2185 inform (info
.fmtloc
, "directive argument in the range [%E, %E]",
2186 fmtres
.argmin
, fmtres
.argmax
);
2188 inform (info
.fmtloc
,
2189 "using the range [%E, %E] for directive argument",
2190 fmtres
.argmin
, fmtres
.argmax
);
2193 res
->warned
|= warned
;
2196 /* Account for the number of bytes between BEG and END (or between
2197 BEG + strlen (BEG) when END is null) in the format string in a call
2198 to a formatted output function described by INFO. Reflect the count
2199 in RES and issue warnings as appropriate. */
2202 add_bytes (const pass_sprintf_length::call_info
&info
,
2203 const char *beg
, const char *end
, format_result
*res
)
2205 if (res
->number_chars_min
>= HOST_WIDE_INT_MAX
)
2208 /* The number of bytes to output is the number of bytes between
2209 the end of the last directive and the beginning of the next
2210 one if it exists, otherwise the number of characters remaining
2211 in the format string plus 1 for the terminating NUL. */
2212 size_t nbytes
= end
? end
- beg
: strlen (beg
) + 1;
2214 /* Return if there are no bytes to add at this time but there are
2215 directives remaining in the format string. */
2219 /* Compute the range of available bytes in the destination. There
2220 must always be at least one byte left for the terminating NUL
2221 that's appended after the format string has been processed. */
2222 result_range avail_range
= bytes_remaining (info
.objsize
, *res
);
2224 /* If issuing a diagnostic (only when one hasn't already been issued),
2225 distinguish between a possible overflow ("may write") and a certain
2226 overflow somewhere "past the end." (Ditto for truncation.)
2227 KNOWNRANGE is used to warn even at level 1 about possibly writing
2228 past the end or truncation due to strings of unknown lengths that
2229 are bounded by the arrays they are known to refer to. */
2231 && (avail_range
.max
< nbytes
2232 || ((res
->knownrange
|| 1 < warn_format_length
)
2233 && avail_range
.min
< nbytes
)))
2235 /* Set NAVAIL to the number of available bytes used to decide
2236 whether or not to issue a warning below. The exact kind of
2237 warning will depend on AVAIL_RANGE. */
2238 unsigned HOST_WIDE_INT navail
= avail_range
.max
;
2239 if (nbytes
<= navail
&& avail_range
.min
< HOST_WIDE_INT_MAX
2240 && (res
->knownrange
|| 1 < warn_format_length
))
2241 navail
= avail_range
.min
;
2243 /* Compute the offset of the first format character that is beyond
2244 the end of the destination region and the length of the rest of
2245 the format string from that point on. */
2246 unsigned HOST_WIDE_INT off
2247 = (unsigned HOST_WIDE_INT
)(beg
- info
.fmtstr
) + navail
;
2249 size_t len
= strlen (info
.fmtstr
+ off
);
2251 /* Create a location that underscores the substring of the format
2252 string that is or may be written past the end (or is or may be
2253 truncated), pointing the caret at the first character of the
2256 (info
.fmtloc
, TREE_TYPE (info
.format
), off
, len
? off
: 0,
2259 /* Is the output of the last directive the result of the argument
2260 being within a range whose lower bound would fit in the buffer
2261 but the upper bound would not? If so, use the word "may" to
2262 indicate that the overflow/truncation may (but need not) happen. */
2264 = (res
->number_chars_min
< res
->number_chars_max
2265 && res
->number_chars_min
+ nbytes
<= info
.objsize
);
2267 if (!end
&& ((nbytes
- navail
) == 1 || boundrange
))
2269 /* There is room for the rest of the format string but none
2270 for the terminating nul. */
2272 = (info
.bounded
// Snprintf and the like.
2274 ? G_("output may be truncated before the last format character"
2275 : "output truncated before the last format character"))
2277 ? G_("may write a terminating nul past the end "
2278 "of the destination")
2279 : G_("writing a terminating nul past the end "
2280 "of the destination")));
2284 || !info
.retval_used ()
2285 || warn_format_trunc
> 1)
2286 res
->warned
= fmtwarn (loc
, NULL
, NULL
, info
.warnopt (), text
);
2290 /* There isn't enough room for 1 or more characters that remain
2291 to copy from the format string. */
2293 = (info
.bounded
// Snprintf and the like.
2295 ? G_("output may be truncated at or before format character "
2296 "%qc at offset %wu")
2297 : G_("output truncated at format character %qc at offset %wu"))
2298 : (res
->number_chars
>= HOST_WIDE_INT_MAX
2299 ? G_("may write format character %#qc at offset %wu past "
2300 "the end of the destination")
2301 : G_("writing format character %#qc at offset %wu past "
2302 "the end of the destination")));
2306 || !info
.retval_used ()
2307 || warn_format_trunc
> 1)
2308 res
->warned
= fmtwarn (loc
, NULL
, NULL
, info
.warnopt (),
2309 text
, info
.fmtstr
[off
], off
);
2313 if (res
->warned
&& !end
&& info
.objsize
< HOST_WIDE_INT_MAX
)
2315 /* If a warning has been issued for buffer overflow or truncation
2316 (but not otherwise) help the user figure out how big a buffer
2319 location_t callloc
= gimple_location (info
.callstmt
);
2321 unsigned HOST_WIDE_INT min
= res
->number_chars_min
;
2322 unsigned HOST_WIDE_INT max
= res
->number_chars_max
;
2323 unsigned HOST_WIDE_INT exact
2324 = (res
->number_chars
< HOST_WIDE_INT_MAX
2325 ? res
->number_chars
: res
->number_chars_min
);
2327 if (min
< max
&& max
< HOST_WIDE_INT_MAX
)
2329 "format output between %wu and %wu bytes into "
2330 "a destination of size %wu",
2331 min
+ nbytes
, max
+ nbytes
, info
.objsize
);
2334 (nbytes
+ exact
== 1
2335 ? G_("format output %wu byte into a destination of size %wu")
2336 : G_("format output %wu bytes into a destination of size %wu")),
2337 nbytes
+ exact
, info
.objsize
);
2340 /* Add the number of bytes and then check for INT_MAX overflow. */
2343 /* Has the minimum output length minus the terminating nul exceeded
2345 bool exceedmin
= (res
->number_chars_min
- !end
) > target_int_max ();
2349 || (1 < warn_format_length
2350 && (res
->number_chars_max
- !end
) > target_int_max ())))
2352 /* The function's output exceeds INT_MAX bytes. */
2354 /* Set NAVAIL to the number of available bytes used to decide
2355 whether or not to issue a warning below. The exact kind of
2356 warning will depend on AVAIL_RANGE. */
2357 unsigned HOST_WIDE_INT navail
= avail_range
.max
;
2358 if (nbytes
<= navail
&& avail_range
.min
< HOST_WIDE_INT_MAX
2359 && (res
->bounded
|| 1 < warn_format_length
))
2360 navail
= avail_range
.min
;
2362 /* Compute the offset of the first format character that is beyond
2363 the end of the destination region and the length of the rest of
2364 the format string from that point on. */
2365 unsigned HOST_WIDE_INT off
= (unsigned HOST_WIDE_INT
)(beg
- info
.fmtstr
);
2366 if (navail
< HOST_WIDE_INT_MAX
)
2369 size_t len
= strlen (info
.fmtstr
+ off
);
2372 (info
.fmtloc
, TREE_TYPE (info
.format
), off
- !len
, len
? off
: 0,
2375 if (res
->number_chars_min
== res
->number_chars_max
)
2376 res
->warned
= fmtwarn (loc
, NULL
, NULL
, info
.warnopt (),
2377 "output of %wu bytes causes "
2378 "result to exceed %<INT_MAX%>",
2379 res
->number_chars_min
- !end
);
2384 ? G_ ("output between %wu and %wu bytes causes "
2385 "result to exceed %<INT_MAX%>")
2386 : G_ ("output between %wu and %wu bytes may cause "
2387 "result to exceed %<INT_MAX%>"));
2388 res
->warned
= fmtwarn (loc
, NULL
, NULL
, info
.warnopt (), text
,
2389 res
->number_chars_min
- !end
,
2390 res
->number_chars_max
- !end
);
2395 #pragma GCC diagnostic pop
2397 /* Compute the length of the output resulting from the call to a formatted
2398 output function described by INFO and store the result of the call in
2399 *RES. Issue warnings for detected past the end writes. Return true
2400 if the complete format string has been processed and *RES can be relied
2401 on, false otherwise (e.g., when a unknown or unhandled directive was seen
2402 that caused the processing to be terminated early). */
2405 pass_sprintf_length::compute_format_length (call_info
&info
,
2408 /* The variadic argument counter. */
2409 unsigned argno
= info
.argidx
;
2411 /* Reset exact, minimum, and maximum character counters. */
2412 res
->number_chars
= res
->number_chars_min
= res
->number_chars_max
= 0;
2414 /* No directive has been seen yet so the length of output is bounded
2415 by the known range [0, 0] and constant (with no conversion producing
2416 more than 4K bytes) until determined otherwise. */
2417 res
->bounded
= true;
2418 res
->knownrange
= true;
2419 res
->constant
= true;
2420 res
->under4k
= true;
2421 res
->floating
= false;
2422 res
->warned
= false;
2424 const char *pf
= info
.fmtstr
;
2428 /* The beginning of the next format directive. */
2429 const char *dir
= strchr (pf
, '%');
2431 /* Add the number of bytes between the end of the last directive
2432 and either the next if one exists, or the end of the format
2434 add_bytes (info
, pf
, dir
, res
);
2443 /* Incomplete directive. */
2447 conversion_spec spec
= conversion_spec ();
2449 /* POSIX numbered argument index or zero when none. */
2450 unsigned dollar
= 0;
2454 /* This could be either a POSIX positional argument, the '0'
2455 flag, or a width, depending on what follows. Store it as
2456 width and sort it out later after the next character has
2459 spec
.width
= strtol (pf
, &end
, 10);
2460 spec
.have_width
= true;
2463 else if ('*' == *pf
)
2465 /* Similarly to the block above, this could be either a POSIX
2466 positional argument or a width, depending on what follows. */
2467 if (argno
< gimple_call_num_args (info
.callstmt
))
2468 spec
.star_width
= gimple_call_arg (info
.callstmt
, argno
++);
2470 spec
.star_width
= void_node
;
2476 /* Handle the POSIX dollar sign which references the 1-based
2477 positional argument number. */
2478 if (spec
.have_width
)
2479 dollar
= spec
.width
+ info
.argidx
;
2480 else if (spec
.star_width
2481 && TREE_CODE (spec
.star_width
) == INTEGER_CST
)
2482 dollar
= spec
.width
+ tree_to_shwi (spec
.star_width
);
2484 /* Bail when the numbered argument is out of range (it will
2485 have already been diagnosed by -Wformat). */
2487 || dollar
== info
.argidx
2488 || dollar
> gimple_call_num_args (info
.callstmt
))
2493 spec
.star_width
= NULL_TREE
;
2494 spec
.have_width
= false;
2498 if (dollar
|| !spec
.star_width
)
2500 if (spec
.have_width
)
2502 if (spec
.width
== 0)
2504 /* The '0' that has been interpreted as a width above is
2505 actually a flag. Reset HAVE_WIDTH, set the '0' flag,
2506 and continue processing other flags. */
2507 spec
.have_width
= false;
2508 spec
.set_flag ('0');
2512 /* (Non-zero) width has been seen. The next character
2513 is either a period or a digit. */
2514 goto start_precision
;
2517 /* When either '$' has been seen, or width has not been seen,
2518 the next field is the optional flags followed by an optional
2528 spec
.set_flag (*pf
++);
2540 spec
.width
= strtol (pf
, &end
, 10);
2541 spec
.have_width
= true;
2544 else if ('*' == *pf
)
2546 if (argno
< gimple_call_num_args (info
.callstmt
))
2547 spec
.star_width
= gimple_call_arg (info
.callstmt
, argno
++);
2549 spec
.star_width
= void_node
;
2552 else if ('\'' == *pf
)
2554 /* The POSIX apostrophe indicating a numeric grouping
2555 in the current locale. Even though it's possible to
2556 estimate the upper bound on the size of the output
2557 based on the number of digits it probably isn't worth
2571 spec
.precision
= strtol (pf
, &end
, 10);
2572 spec
.have_precision
= true;
2575 else if ('*' == *pf
)
2577 if (argno
< gimple_call_num_args (info
.callstmt
))
2578 spec
.star_precision
= gimple_call_arg (info
.callstmt
, argno
++);
2580 spec
.star_precision
= void_node
;
2585 /* The decimal precision or the asterisk are optional.
2586 When neither is specified it's taken to be zero. */
2588 spec
.have_precision
= true;
2598 spec
.modifier
= FMT_LEN_hh
;
2601 spec
.modifier
= FMT_LEN_h
;
2606 spec
.modifier
= FMT_LEN_j
;
2611 spec
.modifier
= FMT_LEN_L
;
2619 spec
.modifier
= FMT_LEN_ll
;
2622 spec
.modifier
= FMT_LEN_l
;
2627 spec
.modifier
= FMT_LEN_t
;
2632 spec
.modifier
= FMT_LEN_z
;
2639 /* Handle a sole '%' character the same as "%%" but since it's
2640 undefined prevent the result from being folded. */
2643 res
->bounded
= false;
2646 spec
.fmtfunc
= format_percent
;
2657 res
->floating
= true;
2658 spec
.fmtfunc
= format_floating
;
2667 spec
.fmtfunc
= format_integer
;
2671 /* The %p output is implementation-defined. It's possible
2672 to determine this format but due to extensions (especially
2673 those of the Linux kernel -- see bug 78512) the first %p
2674 in the format string disables any further processing. */
2678 /* %n has side-effects even when nothing is actually printed to
2680 info
.nowrite
= false;
2686 spec
.fmtfunc
= format_string
;
2690 /* Unknown conversion specification. */
2694 spec
.specifier
= *pf
++;
2696 /* Compute the length of the format directive. */
2697 size_t dirlen
= pf
- dir
;
2699 /* Extract the argument if the directive takes one and if it's
2700 available (e.g., the function doesn't take a va_list). Treat
2701 missing arguments the same as va_list, even though they will
2702 have likely already been diagnosed by -Wformat. */
2703 tree arg
= NULL_TREE
;
2704 if (spec
.specifier
!= '%'
2705 && argno
< gimple_call_num_args (info
.callstmt
))
2706 arg
= gimple_call_arg (info
.callstmt
, dollar
? dollar
: argno
++);
2708 ::format_directive (info
, res
, dir
, dirlen
, spec
, arg
);
2711 /* Complete format string was processed (with or without warnings). */
2715 /* Return the size of the object referenced by the expression DEST if
2716 available, or -1 otherwise. */
2718 static unsigned HOST_WIDE_INT
2719 get_destination_size (tree dest
)
2721 /* Use __builtin_object_size to determine the size of the destination
2722 object. When optimizing, determine the smallest object (such as
2723 a member array as opposed to the whole enclosing object), otherwise
2724 use type-zero object size to determine the size of the enclosing
2725 object (the function fails without optimization in this type). */
2727 init_object_sizes ();
2729 int ost
= optimize
> 0;
2730 unsigned HOST_WIDE_INT size
;
2731 if (compute_builtin_object_size (dest
, ost
, &size
))
2734 return HOST_WIDE_INT_M1U
;
2737 /* Given a suitable result RES of a call to a formatted output function
2738 described by INFO, substitute the result for the return value of
2739 the call. The result is suitable if the number of bytes it represents
2740 is known and exact. A result that isn't suitable for substitution may
2741 have its range set to the range of return values, if that is known. */
2744 try_substitute_return_value (gimple_stmt_iterator
*gsi
,
2745 const pass_sprintf_length::call_info
&info
,
2746 const format_result
&res
)
2748 tree lhs
= gimple_get_lhs (info
.callstmt
);
2750 /* Avoid the return value optimization when the behavior of the call
2751 is undefined either because any directive may have produced 4K or
2752 more of output, or the return value exceeds INT_MAX, or because
2753 the output overflows the destination object (but leave it enabled
2754 when the function is bounded because then the behavior is well-
2759 && (info
.bounded
|| res
.number_chars
<= info
.objsize
)
2760 && res
.number_chars
- 1 <= target_int_max ()
2761 /* Not prepared to handle possibly throwing calls here; they shouldn't
2762 appear in non-artificial testcases, except when the __*_chk routines
2763 are badly declared. */
2764 && !stmt_ends_bb_p (info
.callstmt
))
2766 tree cst
= build_int_cst (integer_type_node
, res
.number_chars
- 1);
2770 /* Replace the call to the bounded function with a zero size
2771 (e.g., snprintf(0, 0, "%i", 123) with the constant result
2772 of the function minus 1 for the terminating NUL which
2773 the function's return value does not include. */
2774 if (!update_call_from_tree (gsi
, cst
))
2775 gimplify_and_update_call_from_tree (gsi
, cst
);
2776 gimple
*callstmt
= gsi_stmt (*gsi
);
2777 update_stmt (callstmt
);
2781 /* Replace the left-hand side of the call with the constant
2782 result of the formatted function minus 1 for the terminating
2783 NUL which the function's return value does not include. */
2784 gimple_call_set_lhs (info
.callstmt
, NULL_TREE
);
2785 gimple
*g
= gimple_build_assign (lhs
, cst
);
2786 gsi_insert_after (gsi
, g
, GSI_NEW_STMT
);
2787 update_stmt (info
.callstmt
);
2792 location_t callloc
= gimple_location (info
.callstmt
);
2793 fprintf (dump_file
, "On line %i substituting ",
2794 LOCATION_LINE (callloc
));
2795 print_generic_expr (dump_file
, cst
, dump_flags
);
2796 fprintf (dump_file
, " for ");
2797 print_generic_expr (dump_file
, info
.func
, dump_flags
);
2798 fprintf (dump_file
, " %s (output %s).\n",
2799 info
.nowrite
? "call" : "return value",
2800 res
.constant
? "constant" : "variable");
2805 unsigned HOST_WIDE_INT maxbytes
;
2809 && ((maxbytes
= res
.number_chars
- 1) <= target_int_max ()
2810 || (res
.number_chars_min
- 1 <= target_int_max ()
2811 && (maxbytes
= res
.number_chars_max
- 1) <= target_int_max ()))
2812 && (info
.bounded
|| maxbytes
< info
.objsize
))
2814 /* If the result is in a valid range bounded by the size of
2815 the destination set it so that it can be used for subsequent
2817 int prec
= TYPE_PRECISION (integer_type_node
);
2819 if (res
.number_chars
< target_int_max () && res
.under4k
)
2821 wide_int num
= wi::shwi (res
.number_chars
- 1, prec
);
2822 set_range_info (lhs
, VR_RANGE
, num
, num
);
2824 else if (res
.number_chars_min
< target_int_max ()
2825 && res
.number_chars_max
< target_int_max ())
2827 wide_int min
= wi::shwi (res
.under4k
? res
.number_chars_min
- 1
2828 : target_int_min (), prec
);
2829 wide_int max
= wi::shwi (res
.number_chars_max
- 1, prec
);
2830 set_range_info (lhs
, VR_RANGE
, min
, max
);
2836 const char *inbounds
2837 = (res
.number_chars_min
<= info
.objsize
2838 ? (res
.number_chars_max
<= info
.objsize
2839 ? "in" : "potentially out-of")
2842 location_t callloc
= gimple_location (info
.callstmt
);
2843 fprintf (dump_file
, "On line %i ", LOCATION_LINE (callloc
));
2844 print_generic_expr (dump_file
, info
.func
, dump_flags
);
2846 const char *ign
= lhs
? "" : " ignored";
2847 if (res
.number_chars
>= HOST_WIDE_INT_MAX
)
2849 " %s-bounds return value in range [%lu, %lu]%s.\n",
2851 (unsigned long)res
.number_chars_min
- 1,
2852 (unsigned long)res
.number_chars_max
- 1, ign
);
2854 fprintf (dump_file
, " %s-bounds return value %lu%s.\n",
2855 inbounds
, (unsigned long)res
.number_chars
- 1, ign
);
2860 /* Determine if a GIMPLE CALL is to one of the sprintf-like built-in
2861 functions and if so, handle it. */
2864 pass_sprintf_length::handle_gimple_call (gimple_stmt_iterator
*gsi
)
2866 call_info info
= call_info ();
2868 info
.callstmt
= gsi_stmt (*gsi
);
2869 if (!gimple_call_builtin_p (info
.callstmt
, BUILT_IN_NORMAL
))
2872 info
.func
= gimple_call_fndecl (info
.callstmt
);
2873 info
.fncode
= DECL_FUNCTION_CODE (info
.func
);
2875 /* The size of the destination as in snprintf(dest, size, ...). */
2876 unsigned HOST_WIDE_INT dstsize
= HOST_WIDE_INT_M1U
;
2878 /* The size of the destination determined by __builtin_object_size. */
2879 unsigned HOST_WIDE_INT objsize
= HOST_WIDE_INT_M1U
;
2881 /* Buffer size argument number (snprintf and vsnprintf). */
2882 unsigned HOST_WIDE_INT idx_dstsize
= HOST_WIDE_INT_M1U
;
2884 /* Object size argument number (snprintf_chk and vsnprintf_chk). */
2885 unsigned HOST_WIDE_INT idx_objsize
= HOST_WIDE_INT_M1U
;
2887 /* Format string argument number (valid for all functions). */
2888 unsigned idx_format
;
2890 switch (info
.fncode
)
2892 case BUILT_IN_SPRINTF
:
2894 // __builtin_sprintf (dst, format, ...)
2899 case BUILT_IN_SPRINTF_CHK
:
2901 // __builtin___sprintf_chk (dst, ost, objsize, format, ...)
2907 case BUILT_IN_SNPRINTF
:
2909 // __builtin_snprintf (dst, size, format, ...)
2913 info
.bounded
= true;
2916 case BUILT_IN_SNPRINTF_CHK
:
2918 // __builtin___snprintf_chk (dst, size, ost, objsize, format, ...)
2923 info
.bounded
= true;
2926 case BUILT_IN_VSNPRINTF
:
2928 // __builtin_vsprintf (dst, size, format, va)
2932 info
.bounded
= true;
2935 case BUILT_IN_VSNPRINTF_CHK
:
2937 // __builtin___vsnprintf_chk (dst, size, ost, objsize, format, va)
2942 info
.bounded
= true;
2945 case BUILT_IN_VSPRINTF
:
2947 // __builtin_vsprintf (dst, format, va)
2952 case BUILT_IN_VSPRINTF_CHK
:
2954 // __builtin___vsprintf_chk (dst, ost, objsize, format, va)
2964 /* The first argument is a pointer to the destination. */
2965 tree dstptr
= gimple_call_arg (info
.callstmt
, 0);
2967 info
.format
= gimple_call_arg (info
.callstmt
, idx_format
);
2969 if (idx_dstsize
== HOST_WIDE_INT_M1U
)
2971 /* For non-bounded functions like sprintf, determine the size
2972 of the destination from the object or pointer passed to it
2973 as the first argument. */
2974 dstsize
= get_destination_size (dstptr
);
2976 else if (tree size
= gimple_call_arg (info
.callstmt
, idx_dstsize
))
2978 /* For bounded functions try to get the size argument. */
2980 if (TREE_CODE (size
) == INTEGER_CST
)
2982 dstsize
= tree_to_uhwi (size
);
2983 /* No object can be larger than SIZE_MAX bytes (half the address
2984 space) on the target.
2985 The functions are defined only for output of at most INT_MAX
2986 bytes. Specifying a bound in excess of that limit effectively
2987 defeats the bounds checking (and on some implementations such
2988 as Solaris cause the function to fail with EINVAL). */
2989 if (dstsize
> target_size_max () / 2)
2991 /* Avoid warning if -Wstringop-overflow is specified since
2992 it also warns for the same thing though only for the
2993 checking built-ins. */
2994 if ((idx_objsize
== HOST_WIDE_INT_M1U
2995 || !warn_stringop_overflow
))
2996 warning_at (gimple_location (info
.callstmt
), info
.warnopt (),
2997 "specified bound %wu exceeds maximum object size "
2999 dstsize
, target_size_max () / 2);
3001 else if (dstsize
> target_int_max ())
3002 warning_at (gimple_location (info
.callstmt
), info
.warnopt (),
3003 "specified bound %wu exceeds %<INT_MAX %>",
3006 else if (TREE_CODE (size
) == SSA_NAME
)
3008 /* Try to determine the range of values of the argument
3009 and use the greater of the two at -Wformat-level 1 and
3010 the smaller of them at level 2. */
3012 enum value_range_type range_type
3013 = get_range_info (size
, &min
, &max
);
3014 if (range_type
== VR_RANGE
)
3017 = (warn_format_length
< 2
3018 ? wi::fits_uhwi_p (max
) ? max
.to_uhwi () : max
.to_shwi ()
3019 : wi::fits_uhwi_p (min
) ? min
.to_uhwi () : min
.to_shwi ());
3024 if (idx_objsize
!= HOST_WIDE_INT_M1U
)
3026 if (tree size
= gimple_call_arg (info
.callstmt
, idx_objsize
))
3027 if (tree_fits_uhwi_p (size
))
3028 objsize
= tree_to_uhwi (size
);
3031 if (info
.bounded
&& !dstsize
)
3033 /* As a special case, when the explicitly specified destination
3034 size argument (to a bounded function like snprintf) is zero
3035 it is a request to determine the number of bytes on output
3036 without actually producing any. Pretend the size is
3037 unlimited in this case. */
3038 info
.objsize
= HOST_WIDE_INT_MAX
;
3039 info
.nowrite
= true;
3043 /* For calls to non-bounded functions or to those of bounded
3044 functions with a non-zero size, warn if the destination
3046 if (integer_zerop (dstptr
))
3048 /* This is diagnosed with -Wformat only when the null is a constant
3049 pointer. The warning here diagnoses instances where the pointer
3051 location_t loc
= gimple_location (info
.callstmt
);
3052 warning_at (EXPR_LOC_OR_LOC (dstptr
, loc
),
3053 info
.warnopt (), "null destination pointer");
3057 /* Set the object size to the smaller of the two arguments
3058 of both have been specified and they're not equal. */
3059 info
.objsize
= dstsize
< objsize
? dstsize
: objsize
;
3062 && dstsize
< target_size_max () / 2 && objsize
< dstsize
3063 /* Avoid warning if -Wstringop-overflow is specified since
3064 it also warns for the same thing though only for the
3065 checking built-ins. */
3066 && (idx_objsize
== HOST_WIDE_INT_M1U
3067 || !warn_stringop_overflow
))
3069 warning_at (gimple_location (info
.callstmt
), info
.warnopt (),
3070 "specified bound %wu exceeds the size %wu "
3071 "of the destination object", dstsize
, objsize
);
3075 if (integer_zerop (info
.format
))
3077 /* This is diagnosed with -Wformat only when the null is a constant
3078 pointer. The warning here diagnoses instances where the pointer
3080 location_t loc
= gimple_location (info
.callstmt
);
3081 warning_at (EXPR_LOC_OR_LOC (info
.format
, loc
),
3082 info
.warnopt (), "null format string");
3086 info
.fmtstr
= get_format_string (info
.format
, &info
.fmtloc
);
3090 /* The result is the number of bytes output by the formatted function,
3091 including the terminating NUL. */
3092 format_result res
= format_result ();
3094 bool success
= compute_format_length (info
, &res
);
3096 /* When optimizing and the printf return value optimization is enabled,
3097 attempt to substitute the computed result for the return value of
3098 the call. Avoid this optimization when -frounding-math is in effect
3099 and the format string contains a floating point directive. */
3102 && flag_printf_return_value
3103 && (!flag_rounding_math
|| !res
.floating
))
3104 try_substitute_return_value (gsi
, info
, res
);
3107 /* Execute the pass for function FUN. */
3110 pass_sprintf_length::execute (function
*fun
)
3113 FOR_EACH_BB_FN (bb
, fun
)
3115 for (gimple_stmt_iterator si
= gsi_start_bb (bb
); !gsi_end_p (si
);
3118 /* Iterate over statements, looking for function calls. */
3119 gimple
*stmt
= gsi_stmt (si
);
3121 if (is_gimple_call (stmt
))
3122 handle_gimple_call (&si
);
3126 fini_object_sizes ();
3131 } /* Unnamed namespace. */
3133 /* Return a pointer to a pass object newly constructed from the context
3137 make_pass_sprintf_length (gcc::context
*ctxt
)
3139 return new pass_sprintf_length (ctxt
);