gcc/analyzer/varargs.dot

   1 /* An overview of the state machine from varargs.cc
   2    Copyright (C) 2022-2024 Free Software Foundation, Inc.
   3    Contributed by David Malcolm <dmalcolm@redhat.com>.
   4
   5 This file is part of GCC.
   6
   7 GCC is free software; you can redistribute it and/or modify it
   8 under the terms of the GNU General Public License as published by
   9 the Free Software Foundation; either version 3, or (at your option)
  10 any later version.
  11
  12 GCC is distributed in the hope that it will be useful, but
  13 WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15 General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GCC; see the file COPYING3.  If not see
  19 <http://www.gnu.org/licenses/>.  */
  20
  21 /* Keep this in-sync with varargs.cc  */
  22
  23 digraph "va_list" {
  24
  25   /* STATES. */
  26
  27   /* Start state.  */
  28   start;
  29
  30   /* State for a va_list that is the result of a va_start or va_copy.  */
  31   started;
  32
  33   /* State for a va_list that has had va_end called on it.  */
  34   ended;
  35
  36   /* TRANSITIONS. */
  37
  38   /* on_va_start: */
  39   start -> started [label="on 'va_start(X, ...)'"];
  40
  41   /* on_va_copy: */
  42   start -> started [label="on 'va_copy(X, ...)'"];
  43   // in check_for_ended_va_list:
  44   ended -> ended [label="on 'va_copy(X, ...)':\nWarn('use after va_end')"];
  45
  46   /* on_va_arg: */
  47   started -> started [label="on 'va_arg(X, ...)'"];
  48   started -> started [label="on 'va_copy(..., X)'"];
  49   // in check_for_ended_va_list:
  50   ended -> ended [label="on 'va_arg(X, ...)':\nWarn('use after va_end')"];
  51
  52   /* on_va_end: */
  53   started -> ended [label="on 'va_end(X)'"];
  54   // in check_for_ended_va_list:
  55   ended -> ended [label="on 'va_end(X)':\nWarn('use after va_end')"];
  56 }