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

source code of glibc/argp/tst-argp1.c