source: downloads/boost_1_33_1/tools/build/jam_src/rules.h @ 12

/*
 * Copyright 1993, 1995 Christopher Seiwald.
 *
 * This file is part of Jam - see jam.c for Copyright information.
 */

/*  This file is ALSO:
 *  Copyright 2001-2004 David Abrahams.
 *  Distributed under the Boost Software License, Version 1.0.
 *  (See accompanying file LICENSE_1_0.txt or http://www.boost.org/LICENSE_1_0.txt)
 */

#ifndef RULES_DWA_20011020_H
# define RULES_DWA_20011020_H

# include "modules.h"
# include "jam.h"
# include "parse.h"

/*
 * rules.h -  targets, rules, and related information
 *
 * This file describes the structures holding the targets, rules, and
 * related information accumulated by interpreting the statements
 * of the jam files.
 *
 * The following are defined:
 *
 *      RULE - a generic jam rule, the product of RULE and ACTIONS 
 *      ACTIONS - a chain of ACTIONs 
 *      ACTION - a RULE instance with targets and sources 
 *      SETTINGS - variables to set when executing a TARGET's ACTIONS 
 *      TARGETS - a chain of TARGETs 
 *      TARGET - a file or "thing" that can be built 
 *
 * 04/11/94 (seiwald) - Combined deps & headers into deps[2] in TARGET.
 * 04/12/94 (seiwald) - actionlist() now just appends a single action.
 * 06/01/94 (seiwald) - new 'actions existing' does existing sources
 * 12/20/94 (seiwald) - NOTIME renamed NOTFILE.
 * 01/19/95 (seiwald) - split DONTKNOW into CANTFIND/CANTMAKE.
 * 02/02/95 (seiwald) - new LEAVES modifier on targets.
 * 02/14/95 (seiwald) - new NOUPDATE modifier on targets.
 */

typedef struct _rule RULE;
typedef struct _target TARGET;
typedef struct _targets TARGETS;
typedef struct _action ACTION;
typedef struct _actions ACTIONS;
typedef struct _settings SETTINGS ;

/* RULE - a generic jam rule, the product of RULE and ACTIONS */

/* A rule's argument list */
struct argument_list
{
    int reference_count;
    LOL data[1];
};

/* The build actions corresponding to a rule */
struct rule_actions
{
    int reference_count;
    char* command;       /* command string from ACTIONS */
    LIST* bindlist;
    int flags;          /* modifiers on ACTIONS */

# define    RULE_NEWSRCS    0x01    /* $(>) is updated sources only */
# define    RULE_TOGETHER   0x02    /* combine actions on single target */
# define    RULE_IGNORE 0x04    /* ignore return status of executes */
# define    RULE_QUIETLY    0x08    /* don't mention it unless verbose */
# define    RULE_PIECEMEAL  0x10    /* split exec so each $(>) is small */
# define    RULE_EXISTING   0x20    /* $(>) is pre-exisitng sources only */
};

typedef struct rule_actions rule_actions;
typedef struct argument_list argument_list;

struct _rule {
    char    *name;
    PARSE   *procedure;        /* parse tree from RULE */
    argument_list* arguments;  /* argument checking info, or NULL for unchecked */
    rule_actions* actions;     /* build actions, or NULL for no actions */
    module_t  *module;           /* module in which this rule is executed */
    int     exported;          /* nonzero if this rule is supposed to
                                * appear in the global module and be
                                * automatically imported into other modules
                                */
#ifdef HAVE_PYTHON
    PyObject* python_function;
#endif    
};

/* ACTIONS - a chain of ACTIONs */

struct _actions {
        ACTIONS *next;
        ACTIONS *tail;                  /* valid only for head */
        ACTION  *action;
} ;

/* ACTION - a RULE instance with targets and sources */

struct _action {
        RULE    *rule;
        TARGETS *targets;
        TARGETS *sources;               /* aka $(>) */
        char    running;                /* has been started */
        char    status;                 /* see TARGET status */
} ;

/* SETTINGS - variables to set when executing a TARGET's ACTIONS */

struct _settings {
        SETTINGS *next;
        char    *symbol;                /* symbol name for var_set() */
        LIST    *value;                 /* symbol value for var_set() */
} ;

/* TARGETS - a chain of TARGETs */

struct _targets {
        TARGETS *next;
        TARGETS *tail;                  /* valid only for head */
        TARGET  *target;
} ;

/* TARGET - a file or "thing" that can be built */

struct _target {
        char    *name;
        char    *boundname;             /* if search() relocates target */
        ACTIONS *actions;               /* rules to execute, if any */
        SETTINGS *settings;             /* variables to define */

