dsn_util.c

[詳解]

/*++
/* NAME
/*  dsn_util 3
/* SUMMARY
/*  DSN status parsing routines
/* SYNOPSIS
/*  #include <dsn_util.h>
/*
/*  #define DSN_SIZE ...
/*
/*  typedef struct { ... } DSN_BUF;
/*
/*  typedef struct {
/* .in +4
/*      DSN_STAT dsn;       /* RFC 3463 status */
/*      const char *text;   /* Free text */
/* .in -4
/*  } DSN_SPLIT;
/*
/*  DSN_SPLIT *dsn_split(dp, def_dsn, text)
/*  DSN_SPLIT *dp;
/*  const char *def_dsn;
/*  const char *text;
/*
/*  char    *dsn_prepend(def_dsn, text)
/*  const char *def_dsn;
/*  const char *text;
/*
/*  size_t  dsn_valid(text)
/*  const char *text;
/*
/*  void    DSN_UPDATE(dsn_buf, dsn, len)
/*  DSN_BUF dsn_buf;
/*  const char *dsn;
/*  size_t  len;
/*
/*  const char *DSN_CODE(dsn_buf)
/*  DSN_BUF dsn_buf;
/*
/*  char    *DSN_CLASS(dsn_buf)
/*  DSN_BUF dsn_buf;
/* DESCRIPTION
/*  The functions in this module manipulate pairs of RFC 3463
/*  status codes and descriptive free text.
/*
/*  dsn_split() splits text into an RFC 3463 status code and
/*  descriptive free text.  When the text does not start with
/*  a status code, the specified default status code is used
/*  instead.  Whitespace before the optional status code or
/*  text is skipped.  dsn_split() returns a copy of the RFC
/*  3463 status code, and returns a pointer to (not copy of)
/*  the remainder of the text.  The result value is the first
/*  argument.
/*
/*  dsn_prepend() prepends the specified default RFC 3463 status
/*  code to the specified text if no status code is present in
/*  the text. This function produces the same result as calling
/*  concatenate() with the results from dsn_split().  The result
/*  should be passed to myfree(). Whitespace before the optional
/*  status code or text is skipped.
/*
/*  dsn_valid() returns the length of the RFC 3463 status code
/*  at the beginning of text, or zero. It does not skip initial
/*  whitespace.
/*
/*  Arguments:
/* .IP def_dsn
/*  Null-terminated default RFC 3463 status code that will be
/*  used when the free text does not start with one.
/* .IP dp
/*  Pointer to storage for copy of DSN status code, and for
/*  pointer to free text.
/* .IP dsn
/*  Null-terminated RFC 3463 status code.
/* .IP text
/*  Null-terminated free text.
/* SEE ALSO
/*  msg(3) diagnostics interface
/* DIAGNOSTICS
/*  Panic: invalid default DSN code.
/* LICENSE
/* .ad
/* .fi
/*  The Secure Mailer license must be distributed with this software.
/* AUTHOR(S)
/*  Wietse Venema
/*  IBM T.J. Watson Research
/*  P.O. Box 704
/*  Yorktown Heights, NY 10598, USA
/*--*/

/* System library. */

#include <sys_defs.h>
#include <stdarg.h>
#include <string.h>
#include <ctype.h>

/* Utility library. */

#include <msg.h>
#include <mymalloc.h>
#include <vstring.h>
#include <stringops.h>

/* Global library. */

#include <dsn_util.h>

/* dsn_valid - check RFC 3463 enhanced status code, return length or zero */

size_t  dsn_valid(const char *text)
{
    const unsigned char *cp = (unsigned char *) text;
    size_t  len;

    /* First portion is one digit followed by dot. */
    if ((cp[0] != '2' && cp[0] != '4' && cp[0] != '5') || cp[1] != '.')
    return (0);

    /* Second portion is 1-3 digits followed by dot. */
    cp += 2;
    if ((len = strspn((char *) cp, "0123456789")) < 1 || len > DSN_DIGS2
    || cp[len] != '.')
    return (0);

    /* Last portion is 1-3 digits followed by end-of-string or whitespace. */
    cp += len + 1;
    if ((len = strspn((char *) cp, "0123456789")) < 1 || len > DSN_DIGS3
    || (cp[len] != 0 && !ISSPACE(cp[len])))
    return (0);

    return (((char *) cp - text) + len);
}

/* dsn_split - split text into DSN and text */

DSN_SPLIT *dsn_split(DSN_SPLIT *dp, const char *def_dsn, const char *text)
{
    const char *myname = "dsn_split";
    const char *cp = text;
    size_t  len;

    /*
     * Look for an optional RFC 3463 enhanced status code.
     * 
     * XXX If we want to enforce that the first digit of the status code in the
     * text matches the default status code, then pipe_command() needs to be
     * changed. It currently auto-detects the reply code without knowing in
     * advance if the result will start with '4' or '5'.
     */
    while (ISSPACE(*cp))
    cp++;
    if ((len = dsn_valid(cp)) > 0) {
    strncpy(dp->dsn.data, cp, len);
    dp->dsn.data[len] = 0;
    cp += len + 1;
    } else if ((len = dsn_valid(def_dsn)) > 0) {
    strncpy(dp->dsn.data, def_dsn, len);
    dp->dsn.data[len] = 0;
    } else {
    msg_panic("%s: bad default status \"%s\"", myname, def_dsn);
    }

    /*
     * The remainder is free text.
     */
    while (ISSPACE(*cp))
    cp++;
    dp->text = cp;

    return (dp);
}

/* dsn_prepend - prepend optional status to text, result on heap */

char   *dsn_prepend(const char *def_dsn, const char *text)
{
    DSN_SPLIT dp;

    dsn_split(&dp, def_dsn, text);
    return (concatenate(DSN_STATUS(dp.dsn), " ", dp.text, (char *) 0));
}