Sync usage with man page.

[netbsd-mini2440.git] / external / gpl2 / xcvs / dist / src / wrapper.c

/* This program 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.

   This program 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.  */

#include "cvs.h"
#include "getline.h"

/*
  Original Author:  athan@morgan.com <Andrew C. Athan> 2/1/94
  Modified By:      vdemarco@bou.shl.com

  This package was written to support the NEXTSTEP concept of
  "wrappers."  These are essentially directories that are to be
  treated as "files."  This package allows such wrappers to be
  "processed" on the way in and out of CVS.  The intended use is to
  wrap up a wrapper into a single tar, such that that tar can be
  treated as a single binary file in CVS.  To solve the problem
  effectively, it was also necessary to be able to prevent rcsmerge
  application at appropriate times.

  ------------------
  Format of wrapper file ($CVSROOT/CVSROOT/cvswrappers or .cvswrappers)

  wildcard      [option value][option value]...

  where option is one of
  -m            update methodology      value: MERGE or COPY
  -k            default -k rcs option to use on import or add

  and value is a single-quote delimited value.

  E.g:
  *.nib         -f 'gunzipuntar' -t 'targzip' -m 'COPY'
*/


typedef struct {
    char *wildCard;
    char *tocvsFilter;
    char *fromcvsFilter;
    char *rcsOption;
    WrapMergeMethod mergeMethod;
} WrapperEntry;

static WrapperEntry **wrap_list=NULL;
static WrapperEntry **wrap_saved_list=NULL;

static int wrap_size=0;
static int wrap_count=0;
static int wrap_tempcount=0;

/* FIXME: the relationship between wrap_count, wrap_tempcount,
 * wrap_saved_count, and wrap_saved_tempcount is not entirely clear;
 * it is certainly suspicious that wrap_saved_count is never set to a
 * value other than zero!  If the variable isn't being used, it should
 * be removed.  And in general, we should describe how temporary
 * vs. permanent wrappers are implemented, and then make sure the
 * implementation is actually doing that.
 *
 * Right now things seem to be working, but that's no guarantee there
 * isn't a bug lurking somewhere in the murk.
 */

static int wrap_saved_count=0;

static int wrap_saved_tempcount=0;

#define WRAPPER_GROW    8

void wrap_add_entry (WrapperEntry *e,int temp);
void wrap_kill (void);
void wrap_kill_temp (void);
void wrap_free_entry (WrapperEntry *e);
void wrap_free_entry_internal (WrapperEntry *e);
void wrap_restore_saved (void);

void wrap_setup(void)
{
    /* FIXME-reentrancy: if we do a multithreaded server, will need to
       move this to a per-connection data structure, or better yet
       think about a cleaner solution.  */
    static int wrap_setup_already_done = 0;
    char *homedir;

    if (wrap_setup_already_done != 0)
        return;
    else
        wrap_setup_already_done = 1;

    if (!current_parsed_root->isremote)
    {
        char *file;

        /* Then add entries found in repository, if it exists.  */
        file = Xasprintf ("%s/%s/%s", current_parsed_root->directory,
                          CVSROOTADM, CVSROOTADM_WRAPPER);
        if (isfile (file))
        {
            wrap_add_file(file,0);
        }
        free (file);
    }

    /* Then add entries found in home dir, (if user has one) and file
       exists.  */
    homedir = get_homedir ();
    /* If we can't find a home directory, ignore ~/.cvswrappers.  This may
       make tracking down problems a bit of a pain, but on the other
       hand it might be obnoxious to complain when CVS will function
       just fine without .cvswrappers (and many users won't even know what
       .cvswrappers is).  */
    if (homedir != NULL)
    {
        char *file = strcat_filename_onto_homedir (homedir, CVSDOTWRAPPER);
        if (isfile (file))
        {
            wrap_add_file (file, 0);
        }
        free (file);
    }

    /* FIXME: calling wrap_add() below implies that the CVSWRAPPERS
     * environment variable contains exactly one "wrapper" -- a line
     * of the form
     * 
     *    FILENAME_PATTERN      FLAG  OPTS [ FLAG OPTS ...]
     *
     * This may disagree with the documentation, which states:
     * 
     *   `$CVSWRAPPERS'
     *      A whitespace-separated list of file name patterns that CVS
     *      should treat as wrappers. *Note Wrappers::.
     *
     * Does this mean the environment variable can hold multiple
     * wrappers lines?  If so, a single call to wrap_add() is
     * insufficient.
     */

    /* Then add entries found in CVSWRAPPERS environment variable. */
    wrap_add (getenv (WRAPPER_ENV), 0);
}

