apt-private/private-cmndline.cc

   1 // Include Files                                                        /*{{{*/
   2 #include <config.h>
   3
   4 #include <apt-pkg/cmndline.h>
   5 #include <apt-pkg/configuration.h>
   6 #include <apt-pkg/fileutl.h>
   7 #include <apt-pkg/pkgsystem.h>
   8 #include <apt-pkg/init.h>
   9 #include <apt-pkg/error.h>
  10 #include <apt-pkg/strutl.h>
  11
  12 #include <apt-private/private-cmndline.h>
  13
  14 #include <stdarg.h>
  15 #include <string.h>
  16 #include <stdlib.h>
  17
  18 #include <vector>
  19 #include <iomanip>
  20
  21 #include <apti18n.h>
  22                                                                         /*}}}*/
  23
  24 APT_SENTINEL static bool strcmp_match_in_list(char const * const Cmd, ...)              /*{{{*/
  25 {
  26    va_list args;
  27    bool found = false;
  28    va_start(args, Cmd);
  29    char const * Match = NULL;
  30    while ((Match = va_arg(args, char const *)) != NULL)
  31    {
  32       if (strcmp(Cmd, Match) != 0)
  33          continue;
  34       found = true;
  35       break;
  36    }
  37    va_end(args);
  38    return found;
  39 }
  40                                                                         /*}}}*/
  41 #define addArg(w,x,y,z) Args.push_back(CommandLine::MakeArgs(w,x,y,z))
  42 #define CmdMatches(...) strcmp_match_in_list(Cmd, __VA_ARGS__, NULL)
  43 static bool addArgumentsAPTCache(std::vector<CommandLine::Args> &Args, char const * const Cmd)/*{{{*/
  44 {
  45    if (CmdMatches("depends", "rdepends", "xvcg", "dotty"))
  46    {
  47       addArg('i', "important", "APT::Cache::Important", 0);
  48       addArg(0, "installed", "APT::Cache::Installed", 0);
  49       addArg(0, "pre-depends", "APT::Cache::ShowPre-Depends", 0);
  50       addArg(0, "depends", "APT::Cache::ShowDepends", 0);
  51       addArg(0, "recommends", "APT::Cache::ShowRecommends", 0);
  52       addArg(0, "suggests", "APT::Cache::ShowSuggests", 0);
  53       addArg(0, "replaces", "APT::Cache::ShowReplaces", 0);
  54       addArg(0, "breaks", "APT::Cache::ShowBreaks", 0);
  55       addArg(0, "conflicts", "APT::Cache::ShowConflicts", 0);
  56       addArg(0, "enhances", "APT::Cache::ShowEnhances", 0);
  57       addArg(0, "recurse", "APT::Cache::RecurseDepends", 0);
  58       addArg(0, "implicit", "APT::Cache::ShowImplicit", 0);
  59    }
  60    else if (CmdMatches("search"))
  61    {
  62       addArg('n', "names-only", "APT::Cache::NamesOnly", 0);
  63       addArg('f', "full", "APT::Cache::ShowFull", 0);
  64    }
  65    else if (CmdMatches("show"))
  66    {
  67       addArg('a', "all-versions", "APT::Cache::AllVersions", 0);
  68    }
  69    else if (CmdMatches("pkgnames"))
  70    {
  71       addArg(0, "all-names", "APT::Cache::AllNames", 0);
  72    }
  73    else if (CmdMatches("unmet"))
  74    {
  75       addArg('i', "important", "APT::Cache::Important", 0);
  76    }
  77    else if (CmdMatches("showsrc"))
  78    {
  79       addArg(0,"only-source","APT::Cache::Only-Source",0);
  80    }
  81    else if (CmdMatches("gencaches", "showpkg", "stats", "dump",
  82             "dumpavail", "showauto", "policy", "madison"))
  83       ;
  84    else
  85       return false;
  86
  87    bool const found_something = Args.empty() == false;
  88
  89    // FIXME: move to the correct command(s)
  90    addArg('g', "generate", "APT::Cache::Generate", 0);
  91    addArg('t', "target-release", "APT::Default-Release", CommandLine::HasArg);
  92    addArg('t', "default-release", "APT::Default-Release", CommandLine::HasArg);
  93
  94    addArg('p', "pkg-cache", "Dir::Cache::pkgcache", CommandLine::HasArg);
  95    addArg('s', "src-cache", "Dir::Cache::srcpkgcache", CommandLine::HasArg);
  96
  97    return found_something;
  98 }
  99                                                                         /*}}}*/
 100 static bool addArgumentsAPTCDROM(std::vector<CommandLine::Args> &Args, char const * const Cmd)/*{{{*/
 101 {
 102    if (CmdMatches("add", "ident") == false)
 103       return false;
 104
 105    // FIXME: move to the correct command(s)
 106    addArg(0, "auto-detect", "Acquire::cdrom::AutoDetect", CommandLine::Boolean);
 107    addArg('d', "cdrom", "Acquire::cdrom::mount", CommandLine::HasArg);
 108    addArg('r', "rename", "APT::CDROM::Rename", 0);
 109    addArg('m', "no-mount", "APT::CDROM::NoMount", 0);
 110    addArg('f', "fast", "APT::CDROM::Fast", 0);
 111    addArg('n', "just-print", "APT::CDROM::NoAct", 0);
 112    addArg('n', "recon", "APT::CDROM::NoAct", 0);
 113    addArg('n', "no-act", "APT::CDROM::NoAct", 0);
 114    addArg('a', "thorough", "APT::CDROM::Thorough", 0);
 115    return true;
 116 }
 117                                                                         /*}}}*/
 118 static bool addArgumentsAPTConfig(std::vector<CommandLine::Args> &Args, char const * const Cmd)/*{{{*/
 119 {
 120    if (CmdMatches("dump"))
 121    {
 122       addArg(0,"empty","APT::Config::Dump::EmptyValue",CommandLine::Boolean);
 123       addArg(0,"format","APT::Config::Dump::Format",CommandLine::HasArg);
 124    }
 125    else if (CmdMatches("shell"))
 126       ;
 127    else
 128       return false;
 129
 130    return true;
 131 }
 132                                                                         /*}}}*/
 133 static bool addArgumentsAPTExtractTemplates(std::vector<CommandLine::Args> &Args, char const * const)/*{{{*/
 134 {
 135    addArg('t',"tempdir","APT::ExtractTemplates::TempDir",CommandLine::HasArg);
 136    return true;
 137 }
 138                                                                         /*}}}*/
 139 static bool addArgumentsAPTFTPArchive(std::vector<CommandLine::Args> &Args, char const * const)/*{{{*/
 140 {
 141    addArg(0,"md5","APT::FTPArchive::MD5",0);
 142    addArg(0,"sha1","APT::FTPArchive::SHA1",0);
 143    addArg(0,"sha256","APT::FTPArchive::SHA256",0);
 144    addArg(0,"sha512","APT::FTPArchive::SHA512",0);
 145    addArg('d',"db","APT::FTPArchive::DB",CommandLine::HasArg);
 146    addArg('s',"source-override","APT::FTPArchive::SourceOverride",CommandLine::HasArg);
 147    addArg(0,"delink","APT::FTPArchive::DeLinkAct",0);
 148    addArg(0,"readonly","APT::FTPArchive::ReadOnlyDB",0);
 149    addArg(0,"contents","APT::FTPArchive::Contents",0);
 150    addArg('a',"arch","APT::FTPArchive::Architecture",CommandLine::HasArg);
 151    return true;
 152 }
 153                                                                         /*}}}*/
 154 static bool addArgumentsAPTInternalSolver(std::vector<CommandLine::Args> &, char const * const)/*{{{*/
 155 {
 156    return true;
 157 }
 158                                                                         /*}}}*/
 159 static bool addArgumentsAPTHelper(std::vector<CommandLine::Args> &, char const * const)/*{{{*/
 160 {
 161    return true;
 162 }
 163                                                                         /*}}}*/
 164 static bool addArgumentsAPTGet(std::vector<CommandLine::Args> &Args, char const * const Cmd)/*{{{*/
 165 {
 166    if (CmdMatches("install", "remove", "purge", "upgrade", "dist-upgrade",
 167             "dselect-upgrade", "autoremove", "full-upgrade"))
 168    {
 169       addArg(0, "show-progress", "DpkgPM::Progress", 0);
 170       addArg('f', "fix-broken", "APT::Get::Fix-Broken", 0);
 171       addArg(0, "purge", "APT::Get::Purge", 0);
 172       addArg('V',"verbose-versions","APT::Get::Show-Versions",0);
 173       addArg(0, "auto-remove", "APT::Get::AutomaticRemove", 0);
 174       addArg(0, "reinstall", "APT::Get::ReInstall", 0);
 175       addArg(0, "solver", "APT::Solver", CommandLine::HasArg);
 176       if (CmdMatches("upgrade"))
 177       {
 178          addArg(0, "new-pkgs", "APT::Get::Upgrade-Allow-New",
 179                 CommandLine::Boolean);
 180       }
 181    }
 182    else if (CmdMatches("update"))
 183    {
 184       addArg(0, "list-cleanup", "APT::Get::List-Cleanup", 0);
 185    }
 186    else if (CmdMatches("source"))
 187    {
 188       addArg('b', "compile", "APT::Get::Compile", 0);
 189       addArg('b', "build", "APT::Get::Compile", 0);
 190       addArg('P', "build-profiles", "APT::Build-Profiles", CommandLine::HasArg);
 191       addArg(0, "diff-only", "APT::Get::Diff-Only", 0);
 192       addArg(0, "debian-only", "APT::Get::Diff-Only", 0);
 193       addArg(0, "tar-only", "APT::Get::Tar-Only", 0);
 194       addArg(0, "dsc-only", "APT::Get::Dsc-Only", 0);
 195    }
 196    else if (CmdMatches("build-dep"))
 197    {
 198       addArg('a', "host-architecture", "APT::Get::Host-Architecture", CommandLine::HasArg);
 199       addArg('P', "build-profiles", "APT::Build-Profiles", CommandLine::HasArg);
 200       addArg(0, "purge", "APT::Get::Purge", 0);
 201       addArg(0, "solver", "APT::Solver", CommandLine::HasArg);
 202       // this has no effect *but* sbuild is using it (see LP: #1255806)
 203       // once sbuild is fixed, this option can be removed
 204       addArg('f', "fix-broken", "APT::Get::Fix-Broken", 0);
 205    }
 206    else if (CmdMatches("indextargets"))
 207    {
 208       addArg(0,"format","APT::Get::IndexTargets::Format", CommandLine::HasArg);
 209       addArg(0,"release-info","APT::Get::IndexTargets::ReleaseInfo", 0);
 210    }
 211    else if (CmdMatches("clean", "autoclean", "auto-clean", "check", "download", "changelog") ||
 212             CmdMatches("markauto", "unmarkauto")) // deprecated commands
 213       ;
 214    else if (CmdMatches("moo"))
 215       addArg(0, "color", "APT::Moo::Color", 0);
 216
 217    if (CmdMatches("install", "remove", "purge", "upgrade", "dist-upgrade",
 218             "dselect-upgrade", "autoremove", "auto-remove", "clean", "autoclean", "auto-clean", "check",
 219             "build-dep", "full-upgrade", "source"))
 220    {
 221       addArg('s', "simulate", "APT::Get::Simulate", 0);
 222       addArg('s', "just-print", "APT::Get::Simulate", 0);
 223       addArg('s', "recon", "APT::Get::Simulate", 0);
 224       addArg('s', "dry-run", "APT::Get::Simulate", 0);
 225       addArg('s', "no-act", "APT::Get::Simulate", 0);
 226    }
 227
 228    bool const found_something = Args.empty() == false;
 229
 230    // FIXME: move to the correct command(s)
 231    addArg('d',"download-only","APT::Get::Download-Only",0);
 232    addArg('y',"yes","APT::Get::Assume-Yes",0);
 233    addArg('y',"assume-yes","APT::Get::Assume-Yes",0);
 234    addArg(0,"assume-no","APT::Get::Assume-No",0);
 235    addArg('u',"show-upgraded","APT::Get::Show-Upgraded",0);
 236    addArg('m',"ignore-missing","APT::Get::Fix-Missing",0);
 237    addArg('t',"target-release","APT::Default-Release",CommandLine::HasArg);
 238    addArg('t',"default-release","APT::Default-Release",CommandLine::HasArg);
 239    addArg(0,"download","APT::Get::Download",0);
 240    addArg(0,"fix-missing","APT::Get::Fix-Missing",0);
 241    addArg(0,"ignore-hold","APT::Ignore-Hold",0);
 242    addArg(0,"upgrade","APT::Get::upgrade",0);
 243    addArg(0,"only-upgrade","APT::Get::Only-Upgrade",0);
 244    addArg(0,"allow-change-held-packages","APT::Get::allow-change-held-packages",CommandLine::Boolean);
 245    addArg(0,"allow-remove-essential","APT::Get::allow-remove-essential",CommandLine::Boolean);
 246    addArg(0,"allow-downgrades","APT::Get::allow-downgrades",CommandLine::Boolean);
 247    addArg(0,"force-yes","APT::Get::force-yes",0);
 248    addArg(0,"print-uris","APT::Get::Print-URIs",0);
 249    addArg(0,"trivial-only","APT::Get::Trivial-Only",0);
 250    addArg(0,"remove","APT::Get::Remove",0);
 251    addArg(0,"only-source","APT::Get::Only-Source",0);
 252    addArg(0,"arch-only","APT::Get::Arch-Only",0);
 253    addArg(0,"allow-unauthenticated","APT::Get::AllowUnauthenticated",0);
 254    addArg(0,"allow-insecure-repositories","Acquire::AllowInsecureRepositories",0);
 255    addArg(0,"install-recommends","APT::Install-Recommends",CommandLine::Boolean);
 256    addArg(0,"install-suggests","APT::Install-Suggests",CommandLine::Boolean);
 257    addArg(0,"fix-policy","APT::Get::Fix-Policy-Broken",0);
 258
 259    return found_something;
 260 }
 261                                                                         /*}}}*/
 262 static bool addArgumentsAPTMark(std::vector<CommandLine::Args> &Args, char const * const Cmd)/*{{{*/
 263 {
 264    if (CmdMatches("auto", "manual", "hold", "unhold", "showauto",
 265             "showmanual", "showhold", "showholds",
 266             "markauto", "unmarkauto"))
 267    {
 268       addArg('f',"file","Dir::State::extended_states",CommandLine::HasArg);
 269    }
 270    else if (CmdMatches("install", "remove", "deinstall", "purge",
 271             "showinstall", "showinstalls", "showremove", "showremoves",
 272             "showdeinstall", "showdeinstalls", "showpurge", "showpurges"))
 273       ;
 274    else
 275       return false;
 276
 277    if (CmdMatches("markauto", "unmarkauto"))
 278    {
 279       addArg('v',"verbose","APT::MarkAuto::Verbose",0);
 280    }
 281
 282    if (strncmp(Cmd, "show", strlen("show")) != 0)
 283    {
 284       addArg('s',"simulate","APT::Mark::Simulate",0);
 285       addArg('s',"just-print","APT::Mark::Simulate",0);
 286       addArg('s',"recon","APT::Mark::Simulate",0);
 287       addArg('s',"dry-run","APT::Mark::Simulate",0);
 288       addArg('s',"no-act","APT::Mark::Simulate",0);
 289    }
 290
 291    return true;
 292 }
 293                                                                         /*}}}*/
 294 static bool addArgumentsAPTSortPkgs(std::vector<CommandLine::Args> &Args, char const * const)/*{{{*/
 295 {
 296    addArg('s',"source","APT::SortPkgs::Source",0);
 297    return true;
 298 }
 299                                                                         /*}}}*/
 300 static bool addArgumentsAPT(std::vector<CommandLine::Args> &Args, char const * const Cmd)/*{{{*/
 301 {
 302    if (CmdMatches("list"))
 303    {
 304       addArg('i',"installed","APT::Cmd::Installed",0);
 305       addArg(0,"upgradeable","APT::Cmd::Upgradable",0);
 306       addArg('u',"upgradable","APT::Cmd::Upgradable",0);
 307       addArg(0,"manual-installed","APT::Cmd::Manual-Installed",0);
 308       addArg('v', "verbose", "APT::Cmd::List-Include-Summary", 0);
 309       addArg('a', "all-versions", "APT::Cmd::All-Versions", 0);
 310    }
 311    else if (CmdMatches("show"))
 312    {
 313       addArg('a', "all-versions", "APT::Cache::AllVersions", 0);
 314    }
 315    else if (addArgumentsAPTGet(Args, Cmd) || addArgumentsAPTCache(Args, Cmd))
 316    {
 317        // we have no (supported) command-name overlaps so far, so we call
 318        // specifics in order until we find one which adds arguments
 319    }
 320    else
 321       return false;
 322
 323    return true;
 324 }
 325                                                                         /*}}}*/
 326 std::vector<CommandLine::Args> getCommandArgs(APT_CMD const Program, char const * const Cmd)/*{{{*/
 327 {
 328    std::vector<CommandLine::Args> Args;
 329    Args.reserve(50);
 330    if (Cmd == nullptr)
 331    {
 332       if (Program == APT_CMD::APT_EXTRACTTEMPLATES)
 333          addArgumentsAPTExtractTemplates(Args, Cmd);
 334    }
 335    else if (strcmp(Cmd, "help") == 0)
 336       ; // no options for help so no need to implement it in each
 337    else
 338       switch (Program)
 339       {
 340          case APT_CMD::APT: addArgumentsAPT(Args, Cmd); break;
 341          case APT_CMD::APT_GET: addArgumentsAPTGet(Args, Cmd); break;
 342          case APT_CMD::APT_CACHE: addArgumentsAPTCache(Args, Cmd); break;
 343          case APT_CMD::APT_CDROM: addArgumentsAPTCDROM(Args, Cmd); break;
 344          case APT_CMD::APT_CONFIG: addArgumentsAPTConfig(Args, Cmd); break;
 345          case APT_CMD::APT_EXTRACTTEMPLATES: addArgumentsAPTExtractTemplates(Args, Cmd); break;
 346          case APT_CMD::APT_FTPARCHIVE: addArgumentsAPTFTPArchive(Args, Cmd); break;
 347          case APT_CMD::APT_HELPER: addArgumentsAPTHelper(Args, Cmd); break;
 348          case APT_CMD::APT_INTERNAL_SOLVER: addArgumentsAPTInternalSolver(Args, Cmd); break;
 349          case APT_CMD::APT_MARK: addArgumentsAPTMark(Args, Cmd); break;
 350          case APT_CMD::APT_SORTPKG: addArgumentsAPTSortPkgs(Args, Cmd); break;
 351       }
 352
 353    // options without a command
 354    addArg('h', "help", "help", 0);
 355    addArg('v', "version", "version", 0);
 356    // general options
 357    addArg('q', "quiet", "quiet", CommandLine::IntLevel);
 358    addArg('q', "silent", "quiet", CommandLine::IntLevel);
 359    addArg('c', "config-file", 0, CommandLine::ConfigFile);
 360    addArg('o', "option", 0, CommandLine::ArbItem);
 361    addArg(0, NULL, NULL, 0);
 362
 363    return Args;
 364 }
 365                                                                         /*}}}*/
 366 #undef CmdMatches
 367 #undef addArg
 368 static void ShowHelpListCommands(std::vector<aptDispatchWithHelp> const &Cmds)/*{{{*/
 369 {
 370    if (Cmds.empty() || Cmds[0].Match == nullptr)
 371       return;
 372    std::cout << std::endl << _("Most used commands:") << std::endl;
 373    for (auto const &c: Cmds)
 374    {
 375       if (c.Help == nullptr)
 376          continue;
 377       std::cout << "  " << c.Match << " - " << c.Help << std::endl;
 378    }
 379 }
 380                                                                         /*}}}*/
 381 static bool ShowCommonHelp(APT_CMD const Binary, CommandLine &CmdL, std::vector<aptDispatchWithHelp> const &Cmds)/*{{{*/
 382 {
 383    std::cout << PACKAGE << " " << PACKAGE_VERSION << " (" << COMMON_ARCH << ")" << std::endl;
 384    if (_config->FindB("version") == true && Binary != APT_CMD::APT_GET)
 385       return true;
 386    if (ShowHelp(CmdL) == false)
 387       return false;
 388    if (_config->FindB("version") == true || Binary == APT_CMD::APT_FTPARCHIVE)
 389       return true;
 390    ShowHelpListCommands(Cmds);
 391    std::cout << std::endl;
 392    char const * cmd = nullptr;
 393    switch (Binary)
 394    {
 395       case APT_CMD::APT: cmd = "apt(8)"; break;
 396       case APT_CMD::APT_CACHE: cmd = "apt-cache(8)"; break;
 397       case APT_CMD::APT_CDROM: cmd = "apt-cdrom(8)"; break;
 398       case APT_CMD::APT_CONFIG: cmd = "apt-config(8)"; break;
 399       case APT_CMD::APT_EXTRACTTEMPLATES: cmd = "apt-extracttemplates(1)"; break;
 400       case APT_CMD::APT_FTPARCHIVE: cmd = "apt-ftparchive(1)"; break;
 401       case APT_CMD::APT_GET: cmd = "apt-get(8)"; break;
 402       case APT_CMD::APT_HELPER: cmd = nullptr; break;
 403       case APT_CMD::APT_INTERNAL_SOLVER: cmd = nullptr; break;
 404       case APT_CMD::APT_MARK: cmd = "apt-mark(8)"; break;
 405       case APT_CMD::APT_SORTPKG: cmd = "apt-sortpkgs(1)"; break;
 406    }
 407    if (cmd != nullptr)
 408       ioprintf(std::cout, _("See %s for more information about the available commands."), cmd);
 409    std::cout << std::endl <<
 410       _("Configuration options and syntax is detailed in apt.conf(5).\n"
 411             "Information about how to configure sources can be found in sources.list(5).\n"
 412             "Package and version choices can be expressed via apt_preferences(5).\n"
 413             "Security details are available in apt-secure(8).\n");
 414    if (Binary == APT_CMD::APT_GET || Binary == APT_CMD::APT)
 415       std::cout << std::right << std::setw(70) << _("This APT has Super Cow Powers.") << std::endl;
 416    else if (Binary == APT_CMD::APT_HELPER)
 417       std::cout << std::right << std::setw(70) << _("This APT helper has Super Meep Powers.") << std::endl;
 418    return true;
 419 }
 420                                                                         /*}}}*/
 421 static void BinarySpecificConfiguration(char const * const Binary)      /*{{{*/
 422 {
 423    std::string const binary = flNotDir(Binary);
 424    if (binary == "apt" || binary == "apt-config")
 425    {
 426       _config->CndSet("Binary::apt::APT::Color", true);
 427       _config->CndSet("Binary::apt::APT::Cache::Show::Version", 2);
 428       _config->CndSet("Binary::apt::APT::Cache::AllVersions", false);
 429       _config->CndSet("Binary::apt::APT::Cache::ShowVirtuals", true);
 430       _config->CndSet("Binary::apt::APT::Cache::Search::Version", 2);
 431       _config->CndSet("Binary::apt::APT::Cache::ShowDependencyType", true);
 432       _config->CndSet("Binary::apt::APT::Cache::ShowVersion", true);
 433       _config->CndSet("Binary::apt::APT::Get::Upgrade-Allow-New", true);
 434       _config->CndSet("Binary::apt::APT::Cmd::Show-Update-Stats", true);
 435       _config->CndSet("Binary::apt::DPkg::Progress-Fancy", true);
 436       _config->CndSet("Binary::apt::Acquire::AllowInsecureRepositories", false);
 437    }
 438
 439    _config->Set("Binary", binary);
 440    std::string const conf = "Binary::" + binary;
 441    _config->MoveSubTree(conf.c_str(), NULL);
 442 }
 443                                                                         /*}}}*/
 444 std::vector<CommandLine::Dispatch> ParseCommandLine(CommandLine &CmdL, APT_CMD const Binary,/*{{{*/
 445       Configuration * const * const Cnf, pkgSystem ** const Sys, int const argc, const char *argv[])
 446 {
 447    if (Cnf != NULL && pkgInitConfig(**Cnf) == false)
 448    {
 449       _error->DumpErrors();
 450       exit(100);
 451    }
 452
 453    if (likely(argc != 0 && argv[0] != NULL))
 454       BinarySpecificConfiguration(argv[0]);
 455
 456    std::vector<aptDispatchWithHelp> const CmdsWithHelp = GetCommands();
 457    std::vector<CommandLine::Dispatch> Cmds;
 458    if (CmdsWithHelp.empty() == false)
 459    {
 460       CommandLine::Dispatch const help = { "help", [](CommandLine &){return false;} };
 461       Cmds.push_back(std::move(help));
 462    }
 463    for (auto const& cmd : CmdsWithHelp)
 464       Cmds.push_back({cmd.Match, cmd.Handler});
 465
 466    // Args running out of scope invalidates the pointer stored in CmdL,
 467    // but we don't use the pointer after this function, so we ignore
 468    // this problem for now and figure something out if we have to.
 469    std::vector<CommandLine::Args> Args;
 470    if (Cmds.empty() == false && Cmds[0].Handler != nullptr)
 471       Args = getCommandArgs(Binary, CommandLine::GetCommand(Cmds.data(), argc, argv));
 472    else
 473       Args = getCommandArgs(Binary, nullptr);
 474    CmdL = CommandLine(Args.data(), _config);
 475
 476    if (CmdL.Parse(argc,argv) == false ||
 477        (Sys != NULL && pkgInitSystem(*_config, *Sys) == false))
 478    {
 479       if (_config->FindB("version") == true)
 480          ShowCommonHelp(Binary, CmdL, CmdsWithHelp);
 481
 482       _error->DumpErrors();
 483       exit(100);
 484    }
 485
 486    // See if the help should be shown
 487    if (_config->FindB("help") == true || _config->FindB("version") == true ||
 488          (CmdL.FileSize() > 0 && strcmp(CmdL.FileList[0], "help") == 0))
 489    {
 490       ShowCommonHelp(Binary, CmdL, CmdsWithHelp);
 491       exit(0);
 492    }
 493    if (Cmds.empty() == false && CmdL.FileSize() == 0)
 494    {
 495       ShowCommonHelp(Binary, CmdL, CmdsWithHelp);
 496       exit(1);
 497    }
 498    return Cmds;
 499 }
 500                                                                         /*}}}*/
 501 unsigned short DispatchCommandLine(CommandLine &CmdL, std::vector<CommandLine::Dispatch> const &Cmds)   /*{{{*/
 502 {
 503    // Match the operation
 504    bool const returned = Cmds.empty() ? true : CmdL.DispatchArg(Cmds.data());
 505
 506    // Print any errors or warnings found during parsing
 507    bool const Errors = _error->PendingError();
 508    if (_config->FindI("quiet",0) > 0)
 509       _error->DumpErrors();
 510    else
 511       _error->DumpErrors(GlobalError::DEBUG);
 512    if (returned == false)
 513       return 100;
 514    return Errors == true ? 100 : 0;
 515 }
 516                                                                         /*}}}*/