1 /* Test program for argp argument parser
2 Copyright (C) 1997-2020 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
4 Written by Miles Bader <miles@gnu.ai.mit.edu>.
6 The GNU C Library is free software; you can redistribute it and/or
7 modify it under the terms of the GNU Lesser General Public
8 License as published by the Free Software Foundation; either
9 version 2.1 of the License, or (at your option) any later version.
11 The GNU C Library is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 Lesser General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public
17 License along with the GNU C Library; if not, see
18 <https://www.gnu.org/licenses/>. */
29 const char *argp_program_version = "argp-test 1.0";
31 struct argp_option sub_options[] =
33 {"subopt1", 's', 0, 0, "Nested option 1"},
34 {"subopt2", 'S', 0, 0, "Nested option 2"},
36 { 0, 0, 0, 0, "Some more nested options:", 10},
37 {"subopt3", 'p', 0, 0, "Nested option 3"},
39 {"subopt4", 'q', 0, 0, "Nested option 4", 1},
44 static const char sub_args_doc[] = "STRING...\n-";
45 static const char sub_doc[] = "\vThis is the doc string from the sub-arg-parser.";
48 sub_parse_opt (int key, char *arg, struct argp_state *state)
52 case ARGP_KEY_NO_ARGS:
53 printf ("NO SUB ARGS\n");
56 printf ("SUB ARG: %s\n", arg);
59 case 's' : case 'S': case 'p': case 'q':
60 printf ("SUB KEY %c\n", key);
64 return ARGP_ERR_UNKNOWN;
70 sub_help_filter (int key, const char *text, void *input)
72 if (key == ARGP_KEY_HELP_EXTRA)
73 return strdup ("This is some extra text from the sub parser (note that it \
74 is preceded by a blank line).");
79 static struct argp sub_argp = {
80 sub_options, sub_parse_opt, sub_args_doc, sub_doc, 0, sub_help_filter
83 /* Structure used to communicate with the parsing functions. */
86 unsigned foonly; /* Value parsed for foonly. */
87 unsigned foonly_default; /* Default value for it. */
93 struct argp_option options[] =
95 {"pid", 'p', "PID", 0, "List the process PID"},
96 {"pgrp", OPT_PGRP,"PGRP",0, "List processes in the process group PGRP"},
97 {"no-parent", 'P', 0, 0, "Include processes without parents"},
98 {0, 'x', 0, OPTION_ALIAS},
99 {"all-fields",'Q', 0, 0, "Don't elide unusable fields (normally"
100 " if there's some reason ps can't"
101 " print a field for any process, it's"
102 " removed from the output entirely)" },
103 {"reverse", 'r', 0, 0, "Reverse the order of any sort"},
104 {"gratuitously-long-reverse-option", 0, 0, OPTION_ALIAS},
105 {"session", OPT_SESS,"SID", OPTION_ARG_OPTIONAL,
106 "Add the processes from the session"
107 " SID (which defaults to the sid of"
108 " the current process)" },
110 {0,0,0,0, "Here are some more options:"},
111 {"foonly", 'f', "ZOT", OPTION_ARG_OPTIONAL, "Glork a foonly"},
112 {"zaza", 'z', 0, 0, "Snit a zar"},
117 static const char args_doc[] = "STRING";
118 static const char doc[] = "Test program for argp."
119 "\vThis doc string comes after the options."
120 "\nHey! Some manual formatting!"
121 "\nThe current time is: %s";
124 popt (int key, char *arg)
128 sprintf (buf, "%c", key);
130 sprintf (buf, "%d", key);
132 printf ("KEY %s: %s\n", buf, arg);
134 printf ("KEY %s\n", buf);
138 parse_opt (int key, char *arg, struct argp_state *state)
140 struct params *params = state->input;
144 case ARGP_KEY_NO_ARGS:
145 printf ("NO ARGS\n");
149 if (state->arg_num > 0)
150 return ARGP_ERR_UNKNOWN; /* Leave it for the sub-arg parser. */
151 printf ("ARG: %s\n", arg);
156 params->foonly = atoi (arg);
158 params->foonly = params->foonly_default;
162 case 'p': case 'P': case OPT_PGRP: case 'x': case 'Q':
163 case 'r': case OPT_SESS: case 'z':
168 return ARGP_ERR_UNKNOWN;
174 help_filter (int key, const char *text, void *input)
177 struct params *params = input;
179 if (key == ARGP_KEY_HELP_POST_DOC && text)
181 time_t now = time (0);
182 asprintf (&new_text, text, ctime (&now));
185 /* Show the default for the --foonly option. */
186 asprintf (&new_text, "%s (ZOT defaults to %x)",
187 text, params->foonly_default);
189 new_text = (char *)text;
194 static struct argp_child argp_children[] = { { &sub_argp }, { 0 } };
195 static struct argp argp = {
196 options, parse_opt, args_doc, doc, argp_children, help_filter
200 main (int argc, char **argv)
202 struct params params;
204 params.foonly_default = random ();
205 argp_parse (&argp, argc, argv, 0, 0, ¶ms);
206 printf ("After parsing: foonly = %x\n", params.foonly);