#ifdef CLIENT_SUPPORT
/* Send -W arguments for the wrappers to the server.  The command must
   be one that accepts them (e.g. update, import).  */
void
wrap_send (void)
{
    int i;

    for (i = 0; i < wrap_count + wrap_tempcount; ++i)
    {
        if (wrap_list[i]->tocvsFilter != NULL
            || wrap_list[i]->fromcvsFilter != NULL)
            /* For greater studliness we would print the offending option
               and (more importantly) where we found it.  */
            error (0, 0, "\
-t and -f wrapper options are not supported remotely; ignored");
        if (wrap_list[i]->mergeMethod == WRAP_COPY)
            /* For greater studliness we would print the offending option
               and (more importantly) where we found it.  */
            error (0, 0, "\
-m wrapper option is not supported remotely; ignored");
        send_to_server ("Argument -W\012Argument ", 0);
        send_to_server (wrap_list[i]->wildCard, 0);
        send_to_server (" -k '", 0);
        if (wrap_list[i]->rcsOption != NULL)
            send_to_server (wrap_list[i]->rcsOption, 0);
        else
            send_to_server ("kv", 0);
        send_to_server ("'\012", 0);
    }
}
#endif /* CLIENT_SUPPORT */

#if defined(SERVER_SUPPORT) || defined(CLIENT_SUPPORT)
/* Output wrapper entries in the format of cvswrappers lines.
 *
 * This is useful when one side of a client/server connection wants to
 * send its wrappers to the other; since the receiving side would like
 * to use wrap_add() to incorporate the wrapper, it's best if the
 * entry arrives in this format.
 *
 * The entries are stored in `line', which is allocated here.  Caller
 * can free() it.
 *
 * If first_call_p is nonzero, then start afresh.  */
void
wrap_unparse_rcs_options (char **line, int first_call_p)
{
    /* FIXME-reentrancy: we should design a reentrant interface, like
       a callback which gets handed each wrapper (a multithreaded
       server being the most concrete reason for this, but the
       non-reentrant interface is fairly unnecessary/ugly).  */
    static int i;

    if (first_call_p)
        i = 0;

    if (i >= wrap_count + wrap_tempcount) {
        *line = NULL;
        return;
    }

    *line = Xasprintf ("%s -k '%s'",
                       wrap_list[i]->wildCard,
                       wrap_list[i]->rcsOption
                       ? wrap_list[i]->rcsOption : "kv");
    ++i;
}
#endif /* SERVER_SUPPORT || CLIENT_SUPPORT */

/*
 * Remove fmt str specifier other than %% or %s. And allow
 * only max_s %s specifiers
 */
static void
wrap_clean_fmt_str(char *fmt, int max_s)
{
    while (*fmt) {
        if (fmt[0] == '%' && fmt[1])
        {
            if (fmt[1] == '%') 
                fmt++;
            else
                if (fmt[1] == 's' && max_s > 0)
                {
                    max_s--;
                    fmt++;
                } else 
                    *fmt = ' ';
        }
        fmt++;
    }
}

/*
 * Open a file and read lines, feeding each line to a line parser. Arrange
 * for keeping a temporary list of wrappers at the end, if the "temp"
 * argument is set.
 */
void
wrap_add_file (const char *file, int temp)
{
    FILE *fp;
    char *line = NULL;
    size_t line_allocated = 0;

    wrap_restore_saved ();
    wrap_kill_temp ();

    /* Load the file.  */
    fp = CVS_FOPEN (file, "r");
    if (fp == NULL)
    {
        if (!existence_error (errno))
            error (0, errno, "cannot open %s", file);
        return;
    }
    while (getline (&line, &line_allocated, fp) >= 0)
        wrap_add (line, temp);
    if (line)
        free (line);
    if (ferror (fp))
        error (0, errno, "cannot read %s", file);
    if (fclose (fp) == EOF)
        error (0, errno, "cannot close %s", file);
}

