1: /* Copyright (C) 2002, 2003 Free Software Foundation, Inc.
    2:    This file is part of the GNU C Library.
    3:    Contributed by Ulrich Drepper <drepper@redhat.com>, 2002.
    4: 
    5:    The GNU C Library is free software; you can redistribute it and/or
    6:    modify it under the terms of the GNU Lesser General Public
    7:    License as published by the Free Software Foundation; either
    8:    version 2.1 of the License, or (at your option) any later version.
    9: 
   10:    The GNU C Library is distributed in the hope that it will be useful,
   11:    but WITHOUT ANY WARRANTY; without even the implied warranty of
   12:    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   13:    Lesser General Public License for more details.
   14: 
   15:    You should have received a copy of the GNU Lesser General Public
   16:    License along with the GNU C Library; if not, write to the Free
   17:    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
   18:    02111-1307 USA.  */
   19: 
   20: #include <argp.h>
   21: 
   22: 
   23: 
   24: 
   25: #define OPT_TO_THREAD           300
   26: #define OPT_TO_PROCESS          301
   27: #define OPT_SYNC_SIGNAL         302
   28: #define OPT_SYNC_JOIN           303
   29: #define OPT_TOPLEVEL            304
   30: 
   31: 
   32: static const struct argp_option test_options[] =
   33:   {
   34:     { NULL, 0, NULL, 0, "\
   35: This is a test for threads so we allow ther user to selection the number of \
   36: threads which are used at any one time.  Independently the total number of \
   37: rounds can be selected.  This is the total number of threads which will have \
   38: run when the process terminates:" },
   39:     { "threads", 't', "NUMBER", 0, "Number of threads used at once" },
   40:     { "starts", 's', "NUMBER", 0, "Total number of working threads" },
   41:     { "toplevel", OPT_TOPLEVEL, "NUMBER", 0,
   42:       "Number of toplevel threads which start the other threads; this \
   43: implies --sync-join" },
   44: 
   45:     { NULL, 0, NULL, 0, "\
   46: Each thread can do one of two things: sleep or do work.  The latter is 100% \
   47: CPU bound.  The work load is the probability a thread does work.  All values \
   48: from zero to 100 (inclusive) are valid.  How often each thread repeats this \
   49: can be determined by the number of rounds.  The work cost determines how long \
   50: each work session (not sleeping) takes.  If it is zero a thread would \
   51: effectively nothing.  By setting the number of rounds to zero the thread \
   52: does no work at all and pure thread creation times can be measured." },
   53:     { "workload", 'w', "PERCENT", 0, "Percentage of time spent working" },
   54:     { "workcost", 'c', "NUMBER", 0,
   55:       "Factor in the cost of each round of working" },
   56:     { "rounds", 'r', "NUMBER", 0, "Number of rounds each thread runs" },
   57: 
   58:     { NULL, 0, NULL, 0, "\
   59: There are a number of different methods how thread creation can be \
   60: synchronized.  Synchronization is necessary since the number of concurrently \
   61: running threads is limited." },
   62:     { "sync-signal", OPT_SYNC_SIGNAL, NULL, 0,
   63:       "Synchronize using a signal (default)" },
   64:     { "sync-join", OPT_SYNC_JOIN, NULL, 0, "Synchronize using pthread_join" },
   65: 
   66:     { NULL, 0, NULL, 0, "\
   67: One parameter for each threads execution is the size of the stack.  If this \
   68: parameter is not used the system's default stack size is used.  If many \
   69: threads are used the stack size should be chosen quite small." },
   70:     { "stacksize", 'S', "BYTES", 0, "Size of threads stack" },
   71:     { "guardsize", 'g', "BYTES", 0,
   72:       "Size of stack guard area; must fit into the stack" },
   73: 
   74:     { NULL, 0, NULL, 0, "Signal options:" },
   75:     { "to-thread", OPT_TO_THREAD, NULL, 0, "Send signal to main thread" },
   76:     { "to-process", OPT_TO_PROCESS, NULL, 0,
   77:       "Send signal to process (default)" },
   78: 
   79:     { NULL, 0, NULL, 0, "Administrative options:" },
   80:     { "progress", 'p', NULL, 0, "Show signs of progress" },
   81:     { "timing", 'T', NULL, 0,
   82:       "Measure time from startup to the last thread finishing" },
   83:     { NULL, 0, NULL, 0, NULL }
   84:   };
   85: 
   86: /* Prototype for option handler.  */
   87: static error_t parse_opt (int key, char *arg, struct argp_state *state);
   88: 
   89: /* Data structure to communicate with argp functions.  */
   90: static struct argp argp =
   91: {
   92:   test_options, parse_opt
   93: };
   94: 
   95: 
   96: static int
   97: do_test (void)
   98: {
   99:   int argc = 2;
  100:   char *argv[3] = { (char *) "tst-argp1", (char *) "--help", NULL };
  101:   int remaining;
  102: 
  103:   /* Parse and process arguments.  */
  104:   argp_parse (&argp, argc, argv, 0, &remaining, NULL);
  105: 
  106:   return 0;
  107: }
  108: 
  109: 
  110: /* Handle program arguments.  */
  111: static error_t
  112: parse_opt (int key, char *arg, struct argp_state *state)
  113: {
  114:   return ARGP_ERR_UNKNOWN;
  115: }
  116: 
  117: #define TEST_FUNCTION do_test ()
  118: #include "../test-skeleton.c"