]>
Commit | Line | Data |
---|---|---|
08e8f724 AL |
1 | // -*- mode: cpp; mode: fold -*- |
2 | // Description /*{{{*/ | |
bac2e715 | 3 | // $Id: cmndline.cc,v 1.15 2003/02/10 01:40:58 doogie Exp $ |
08e8f724 AL |
4 | /* ###################################################################### |
5 | ||
6 | Command Line Class - Sophisticated command line parser | |
7 | ||
7da2b375 AL |
8 | This source is placed in the Public Domain, do with it what you will |
9 | It was originally written by Jason Gunthorpe <jgg@debian.org>. | |
10 | ||
08e8f724 AL |
11 | ##################################################################### */ |
12 | /*}}}*/ | |
13 | // Include files /*{{{*/ | |
ea542140 DK |
14 | #include<config.h> |
15 | ||
472ff00e | 16 | #include <apt-pkg/configuration.h> |
08e8f724 AL |
17 | #include <apt-pkg/cmndline.h> |
18 | #include <apt-pkg/error.h> | |
cdcc6d34 | 19 | #include <apt-pkg/strutl.h> |
b2e465d6 | 20 | |
453b82a3 DK |
21 | #include <stddef.h> |
22 | #include <stdlib.h> | |
23 | #include <string.h> | |
24 | #include <string> | |
25 | ||
ea542140 | 26 | #include <apti18n.h> |
08e8f724 | 27 | /*}}}*/ |
584e4558 | 28 | using namespace std; |
08e8f724 AL |
29 | |
30 | // CommandLine::CommandLine - Constructor /*{{{*/ | |
31 | // --------------------------------------------------------------------- | |
32 | /* */ | |
33 | CommandLine::CommandLine(Args *AList,Configuration *Conf) : ArgList(AList), | |
34 | Conf(Conf), FileList(0) | |
35 | { | |
ad7e0941 DK |
36 | } |
37 | CommandLine::CommandLine() : ArgList(NULL), Conf(NULL), FileList(0) | |
38 | { | |
e1b74f61 AL |
39 | } |
40 | /*}}}*/ | |
41 | // CommandLine::~CommandLine - Destructor /*{{{*/ | |
42 | // --------------------------------------------------------------------- | |
43 | /* */ | |
44 | CommandLine::~CommandLine() | |
45 | { | |
46 | delete [] FileList; | |
08e8f724 AL |
47 | } |
48 | /*}}}*/ | |
b9179170 MV |
49 | // CommandLine::GetCommand - return the first non-option word /*{{{*/ |
50 | char const * CommandLine::GetCommand(Dispatch const * const Map, | |
51 | unsigned int const argc, char const * const * const argv) | |
52 | { | |
c4b91cbe DK |
53 | // if there is a -- on the line there must be the word we search for either |
54 | // before it (as -- marks the end of the options) or right after it (as we can't | |
55 | // decide if the command is actually an option, given that in theory, you could | |
56 | // have parameters named like commands) | |
b9179170 MV |
57 | for (size_t i = 1; i < argc; ++i) |
58 | { | |
59 | if (strcmp(argv[i], "--") != 0) | |
60 | continue; | |
c4b91cbe DK |
61 | // check if command is before -- |
62 | for (size_t k = 1; k < i; ++k) | |
b9179170 | 63 | for (size_t j = 0; Map[j].Match != NULL; ++j) |
c4b91cbe | 64 | if (strcmp(argv[k], Map[j].Match) == 0) |
b9179170 | 65 | return Map[j].Match; |
c4b91cbe DK |
66 | // see if the next token after -- is the command |
67 | ++i; | |
68 | if (i < argc) | |
b9179170 MV |
69 | for (size_t j = 0; Map[j].Match != NULL; ++j) |
70 | if (strcmp(argv[i], Map[j].Match) == 0) | |
71 | return Map[j].Match; | |
c4b91cbe | 72 | // we found a --, but not a command |
b9179170 MV |
73 | return NULL; |
74 | } | |
75 | // no --, so search for the first word matching a command | |
76 | // FIXME: How like is it that an option parameter will be also a valid Match ? | |
77 | for (size_t i = 1; i < argc; ++i) | |
78 | { | |
79 | if (*(argv[i]) == '-') | |
80 | continue; | |
81 | for (size_t j = 0; Map[j].Match != NULL; ++j) | |
82 | if (strcmp(argv[i], Map[j].Match) == 0) | |
83 | return Map[j].Match; | |
84 | } | |
85 | return NULL; | |
86 | } | |
87 | /*}}}*/ | |
08e8f724 AL |
88 | // CommandLine::Parse - Main action member /*{{{*/ |
89 | // --------------------------------------------------------------------- | |
90 | /* */ | |
91 | bool CommandLine::Parse(int argc,const char **argv) | |
92 | { | |
e1b74f61 | 93 | delete [] FileList; |
08e8f724 AL |
94 | FileList = new const char *[argc]; |
95 | const char **Files = FileList; | |
96 | int I; | |
97 | for (I = 1; I != argc; I++) | |
98 | { | |
99 | const char *Opt = argv[I]; | |
100 | ||
101 | // It is not an option | |
102 | if (*Opt != '-') | |
103 | { | |
104 | *Files++ = Opt; | |
105 | continue; | |
106 | } | |
107 | ||
108 | Opt++; | |
109 | ||
110 | // Double dash signifies the end of option processing | |
111 | if (*Opt == '-' && Opt[1] == 0) | |
343bd48e AL |
112 | { |
113 | I++; | |
08e8f724 | 114 | break; |
343bd48e | 115 | } |
08e8f724 AL |
116 | |
117 | // Single dash is a short option | |
118 | if (*Opt != '-') | |
119 | { | |
120 | // Iterate over each letter | |
121 | while (*Opt != 0) | |
122 | { | |
123 | // Search for the option | |
124 | Args *A; | |
125 | for (A = ArgList; A->end() == false && A->ShortOpt != *Opt; A++); | |
126 | if (A->end() == true) | |
71510743 | 127 | return _error->Error(_("Command line option '%c' [from %s] is not understood in combination with the other options."),*Opt,argv[I]); |
08e8f724 AL |
128 | |
129 | if (HandleOpt(I,argc,argv,Opt,A) == false) | |
130 | return false; | |
131 | if (*Opt != 0) | |
132 | Opt++; | |
133 | } | |
134 | continue; | |
135 | } | |
136 | ||
137 | Opt++; | |
138 | ||
139 | // Match up to a = against the list | |
08e8f724 | 140 | Args *A; |
404528bd | 141 | const char *OptEnd = strchrnul(Opt, '='); |
ae2be086 DH |
142 | for (A = ArgList; A->end() == false && |
143 | (A->LongOpt == 0 || stringcasecmp(Opt,OptEnd,A->LongOpt) != 0); | |
144 | ++A); | |
08e8f724 AL |
145 | |
146 | // Failed, look for a word after the first - (no-foo) | |
0d47bd08 | 147 | bool PreceedMatch = false; |
08e8f724 AL |
148 | if (A->end() == true) |
149 | { | |
404528bd DK |
150 | Opt = (const char*) memchr(Opt, '-', OptEnd - Opt); |
151 | if (Opt == NULL) | |
b7bbde25 | 152 | return _error->Error(_("Command line option %s is not understood in combination with the other options"),argv[I]); |
08e8f724 AL |
153 | Opt++; |
154 | ||
155 | for (A = ArgList; A->end() == false && | |
7a6d9076 DK |
156 | (A->LongOpt == 0 || stringcasecmp(Opt,OptEnd,A->LongOpt) != 0); |
157 | ++A); | |
08e8f724 AL |
158 | |
159 | // Failed again.. | |
160 | if (A->end() == true && OptEnd - Opt != 1) | |
b7bbde25 | 161 | return _error->Error(_("Command line option %s is not understood in combination with the other options"),argv[I]); |
0d47bd08 | 162 | |
08e8f724 | 163 | // The option could be a single letter option prefixed by a no-.. |
08e8f724 | 164 | if (A->end() == true) |
0d47bd08 AL |
165 | { |
166 | for (A = ArgList; A->end() == false && A->ShortOpt != *Opt; A++); | |
167 | ||
168 | if (A->end() == true) | |
b7bbde25 | 169 | return _error->Error(_("Command line option %s is not understood in combination with the other options"),argv[I]); |
0d47bd08 | 170 | } |
e1b74f61 AL |
171 | |
172 | // The option is not boolean | |
173 | if (A->IsBoolean() == false) | |
b2e465d6 | 174 | return _error->Error(_("Command line option %s is not boolean"),argv[I]); |
0d47bd08 | 175 | PreceedMatch = true; |
08e8f724 AL |
176 | } |
177 | ||
178 | // Deal with it. | |
179 | OptEnd--; | |
0d47bd08 | 180 | if (HandleOpt(I,argc,argv,OptEnd,A,PreceedMatch) == false) |
08e8f724 AL |
181 | return false; |
182 | } | |
183 | ||
184 | // Copy any remaining file names over | |
185 | for (; I != argc; I++) | |
186 | *Files++ = argv[I]; | |
187 | *Files = 0; | |
2bb25574 DK |
188 | |
189 | SaveInConfig(argc, argv); | |
190 | ||
08e8f724 AL |
191 | return true; |
192 | } | |
193 | /*}}}*/ | |
194 | // CommandLine::HandleOpt - Handle a single option including all flags /*{{{*/ | |
195 | // --------------------------------------------------------------------- | |
196 | /* This is a helper function for parser, it looks at a given argument | |
197 | and looks for specific patterns in the string, it gets tokanized | |
198 | -ruffly- like -*[yes|true|enable]-(o|longopt)[=][ ][argument] */ | |
199 | bool CommandLine::HandleOpt(int &I,int argc,const char *argv[], | |
0d47bd08 | 200 | const char *&Opt,Args *A,bool PreceedMatch) |
08e8f724 AL |
201 | { |
202 | const char *Argument = 0; | |
203 | bool CertainArg = false; | |
204 | int IncI = 0; | |
205 | ||
206 | /* Determine the possible location of an option or 0 if their is | |
207 | no option */ | |
208 | if (Opt[1] == 0 || (Opt[1] == '=' && Opt[2] == 0)) | |
209 | { | |
210 | if (I + 1 < argc && argv[I+1][0] != '-') | |
211 | Argument = argv[I+1]; | |
212 | ||
213 | // Equals was specified but we fell off the end! | |
214 | if (Opt[1] == '=' && Argument == 0) | |
b2e465d6 | 215 | return _error->Error(_("Option %s requires an argument."),argv[I]); |
08e8f724 AL |
216 | if (Opt[1] == '=') |
217 | CertainArg = true; | |
218 | ||
219 | IncI = 1; | |
220 | } | |
221 | else | |
222 | { | |
223 | if (Opt[1] == '=') | |
224 | { | |
225 | CertainArg = true; | |
226 | Argument = Opt + 2; | |
227 | } | |
228 | else | |
229 | Argument = Opt + 1; | |
230 | } | |
0d47bd08 | 231 | |
08e8f724 AL |
232 | // Option is an argument set |
233 | if ((A->Flags & HasArg) == HasArg) | |
234 | { | |
235 | if (Argument == 0) | |
b2e465d6 | 236 | return _error->Error(_("Option %s requires an argument."),argv[I]); |
08e8f724 AL |
237 | Opt += strlen(Opt); |
238 | I += IncI; | |
239 | ||
240 | // Parse a configuration file | |
241 | if ((A->Flags & ConfigFile) == ConfigFile) | |
242 | return ReadConfigFile(*Conf,Argument); | |
e1b74f61 | 243 | |
0da8987a | 244 | // Arbitrary item specification |
e1b74f61 AL |
245 | if ((A->Flags & ArbItem) == ArbItem) |
246 | { | |
404528bd DK |
247 | const char *J = strchr(Argument, '='); |
248 | if (J == NULL) | |
bac2e715 | 249 | return _error->Error(_("Option %s: Configuration item specification must have an =<val>."),argv[I]); |
e1b74f61 | 250 | |
7e798dd7 AL |
251 | // = is trailing |
252 | if (J[1] == 0) | |
253 | { | |
254 | if (I+1 >= argc) | |
bac2e715 | 255 | return _error->Error(_("Option %s: Configuration item specification must have an =<val>."),argv[I]); |
7e798dd7 AL |
256 | Conf->Set(string(Argument,J-Argument),string(argv[I++ +1])); |
257 | } | |
258 | else | |
259 | Conf->Set(string(Argument,J-Argument),string(J+1)); | |
e1b74f61 AL |
260 | |
261 | return true; | |
262 | } | |
08e8f724 | 263 | |
404528bd | 264 | const char *I = strchrnul(A->ConfName, ' '); |
7f25bdff AL |
265 | if (*I == ' ') |
266 | Conf->Set(string(A->ConfName,0,I-A->ConfName),string(I+1) + Argument); | |
267 | else | |
268 | Conf->Set(A->ConfName,string(I) + Argument); | |
269 | ||
08e8f724 AL |
270 | return true; |
271 | } | |
272 | ||
273 | // Option is an integer level | |
274 | if ((A->Flags & IntLevel) == IntLevel) | |
275 | { | |
276 | // There might be an argument | |
277 | if (Argument != 0) | |
278 | { | |
279 | char *EndPtr; | |
280 | unsigned long Value = strtol(Argument,&EndPtr,10); | |
281 | ||
282 | // Conversion failed and the argument was specified with an =s | |
283 | if (EndPtr == Argument && CertainArg == true) | |
b2e465d6 | 284 | return _error->Error(_("Option %s requires an integer argument, not '%s'"),argv[I],Argument); |
08e8f724 AL |
285 | |
286 | // Conversion was ok, set the value and return | |
9435cc9b | 287 | if (EndPtr != 0 && EndPtr != Argument && *EndPtr == 0) |
08e8f724 AL |
288 | { |
289 | Conf->Set(A->ConfName,Value); | |
290 | Opt += strlen(Opt); | |
291 | I += IncI; | |
292 | return true; | |
293 | } | |
294 | } | |
295 | ||
296 | // Increase the level | |
297 | Conf->Set(A->ConfName,Conf->FindI(A->ConfName)+1); | |
298 | return true; | |
299 | } | |
300 | ||
301 | // Option is a boolean | |
302 | int Sense = -1; // -1 is unspecified, 0 is yes 1 is no | |
303 | ||
304 | // Look for an argument. | |
305 | while (1) | |
306 | { | |
1e3f4083 | 307 | // Look at preceding text |
08e8f724 AL |
308 | char Buffer[300]; |
309 | if (Argument == 0) | |
310 | { | |
0d47bd08 AL |
311 | if (PreceedMatch == false) |
312 | break; | |
313 | ||
08e8f724 | 314 | if (strlen(argv[I]) >= sizeof(Buffer)) |
b2e465d6 | 315 | return _error->Error(_("Option '%s' is too long"),argv[I]); |
0d47bd08 AL |
316 | |
317 | // Skip the leading dash | |
08e8f724 AL |
318 | const char *J = argv[I]; |
319 | for (; *J != 0 && *J == '-'; J++); | |
404528bd DK |
320 | |
321 | const char *JEnd = strchr(J, '-'); | |
322 | if (JEnd != NULL) | |
08e8f724 AL |
323 | { |
324 | strncpy(Buffer,J,JEnd - J); | |
325 | Buffer[JEnd - J] = 0; | |
326 | Argument = Buffer; | |
327 | CertainArg = true; | |
328 | } | |
329 | else | |
330 | break; | |
331 | } | |
332 | ||
3b5421b4 AL |
333 | // Check for boolean |
334 | Sense = StringToBool(Argument); | |
335 | if (Sense >= 0) | |
08e8f724 | 336 | { |
08e8f724 AL |
337 | // Eat the argument |
338 | if (Argument != Buffer) | |
339 | { | |
340 | Opt += strlen(Opt); | |
341 | I += IncI; | |
342 | } | |
343 | break; | |
344 | } | |
345 | ||
08e8f724 | 346 | if (CertainArg == true) |
b2e465d6 | 347 | return _error->Error(_("Sense %s is not understood, try true or false."),Argument); |
08e8f724 AL |
348 | |
349 | Argument = 0; | |
350 | } | |
351 | ||
352 | // Indeterminate sense depends on the flag | |
353 | if (Sense == -1) | |
354 | { | |
355 | if ((A->Flags & InvBoolean) == InvBoolean) | |
356 | Sense = 0; | |
357 | else | |
358 | Sense = 1; | |
359 | } | |
360 | ||
361 | Conf->Set(A->ConfName,Sense); | |
362 | return true; | |
363 | } | |
364 | /*}}}*/ | |
bc4af0b9 | 365 | // CommandLine::FileSize - Count the number of filenames /*{{{*/ |
e1b74f61 AL |
366 | // --------------------------------------------------------------------- |
367 | /* */ | |
368 | unsigned int CommandLine::FileSize() const | |
369 | { | |
370 | unsigned int Count = 0; | |
371 | for (const char **I = FileList; I != 0 && *I != 0; I++) | |
372 | Count++; | |
373 | return Count; | |
374 | } | |
375 | /*}}}*/ | |
bc4af0b9 AL |
376 | // CommandLine::DispatchArg - Do something with the first arg /*{{{*/ |
377 | // --------------------------------------------------------------------- | |
378 | /* */ | |
b0b4efb9 | 379 | bool CommandLine::DispatchArg(Dispatch *Map,bool NoMatch) |
bc4af0b9 AL |
380 | { |
381 | int I; | |
382 | for (I = 0; Map[I].Match != 0; I++) | |
383 | { | |
384 | if (strcmp(FileList[0],Map[I].Match) == 0) | |
385 | { | |
386 | bool Res = Map[I].Handler(*this); | |
387 | if (Res == false && _error->PendingError() == false) | |
388 | _error->Error("Handler silently failed"); | |
389 | return Res; | |
390 | } | |
391 | } | |
392 | ||
393 | // No matching name | |
394 | if (Map[I].Match == 0) | |
b0b4efb9 AL |
395 | { |
396 | if (NoMatch == true) | |
b2e465d6 | 397 | _error->Error(_("Invalid operation %s"),FileList[0]); |
b0b4efb9 AL |
398 | } |
399 | ||
bc4af0b9 AL |
400 | return false; |
401 | } | |
402 | /*}}}*/ | |
2bb25574 DK |
403 | // CommandLine::SaveInConfig - for output later in a logfile or so /*{{{*/ |
404 | // --------------------------------------------------------------------- | |
405 | /* We save the commandline here to have it around later for e.g. logging. | |
406 | It feels a bit like a hack here and isn't bulletproof, but it is better | |
407 | than nothing after all. */ | |
408 | void CommandLine::SaveInConfig(unsigned int const &argc, char const * const * const argv) | |
409 | { | |
093e9f5d | 410 | char cmdline[100 + argc * 50]; |
70e0c168 | 411 | memset(cmdline, 0, sizeof(cmdline)); |
2bb25574 DK |
412 | unsigned int length = 0; |
413 | bool lastWasOption = false; | |
414 | bool closeQuote = false; | |
093e9f5d | 415 | for (unsigned int i = 0; i < argc && length < sizeof(cmdline); ++i, ++length) |
2bb25574 DK |
416 | { |
417 | for (unsigned int j = 0; argv[i][j] != '\0' && length < sizeof(cmdline)-1; ++j, ++length) | |
418 | { | |
419 | cmdline[length] = argv[i][j]; | |
420 | if (lastWasOption == true && argv[i][j] == '=') | |
421 | { | |
422 | // That is possibly an option: Quote it if it includes spaces, | |
423 | // the benefit is that this will eliminate also most false positives | |
404528bd DK |
424 | const char* c = strchr(&argv[i][j+1], ' '); |
425 | if (c == NULL) continue; | |
2bb25574 DK |
426 | cmdline[++length] = '"'; |
427 | closeQuote = true; | |
428 | } | |
429 | } | |
430 | if (closeQuote == true) | |
431 | cmdline[length++] = '"'; | |
432 | // Problem: detects also --hello | |
433 | if (cmdline[length-1] == 'o') | |
434 | lastWasOption = true; | |
435 | cmdline[length] = ' '; | |
436 | } | |
437 | cmdline[--length] = '\0'; | |
438 | _config->Set("CommandLine::AsString", cmdline); | |
439 | } | |
440 | /*}}}*/ | |
b9179170 MV |
441 | CommandLine::Args CommandLine::MakeArgs(char ShortOpt, char const *LongOpt, char const *ConfName, unsigned long Flags)/*{{{*/ |
442 | { | |
443 | /* In theory, this should be a constructor for CommandLine::Args instead, | |
444 | but this breaks compatibility as gcc thinks this is a c++11 initializer_list */ | |
445 | CommandLine::Args arg; | |
446 | arg.ShortOpt = ShortOpt; | |
447 | arg.LongOpt = LongOpt; | |
448 | arg.ConfName = ConfName; | |
449 | arg.Flags = Flags; | |
450 | return arg; | |
451 | } | |
452 | /*}}}*/ |