void
wrap_kill(void)
{
    wrap_kill_temp();
    while(wrap_count)
        wrap_free_entry(wrap_list[--wrap_count]);
}

void
wrap_kill_temp(void)
{
    WrapperEntry **temps=wrap_list+wrap_count;

    while(wrap_tempcount)
        wrap_free_entry(temps[--wrap_tempcount]);
}

void
wrap_free_entry(WrapperEntry *e)
{
    wrap_free_entry_internal(e);
    free(e);
}

void
wrap_free_entry_internal(WrapperEntry *e)
{
    free (e->wildCard);
    if (e->tocvsFilter)
        free (e->tocvsFilter);
    if (e->fromcvsFilter)
        free (e->fromcvsFilter);
    if (e->rcsOption)
        free (e->rcsOption);
}

void
wrap_restore_saved(void)
{
    if(!wrap_saved_list)
        return;

    wrap_kill();

    free(wrap_list);

    wrap_list=wrap_saved_list;
    wrap_count=wrap_saved_count;
    wrap_tempcount=wrap_saved_tempcount;

    wrap_saved_list=NULL;
    wrap_saved_count=0;
    wrap_saved_tempcount=0;
}

void
wrap_add (char *line, int isTemp)
{
    char *temp;
    char ctemp;
    WrapperEntry e;
    char opt;

    if (!line || line[0] == '#')
        return;

    memset (&e, 0, sizeof(e));

        /* Search for the wild card */
    while (*line && isspace ((unsigned char) *line))
        ++line;
    for (temp = line;
         *line && !isspace ((unsigned char) *line);
         ++line)
        ;
    if(temp==line)
        return;

    ctemp=*line;
    *line='\0';

    e.wildCard=xstrdup(temp);
    *line=ctemp;

    while(*line){
            /* Search for the option */
        while(*line && *line!='-')
            ++line;
        if(!*line)
            break;
        ++line;
        if(!*line)
            break;
        opt=*line;

            /* Search for the filter commandline */
        for(++line;*line && *line!='\'';++line);
        if(!*line)
            break;

        for(temp=++line;*line && (*line!='\'' || line[-1]=='\\');++line)
            ;

        /* This used to "break;" (ignore the option) if there was a
           single character between the single quotes (I'm guessing
           that was accidental).  Now it "break;"s if there are no
           characters.  I'm not sure either behavior is particularly
           necessary--the current options might not require ''
           arguments, but surely some future option legitimately
           might.  Also I'm not sure that ignoring the option is a
           swift way to handle syntax errors in general.  */
        if (line==temp)
            break;

        ctemp=*line;
        *line='\0';
        switch(opt){
        case 'f':
            /* Before this is reenabled, need to address the problem in
               commit.c (see
               <http://ximbiot.com/cvs/cvshome/docs/infowrapper.html>).  */
            error (1, 0,
                   "-t/-f wrappers not supported by this version of CVS");

            if(e.fromcvsFilter)
                free(e.fromcvsFilter);
            /* FIXME: error message should say where the bad value
               came from.  */
            e.fromcvsFilter =
              expand_path (temp, current_parsed_root->directory, false,
                           "<wrapper>", 0);
            if (!e.fromcvsFilter)
                error (1, 0, "Correct above errors first");
            break;
        case 't':
            /* Before this is reenabled, need to address the problem in
               commit.c (see
               <http://ximbiot.com/cvs/cvshome/docs/infowrapper.html>).  */
            error (1, 0,
                   "-t/-f wrappers not supported by this version of CVS");

            if(e.tocvsFilter)
                free(e.tocvsFilter);
            /* FIXME: error message should say where the bad value
               came from.  */
            e.tocvsFilter = expand_path (temp, current_parsed_root->directory,
                                         false, "<wrapper>", 0);
            if (!e.tocvsFilter)
                error (1, 0, "Correct above errors first");
            break;
        case 'm':
            if(*temp=='C' || *temp=='c')
                e.mergeMethod=WRAP_COPY;
            else
                e.mergeMethod=WRAP_MERGE;
            break;
        case 'k':
            if (e.rcsOption)
                free (e.rcsOption);
            e.rcsOption = strcmp (temp, "kv") ? xstrdup (temp) : NULL;
            break;
        default:
            break;
        }
        *line=ctemp;
        if(!*line)break;
        ++line;
    }

    wrap_add_entry(&e, isTemp);
}

