[6974a34] | 1 | /* cmdline.c |
---|
[aadc86e] | 2 | * Wrapper for GNU getopt which deals with standard options |
---|
[736f7df] | 3 | * Copyright (C) 1998-2001,2003,2004,2011,2012,2014 Olly Betts |
---|
[846746e] | 4 | * |
---|
[89231c4] | 5 | * This program is free software; you can redistribute it and/or modify |
---|
| 6 | * it under the terms of the GNU General Public License as published by |
---|
| 7 | * the Free Software Foundation; either version 2 of the License, or |
---|
| 8 | * (at your option) any later version. |
---|
[846746e] | 9 | * |
---|
| 10 | * This program is distributed in the hope that it will be useful, |
---|
| 11 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
[89231c4] | 12 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
---|
| 13 | * GNU General Public License for more details. |
---|
[846746e] | 14 | * |
---|
[89231c4] | 15 | * You should have received a copy of the GNU General Public License |
---|
| 16 | * along with this program; if not, write to the Free Software |
---|
[ecbc6c18] | 17 | * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA |
---|
[aadc86e] | 18 | */ |
---|
| 19 | |
---|
| 20 | #include <config.h> |
---|
| 21 | |
---|
| 22 | #include <ctype.h> |
---|
[3b9ec3f] | 23 | #include <errno.h> |
---|
[dd6f74e] | 24 | #include <float.h> |
---|
[aadc86e] | 25 | #include <stdio.h> |
---|
[e05bdb8] | 26 | #include <string.h> |
---|
[f2122f0] | 27 | #include <limits.h> |
---|
[aadc86e] | 28 | |
---|
[be97baf] | 29 | #include "getopt.h" |
---|
| 30 | |
---|
[aadc86e] | 31 | #include "cmdline.h" |
---|
[45af761] | 32 | #include "debug.h" |
---|
[e05bdb8] | 33 | #include "filename.h" |
---|
[aadc86e] | 34 | |
---|
[d227ee5] | 35 | #include "message.h" |
---|
| 36 | |
---|
[aadc86e] | 37 | /* It might be useful to be able to disable all long options on small |
---|
[175cac6] | 38 | * platforms like older PDAs. |
---|
[aadc86e] | 39 | */ |
---|
| 40 | #if 0 |
---|
| 41 | # define getopt_long(ARGC, ARGV, STR, OPTS, PTR) getopt(ARGC, ARGV, STR) |
---|
| 42 | #endif |
---|
| 43 | |
---|
| 44 | /* |
---|
| 45 | * bad command line give: |
---|
| 46 | * <problem> |
---|
[cb3d1e2] | 47 | * |
---|
[e05bdb8] | 48 | * <short syntax> |
---|
[cb3d1e2] | 49 | * |
---|
[aadc86e] | 50 | * --help gives: |
---|
| 51 | * <version> |
---|
[cb3d1e2] | 52 | * |
---|
[aadc86e] | 53 | * <short syntax> |
---|
| 54 | * |
---|
| 55 | * <table> |
---|
[cb3d1e2] | 56 | * |
---|
[aadc86e] | 57 | * <blurb> |
---|
| 58 | * |
---|
| 59 | * --version gives: |
---|
| 60 | * <version> |
---|
| 61 | */ |
---|
| 62 | |
---|
| 63 | /* |
---|
| 64 | * want to cope with optional/required parameters on long options |
---|
| 65 | * and also parameters on short options |
---|
[3b9ec3f] | 66 | */ |
---|
[aadc86e] | 67 | |
---|
| 68 | static const char newline_tabs[] = "\n\t\t\t\t"; |
---|
| 69 | |
---|
[3b9ec3f] | 70 | static int argc; |
---|
[647407d] | 71 | static char * const *argv; |
---|
[3b9ec3f] | 72 | static const char *shortopts; |
---|
| 73 | static const struct option *longopts; |
---|
| 74 | static int *longind; |
---|
| 75 | static const struct help_msg *help; |
---|
| 76 | static int min_args, max_args; |
---|
[d8dbdff] | 77 | static int msg_args, msg_extra; |
---|
| 78 | static const char * msg_extra_arg; |
---|
[3b9ec3f] | 79 | |
---|
| 80 | void |
---|
| 81 | cmdline_help(void) |
---|
[aadc86e] | 82 | { |
---|
[9e513bd3] | 83 | while (help && help->opt) { |
---|
[aadc86e] | 84 | const char *longopt = 0; |
---|
| 85 | int opt = help->opt; |
---|
| 86 | const struct option *o = 0; |
---|
| 87 | |
---|
| 88 | if (HLP_ISLONG(opt)) { |
---|
[3b9ec3f] | 89 | o = longopts + HLP_DECODELONG(opt); |
---|
[aadc86e] | 90 | longopt = o->name; |
---|
| 91 | opt = o->val; |
---|
| 92 | } |
---|
| 93 | |
---|
[0580c6a] | 94 | if (isalnum((unsigned char)opt)) |
---|
[5fbfd8d] | 95 | printf(" -%c%c", opt, longopt ? ',' : ' '); |
---|
[aadc86e] | 96 | else |
---|
| 97 | fputs(" ", stdout); |
---|
| 98 | |
---|
| 99 | if (longopt) { |
---|
| 100 | int len = strlen(longopt); |
---|
| 101 | printf(" --%s", longopt); |
---|
| 102 | if (o && o->has_arg) { |
---|
| 103 | const char *p; |
---|
| 104 | len += len + 1; |
---|
| 105 | |
---|
| 106 | if (o->has_arg == optional_argument) { |
---|
| 107 | putchar('['); |
---|
| 108 | len += 2; |
---|
| 109 | } |
---|
| 110 | |
---|
| 111 | putchar('='); |
---|
| 112 | |
---|
[8adbe49] | 113 | for (p = longopt; *p ; p++) putchar((unsigned char)toupper(*p)); |
---|
[aadc86e] | 114 | |
---|
| 115 | if (o->has_arg == optional_argument) putchar(']'); |
---|
| 116 | } |
---|
| 117 | len = (len >> 3) + 2; |
---|
| 118 | if (len > 4) len = 0; |
---|
| 119 | fputs(newline_tabs + len, stdout); |
---|
| 120 | } else { |
---|
| 121 | fputs(newline_tabs + 1, stdout); |
---|
| 122 | } |
---|
| 123 | |
---|
[45af761] | 124 | if (help->arg) { |
---|
| 125 | SVX_ASSERT(strstr(msg(help->msg_no), "%s") != NULL); |
---|
| 126 | printf(msg(help->msg_no), help->arg); |
---|
| 127 | putnl(); |
---|
| 128 | } else { |
---|
| 129 | SVX_ASSERT(strstr(msg(help->msg_no), "%s") == NULL); |
---|
| 130 | puts(msg(help->msg_no)); |
---|
| 131 | } |
---|
[aadc86e] | 132 | help++; |
---|
| 133 | } |
---|
[45af761] | 134 | fputs(" --help\t\t\t", stdout); |
---|
[736f7df] | 135 | /* TRANSLATORS: description of --help option */ |
---|
[45af761] | 136 | puts(msg(/*display this help and exit*/150)); |
---|
| 137 | fputs(" --version\t\t\t", stdout); |
---|
[c5d45ba] | 138 | /* TRANSLATORS: description of --version option */ |
---|
[45af761] | 139 | puts(msg(/*output version information and exit*/151)); |
---|
[acc20b1] | 140 | |
---|
[d8dbdff] | 141 | if (msg_extra) { |
---|
[acc20b1] | 142 | putnl(); |
---|
[d8dbdff] | 143 | if (msg_extra_arg) { |
---|
| 144 | SVX_ASSERT(strstr(msg(msg_extra), "%s") != NULL); |
---|
| 145 | printf(msg(msg_extra), msg_extra_arg); |
---|
| 146 | putnl(); |
---|
| 147 | } else { |
---|
| 148 | SVX_ASSERT(strstr(msg(msg_extra), "%s") == NULL); |
---|
| 149 | puts(msg(msg_extra)); |
---|
| 150 | } |
---|
[acc20b1] | 151 | } |
---|
[647407d] | 152 | |
---|
[aadc86e] | 153 | exit(0); |
---|
| 154 | } |
---|
| 155 | |
---|
[3b9ec3f] | 156 | void |
---|
| 157 | cmdline_version(void) |
---|
[aadc86e] | 158 | { |
---|
[82afbc4] | 159 | printf("%s - "PRETTYPACKAGE" "VERSION"\n", msg_appname()); |
---|
[aadc86e] | 160 | } |
---|
| 161 | |
---|
[3b9ec3f] | 162 | void |
---|
| 163 | cmdline_syntax(void) |
---|
[cb3d1e2] | 164 | { |
---|
[736f7df] | 165 | /* TRANSLATORS: as in: Usage: cavern … */ |
---|
[ee7511a] | 166 | printf("\n%s: %s", msg(/*Usage*/49), msg_appname()); |
---|
[736f7df] | 167 | /* TRANSLATORS: in command line usage messages e.g. Usage: cavern [OPTION]… */ |
---|
[9e513bd3] | 168 | if (help && help->opt) printf(" [%s]...", msg(/*OPTION*/153)); |
---|
[d8dbdff] | 169 | if (msg_args) { |
---|
[acc20b1] | 170 | putchar(' '); |
---|
[d8dbdff] | 171 | puts(msg(msg_args)); |
---|
[acc20b1] | 172 | return; |
---|
| 173 | } |
---|
[3b9ec3f] | 174 | if (min_args) { |
---|
| 175 | int i = min_args; |
---|
[a580dc1] | 176 | while (i--) printf(" %s", msg(/*FILE*/124)); |
---|
[3b9ec3f] | 177 | } |
---|
[647407d] | 178 | if (max_args == -1) { |
---|
[a580dc1] | 179 | if (!min_args) printf(" [%s]", msg(/*FILE*/124)); |
---|
[647407d] | 180 | fputs("...", stdout); |
---|
| 181 | } else if (max_args > min_args) { |
---|
| 182 | int i = max_args - min_args; |
---|
[a580dc1] | 183 | while (i--) printf(" [%s]", msg(/*FILE*/124)); |
---|
[647407d] | 184 | } |
---|
[3b9ec3f] | 185 | putnl(); |
---|
| 186 | } |
---|
| 187 | |
---|
[2668614] | 188 | static void |
---|
| 189 | syntax_and_help_pointer(void) |
---|
| 190 | { |
---|
| 191 | cmdline_syntax(); |
---|
[ee7511a] | 192 | fprintf(stderr, msg(/*Try “%s --help” for more information.\n*/157), |
---|
[2668614] | 193 | msg_appname()); |
---|
| 194 | exit(1); |
---|
| 195 | } |
---|
| 196 | |
---|
| 197 | static void |
---|
| 198 | moan_and_die(int msgno) |
---|
| 199 | { |
---|
| 200 | fprintf(stderr, "%s: ", msg_appname()); |
---|
| 201 | fprintf(stderr, msg(msgno), optarg); |
---|
| 202 | fputnl(stderr); |
---|
| 203 | cmdline_syntax(); |
---|
| 204 | exit(1); |
---|
| 205 | } |
---|
| 206 | |
---|
| 207 | void |
---|
| 208 | cmdline_too_few_args(void) |
---|
| 209 | { |
---|
| 210 | fprintf(stderr, "%s: %s\n", msg_appname(), msg(/*too few arguments*/122)); |
---|
| 211 | syntax_and_help_pointer(); |
---|
| 212 | } |
---|
| 213 | |
---|
| 214 | void |
---|
| 215 | cmdline_too_many_args(void) |
---|
| 216 | { |
---|
| 217 | fprintf(stderr, "%s: %s\n", msg_appname(), msg(/*too many arguments*/123)); |
---|
| 218 | syntax_and_help_pointer(); |
---|
| 219 | } |
---|
| 220 | |
---|
[acc20b1] | 221 | void |
---|
[d8dbdff] | 222 | cmdline_set_syntax_message(int msg_args_, int msg_extra_, const char * arg) |
---|
[acc20b1] | 223 | { |
---|
[d8dbdff] | 224 | msg_args = msg_args_; |
---|
| 225 | msg_extra = msg_extra_; |
---|
| 226 | msg_extra_arg = arg; |
---|
[acc20b1] | 227 | } |
---|
| 228 | |
---|
[3b9ec3f] | 229 | int |
---|
| 230 | cmdline_int_arg(void) |
---|
[aadc86e] | 231 | { |
---|
[f2122f0] | 232 | long result; |
---|
[3b9ec3f] | 233 | char *endptr; |
---|
[cb3d1e2] | 234 | |
---|
[3b9ec3f] | 235 | errno = 0; |
---|
| 236 | |
---|
| 237 | result = strtol(optarg, &endptr, 10); |
---|
| 238 | |
---|
[f2122f0] | 239 | if (errno == ERANGE || result > INT_MAX || result < INT_MIN) { |
---|
[0804fbe] | 240 | moan_and_die(/*numeric argument “%s” out of range*/185); |
---|
[3b9ec3f] | 241 | } else if (*optarg == '\0' || *endptr != '\0') { |
---|
[0804fbe] | 242 | moan_and_die(/*argument “%s” not an integer*/186); |
---|
[3b9ec3f] | 243 | } |
---|
[cb3d1e2] | 244 | |
---|
[f2122f0] | 245 | return (int)result; |
---|
[aadc86e] | 246 | } |
---|
| 247 | |
---|
[acc20b1] | 248 | double |
---|
| 249 | cmdline_double_arg(void) |
---|
[aadc86e] | 250 | { |
---|
[acc20b1] | 251 | double result; |
---|
[3b9ec3f] | 252 | char *endptr; |
---|
[cb3d1e2] | 253 | |
---|
[3b9ec3f] | 254 | errno = 0; |
---|
| 255 | |
---|
| 256 | result = strtod(optarg, &endptr); |
---|
| 257 | |
---|
| 258 | if (errno == ERANGE) { |
---|
[0804fbe] | 259 | moan_and_die(/*numeric argument “%s” out of range*/185); |
---|
[3b9ec3f] | 260 | } else if (*optarg == '\0' || *endptr != '\0') { |
---|
[0804fbe] | 261 | moan_and_die(/*argument “%s” not a number*/187); |
---|
[3b9ec3f] | 262 | } |
---|
[cb3d1e2] | 263 | |
---|
[3b9ec3f] | 264 | return result; |
---|
| 265 | } |
---|
| 266 | |
---|
| 267 | void |
---|
| 268 | cmdline_init(int argc_, char *const *argv_, const char *shortopts_, |
---|
| 269 | const struct option *longopts_, int *longind_, |
---|
| 270 | const struct help_msg *help_, |
---|
| 271 | int min_args_, int max_args_) |
---|
| 272 | { |
---|
| 273 | argc = argc_; |
---|
| 274 | argv = argv_; |
---|
| 275 | shortopts = shortopts_; |
---|
| 276 | longopts = longopts_; |
---|
| 277 | longind = longind_; |
---|
| 278 | help = help_; |
---|
| 279 | min_args = min_args_; |
---|
| 280 | max_args = max_args_; |
---|
| 281 | } |
---|
| 282 | |
---|
| 283 | int |
---|
| 284 | cmdline_getopt(void) |
---|
| 285 | { |
---|
| 286 | int opt = getopt_long(argc, argv, shortopts, longopts, longind); |
---|
[aadc86e] | 287 | |
---|
[2668614] | 288 | switch (opt) { |
---|
| 289 | case EOF: |
---|
[a580dc1] | 290 | /* check valid # of args given - if not give syntax message */ |
---|
[3b9ec3f] | 291 | if (argc - optind < min_args) { |
---|
[2668614] | 292 | cmdline_too_few_args(); |
---|
[3b9ec3f] | 293 | } else if (max_args >= 0 && argc - optind > max_args) { |
---|
[2668614] | 294 | cmdline_too_many_args(); |
---|
[3b9ec3f] | 295 | } |
---|
[2668614] | 296 | break; |
---|
[aadc86e] | 297 | case ':': /* parameter missing */ |
---|
| 298 | case '?': /* unknown opt, ambiguous match, or extraneous param */ |
---|
[a580dc1] | 299 | /* getopt displays a message for us */ |
---|
[2668614] | 300 | syntax_and_help_pointer(); |
---|
| 301 | break; |
---|
[aadc86e] | 302 | case HLP_VERSION: /* --version */ |
---|
[3b9ec3f] | 303 | cmdline_version(); |
---|
[aadc86e] | 304 | exit(0); |
---|
| 305 | case HLP_HELP: /* --help */ |
---|
[3b9ec3f] | 306 | cmdline_version(); |
---|
| 307 | cmdline_syntax(); |
---|
[aadc86e] | 308 | putchar('\n'); |
---|
[3b9ec3f] | 309 | cmdline_help(); |
---|
[aadc86e] | 310 | exit(0); |
---|
| 311 | } |
---|
| 312 | return opt; |
---|
| 313 | } |
---|