        short flags;                    /* status info */

# define        T_FLAG_TEMP     0x0001  /* TEMPORARY applied */
# define        T_FLAG_NOCARE   0x0002  /* NOCARE applied */
# define        T_FLAG_NOTFILE  0x0004  /* NOTFILE applied */
# define        T_FLAG_TOUCHED  0x0008  /* ALWAYS applied or -t target */
# define        T_FLAG_LEAVES   0x0010  /* LEAVES applied */
# define        T_FLAG_NOUPDATE 0x0020  /* NOUPDATE applied */
# define        T_FLAG_VISITED  0x0040    /* CWM: Used in debugging */

/* this flag was added to support a new builtin rule named "RMBAD" */
/* it is used to force removal of outdated targets whose dependencies
 * fail to build  */
    
# define        T_FLAG_RMOLD    0x0080    /* RMBAD applied */

/* this flag was added to support a new builting rule named "FAIL_EXPECTED" */
/* it is used to indicate that the result of running a given action should  */
/* be inverted (i.e. ok <=> fail). This is useful to launch certain test    */
/* runs from a Jamfile..                                                    */
/*                                                                          */
# define        T_FLAG_FAIL_EXPECTED  0x0100  /* FAIL_EXPECTED applied */

# define T_FLAG_INTERNAL 0x0200    /* internal INCLUDES node */

/*  Indicates that the target must be a file. This prevents matching non-files,
    like directories, when a target is searched. */
#define     T_FLAG_ISFILE   0x0400



#ifdef OPT_SEMAPHORE
# define        T_MAKE_SEMAPHORE 5 /* Special target type for semaphores */
#endif


        char    binding;                /* how target relates to real file */

# define        T_BIND_UNBOUND  0       /* a disembodied name */
# define        T_BIND_MISSING  1       /* couldn't find real file */
#ifdef OPT_SEMAPHORE
        TARGET  *semaphore;             /* used in serialization */
#endif
# define        T_BIND_PARENTS  2       /* using parent's timestamp */
# define        T_BIND_EXISTS   3       /* real file, timestamp valid */

        TARGETS         *depends;       /* dependencies */
        TARGETS         *dependents;/* the inverse of dependencies */
    TARGETS     *rebuilds;  /* targets that should be force-rebuilt whenever this one is */
        TARGET          *includes;      /* includes */
    TARGET        *original_target; /* original_target->includes = this */
    char rescanned;

        time_t  time;                   /* update time */
        time_t  leaf;                   /* update time of leaf sources */

        char    fate;                   /* make0()'s diagnosis */

# define        T_FATE_INIT     0       /* nothing done to target */
# define        T_FATE_MAKING   1       /* make0(target) on stack */

# define        T_FATE_STABLE   2       /* target didn't need updating */
# define        T_FATE_NEWER    3       /* target newer than parent */

# define        T_FATE_SPOIL    4       /* >= SPOIL rebuilds parents */
# define        T_FATE_ISTMP    4       /* unneeded temp target oddly present */

# define        T_FATE_BUILD    5       /* >= BUILD rebuilds target */
# define        T_FATE_TOUCHED  5       /* manually touched with -t */
# define        T_FATE_REBUILD  6
# define        T_FATE_MISSING  7       /* is missing, needs updating */
# define        T_FATE_NEEDTMP  8       /* missing temp that must be rebuild */
# define        T_FATE_OUTDATED 9       /* is out of date, needs updating */
# define        T_FATE_UPDATE   10      /* deps updated, needs updating */

# define        T_FATE_BROKEN   11      /* >= BROKEN ruins parents */
# define        T_FATE_CANTFIND 11      /* no rules to make missing target */
# define        T_FATE_CANTMAKE 12      /* can't find dependents */

        char    progress;               /* tracks make1() progress */

# define        T_MAKE_INIT     0       /* make1(target) not yet called */
# define        T_MAKE_ONSTACK  1       /* make1(target) on stack */
# define        T_MAKE_ACTIVE   2       /* make1(target) in make1b() */
# define        T_MAKE_RUNNING  3       /* make1(target) running commands */
# define        T_MAKE_DONE     4       /* make1(target) done */

        char    status;                 /* execcmd() result */

        int     asynccnt;               /* child deps outstanding */
        TARGETS *parents;               /* used by make1() for completion */
        char    *cmds;                  /* type-punned command list */

    char* failed;
} ;

RULE    *bindrule( char *rulename, module_t* );

RULE*   import_rule( RULE* source, module_t* m, char* name );
RULE*   new_rule_body( module_t* m, char* rulename, argument_list* args, PARSE* procedure, int exprt );
RULE*   new_rule_actions( module_t* m, char* rulename, char* command, LIST* bindlist, int flags );
TARGET  *bindtarget( const char *targetname );
TARGET *copytarget( const TARGET *t );
void bind_explicitly_located_targets();
TARGET* search_for_target( char * name, LIST* search_path );
void    touchtarget( char *t );
TARGETS *targetlist( TARGETS *chain, LIST  *targets );
TARGETS *targetentry( TARGETS *chain, TARGET *target );
TARGETS *targetchain( TARGETS *chain, TARGETS *targets );
void freetargets( TARGETS *chain );
ACTIONS *actionlist( ACTIONS *chain, ACTION *action );
void freeactions( ACTIONS *chain );
SETTINGS *addsettings( SETTINGS *head, int append, char *symbol, LIST *value );
void    pushsettings( SETTINGS *v );
void    popsettings( SETTINGS *v );
SETTINGS *copysettings( SETTINGS *v );
void    freesettings( SETTINGS *v );
void    rule_free( RULE *r );
void    donerules();

argument_list* args_new();
void    args_refer( argument_list* );
void    args_free( argument_list* );

void actions_refer(rule_actions*);
void actions_free(rule_actions*);

#endif