void
wrap_add_entry (WrapperEntry *e, int temp)
{
    int x;
    if (wrap_count + wrap_tempcount >= wrap_size)
    {
        wrap_size += WRAPPER_GROW;
        wrap_list = xnrealloc (wrap_list, wrap_size, sizeof (WrapperEntry *));
    }

    if (!temp && wrap_tempcount)
    {
        for (x = wrap_count + wrap_tempcount - 1; x >= wrap_count; --x)
            wrap_list[x + 1] = wrap_list[x];
    }

    x = (temp ? wrap_count + (wrap_tempcount++) : (wrap_count++));
    wrap_list[x] = xmalloc (sizeof (WrapperEntry));
    *wrap_list[x] = *e;
}

/* Return 1 if the given filename is a wrapper filename */
int
wrap_name_has (const char *name, WrapMergeHas has)
{
    int x,count=wrap_count+wrap_tempcount;
    char *temp;

    for(x=0;x<count;++x)
        if (CVS_FNMATCH (wrap_list[x]->wildCard, name, 0) == 0){
            switch(has){
            case WRAP_TOCVS:
                temp=wrap_list[x]->tocvsFilter;
                break;
            case WRAP_FROMCVS:
                temp=wrap_list[x]->fromcvsFilter;
                break;
            case WRAP_RCSOPTION:
                temp = wrap_list[x]->rcsOption;
                break;
            default:
                abort ();
            }
            if(temp==NULL)
                return (0);
            else
                return (1);
        }
    return (0);
}

static WrapperEntry *wrap_matching_entry (const char *);

static WrapperEntry *
wrap_matching_entry (const char *name)
{
    int x,count=wrap_count+wrap_tempcount;

    for(x=0;x<count;++x)
        if (CVS_FNMATCH (wrap_list[x]->wildCard, name, 0) == 0)
            return wrap_list[x];
    return NULL;
}

/* Return the RCS options for FILENAME in a newly malloc'd string.  If
   ASFLAG, then include "-k" at the beginning (e.g. "-kb"), otherwise
   just give the option itself (e.g. "b").  */
char *
wrap_rcsoption (const char *filename, int asflag)
{
    WrapperEntry *e = wrap_matching_entry (filename);

    if (e == NULL || e->rcsOption == NULL || (*e->rcsOption == '\0'))
        return NULL;

    return Xasprintf ("%s%s", asflag ? "-k" : "", e->rcsOption);
}

char *
wrap_tocvs_process_file(const char *fileName)
{
    WrapperEntry *e=wrap_matching_entry(fileName);
    static char *buf = NULL;
    char *args;

    if(e==NULL || e->tocvsFilter==NULL)
        return NULL;

    if (buf != NULL)
        free (buf);
    buf = cvs_temp_name ();

    wrap_clean_fmt_str (e->tocvsFilter, 2);
    args = Xasprintf (e->tocvsFilter, fileName, buf);
    run_setup (args);
    run_exec (RUN_TTY, RUN_TTY, RUN_TTY, RUN_NORMAL | RUN_REALLY );
    free (args);

    return buf;
}

int
wrap_merge_is_copy (const char *fileName)
{
    WrapperEntry *e=wrap_matching_entry(fileName);
    if(e==NULL || e->mergeMethod==WRAP_MERGE)
        return 0;

    return 1;
}

void
wrap_fromcvs_process_file(const char *fileName)
{
    char *args;
    WrapperEntry *e = wrap_matching_entry(fileName);

    if (e != NULL && e->fromcvsFilter != NULL)
    {
        wrap_clean_fmt_str (e->fromcvsFilter, 1);
        args = Xasprintf (e->fromcvsFilter, fileName);
        run_setup (args);
        run_exec (RUN_TTY, RUN_TTY, RUN_TTY, RUN_NORMAL);
        free (args);
    }
    return;
}