1 /* args.c - parse command-line args
5 Copyright 2001 University of Southern California
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
27 #include "sprintf_alloc.h"
29 static void print_version(void);
33 ARGS_OPT_FORCE_DEFAULTS
= 129,
34 ARGS_OPT_FORCE_DEPENDS
,
35 ARGS_OPT_FORCE_OVERWRITE
,
36 ARGS_OPT_FORCE_DOWNGRADE
,
37 ARGS_OPT_FORCE_REINSTALL
,
38 ARGS_OPT_FORCE_REMOVAL_OF_DEPENDENT_PACKAGES
,
39 ARGS_OPT_FORCE_REMOVAL_OF_ESSENTIAL_PACKAGES
,
43 ARGS_OPT_VERBOSE_WGET
,
45 ARGS_OPT_MULTIPLE_PROVIDERS
48 int args_init(args_t
*args
)
52 memset(args
, 0, sizeof(args_t
));
54 args
->dest
= ARGS_DEFAULT_DEST
;
56 conf_file_dir
= getenv("OPKG_CONF_DIR");
57 if (conf_file_dir
== NULL
|| conf_file_dir
[0] == '\0') {
58 conf_file_dir
= ARGS_DEFAULT_CONF_FILE_DIR
;
60 sprintf_alloc(&args
->conf_file
, "%s/%s", conf_file_dir
,
61 ARGS_DEFAULT_CONF_FILE_NAME
);
63 args
->force_defaults
= ARGS_DEFAULT_FORCE_DEFAULTS
;
64 args
->force_depends
= ARGS_DEFAULT_FORCE_DEPENDS
;
65 args
->force_overwrite
= ARGS_DEFAULT_FORCE_OVERWRITE
;
66 args
->force_downgrade
= ARGS_DEFAULT_FORCE_DOWNGRADE
;
67 args
->force_reinstall
= ARGS_DEFAULT_FORCE_REINSTALL
;
68 args
->force_removal_of_dependent_packages
= ARGS_DEFAULT_FORCE_REMOVAL_OF_DEPENDENT_PACKAGES
;
69 args
->force_removal_of_essential_packages
= ARGS_DEFAULT_FORCE_REMOVAL_OF_ESSENTIAL_PACKAGES
;
70 args
->noaction
= ARGS_DEFAULT_NOACTION
;
71 args
->nodeps
= ARGS_DEFAULT_NODEPS
;
72 args
->verbose_wget
= ARGS_DEFAULT_VERBOSE_WGET
;
73 args
->verbosity
= ARGS_DEFAULT_VERBOSITY
;
74 args
->offline_root
= ARGS_DEFAULT_OFFLINE_ROOT
;
75 args
->offline_root_pre_script_cmd
= ARGS_DEFAULT_OFFLINE_ROOT_PRE_SCRIPT_CMD
;
76 args
->offline_root_post_script_cmd
= ARGS_DEFAULT_OFFLINE_ROOT_POST_SCRIPT_CMD
;
77 args
->multiple_providers
= 0;
78 args
->nocheckfordirorfile
= 0;
79 args
->noreadfeedsfile
= 0;
84 void args_deinit(args_t
*args
)
86 free(args
->conf_file
);
87 args
->conf_file
= NULL
;
90 int args_parse(args_t
*args
, int argc
, char *argv
[])
95 static struct option long_options
[] = {
96 {"query-all", 0, 0, 'A'},
97 {"conf-file", 1, 0, 'f'},
100 {"force-defaults", 0, 0, ARGS_OPT_FORCE_DEFAULTS
},
101 {"force_defaults", 0, 0, ARGS_OPT_FORCE_DEFAULTS
},
102 {"force-depends", 0, 0, ARGS_OPT_FORCE_DEPENDS
},
103 {"force_depends", 0, 0, ARGS_OPT_FORCE_DEPENDS
},
104 {"force-overwrite", 0, 0, ARGS_OPT_FORCE_OVERWRITE
},
105 {"force_overwrite", 0, 0, ARGS_OPT_FORCE_OVERWRITE
},
106 {"force_downgrade", 0, 0, ARGS_OPT_FORCE_DOWNGRADE
},
107 {"force-downgrade", 0, 0, ARGS_OPT_FORCE_DOWNGRADE
},
108 {"force-reinstall", 0, 0, ARGS_OPT_FORCE_REINSTALL
},
109 {"force_reinstall", 0, 0, ARGS_OPT_FORCE_REINSTALL
},
110 {"force-space", 0, 0, ARGS_OPT_FORCE_SPACE
},
111 {"force_space", 0, 0, ARGS_OPT_FORCE_SPACE
},
113 ARGS_OPT_FORCE_REMOVAL_OF_DEPENDENT_PACKAGES
},
114 {"force-removal-of-dependent-packages", 0, 0,
115 ARGS_OPT_FORCE_REMOVAL_OF_DEPENDENT_PACKAGES
},
116 {"force_removal_of_dependent_packages", 0, 0,
117 ARGS_OPT_FORCE_REMOVAL_OF_DEPENDENT_PACKAGES
},
118 {"force-removal-of-essential-packages", 0, 0,
119 ARGS_OPT_FORCE_REMOVAL_OF_ESSENTIAL_PACKAGES
},
120 {"force_removal_of_essential_packages", 0, 0,
121 ARGS_OPT_FORCE_REMOVAL_OF_ESSENTIAL_PACKAGES
},
122 {"multiple-providers", 0, 0, ARGS_OPT_MULTIPLE_PROVIDERS
},
123 {"multiple_providers", 0, 0, ARGS_OPT_MULTIPLE_PROVIDERS
},
124 {"noaction", 0, 0, ARGS_OPT_NOACTION
},
125 {"nodeps", 0, 0, ARGS_OPT_NODEPS
},
126 {"offline", 1, 0, 'o'},
127 {"offline-root", 1, 0, 'o'},
128 {"test", 0, 0, ARGS_OPT_NOACTION
},
129 {"tmp-dir", 1, 0, 't'},
130 {"verbose-wget", 0, 0, ARGS_OPT_VERBOSE_WGET
},
131 {"verbose_wget", 0, 0, ARGS_OPT_VERBOSE_WGET
},
132 {"verbosity", 2, 0, 'V'},
133 {"version", 0, 0, 'v'},
138 c
= getopt_long_only(argc
, argv
, "Ad:f:no:t:vV:", long_options
, &option_index
);
150 free(args
->conf_file
);
151 args
->conf_file
= strdup(optarg
);
154 args
->offline_root
= optarg
;
160 args
->tmp_dir
= strdup(optarg
);
166 case ARGS_OPT_VERBOSITY
:
168 args
->verbosity
= atoi(optarg
);
170 args
->verbosity
+= 1;
172 case ARGS_OPT_FORCE_DEFAULTS
:
173 args
->force_defaults
= 1;
175 case ARGS_OPT_FORCE_DEPENDS
:
176 args
->force_depends
= 1;
178 case ARGS_OPT_FORCE_OVERWRITE
:
179 args
->force_overwrite
= 1;
181 case ARGS_OPT_FORCE_DOWNGRADE
:
182 args
->force_downgrade
= 1;
184 case ARGS_OPT_FORCE_REINSTALL
:
185 args
->force_reinstall
= 1;
187 case ARGS_OPT_FORCE_REMOVAL_OF_ESSENTIAL_PACKAGES
:
188 args
->force_removal_of_essential_packages
= 1;
190 case ARGS_OPT_FORCE_REMOVAL_OF_DEPENDENT_PACKAGES
:
191 args
->force_removal_of_dependent_packages
= 1;
193 case ARGS_OPT_FORCE_SPACE
:
194 args
->force_space
= 1;
196 case ARGS_OPT_VERBOSE_WGET
:
197 args
->verbose_wget
= 1;
199 case ARGS_OPT_MULTIPLE_PROVIDERS
:
200 args
->multiple_providers
= 1;
202 case ARGS_OPT_NODEPS
:
205 case ARGS_OPT_NOACTION
:
215 printf("Confusion: getopt_long returned %d\n", c
);
226 void args_usage(char *complaint
)
229 fprintf(stderr
, "opkg: %s\n", complaint
);
232 fprintf(stderr
, "usage: opkg [options...] sub-command [arguments...]\n");
233 fprintf(stderr
, "where sub-command is one of:\n");
235 fprintf(stderr
, "\nPackage Manipulation:\n");
236 fprintf(stderr
, "\tupdate Update list of available packages\n");
237 fprintf(stderr
, "\tupgrade Upgrade all installed packages to latest version\n");
238 fprintf(stderr
, "\tinstall <pkg> Download and install <pkg> (and dependencies)\n");
239 fprintf(stderr
, "\tinstall <file.ipk> Install package <file.ipk>\n");
240 fprintf(stderr
, "\tconfigure [<pkg>] Configure unpacked packages\n");
241 fprintf(stderr
, "\tremove <pkg|regexp> Remove package <pkg|packages following regexp>\n");
242 fprintf(stderr
, "\tflag <flag> <pkg> ... Flag package(s) <pkg>\n");
243 fprintf(stderr
, "\t <flag>=hold|noprune|user|ok|installed|unpacked (one per invocation) \n");
245 fprintf(stderr
, "\nInformational Commands:\n");
246 fprintf(stderr
, "\tlist List available packages and descriptions\n");
247 fprintf(stderr
, "\tlist_installed List all and only the installed packages and description \n");
248 fprintf(stderr
, "\tfiles <pkg> List all files belonging to <pkg>\n");
249 fprintf(stderr
, "\tsearch <file|regexp> Search for a package providing <file>\n");
251 fprintf(stderr
, "\tinfo [pkg|regexp [<field>]] Display all/some info fields for <pkg> or all\n");
252 fprintf(stderr
, "\tstatus [pkg|regexp [<field>]] Display all/some status fields for <pkg> or all\n");
254 fprintf(stderr
, "\tinfo [pkg|regexp] Display all info for <pkg>\n");
255 fprintf(stderr
, "\tstatus [pkg|regexp] Display all status for <pkg>\n");
257 fprintf(stderr
, "\tdownload <pkg> Download <pkg> to current directory.\n");
258 fprintf(stderr
, "\tcompare_versions <v1> <op> <v2>\n");
259 fprintf(stderr
, "\t compare versions using <= < > >= = << >>\n");
260 fprintf(stderr
, "\tprint_architecture prints the architecture.\n");
261 fprintf(stderr
, "\tprint_installation_architecture\n");
262 fprintf(stderr
, "\twhatdepends [-A] [pkgname|pat]+\n");
263 fprintf(stderr
, "\twhatdependsrec [-A] [pkgname|pat]+\n");
264 fprintf(stderr
, "\twhatprovides [-A] [pkgname|pat]+\n");
265 fprintf(stderr
, "\twhatconflicts [-A] [pkgname|pat]+\n");
266 fprintf(stderr
, "\twhatreplaces [-A] [pkgname|pat]+\n");
267 fprintf(stderr
, "\t prints the installation architecture.\n");
268 fprintf(stderr
, "\nOptions:\n");
269 fprintf(stderr
, "\t-A Query all packages with whatdepends, whatprovides, whatreplaces, whatconflicts\n");
270 fprintf(stderr
, "\t-V <level> Set verbosity level to <level>. If no value is\n");
271 fprintf(stderr
, "\t--verbosity <level> provided increase verbosity by one. Verbosity levels:\n");
272 fprintf(stderr
, "\t 0 errors only\n");
273 fprintf(stderr
, "\t 1 normal messages (default)\n");
274 fprintf(stderr
, "\t 2 informative messages\n");
275 fprintf(stderr
, "\t 3 debug output\n");
276 fprintf(stderr
, "\t-f <conf_file> Use <conf_file> as the opkg configuration file\n");
277 fprintf(stderr
, "\t-conf <conf_file> Default configuration file location\n");
278 fprintf(stderr
, " is %s/%s\n", ARGS_DEFAULT_CONF_FILE_DIR
, ARGS_DEFAULT_CONF_FILE_NAME
);
279 fprintf(stderr
, "\t-d <dest_name> Use <dest_name> as the the root directory for\n");
280 fprintf(stderr
, "\t-dest <dest_name> package installation, removal, upgrading.\n");
281 fprintf(stderr
, " <dest_name> should be a defined dest name from\n");
282 fprintf(stderr
, " the configuration file, (but can also be a\n");
283 fprintf(stderr
, " directory name in a pinch).\n");
284 fprintf(stderr
, "\t-o <offline_root> Use <offline_root> as the root directory for\n");
285 fprintf(stderr
, "\t-offline <offline_root> offline installation of packages.\n");
286 fprintf(stderr
, "\t-verbose_wget more wget messages\n");
288 fprintf(stderr
, "\tForce Options (use when opkg is too smart for its own good):\n");
289 fprintf(stderr
, "\t-force-depends Make dependency checks warnings instead of errors\n");
290 fprintf(stderr
, "\t Install/remove package in spite of failed dependences\n");
291 fprintf(stderr
, "\t-force-defaults Use default options for questions asked by opkg.\n");
292 fprintf(stderr
, " (no prompts). Note that this will not prevent\n");
293 fprintf(stderr
, " package installation scripts from prompting.\n");
294 fprintf(stderr
, "\t-force-reinstall Allow opkg to reinstall a package.\n");
295 fprintf(stderr
, "\t-force-overwrite Allow opkg to overwrite files from another package during an install.\n");
296 fprintf(stderr
, "\t-force-downgrade Allow opkg to downgrade packages.\n");
297 fprintf(stderr
, "\t-force_space Install even if there does not seem to be enough space.\n");
298 fprintf(stderr
, "\t-noaction No action -- test only\n");
299 fprintf(stderr
, "\t-nodeps Do not follow dependences\n");
300 fprintf(stderr
, "\t-force-removal-of-dependent-packages\n");
301 fprintf(stderr
, "\t-recursive Allow opkg to remove package and all that depend on it.\n");
302 fprintf(stderr
, "\t-test No action -- test only\n");
303 fprintf(stderr
, "\t-t Specify tmp-dir.\n");
304 fprintf(stderr
, "\t--tmp-dir Specify tmp-dir.\n");
305 fprintf(stderr
, "\n");
306 fprintf(stderr
, "\tregexp could be something like 'pkgname*' '*file*' or similar\n");
307 fprintf(stderr
, "\teg: opkg info 'libstd*' or opkg search '*libop*' or opkg remove 'libncur*'\n");
308 /* -force-removal-of-essential-packages Let opkg remove essential packages.
309 Using this option is almost guaranteed to break your system, hence this option
310 is not even advertised in the usage statement. */
314 static void print_version(void)
316 fprintf(stderr
, "opkg version %s\n", VERSION
);