Return to pcp.h CVS log

Up to [Apple XNU] / GNUtools / cc

Annotation of GNUtools/cc/pcp.h, revision 1.1

1.1     ! root        1: /* pcp.h -- Describes the format of a precompiled file
        !             2:    Copyright (C) 1990 Free Software Foundation, Inc.
        !             3: 
        !             4: This file is part of GNU CC.
        !             5: 
        !             6: GNU CC is free software; you can redistribute it and/or modify
        !             7: it under the terms of the GNU General Public License as published by
        !             8: the Free Software Foundation; either version 2, or (at your option)
        !             9: any later version.
        !            10: 
        !            11: GNU CC is distributed in the hope that it will be useful,
        !            12: but WITHOUT ANY WARRANTY; without even the implied warranty of
        !            13: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        !            14: GNU General Public License for more details.
        !            15: 
        !            16: You should have received a copy of the GNU General Public License
        !            17: along with GNU CC; see the file COPYING.  If not, write to
        !            18: the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */
        !            19: 
        !            20: 
        !            21: 
        !            22: /* Structure allocated for every string in a precompiled file */
        !            23: typedef struct stringdef STRINGDEF;
        !            24: struct stringdef
        !            25: {
        !            26:   U_CHAR *contents;            /* String to include */
        !            27:   int len;                     /* Its length */
        !            28:   int writeflag;               /* Whether we write this */
        !            29:   int lineno;                  /* Linenumber of source file */
        !            30:   U_CHAR *filename;            /* Name of source file */
        !            31:   STRINGDEF *chain;            /* Global list of strings in natural order */
        !            32:   int output_mark;             /* Where in the output this goes */
        !            33: };
        !            34: 
        !            35: typedef struct keydef KEYDEF;
        !            36: struct keydef
        !            37: {
        !            38:   STRINGDEF *str;
        !            39:   KEYDEF *chain;
        !            40: };
        !            41: 
        !            42: /* Format: */
        !            43: /* A precompiled file starts with a series of #define and #undef
        !            44:  statements:
        !            45:     #define MAC DEF     ---   Indicates MAC must be defined with defn DEF
        !            46:     #define MAC         ---   Indicates MAC must be defined with any defn
        !            47:     #undef MAC          ---   Indicates MAC cannot be defined
        !            48: 
        !            49: These preconditions must be true for a precompiled file to be used.  
        !            50: The preconditions section is null terminated. */
        !            51: 
        !            52: /* Then, there is a four byte number (in network byte order) which */
        !            53:  /* indicates the number of strings the file contains. */
        !            54: 
        !            55: /* Each string contains a STRINGDEF structure.  The only component of */
        !            56:  /* the STRINGDEF structure which is used is the lineno field, which */
        !            57:  /* should hold the line number in the original header file.  */
        !            58:  /* Then follows the string, followed by a null.  Then comes a four */
        !            59:  /* byte number (again, in network byte order) indicating the number */
        !            60:  /* of keys for this string.  Each key is a KEYDEF structure, with */
        !            61:  /* irrelevant contents, followed by the null-terminated string. */
        !            62: 
        !            63: /* If the number of keys is 0, then there are no keys for the string, */
        !            64:  /* in other words, the string will never be included.  If the number */
        !            65:  /* of keys is -1, this is a special flag indicating there are no keys */
        !            66:  /* in the file, and the string is mandatory (that is, it must be */
        !            67:  /* included regardless in the included output).  */
        !            68: 
        !            69: /* A file, then, looks like this:
        !            70: 
        !            71:   Precondition 1
        !            72:   Precondition 2
        !            73:   . 
        !            74:   .
        !            75:   .
        !            76:   <NUL>
        !            77:   Number of strings
        !            78:     STRINGDEF
        !            79:     String . . . <NUL>
        !            80:     Number of keys
        !            81:       KEYDEF
        !            82:       Key . . . <NUL>
        !            83:       KEYDEF 
        !            84:       Key . . . <NUL>
        !            85:       .
        !            86:       .
        !            87:       .
        !            88:     STRINGDEF
        !            89:     String . . . <NUL>
        !            90:     Number of keys
        !            91:       KEYDEF
        !            92:       Key . . . <NUL>
        !            93:       .
        !            94:       .
        !            95:       .
        !            96:     .
        !            97:     .
        !            98:     .
        !            99: 
        !           100: */

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.