/* * Copyright (C) 1986-2005 The Free Software Foundation, Inc. * * Portions Copyright (C) 1998-2005 Derek Price, Ximbiot <http://ximbiot.com>, * and others. * * Portions Copyright (C) 1992, Brian Berliner and Jeff Polk * Portions Copyright (C) 1989-1992, Brian Berliner * * You may distribute under the terms of the GNU General Public License as * specified in the README file that comes with the CVS source distribution. * * RCS source control definitions needed by rcs.c and friends */ /* Strings which indicate a conflict if they occur at the start of a line. */ #define RCS_MERGE_PAT_1 "<<<<<<< " #define RCS_MERGE_PAT_2 "=======\n" #define RCS_MERGE_PAT_3 ">>>>>>> " #define RCSEXT ",v" #define RCSPAT "*,v" #define RCSHEAD "head" #define RCSBRANCH "branch" #define RCSSYMBOLS "symbols" #define RCSDATE "date" #define RCSDESC "desc" #define RCSEXPAND "expand" /* Used by the version of death support which resulted from old versions of CVS (e.g. 1.5 if you define DEATH_SUPPORT and not DEATH_STATE). Only a hacked up RCS (used by those old versions of CVS) will put this into RCS files. Considered obsolete. */ #define RCSDEAD "dead" #define DATEFORM "%02d.%02d.%02d.%02d.%02d.%02d" #define SDATEFORM "%d.%d.%d.%d.%d.%d" /* * Opaque structure definitions used by RCS specific lookup routines */ #define VALID 0x1 /* flags field contains valid data */ #define INATTIC 0x2 /* RCS file is located in the Attic */ #define PARTIAL 0x4 /* RCS file not completly parsed */ /* All the "char *" fields in RCSNode, Deltatext, and RCSVers are '\0'-terminated (except "text" in Deltatext). This means that we can't deal with fields containing '\0', which is a limitation that RCS does not have. Would be nice to fix this some day. */ struct rcsnode { /* Reference count for this structure. Used to deal with the fact that there might be a pointer from the Vers_TS or might not. Callers who increment this field are responsible for calling freercsnode when they are done with their reference. */ int refcount; /* Flags (INATTIC, PARTIAL, &c), see above. */ int flags; /* File name of the RCS file. This is not necessarily the name as specified by the user, but it is a name which can be passed to system calls and a name which is OK to print in error messages (the various names might differ in case). */ char *path; /* Use when printing paths. */ char *print_path; /* Value for head keyword from RCS header, or NULL if empty. HEAD may only * be empty in a valid RCS file when the file has no revisions, a state * that should not be able to occur with CVS. */ char *head; /* Value for branch keyword from RCS header, or NULL if omitted. */ char *branch; /* Raw data on symbolic revisions. The first time that RCS_symbols is called, we parse these into ->symbols, and free ->symbols_data. */ char *symbols_data; /* Value for expand keyword from RCS header, or NULL if omitted. */ char *expand; /* List of nodes, the key of which is the symbolic name and the data of which is the numeric revision that it corresponds to (malloc'd). */ List *symbols; /* List of nodes (type RCSVERS), the key of which the numeric revision number, and the data of which is an RCSVers * for the revision. */ List *versions; /* Value for access keyword from RCS header, or NULL if empty. FIXME: RCS_delaccess would also seem to use "" for empty. We should pick one or the other. */ char *access; /* Raw data on locked revisions. The first time that RCS_getlocks is called, we parse these into ->locks, and free ->locks_data. */ char *locks_data; /* List of nodes, the key of which is the numeric revision and the data of which is the user that it corresponds to (malloc'd). */ List *locks; /* Set for the strict keyword from the RCS header. */ int strict_locks; /* Value for the comment keyword from RCS header (comment leader), or NULL if omitted. */ char *comment; /* Value for the desc field in the RCS file, or NULL if empty. */ char *desc; /* File offset of the first deltatext node, so we can seek there. */ off_t delta_pos; /* Newphrases from the RCS header. List of nodes, the key of which is the "id" which introduces the newphrase, and the value of which is the value from the newphrase. */ List *other; }; typedef struct rcsnode RCSNode; struct deltatext { char *version; /* Log message, or NULL if we do not intend to change the log message (that is, RCS_copydeltas should just use the log message from the file). */ char *log; /* Change text, or NULL if we do not intend to change the change text (that is, RCS_copydeltas should just use the change text from the file). Note that it is perfectly valid to have log be NULL and text non-NULL, or vice-versa. */ char *text; size_t len; /* Newphrase fields from deltatext nodes. FIXME: duplicates the other field in the rcsversnode, I think. */ List *other; }; typedef struct deltatext Deltatext; struct rcsversnode { /* Duplicate of the key by which this structure is indexed. */ char *version; char *date; char *author; char *state; char *next; int dead; int outdated; Deltatext *text; List *branches; /* Newphrase fields from deltatext nodes. Also contains ";add" and ";delete" magic fields (see rcs.c, log.c). I think this is only used by log.c (where it looks up "log"). Duplicates the other field in struct deltatext, I think. */ List *other; /* Newphrase fields from delta nodes. */ List *other_delta; #ifdef PRESERVE_PERMISSIONS_SUPPORT /* Hard link information for each revision. */ List *hardlinks; #endif }; typedef struct rcsversnode RCSVers; /* * CVS reserves all even-numbered branches for its own use. "magic" branches * (see rcs.c) are contained as virtual revision numbers (within symbolic * tags only) off the RCS_MAGIC_BRANCH, which is 0. CVS also reserves the * ".1" branch for vendor revisions. So, if you do your own branching, you * should limit your use to odd branch numbers starting at 3. */ #define RCS_MAGIC_BRANCH 0 /* The type of a function passed to RCS_checkout. */ typedef void (*RCSCHECKOUTPROC) (void *, const char *, size_t); struct rcsbuffer; /* What RCS_deltas is supposed to do. */ enum rcs_delta_op {RCS_ANNOTATE, RCS_FETCH}; /* * exported interfaces */ RCSNode *RCS_parse (const char *file, const char *repos); RCSNode *RCS_parsercsfile (const char *rcsfile); void RCS_fully_parse (RCSNode *); void RCS_reparsercsfile (RCSNode *, FILE **, struct rcsbuffer *); extern int RCS_setattic (RCSNode *, int); char *RCS_check_kflag (const char *arg); char *RCS_getdate (RCSNode * rcs, const char *date, int force_tag_match); char *RCS_gettag (RCSNode * rcs, const char *symtag, int force_tag_match, int *simple_tag); int RCS_exist_rev (RCSNode *rcs, char *rev); int RCS_exist_tag (RCSNode *rcs, char *tag); char *RCS_tag2rev (RCSNode *rcs, char *tag); char *RCS_getversion (RCSNode *rcs, const char *tag, const char *date, int force_tag_match, int *simple_tag); char *RCS_magicrev (RCSNode *rcs, char *rev); int RCS_isbranch (RCSNode *rcs, const char *rev); int RCS_nodeisbranch (RCSNode *rcs, const char *tag); char *RCS_whatbranch (RCSNode *rcs, const char *tag); char *RCS_head (RCSNode * rcs); int RCS_datecmp (const char *date1, const char *date2); time_t RCS_getrevtime (RCSNode * rcs, const char *rev, char *date, int fudge); List *RCS_symbols (RCSNode *rcs); void RCS_check_tag (const char *tag); int RCS_valid_rev (const char *rev); List *RCS_getlocks (RCSNode *rcs); void freercsnode (RCSNode ** rnodep); char *RCS_getbranch (RCSNode *rcs, const char *tag, int force_tag_match); char *RCS_branch_head (RCSNode *rcs, char *rev); int RCS_isdead (RCSNode *, const char *); char *RCS_getexpand (RCSNode *); void RCS_setexpand (RCSNode *, const char *); int RCS_checkout (RCSNode *, const char *, const char *, const char *, const char *, const char *, RCSCHECKOUTPROC, void *); int RCS_checkin (RCSNode *rcs, const char *update_dir, const char *workfile, const char *message, const char *rev, time_t citime, int flags); int RCS_cmp_file (RCSNode *, const char *, char **, const char *, const char *, const char * ); int RCS_settag (RCSNode *, const char *, const char *); int RCS_deltag (RCSNode *, const char *); int RCS_setbranch (RCSNode *, const char *); int RCS_lock (RCSNode *, const char *, int); int RCS_unlock (RCSNode *, char *, int); int RCS_delete_revs (RCSNode *, char *, char *, int); void RCS_addaccess (RCSNode *, char *); void RCS_delaccess (RCSNode *, char *); char *RCS_getaccess (RCSNode *); void RCS_rewrite (RCSNode *, Deltatext *, char *); void RCS_abandon (RCSNode *); int rcs_change_text (const char *, char *, size_t, const char *, size_t, char **, size_t *); void RCS_deltas (RCSNode *, FILE *, struct rcsbuffer *, const char *, enum rcs_delta_op, char **, size_t *, char **, size_t *); void RCS_setincexc (void **, const char *arg); void RCS_setlocalid (const char *, unsigned int, void **, const char *arg); char *make_file_label (const char *, const char *, RCSNode *); extern bool preserve_perms; /* From import.c. */ extern int add_rcs_file (const char *, const char *, const char *, const char *, const char *, const char *, const char *, int, char **, const char *, size_t, FILE *, bool); void free_keywords (void *keywords);