/*++
/* NAME
/* test_main 3
/* SUMMARY
/* test main program
/* SYNOPSIS
/* #include <test_main.h>
/*
/* NORETURN test_main(argc, argv, test_driver, key, value, ...)
/* int argc;
/* char **argv;
/* void (*test_driver)(int argc, char **argv);
/* int key;
/* DESCRIPTION
/* This module implements a test main program for stand-alone
/* module tests.
/*
/* test_main() should be called from a main program. It does
/* generic command-line options processing, and initializes
/* configurable parameters. After calling the test_driver()
/* function, the test_main() function terminates.
/*
/* Arguments:
/* .IP "void (*test_driver)(int argc, char **argv)"
/* A pointer to a function that is called after processing
/* command-line options and initializing configuration parameters.
/* The argc and argv specify the process name and non-option
/* command-line arguments.
/* .PP
/* Optional test_main() arguments are specified as a null-terminated
/* list with macros that have zero or more arguments:
/* .IP "CA_TEST_MAIN_INT_TABLE(CONFIG_INT_TABLE *)"
/* A table with configurable parameters, to be loaded from the
/* global Postfix configuration file. Tables are loaded in the
/* order as specified, and multiple instances of the same type
/* are allowed.
/* .IP "CA_TEST_MAIN_LONG_TABLE(CONFIG_LONG_TABLE *)"
/* A table with configurable parameters, to be loaded from the
/* global Postfix configuration file. Tables are loaded in the
/* order as specified, and multiple instances of the same type
/* are allowed.
/* .IP "CA_TEST_MAIN_STR_TABLE(CONFIG_STR_TABLE *)"
/* A table with configurable parameters, to be loaded from the
/* global Postfix configuration file. Tables are loaded in the
/* order as specified, and multiple instances of the same type
/* are allowed.
/* .IP "CA_TEST_MAIN_BOOL_TABLE(CONFIG_BOOL_TABLE *)"
/* A table with configurable parameters, to be loaded from the
/* global Postfix configuration file. Tables are loaded in the
/* order as specified, and multiple instances of the same type
/* are allowed.
/* .IP "CA_TEST_MAIN_TIME_TABLE(CONFIG_TIME_TABLE *)"
/* A table with configurable parameters, to be loaded from the
/* global Postfix configuration file. Tables are loaded in the
/* order as specified, and multiple instances of the same type
/* are allowed.
/* .IP "CA_TEST_MAIN_RAW_TABLE(CONFIG_RAW_TABLE *)"
/* A table with configurable parameters, to be loaded from the
/* global Postfix configuration file. Tables are loaded in the
/* order as specified, and multiple instances of the same type
/* are allowed. Raw parameters are not subjected to $name
/* evaluation.
/* .IP "CA_TEST_MAIN_NINT_TABLE(CONFIG_NINT_TABLE *)"
/* A table with configurable parameters, to be loaded from the
/* global Postfix configuration file. Tables are loaded in the
/* order as specified, and multiple instances of the same type
/* are allowed.
/* .IP "CA_TEST_MAIN_NBOOL_TABLE(CONFIG_NBOOL_TABLE *)"
/* A table with configurable parameters, to be loaded from the
/* global Postfix configuration file. Tables are loaded in the
/* order as specified, and multiple instances of the same type
/* are allowed.
/* DIAGNOSTICS
/* Problems and transactions are logged stderr.
/* BUGS
/* 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
/*
/* Wietse Venema
/* Google, Inc.
/* 111 8th Avenue
/* New York, NY 10011, USA
/*--*/

 /*
  * System library.
  */
#include <sys_defs.h>
#include <stdlib.h>

 /*
  * Utility library.
  */
#include <dict.h>
#include <msg.h>
#include <msg_vstream.h>
#include <mymalloc.h>
#include <stringops.h>

 /*
  * Global library.
  */
#include <mail_params.h>
#include <mail_conf.h>
#include <mail_dict.h>
#include <mail_task.h>
#include <mail_version.h>

 /*
  * Test library.
  */
#include <test_main.h>

/* test_driver_main - the real main program */

NORETURN test_main(int argc, char **argv, TEST_DRIVER_FN test_driver,...)
{
    const char *myname = "test_driver_main";
    va_list ap;
    int     ch;
    int     key;
    int     test_driver_argc;
    char  **test_driver_argv;

    /*
     * Set up logging.
     */
    var_procname = mystrdup(basename(argv[0]));
    msg_vstream_init(mail_task(var_procname), VSTREAM_ERR);

    /*
     * Check the Postfix library version as soon as we enable logging.
     */
    MAIL_VERSION_CHECK;

    /*
     * Parse JCL.
     */
    while ((ch = GETOPT(argc, argv, "c:v")) > 0) {
 switch (ch) {
 case 'c':
     if (setenv(CONF_ENV_PATH, optarg, 1) < 0)
  msg_fatal("out of memory");
     break;
 case 'v':
     msg_verbose++;
     break;
 default:
     msg_fatal("invalid option: %c. Usage: %s [-c config_dir] [-v]",
        optopt, argv[0]);
     break;
 }
    }

    /*
     * Initialize generic parameters.
     */
    set_mail_conf_str(VAR_PROCNAME, var_procname);
    set_mail_conf_str(VAR_SERVNAME, var_procname);
    mail_conf_read();

    /*
     * Register higher-level dictionaries and initialize the support for
     * dynamically-loaded dictionaries.
     */
    mail_dict_init();

    /*
     * Application-specific initialization.
     */
    va_start(ap, test_driver);
    while ((key = va_arg(ap, int)) != 0) {
 switch (key) {
 case TEST_MAIN_INT_TABLE:
     get_mail_conf_int_table(va_arg(ap, CONFIG_INT_TABLE *));
     break;
 case TEST_MAIN_LONG_TABLE:
     get_mail_conf_long_table(va_arg(ap, CONFIG_LONG_TABLE *));
     break;
 case TEST_MAIN_STR_TABLE:
     get_mail_conf_str_table(va_arg(ap, CONFIG_STR_TABLE *));
     break;
 case TEST_MAIN_BOOL_TABLE:
     get_mail_conf_bool_table(va_arg(ap, CONFIG_BOOL_TABLE *));
     break;
 case TEST_MAIN_TIME_TABLE:
     get_mail_conf_time_table(va_arg(ap, CONFIG_TIME_TABLE *));
     break;
 case TEST_MAIN_RAW_TABLE:
     get_mail_conf_raw_table(va_arg(ap, CONFIG_RAW_TABLE *));
     break;
 case TEST_MAIN_NINT_TABLE:
     get_mail_conf_nint_table(va_arg(ap, CONFIG_NINT_TABLE *));
     break;
 case TEST_MAIN_NBOOL_TABLE:
     get_mail_conf_nbool_table(va_arg(ap, CONFIG_NBOOL_TABLE *));
     break;
 default:
     msg_panic("%s: unknown argument type: %d", myname, key);
 }
    }
    va_end(ap);

    /*
     * Set up call-back info.
     */
    test_driver_argv = argv + optind - 1;
    if (test_driver_argv != argv)
 test_driver_argv[0] = argv[0];
    test_driver_argc = argc - optind + 1;

    /*
     * Call the test driver and terminate (if they didn't terminate already).
     */
    test_driver(test_driver_argc, test_driver_argv);
    exit(0);
}