rpm-build/build/rpmspec.h

#ifndef _H_SPEC_
#define _H_SPEC_

/** \ingroup rpmbuild
 * \file build/rpmspec.h
 *  The Spec and Package data structures used during build.
 */

/** \ingroup rpmbuild
 */
typedef struct SpecStruct *Spec;

/** \ingroup rpmbuild
 */
struct TriggerFileEntry {
    int index;
/*@only@*/ char * fileName;
/*@only@*/ char * script;
/*@only@*/ char * prog;
/*@owned@*/ struct TriggerFileEntry * next;
};

#define RPMBUILD_ISSOURCE	(1 << 0)
#define RPMBUILD_ISPATCH	(1 << 1)
#define RPMBUILD_ISICON		(1 << 2)
#define RPMBUILD_ISNO		(1 << 3)

#define RPMBUILD_DEFAULT_LANG "C"

/** \ingroup rpmbuild
 */
struct Source {
/*@owned@*/ char * fullSource;
/*@dependent@*/ char * source;     /* Pointer into fullSource */
    int flags;
    int num;
/*@owned@*/ struct Source * next;
};

/** \ingroup rpmbuild
 */
/*@-typeuse@*/
typedef struct ReadLevelEntry {
    int reading;
/*@dependent@*/
    struct ReadLevelEntry * next;
} RLE_t;
/*@=typeuse@*/

/** \ingroup rpmbuild
 */
typedef struct OpenFileInfo {
/*@only@*/ const char * fileName;
    FD_t fd;
    int lineNum;
    char * readBuf;
/*@dependent@*/
    char * readPtr;
    size_t readBufSize;
/*@owned@*/
    struct OpenFileInfo * next;
} OFI_t;

/** \ingroup rpmbuild
 */
typedef struct spectag_s {
    int t_tag;
    int t_startx;
    int t_nlines;
/*@only@*/ const char * t_lang;
/*@only@*/ const char * t_msgid;
} * spectag;

/** \ingroup rpmbuild
 */
typedef struct spectags_s {
/*@owned@*/ spectag st_t;
    int st_nalloc;
    int st_ntags;
} * spectags;

/** \ingroup rpmbuild
 */
typedef struct speclines_s {
/*@only@*/ char **sl_lines;
    int sl_nalloc;
    int sl_nlines;
} * speclines;

/** \ingroup rpmbuild
 * The structure used to store values parsed from a spec file.
 */
struct SpecStruct {
/*@only@*/ const char * specFile;	/*!< Name of the spec file. */
/*@only@*/ const char * sourceRpmName;
/*@only@*/ const char * buildRootURL;
/*@only@*/ const char * buildSubdir;
/*@only@*/ const char * rootURL;

/*@owned@*/ /*@null@*/ speclines sl;
/*@owned@*/ /*@null@*/ spectags st;

/*@owned@*/ struct OpenFileInfo * fileStack;
    char *lbuf;
    char *lbufPtr;
    size_t lbuf_len;
    char nextpeekc;
/*@dependent@*/ char * nextline;
/*@dependent@*/ char * line;
    int lineNum;

/*@owned@*/ struct ReadLevelEntry * readStack;

/*@refcounted@*/ Header buildRestrictions;
/*@owned@*/ /*@null@*/ struct SpecStruct ** BASpecs;
/*@only@*/ /*@null@*/ const char ** BANames;
    int BACount;
    int recursing;			/*!< parse is recursive? */

    int force;
    int anyarch;
    int preprocess_mode;

    int gotBuildRootURL;

/*@null@*/ char * passPhrase;
    int timeCheck;
/*@null@*/ const char * cookie;

/*@owned@*/ struct Source * sources;
    int numSources;
    int noSource;

/*@refcounted@*/
    Header sourceHeader;
/*@owned@*/
    void * sourceCpioList;

/*@dependent@*/ /*@null@*/ MacroContext macros;

/*@only@*/ StringBuf prep;		/*!< %prep scriptlet. */
/*@only@*/ StringBuf build;		/*!< %build scriptlet. */
/*@only@*/ StringBuf install;		/*!< %install scriptlet. */
/*@only@*/ StringBuf check;		/*!< %check scriptlet. */
/*@only@*/ StringBuf clean;		/*!< %clean scriptlet. */

/*@owned@*/ struct PackageStruct * packages;	/*!< Package list. */
    const char **exclude;		/*!< Files marked with %exclude. */
    int excludeCount;
};

/** \ingroup rpmbuild
 * The structure used to store values for a package.
 */
struct PackageStruct {
/*@refcounted@*/
    Header header;

/*@owned@*/
    void * cpioList;

/*@owned@*/ struct Source * icon;

    const char *autoReq;
    const char *autoProv;

/*@only@*/ const char * preInFile;	/*!< %pre scriptlet. */
/*@only@*/ const char * postInFile;	/*!< %post scriptlet. */
/*@only@*/ const char * preUnFile;	/*!< %preun scriptlet. */
/*@only@*/ const char * postUnFile;	/*!< %postun scriptlet. */
/*@only@*/ const char * verifyFile;	/*!< %verifyscript scriptlet. */

/*@only@*/ StringBuf specialDoc;

/*@only@*/ struct TriggerFileEntry * triggerFiles;

/*@only@*/ const char * fileFile;
/*@only@*/ StringBuf fileList; /* If NULL, package will not be written */

/*@dependent@*/ struct PackageStruct * next;
};

/** \ingroup rpmbuild
 */
typedef struct PackageStruct * Package;

#ifdef __cplusplus
extern "C" {
#endif

/** \ingroup rpmbuild
 * Create and initialize Spec structure.
 * @return spec		spec file control structure
 */
/*@only@*/ Spec newSpec(void)
	/*@globals rpmGlobalMacroContext @*/
	/*@modifies rpmGlobalMacroContext @*/;

/** \ingroup rpmbuild
 * Destroy Spec structure.
 * @param spec		spec file control structure
 * @return		NULL always
 */
/*@null@*/ Spec freeSpec(/*@only@*/ /*@null@*/ Spec spec)
	/*@globals fileSystem @*/
	/*@modifies spec, fileSystem @*/;

/** \ingroup rpmbuild
 * @param spec		spec file control structure
 * @return		NULL always
 */
/*@-declundef@*/
extern /*@null@*/ Spec (*freeSpecVec) (Spec spec)	/* XXX FIXME */
	/*@globals fileSystem @*/
	/*@modifies spec, fileSystem @*/;
/*@=declundef@*/

/** \ingroup rpmbuild
 */
struct OpenFileInfo * newOpenFileInfo(void)	/*@*/;

OFI_t * freeOpenFileInfo(OFI_t *ofi);

/** \ingroup rpmbuild
 * @param spec		spec file control structure
 * @param h
 * @param tag
 * @param lang
 */
spectag stashSt(Spec spec, Header h, int tag, const char * lang)
	/*@modifies spec->st @*/;

/** \ingroup rpmbuild
 * @param spec		spec file control structure
 * @param pkg
 * @param field
 * @param tag
 */
int addSource(Spec spec, Package pkg, const char * field, int tag)
	/*@globals rpmGlobalMacroContext @*/
	/*@modifies spec->sources, spec->numSources,
		spec->st, spec->macros,
		pkg->icon,
		rpmGlobalMacroContext @*/;

/** \ingroup rpmbuild
 * @param spec		spec file control structure
 * @param field
 * @param tag
 */
int parseNoSource(Spec spec, const char * field, int tag)
	/*@modifies nothing @*/;

#ifdef __cplusplus
}
#endif

#endif /* _H_SPEC_ */