trace.h

Go to the documentation of this file.

/*
Copyright (C) 2004-2005, 2007-2008, 2020 Rocky Bernstein <rocky@gnu.org>

This file is part of GNU Make (remake variant).

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

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

You should have received a copy of the GNU General Public License
along with GNU Make; see the file COPYING.  If not, write to
the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.  */

#ifndef REMAKE_TRACE_H
#define REMAKE_TRACE_H

#include "types.h"
#include "filedef.h"

typedef enum {
  continue_execution,   
  next_execution,       
  skip_execution,       
  debug_readloop,       
  debug_cmd_error       
} debug_return_t;

typedef enum
  {
    DEBUG_BRKPT_BEFORE_PREREQ     = 0,
    DEBUG_BRKPT_AFTER_PREREQ      = 1,
    DEBUG_BRKPT_AFTER_CMD         = 2,
    DEBUG_GOAL_UPDATED_HIT        = 3,
    DEBUG_READ_HIT                = 4,
    DEBUG_ERROR_HIT               = 5,
    DEBUG_STEP_HIT                = 6,
    DEBUG_STEP_COMMAND            = 7,
    DEBUG_EXPLICIT_CALL           = 8,
    DEBUG_STACK_CHANGING          = 99,
    DEBUG_NOT_GIVEN               = 100
  } debug_enter_reason_t;

typedef enum {
    INFO_TARGET_POSITION = 1,
    INFO_TARGET_NAME     = 2,
    INFO_TARGET_POSITION_AND_NAME   = 3, /* 1 & 2 */
    INFO_TARGET_TASKS               = 4,
    INFO_TARGET_TASK_COMMENT        = 8,
    INFO_TARGET_TASKS_WITH_COMMENTS = 12, /* 4 & 8 */
} info_target_output_mask_t;

typedef struct target_stack_node
  {
    file_t                   *p_target;
    file_t                   *p_shared_target;
    struct target_stack_node *p_parent;
  } target_stack_node_t;

extern target_stack_node_t *p_stack_top;

extern target_stack_node_t *trace_push_target (target_stack_node_t *p,
                                               file_t *p_target);

extern void trace_pop_target (target_stack_node_t *p);

typedef struct floc_stack_node
  {
    gmk_floc               *p_floc;
    struct floc_stack_node *p_parent;
  } floc_stack_node_t;

extern floc_stack_node_t *p_stack_floc_top;

extern void trace_push_floc (gmk_floc *p_floc);

extern void trace_pop_floc (void);

extern void dbg_cmd_info_targets(info_target_output_mask_t output_mask);

extern void dbg_cmd_info_tasks();

#endif /*REMAKE_TRACE_H*/