blob: 9b9d7dbd6fea204c9ef8811d3d34cac882af269b [file] [log] [blame]
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +00001/* vi: set sw=4 ts=4: */
2/*
Denis Vlasenko724d1962007-10-10 14:41:07 +00003 * Utility routines.
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +00004 *
Denis Vlasenko724d1962007-10-10 14:41:07 +00005 * Copyright (C) tons of folks. Tracking down who wrote what
6 * isn't something I'm going to worry about... If you wrote something
7 * here, please feel free to acknowledge your work.
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +00008 *
Denis Vlasenko724d1962007-10-10 14:41:07 +00009 * Based in part on code from sash, Copyright (c) 1999 by David I. Bell
Denys Vlasenko0ef64bd2010-08-16 20:14:46 +020010 * Permission has been granted to redistribute this code under GPL.
Denis Vlasenko724d1962007-10-10 14:41:07 +000011 *
Denys Vlasenko0ef64bd2010-08-16 20:14:46 +020012 * Licensed under GPLv2 or later, see file LICENSE in this source tree.
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +000013 */
Denis Vlasenko79cedcb2008-04-08 21:13:28 +000014/* We are trying to not use printf, this benefits the case when selected
15 * applets are really simple. Example:
16 *
17 * $ ./busybox
18 * ...
19 * Currently defined functions:
20 * basename, false, true
21 *
22 * $ size busybox
23 * text data bss dec hex filename
24 * 4473 52 72 4597 11f5 busybox
25 *
26 * FEATURE_INSTALLER or FEATURE_SUID will still link printf routines in. :(
27 */
Denys Vlasenkoaaa07092020-10-01 01:44:26 +020028
29/* Define this accessor before we #define "errno" our way */
30#include <errno.h>
31static inline int *get_perrno(void) { return &errno; }
32
Denys Vlasenkoc1947f12009-10-23 01:30:26 +020033#include "busybox.h"
Denys Vlasenko9be47022011-05-16 12:21:31 +020034
Denys Vlasenko8da415e2010-12-05 01:30:14 +010035#if !(defined(__FreeBSD__) || defined(__OpenBSD__) || defined(__NetBSD__) \
Denys Vlasenko982e87f2013-07-30 11:52:58 +020036 || defined(__APPLE__) \
Denys Vlasenko8da415e2010-12-05 01:30:14 +010037 )
38# include <malloc.h> /* for mallopt */
39#endif
Denys Vlasenko9be47022011-05-16 12:21:31 +020040
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +000041/* Declare <applet>_main() */
42#define PROTOTYPES
43#include "applets.h"
44#undef PROTOTYPES
45
Denis Vlasenko32b2a9f2008-02-22 22:43:22 +000046/* Include generated applet names, pointers to <applet>_main, etc */
Denis Vlasenko1aa7e472007-11-28 06:49:03 +000047#include "applet_tables.h"
Denis Vlasenko468aea22008-04-01 14:47:57 +000048/* ...and if applet_tables generator says we have only one applet... */
49#ifdef SINGLE_APPLET_MAIN
Denys Vlasenko0e5ba082010-06-05 23:11:07 +020050# undef ENABLE_FEATURE_INDIVIDUAL
51# define ENABLE_FEATURE_INDIVIDUAL 1
52# undef IF_FEATURE_INDIVIDUAL
53# define IF_FEATURE_INDIVIDUAL(...) __VA_ARGS__
Denis Vlasenko468aea22008-04-01 14:47:57 +000054#endif
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +000055
Denys Vlasenko0e5ba082010-06-05 23:11:07 +020056#include "usage_compressed.h"
57
Ron Yorston71df2d32018-11-27 14:34:25 +000058#if ENABLE_FEATURE_SH_EMBEDDED_SCRIPTS
Ron Yorston37788982018-11-17 17:48:14 +000059# define DEFINE_SCRIPT_DATA 1
Denys Vlasenko4f2ef4a2018-11-01 09:53:25 +010060# include "embedded_scripts.h"
61#else
62# define NUM_SCRIPTS 0
63#endif
64#if NUM_SCRIPTS > 0
65# include "bb_archive.h"
66static const char packed_scripts[] ALIGN1 = { PACKED_SCRIPTS };
67#endif
Denys Vlasenkofe936242017-01-06 19:16:36 +010068
69/* "Do not compress usage text if uncompressed text is small
70 * and we don't include bunzip2 code for other reasons"
71 *
72 * Useful for mass one-applet rebuild (bunzip2 code is ~2.7k).
73 *
74 * Unlike BUNZIP2, if FEATURE_SEAMLESS_BZ2 is on, bunzip2 code is built but
75 * still may be unused if none of the selected applets calls open_zipped()
76 * or its friends; we test for (FEATURE_SEAMLESS_BZ2 && <APPLET>) instead.
77 * For example, only if TAR and FEATURE_SEAMLESS_BZ2 are both selected,
78 * then bunzip2 code will be linked in anyway, and disabling help compression
79 * would be not optimal:
80 */
81#if UNPACKED_USAGE_LENGTH < 4*1024 \
82 && !(ENABLE_FEATURE_SEAMLESS_BZ2 && ENABLE_TAR) \
83 && !(ENABLE_FEATURE_SEAMLESS_BZ2 && ENABLE_MODPROBE) \
84 && !(ENABLE_FEATURE_SEAMLESS_BZ2 && ENABLE_INSMOD) \
85 && !(ENABLE_FEATURE_SEAMLESS_BZ2 && ENABLE_DEPMOD) \
86 && !(ENABLE_FEATURE_SEAMLESS_BZ2 && ENABLE_MAN) \
87 && !ENABLE_BUNZIP2 \
88 && !ENABLE_BZCAT
89# undef ENABLE_FEATURE_COMPRESS_USAGE
90# define ENABLE_FEATURE_COMPRESS_USAGE 0
91#endif
92
93
Denys Vlasenkod4e4fdb2017-07-03 21:31:16 +020094unsigned FAST_FUNC string_array_len(char **argv)
95{
96 char **start = argv;
97
98 while (*argv)
99 argv++;
100
101 return argv - start;
102}
103
104
Denys Vlasenko0e5ba082010-06-05 23:11:07 +0200105#if ENABLE_SHOW_USAGE && !ENABLE_FEATURE_COMPRESS_USAGE
106static const char usage_messages[] ALIGN1 = UNPACKED_USAGE;
107#else
108# define usage_messages 0
Denys Vlasenko1fcbff22010-06-26 02:40:08 +0200109#endif
Denys Vlasenko0e5ba082010-06-05 23:11:07 +0200110
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000111#if ENABLE_FEATURE_COMPRESS_USAGE
112
Denys Vlasenko5c296de2010-07-03 14:28:35 +0200113static const char packed_usage[] ALIGN1 = { PACKED_USAGE };
Denys Vlasenkod184a722011-09-22 12:45:14 +0200114# include "bb_archive.h"
Ron Yorstonc339c7f2018-11-02 14:14:31 +0100115# define unpack_usage_messages() \
116 unpack_bz2_data(packed_usage, sizeof(packed_usage), sizeof(UNPACKED_USAGE))
Denys Vlasenko0e5ba082010-06-05 23:11:07 +0200117# define dealloc_usage_messages(s) free(s)
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000118
119#else
120
Denys Vlasenko0e5ba082010-06-05 23:11:07 +0200121# define unpack_usage_messages() usage_messages
122# define dealloc_usage_messages(s) ((void)(s))
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000123
124#endif /* FEATURE_COMPRESS_USAGE */
125
126
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +0000127void FAST_FUNC bb_show_usage(void)
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000128{
129 if (ENABLE_SHOW_USAGE) {
Denis Vlasenko468aea22008-04-01 14:47:57 +0000130#ifdef SINGLE_APPLET_STR
Denys Vlasenkoff653552019-01-01 16:54:30 +0100131 /* Imagine that this applet is "true". Dont link in printf! */
Lauri Kasanen2b662c52010-11-13 23:16:05 +0100132 const char *usage_string = unpack_usage_messages();
Denis Vlasenko468aea22008-04-01 14:47:57 +0000133
Ron Yorstonc339c7f2018-11-02 14:14:31 +0100134 if (usage_string) {
135 if (*usage_string == '\b') {
Denys Vlasenkoff653552019-01-01 16:54:30 +0100136 full_write2_str("No help available\n");
Ron Yorstonc339c7f2018-11-02 14:14:31 +0100137 } else {
138 full_write2_str("Usage: "SINGLE_APPLET_STR" ");
139 full_write2_str(usage_string);
Denys Vlasenkoff653552019-01-01 16:54:30 +0100140 full_write2_str("\n");
Ron Yorstonc339c7f2018-11-02 14:14:31 +0100141 }
142 if (ENABLE_FEATURE_CLEAN_UP)
143 dealloc_usage_messages((char*)usage_string);
Denis Vlasenko468aea22008-04-01 14:47:57 +0000144 }
Denis Vlasenko468aea22008-04-01 14:47:57 +0000145#else
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000146 const char *p;
147 const char *usage_string = p = unpack_usage_messages();
Denis Vlasenko1aa7e472007-11-28 06:49:03 +0000148 int ap = find_applet_by_name(applet_name);
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000149
Ron Yorstonc339c7f2018-11-02 14:14:31 +0100150 if (ap < 0 || usage_string == NULL)
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000151 xfunc_die();
Denis Vlasenko1aa7e472007-11-28 06:49:03 +0000152 while (ap) {
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000153 while (*p++) continue;
Denis Vlasenko1aa7e472007-11-28 06:49:03 +0000154 ap--;
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000155 }
Denis Vlasenko79cedcb2008-04-08 21:13:28 +0000156 full_write2_str(bb_banner);
Denys Vlasenkoff653552019-01-01 16:54:30 +0100157 full_write2_str(" multi-call binary.\n"); /* common string */
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000158 if (*p == '\b')
Denys Vlasenkoff653552019-01-01 16:54:30 +0100159 full_write2_str("\nNo help available\n");
Denis Vlasenko79cedcb2008-04-08 21:13:28 +0000160 else {
161 full_write2_str("\nUsage: ");
162 full_write2_str(applet_name);
Denys Vlasenko253f5552018-07-09 18:23:33 +0200163 if (p[0]) {
164 if (p[0] != '\n')
165 full_write2_str(" ");
166 full_write2_str(p);
167 }
Denys Vlasenko7f4a49a2015-05-25 14:30:52 +0200168 full_write2_str("\n");
Denis Vlasenko79cedcb2008-04-08 21:13:28 +0000169 }
Denys Vlasenko630dde12009-08-30 19:57:49 +0200170 if (ENABLE_FEATURE_CLEAN_UP)
171 dealloc_usage_messages((char*)usage_string);
Denis Vlasenko468aea22008-04-01 14:47:57 +0000172#endif
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000173 }
174 xfunc_die();
175}
176
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +0000177int FAST_FUNC find_applet_by_name(const char *name)
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000178{
Ron Yorston59120c32021-01-29 13:22:48 +0000179 unsigned i;
Ron Yorstonb2206172016-04-03 22:29:35 +0200180 int j;
Denis Vlasenko745cd172007-11-29 03:31:20 +0000181 const char *p;
Ron Yorston610c4c32016-03-30 00:42:05 +0200182
Denys Vlasenkoa93e4fd2016-04-02 22:54:23 +0200183/* The commented-out word-at-a-time code is ~40% faster, but +160 bytes.
184 * "Faster" here saves ~0.5 microsecond of real time - not worth it.
185 */
186#if 0 /*BB_UNALIGNED_MEMACCESS_OK && BB_LITTLE_ENDIAN*/
187 uint32_t n32;
188
189 /* Handle all names < 2 chars long early */
190 if (name[0] == '\0')
191 return -1; /* "" is not a valid applet name */
192 if (name[1] == '\0') {
193 if (!ENABLE_TEST)
194 return -1; /* 1-char name is not valid */
195 if (name[0] != ']')
196 return -1; /* 1-char name which isn't "[" is not valid */
197 /* applet "[" is always applet #0: */
198 return 0;
199 }
200#endif
201
Ron Yorston610c4c32016-03-30 00:42:05 +0200202 p = applet_names;
Ron Yorston610c4c32016-03-30 00:42:05 +0200203#if KNOWN_APPNAME_OFFSETS <= 0
Ron Yorston59120c32021-01-29 13:22:48 +0000204 i = 0;
Denis Vlasenko79cedcb2008-04-08 21:13:28 +0000205#else
Ron Yorston59120c32021-01-29 13:22:48 +0000206 i = NUM_APPLETS * (KNOWN_APPNAME_OFFSETS - 1);
Ron Yorston610c4c32016-03-30 00:42:05 +0200207 for (j = ARRAY_SIZE(applet_nameofs)-1; j >= 0; j--) {
208 const char *pp = applet_names + applet_nameofs[j];
209 if (strcmp(name, pp) >= 0) {
210 //bb_error_msg("name:'%s' >= pp:'%s'", name, pp);
211 p = pp;
Ron Yorston610c4c32016-03-30 00:42:05 +0200212 break;
213 }
Ron Yorston59120c32021-01-29 13:22:48 +0000214 i -= NUM_APPLETS;
Ron Yorston610c4c32016-03-30 00:42:05 +0200215 }
Ron Yorston610c4c32016-03-30 00:42:05 +0200216 i /= (unsigned)KNOWN_APPNAME_OFFSETS;
Ron Yorston59120c32021-01-29 13:22:48 +0000217 //bb_error_msg("name:'%s' starting from:'%s' i:%u", name, p, i);
Ron Yorston610c4c32016-03-30 00:42:05 +0200218#endif
219
Denys Vlasenko1cf68e32016-04-02 22:57:17 +0200220 /* Open-coded linear search without strcmp/strlen calls for speed */
Ron Yorston59120c32021-01-29 13:22:48 +0000221 while (*p) {
222 /* Do we see "name\0" at current position in applet_names? */
223 for (j = 0; *p == name[j]; ++j) {
224 if (*p++ == '\0') {
Ron Yorston610c4c32016-03-30 00:42:05 +0200225 //bb_error_msg("found:'%s' i:%u", name, i);
226 return i; /* yes */
227 }
Ron Yorston610c4c32016-03-30 00:42:05 +0200228 }
Ron Yorston59120c32021-01-29 13:22:48 +0000229 /* No. Have we gone too far, alphabetically? */
230 if (*p > name[j]) {
231 //bb_error_msg("break:'%s' i:%u", name, i);
232 break;
233 }
234 /* No. Move to the start of the next applet name. */
235 while (*p++ != '\0')
236 continue;
Denis Vlasenko79cedcb2008-04-08 21:13:28 +0000237 i++;
238 }
239 return -1;
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000240}
241
242
Denis Vlasenko68404f12008-03-17 09:00:54 +0000243void lbb_prepare(const char *applet
Denis Vlasenko5e34ff22009-04-21 11:09:40 +0000244 IF_FEATURE_INDIVIDUAL(, char **argv))
Denis Vlasenko468aea22008-04-01 14:47:57 +0000245 MAIN_EXTERNALLY_VISIBLE;
246void lbb_prepare(const char *applet
Denis Vlasenko5e34ff22009-04-21 11:09:40 +0000247 IF_FEATURE_INDIVIDUAL(, char **argv))
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000248{
Denys Vlasenkob1c7a662020-10-01 00:34:44 +0200249#ifdef bb_cached_errno_ptr
YU Jincheng5156b242021-10-10 02:19:51 +0800250 ASSIGN_CONST_PTR(&bb_errno, get_perrno());
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000251#endif
Denis Vlasenko15cb4a42007-10-11 10:06:26 +0000252 applet_name = applet;
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000253
Denys Vlasenko45b4ecc2014-08-11 20:33:18 +0200254 if (ENABLE_LOCALE_SUPPORT)
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000255 setlocale(LC_ALL, "");
256
Denis Vlasenko82d38da2007-10-10 14:38:47 +0000257#if ENABLE_FEATURE_INDIVIDUAL
258 /* Redundant for busybox (run_applet_and_exit covers that case)
259 * but needed for "individual applet" mode */
Denys Vlasenko9297dbc2010-07-05 21:37:12 +0200260 if (argv[1]
Denys Vlasenko9297dbc2010-07-05 21:37:12 +0200261 && strcmp(argv[1], "--help") == 0
Denys Vlasenko8dff01d2015-03-12 17:48:34 +0100262 && !is_prefixed_with(applet, "busybox")
Denys Vlasenko9297dbc2010-07-05 21:37:12 +0200263 ) {
Denys Vlasenkof26e5632021-03-15 17:42:25 +0100264 /* Special cases. POSIX says "test --help"
265 * should be no different from e.g. "test --foo".
266 */
267 if (!(ENABLE_TEST && strcmp(applet_name, "test") == 0)
268 && !(ENABLE_TRUE && strcmp(applet_name, "true") == 0)
269 && !(ENABLE_FALSE && strcmp(applet_name, "false") == 0)
270 && !(ENABLE_ECHO && strcmp(applet_name, "echo") == 0)
271 )
Denis Vlasenkobd28f6b2008-07-19 08:15:13 +0000272 bb_show_usage();
273 }
Denis Vlasenko82d38da2007-10-10 14:38:47 +0000274#endif
Denis Vlasenkoac7d0e32007-10-08 19:32:12 +0000275}
Denis Vlasenko724d1962007-10-10 14:41:07 +0000276
277/* The code below can well be in applets/applets.c, as it is used only
278 * for busybox binary, not "individual" binaries.
279 * However, keeping it here and linking it into libbusybox.so
280 * (together with remaining tiny applets/applets.o)
281 * makes it possible to avoid --whole-archive at link time.
282 * This makes (shared busybox) + libbusybox smaller.
283 * (--gc-sections would be even better....)
284 */
285
286const char *applet_name;
287#if !BB_MMU
288bool re_execed;
289#endif
290
Denis Vlasenko468aea22008-04-01 14:47:57 +0000291
Denis Vlasenko10f6fb12008-04-29 00:10:27 +0000292/* If not built as a single-applet executable... */
293#if !defined(SINGLE_APPLET_MAIN)
Denis Vlasenko468aea22008-04-01 14:47:57 +0000294
Denis Vlasenko5e34ff22009-04-21 11:09:40 +0000295IF_FEATURE_SUID(static uid_t ruid;) /* real uid */
Denis Vlasenko724d1962007-10-10 14:41:07 +0000296
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +0100297# if ENABLE_FEATURE_SUID_CONFIG
Denis Vlasenko724d1962007-10-10 14:41:07 +0000298
Denys Vlasenko9be47022011-05-16 12:21:31 +0200299static struct suid_config_t {
300 /* next ptr must be first: this struct needs to be llist-compatible */
301 struct suid_config_t *m_next;
Denys Vlasenko4566e172011-05-16 00:01:08 +0200302 struct bb_uidgid_t m_ugid;
Denys Vlasenko9be47022011-05-16 12:21:31 +0200303 int m_applet;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000304 mode_t m_mode;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000305} *suid_config;
306
307static bool suid_cfg_readable;
308
Denys Vlasenkod83aff12011-05-16 13:53:19 +0200309/* libbb candidate */
Denis Vlasenko724d1962007-10-10 14:41:07 +0000310static char *get_trimmed_slice(char *s, char *e)
311{
312 /* First, consider the value at e to be nul and back up until we
313 * reach a non-space char. Set the char after that (possibly at
314 * the original e) to nul. */
315 while (e-- > s) {
316 if (!isspace(*e)) {
317 break;
318 }
319 }
320 e[1] = '\0';
321
322 /* Next, advance past all leading space and return a ptr to the
323 * first non-space char; possibly the terminating nul. */
324 return skip_whitespace(s);
325}
326
Denis Vlasenko724d1962007-10-10 14:41:07 +0000327static void parse_config_file(void)
328{
Denys Vlasenko3770b6b2011-05-16 13:19:25 +0200329 /* Don't depend on the tools to combine strings. */
330 static const char config_file[] ALIGN1 = "/etc/busybox.conf";
331
Denys Vlasenko9be47022011-05-16 12:21:31 +0200332 struct suid_config_t *sct_head;
Denis Vlasenko1aa7e472007-11-28 06:49:03 +0000333 int applet_no;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000334 FILE *f;
335 const char *errmsg;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000336 unsigned lc;
337 smallint section;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000338 struct stat st;
339
Denis Vlasenko724d1962007-10-10 14:41:07 +0000340 ruid = getuid();
341 if (ruid == 0) /* run by root - don't need to even read config file */
342 return;
343
344 if ((stat(config_file, &st) != 0) /* No config file? */
345 || !S_ISREG(st.st_mode) /* Not a regular file? */
346 || (st.st_uid != 0) /* Not owned by root? */
347 || (st.st_mode & (S_IWGRP | S_IWOTH)) /* Writable by non-root? */
Denys Vlasenko4566e172011-05-16 00:01:08 +0200348 || !(f = fopen_for_read(config_file)) /* Cannot open? */
Denis Vlasenko724d1962007-10-10 14:41:07 +0000349 ) {
350 return;
351 }
352
353 suid_cfg_readable = 1;
354 sct_head = NULL;
355 section = lc = 0;
356
357 while (1) {
Denys Vlasenko9be47022011-05-16 12:21:31 +0200358 char buffer[256];
359 char *s;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000360
Denys Vlasenko9be47022011-05-16 12:21:31 +0200361 if (!fgets(buffer, sizeof(buffer), f)) { /* Are we done? */
Denys Vlasenko4566e172011-05-16 00:01:08 +0200362 // Looks like bloat
363 //if (ferror(f)) { /* Make sure it wasn't a read error. */
364 // errmsg = "reading";
365 // goto pe_label;
366 //}
Denis Vlasenko724d1962007-10-10 14:41:07 +0000367 fclose(f);
368 suid_config = sct_head; /* Success, so set the pointer. */
369 return;
370 }
371
Denys Vlasenko9be47022011-05-16 12:21:31 +0200372 s = buffer;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000373 lc++; /* Got a (partial) line. */
374
375 /* If a line is too long for our buffer, we consider it an error.
376 * The following test does mistreat one corner case though.
377 * If the final line of the file does not end with a newline and
378 * yet exactly fills the buffer, it will be treated as too long
379 * even though there isn't really a problem. But it isn't really
380 * worth adding code to deal with such an unlikely situation, and
381 * we do err on the side of caution. Besides, the line would be
382 * too long if it did end with a newline. */
383 if (!strchr(s, '\n') && !feof(f)) {
Denys Vlasenko4566e172011-05-16 00:01:08 +0200384 errmsg = "line too long";
385 goto pe_label;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000386 }
387
388 /* Trim leading and trailing whitespace, ignoring comments, and
389 * check if the resulting string is empty. */
390 s = get_trimmed_slice(s, strchrnul(s, '#'));
391 if (!*s) {
392 continue;
393 }
394
395 /* Check for a section header. */
396
397 if (*s == '[') {
398 /* Unlike the old code, we ignore leading and trailing
399 * whitespace for the section name. We also require that
400 * there are no stray characters after the closing bracket. */
Denys Vlasenko9be47022011-05-16 12:21:31 +0200401 char *e = strchr(s, ']');
Denis Vlasenko724d1962007-10-10 14:41:07 +0000402 if (!e /* Missing right bracket? */
403 || e[1] /* Trailing characters? */
404 || !*(s = get_trimmed_slice(s+1, e)) /* Missing name? */
405 ) {
Denys Vlasenko4566e172011-05-16 00:01:08 +0200406 errmsg = "section header";
407 goto pe_label;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000408 }
409 /* Right now we only have one section so just check it.
410 * If more sections are added in the future, please don't
411 * resort to cascading ifs with multiple strcasecmp calls.
412 * That kind of bloated code is all too common. A loop
413 * and a string table would be a better choice unless the
414 * number of sections is very small. */
415 if (strcasecmp(s, "SUID") == 0) {
416 section = 1;
417 continue;
418 }
419 section = -1; /* Unknown section so set to skip. */
420 continue;
421 }
422
423 /* Process sections. */
424
425 if (section == 1) { /* SUID */
426 /* Since we trimmed leading and trailing space above, we're
427 * now looking for strings of the form
428 * <key>[::space::]*=[::space::]*<value>
429 * where both key and value could contain inner whitespace. */
430
431 /* First get the key (an applet name in our case). */
Denys Vlasenko9be47022011-05-16 12:21:31 +0200432 char *e = strchr(s, '=');
Denis Vlasenko724d1962007-10-10 14:41:07 +0000433 if (e) {
434 s = get_trimmed_slice(s, e);
435 }
436 if (!e || !*s) { /* Missing '=' or empty key. */
Denys Vlasenko4566e172011-05-16 00:01:08 +0200437 errmsg = "keyword";
438 goto pe_label;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000439 }
440
441 /* Ok, we have an applet name. Process the rhs if this
442 * applet is currently built in and ignore it otherwise.
443 * Note: this can hide config file bugs which only pop
444 * up when the busybox configuration is changed. */
Denis Vlasenko1aa7e472007-11-28 06:49:03 +0000445 applet_no = find_applet_by_name(s);
446 if (applet_no >= 0) {
Denys Vlasenko3770b6b2011-05-16 13:19:25 +0200447 unsigned i;
Denys Vlasenko9be47022011-05-16 12:21:31 +0200448 struct suid_config_t *sct;
449
Denis Vlasenko724d1962007-10-10 14:41:07 +0000450 /* Note: We currently don't check for duplicates!
451 * The last config line for each applet will be the
452 * one used since we insert at the head of the list.
453 * I suppose this could be considered a feature. */
Denys Vlasenko4566e172011-05-16 00:01:08 +0200454 sct = xzalloc(sizeof(*sct));
Denis Vlasenko1aa7e472007-11-28 06:49:03 +0000455 sct->m_applet = applet_no;
Denys Vlasenko4566e172011-05-16 00:01:08 +0200456 /*sct->m_mode = 0;*/
Denis Vlasenko724d1962007-10-10 14:41:07 +0000457 sct->m_next = sct_head;
458 sct_head = sct;
459
460 /* Get the specified mode. */
461
462 e = skip_whitespace(e+1);
463
464 for (i = 0; i < 3; i++) {
Denys Vlasenko3770b6b2011-05-16 13:19:25 +0200465 /* There are 4 chars for each of user/group/other.
466 * "x-xx" instead of "x-" are to make
467 * "idx > 3" check catch invalid chars.
468 */
469 static const char mode_chars[] ALIGN1 = "Ssx-" "Ssx-" "x-xx";
470 static const unsigned short mode_mask[] ALIGN2 = {
471 S_ISUID, S_ISUID|S_IXUSR, S_IXUSR, 0, /* Ssx- */
472 S_ISGID, S_ISGID|S_IXGRP, S_IXGRP, 0, /* Ssx- */
473 S_IXOTH, 0 /* x- */
474 };
475 const char *q = strchrnul(mode_chars + 4*i, *e);
476 unsigned idx = q - (mode_chars + 4*i);
477 if (idx > 3) {
Denys Vlasenko4566e172011-05-16 00:01:08 +0200478 errmsg = "mode";
479 goto pe_label;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000480 }
Denys Vlasenko3770b6b2011-05-16 13:19:25 +0200481 sct->m_mode |= mode_mask[q - mode_chars];
482 e++;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000483 }
484
Marek Polacekb0b88842011-04-16 17:33:43 +0200485 /* Now get the user/group info. */
Denis Vlasenko724d1962007-10-10 14:41:07 +0000486
487 s = skip_whitespace(e);
Denys Vlasenko351fec32011-05-16 14:30:26 +0200488 /* Default is 0.0, else parse USER.GROUP: */
489 if (*s) {
490 /* We require whitespace between mode and USER.GROUP */
491 if ((s == e) || !(e = strchr(s, '.'))) {
492 errmsg = "uid.gid";
493 goto pe_label;
494 }
495 *e = ':'; /* get_uidgid needs USER:GROUP syntax */
Denys Vlasenko526d8582015-10-19 04:27:17 +0200496 if (get_uidgid(&sct->m_ugid, s) == 0) {
Denys Vlasenko351fec32011-05-16 14:30:26 +0200497 errmsg = "unknown user/group";
498 goto pe_label;
499 }
Denis Vlasenko724d1962007-10-10 14:41:07 +0000500 }
501 }
502 continue;
503 }
504
505 /* Unknown sections are ignored. */
506
507 /* Encountering configuration lines prior to seeing a
508 * section header is treated as an error. This is how
509 * the old code worked, but it may not be desirable.
510 * We may want to simply ignore such lines in case they
511 * are used in some future version of busybox. */
512 if (!section) {
Denys Vlasenko4566e172011-05-16 00:01:08 +0200513 errmsg = "keyword outside section";
514 goto pe_label;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000515 }
Denis Vlasenko724d1962007-10-10 14:41:07 +0000516 } /* while (1) */
517
518 pe_label:
Denys Vlasenko9be47022011-05-16 12:21:31 +0200519 fclose(f);
Denys Vlasenko4566e172011-05-16 00:01:08 +0200520 bb_error_msg("parse error in %s, line %u: %s", config_file, lc, errmsg);
Denis Vlasenko724d1962007-10-10 14:41:07 +0000521
Denis Vlasenko724d1962007-10-10 14:41:07 +0000522 /* Release any allocated memory before returning. */
Denys Vlasenko9be47022011-05-16 12:21:31 +0200523 llist_free((llist_t*)sct_head, NULL);
Denis Vlasenko724d1962007-10-10 14:41:07 +0000524}
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +0100525# else
Denis Vlasenko724d1962007-10-10 14:41:07 +0000526static inline void parse_config_file(void)
527{
Denis Vlasenko5e34ff22009-04-21 11:09:40 +0000528 IF_FEATURE_SUID(ruid = getuid();)
Denis Vlasenko724d1962007-10-10 14:41:07 +0000529}
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +0100530# endif /* FEATURE_SUID_CONFIG */
Denis Vlasenko724d1962007-10-10 14:41:07 +0000531
532
Denys Vlasenko9cc3d3a2016-12-23 02:42:26 +0100533# if ENABLE_FEATURE_SUID && NUM_APPLETS > 0
Cristian Ionescu-Idbohrnf1d76b62017-01-02 11:17:09 +0100534# if ENABLE_FEATURE_SUID_CONFIG
Denys Vlasenko9cc3d3a2016-12-23 02:42:26 +0100535/* check if u is member of group g */
536static int ingroup(uid_t u, gid_t g)
537{
538 struct group *grp = getgrgid(g);
539 if (grp) {
540 char **mem;
541 for (mem = grp->gr_mem; *mem; mem++) {
542 struct passwd *pwd = getpwnam(*mem);
543 if (pwd && (pwd->pw_uid == u))
544 return 1;
545 }
546 }
547 return 0;
548}
Cristian Ionescu-Idbohrnf1d76b62017-01-02 11:17:09 +0100549# endif
Denys Vlasenko9cc3d3a2016-12-23 02:42:26 +0100550
Denis Vlasenko1aa7e472007-11-28 06:49:03 +0000551static void check_suid(int applet_no)
Denis Vlasenko724d1962007-10-10 14:41:07 +0000552{
553 gid_t rgid; /* real gid */
554
555 if (ruid == 0) /* set by parse_config_file() */
556 return; /* run by root - no need to check more */
557 rgid = getgid();
558
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +0100559# if ENABLE_FEATURE_SUID_CONFIG
Denis Vlasenko724d1962007-10-10 14:41:07 +0000560 if (suid_cfg_readable) {
561 uid_t uid;
Denys Vlasenko9be47022011-05-16 12:21:31 +0200562 struct suid_config_t *sct;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000563 mode_t m;
564
565 for (sct = suid_config; sct; sct = sct->m_next) {
Denis Vlasenko1aa7e472007-11-28 06:49:03 +0000566 if (sct->m_applet == applet_no)
Denis Vlasenko724d1962007-10-10 14:41:07 +0000567 goto found;
568 }
Denis Vlasenko15ca51e2007-10-29 19:25:45 +0000569 goto check_need_suid;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000570 found:
Denys Vlasenko3770b6b2011-05-16 13:19:25 +0200571 /* Is this user allowed to run this applet? */
Denis Vlasenko724d1962007-10-10 14:41:07 +0000572 m = sct->m_mode;
Denys Vlasenko4566e172011-05-16 00:01:08 +0200573 if (sct->m_ugid.uid == ruid)
Denis Vlasenko724d1962007-10-10 14:41:07 +0000574 /* same uid */
575 m >>= 6;
Denys Vlasenko4566e172011-05-16 00:01:08 +0200576 else if ((sct->m_ugid.gid == rgid) || ingroup(ruid, sct->m_ugid.gid))
Denis Vlasenko724d1962007-10-10 14:41:07 +0000577 /* same group / in group */
578 m >>= 3;
Denys Vlasenko3770b6b2011-05-16 13:19:25 +0200579 if (!(m & S_IXOTH)) /* is x bit not set? */
James Byrne69374872019-07-02 11:35:03 +0200580 bb_simple_error_msg_and_die("you have no permission to run this applet");
Denis Vlasenko724d1962007-10-10 14:41:07 +0000581
Denis Vlasenko724d1962007-10-10 14:41:07 +0000582 /* We set effective AND saved ids. If saved-id is not set
Denys Vlasenko3770b6b2011-05-16 13:19:25 +0200583 * like we do below, seteuid(0) can still later succeed! */
584
585 /* Are we directed to change gid
586 * (APPLET = *s* USER.GROUP or APPLET = *S* USER.GROUP)?
587 */
588 if (sct->m_mode & S_ISGID)
589 rgid = sct->m_ugid.gid;
590 /* else: we will set egid = rgid, thus dropping sgid effect */
Denis Vlasenko724d1962007-10-10 14:41:07 +0000591 if (setresgid(-1, rgid, rgid))
James Byrne69374872019-07-02 11:35:03 +0200592 bb_simple_perror_msg_and_die("setresgid");
Denis Vlasenko724d1962007-10-10 14:41:07 +0000593
Denys Vlasenko3770b6b2011-05-16 13:19:25 +0200594 /* Are we directed to change uid
595 * (APPLET = s** USER.GROUP or APPLET = S** USER.GROUP)?
596 */
Denis Vlasenko724d1962007-10-10 14:41:07 +0000597 uid = ruid;
598 if (sct->m_mode & S_ISUID)
Denys Vlasenko4566e172011-05-16 00:01:08 +0200599 uid = sct->m_ugid.uid;
Denys Vlasenko3770b6b2011-05-16 13:19:25 +0200600 /* else: we will set euid = ruid, thus dropping suid effect */
Denis Vlasenko724d1962007-10-10 14:41:07 +0000601 if (setresuid(-1, uid, uid))
James Byrne69374872019-07-02 11:35:03 +0200602 bb_simple_perror_msg_and_die("setresuid");
Denys Vlasenko3770b6b2011-05-16 13:19:25 +0200603
Denys Vlasenko9be47022011-05-16 12:21:31 +0200604 goto ret;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000605 }
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +0100606# if !ENABLE_FEATURE_SUID_CONFIG_QUIET
Denis Vlasenko724d1962007-10-10 14:41:07 +0000607 {
608 static bool onetime = 0;
609
610 if (!onetime) {
611 onetime = 1;
James Byrne69374872019-07-02 11:35:03 +0200612 bb_simple_error_msg("using fallback suid method");
Denis Vlasenko724d1962007-10-10 14:41:07 +0000613 }
614 }
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +0100615# endif
Denis Vlasenko15ca51e2007-10-29 19:25:45 +0000616 check_need_suid:
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +0100617# endif
Denys Vlasenkob9f2d9f2011-01-18 13:58:01 +0100618 if (APPLET_SUID(applet_no) == BB_SUID_REQUIRE) {
Denis Vlasenko724d1962007-10-10 14:41:07 +0000619 /* Real uid is not 0. If euid isn't 0 too, suid bit
620 * is most probably not set on our executable */
621 if (geteuid())
James Byrne69374872019-07-02 11:35:03 +0200622 bb_simple_error_msg_and_die("must be suid to work properly");
Denys Vlasenkob9f2d9f2011-01-18 13:58:01 +0100623 } else if (APPLET_SUID(applet_no) == BB_SUID_DROP) {
Denys Vlasenko12a4f9a2017-07-10 09:17:43 +0200624 /*
625 * Drop all privileges.
626 *
627 * Don't check for errors: in normal use, they are impossible,
628 * and in special cases, exiting is harmful. Example:
629 * 'unshare --user' when user's shell is also from busybox.
630 *
631 * 'unshare --user' creates a new user namespace without any
632 * uid mappings. Thus, busybox binary is setuid nobody:nogroup
633 * within the namespace, as that is the only user. However,
634 * since no uids are mapped, calls to setgid/setuid
635 * fail (even though they would do nothing).
636 */
637 setgid(rgid);
638 setuid(ruid);
Denis Vlasenko724d1962007-10-10 14:41:07 +0000639 }
Denys Vlasenko9be47022011-05-16 12:21:31 +0200640# if ENABLE_FEATURE_SUID_CONFIG
Cristian Ionescu-Idbohrnea137aa2011-05-20 03:52:36 +0200641 ret: ;
Denys Vlasenko9be47022011-05-16 12:21:31 +0200642 llist_free((llist_t*)suid_config, NULL);
643# endif
Denis Vlasenko724d1962007-10-10 14:41:07 +0000644}
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +0100645# else
646# define check_suid(x) ((void)0)
647# endif /* FEATURE_SUID */
Denis Vlasenko724d1962007-10-10 14:41:07 +0000648
649
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +0100650# if ENABLE_FEATURE_INSTALLER
Denys Vlasenko5a7c7202010-04-20 21:02:57 -0400651static const char usr_bin [] ALIGN1 = "/usr/bin/";
652static const char usr_sbin[] ALIGN1 = "/usr/sbin/";
Denys Vlasenkoca466f32022-02-06 19:53:10 +0100653static const char *const install_dir[] ALIGN_PTR = {
Denys Vlasenko5a7c7202010-04-20 21:02:57 -0400654 &usr_bin [8], /* "/" */
655 &usr_bin [4], /* "/bin/" */
Denys Vlasenkod4d289a2010-10-12 04:18:05 +0200656 &usr_sbin[4] /* "/sbin/" */
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +0100657# if !ENABLE_INSTALL_NO_USR
Denys Vlasenkod4d289a2010-10-12 04:18:05 +0200658 ,usr_bin
659 ,usr_sbin
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +0100660# endif
Denys Vlasenko5a7c7202010-04-20 21:02:57 -0400661};
662
Denis Vlasenko724d1962007-10-10 14:41:07 +0000663/* create (sym)links for each applet */
Denys Vlasenko3b405432009-07-15 00:35:34 +0200664static void install_links(const char *busybox, int use_symbolic_links,
665 char *custom_install_dir)
Denis Vlasenko724d1962007-10-10 14:41:07 +0000666{
667 /* directory table
668 * this should be consistent w/ the enum,
669 * busybox.h::bb_install_loc_t, or else... */
Denis Vlasenko1aa7e472007-11-28 06:49:03 +0000670 int (*lf)(const char *, const char *);
Denis Vlasenko724d1962007-10-10 14:41:07 +0000671 char *fpc;
Denys Vlasenko4c201c02018-07-17 15:04:17 +0200672 const char *appname = applet_names;
Denis Vlasenko6b06cb82008-05-15 21:30:45 +0000673 unsigned i;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000674 int rc;
675
Denis Vlasenko1aa7e472007-11-28 06:49:03 +0000676 lf = link;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000677 if (use_symbolic_links)
678 lf = symlink;
679
Denis Vlasenko745cd172007-11-29 03:31:20 +0000680 for (i = 0; i < ARRAY_SIZE(applet_main); i++) {
Denis Vlasenko724d1962007-10-10 14:41:07 +0000681 fpc = concat_path_file(
Denys Vlasenko3b405432009-07-15 00:35:34 +0200682 custom_install_dir ? custom_install_dir : install_dir[APPLET_INSTALL_LOC(i)],
Ron Yorston610c4c32016-03-30 00:42:05 +0200683 appname);
Denis Vlasenko745cd172007-11-29 03:31:20 +0000684 // debug: bb_error_msg("%slinking %s to busybox",
685 // use_symbolic_links ? "sym" : "", fpc);
Denis Vlasenko724d1962007-10-10 14:41:07 +0000686 rc = lf(busybox, fpc);
687 if (rc != 0 && errno != EEXIST) {
688 bb_simple_perror_msg(fpc);
689 }
690 free(fpc);
Ron Yorston610c4c32016-03-30 00:42:05 +0200691 while (*appname++ != '\0')
692 continue;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000693 }
694}
Denys Vlasenko8e950682016-05-31 02:42:49 +0200695# elif ENABLE_BUSYBOX
Mike Frysingerf1999b52014-01-31 00:29:47 -0500696static void install_links(const char *busybox UNUSED_PARAM,
697 int use_symbolic_links UNUSED_PARAM,
698 char *custom_install_dir UNUSED_PARAM)
699{
700}
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +0100701# endif
Denis Vlasenko724d1962007-10-10 14:41:07 +0000702
Denys Vlasenko67e15292020-06-24 13:39:13 +0200703# if ENABLE_BUSYBOX || NUM_APPLETS > 0
Ron Yorston1b0dcc02016-07-05 14:07:50 +0100704static void run_applet_and_exit(const char *name, char **argv) NORETURN;
Denys Vlasenko67e15292020-06-24 13:39:13 +0200705#endif
Ron Yorston1b0dcc02016-07-05 14:07:50 +0100706
Ron Yorstond1b2ae22018-11-18 19:12:26 +0100707# if NUM_SCRIPTS > 0
708static int find_script_by_name(const char *name)
709{
710 int i;
711 int applet = find_applet_by_name(name);
712
713 if (applet >= 0) {
714 for (i = 0; i < NUM_SCRIPTS; ++i)
715 if (applet_numbers[i] == applet)
716 return i;
717 }
718 return -1;
719}
720
Ron Yorston3193cb52019-03-30 07:47:12 +0000721int scripted_main(int argc UNUSED_PARAM, char **argv) MAIN_EXTERNALLY_VISIBLE;
Ron Yorstond1b2ae22018-11-18 19:12:26 +0100722int scripted_main(int argc UNUSED_PARAM, char **argv)
723{
724 int script = find_script_by_name(applet_name);
725 if (script >= 0)
Denys Vlasenko67e15292020-06-24 13:39:13 +0200726# if ENABLE_SHELL_ASH
Denys Vlasenko03ed86b2021-09-28 17:40:59 +0200727 return ash_main(-script - 1, argv);
Denys Vlasenko67e15292020-06-24 13:39:13 +0200728# elif ENABLE_SHELL_HUSH
Denys Vlasenko03ed86b2021-09-28 17:40:59 +0200729 return hush_main(-script - 1, argv);
Denys Vlasenko67e15292020-06-24 13:39:13 +0200730# else
Ron Yorston71df2d32018-11-27 14:34:25 +0000731 return 1;
Denys Vlasenko67e15292020-06-24 13:39:13 +0200732# endif
Ron Yorstond1b2ae22018-11-18 19:12:26 +0100733 return 0;
734}
735
736char* FAST_FUNC
737get_script_content(unsigned n)
738{
739 char *t = unpack_bz2_data(packed_scripts, sizeof(packed_scripts),
740 UNPACKED_SCRIPTS_LENGTH);
741 if (t) {
742 while (n != 0) {
743 while (*t++ != '\0')
744 continue;
745 n--;
746 }
747 }
748 return t;
749}
750# endif /* NUM_SCRIPTS > 0 */
751
Denys Vlasenkof128bdb2017-07-29 00:59:24 +0200752# if ENABLE_BUSYBOX
753# if ENABLE_FEATURE_SH_STANDALONE && ENABLE_FEATURE_TAB_COMPLETION
754 /*
755 * Insert "busybox" into applet table as well.
756 * This makes standalone shell tab-complete this name too.
757 * (Otherwise having "busybox" in applet table is not necessary,
758 * there is other code which routes "busyboxANY_SUFFIX" name
759 * to busybox_main()).
760 */
761//usage:#define busybox_trivial_usage NOUSAGE_STR
762//usage:#define busybox_full_usage ""
763//applet:IF_BUSYBOX(IF_FEATURE_SH_STANDALONE(IF_FEATURE_TAB_COMPLETION(APPLET(busybox, BB_DIR_BIN, BB_SUID_MAYBE))))
Denys Vlasenko9b6f44e2022-05-01 17:06:00 +0200764int busybox_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
Denys Vlasenkof128bdb2017-07-29 00:59:24 +0200765# else
766# define busybox_main(argc,argv) busybox_main(argv)
767static
768# endif
769int busybox_main(int argc UNUSED_PARAM, char **argv)
Denis Vlasenko724d1962007-10-10 14:41:07 +0000770{
771 if (!argv[1]) {
772 /* Called without arguments */
Denis Vlasenko1aa7e472007-11-28 06:49:03 +0000773 const char *a;
Denys Vlasenko0149f022009-05-19 18:01:42 +0200774 int col;
775 unsigned output_width;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000776 help:
Denys Vlasenkoa8a075a2017-01-11 10:52:24 +0100777 output_width = get_terminal_width(2);
Denis Vlasenko724d1962007-10-10 14:41:07 +0000778
Denis Vlasenko21278df2008-06-25 12:15:46 +0000779 dup2(1, 2);
Denys Vlasenko630dde12009-08-30 19:57:49 +0200780 full_write2_str(bb_banner); /* reuse const string */
781 full_write2_str(" multi-call binary.\n"); /* reuse */
782 full_write2_str(
Aaro Koskinen7b729ed2015-04-02 00:55:17 +0300783 "BusyBox is copyrighted by many authors between 1998-2015.\n"
Bradley M. Kuhn0e941d52012-07-13 11:38:38 -0400784 "Licensed under GPLv2. See source distribution for detailed\n"
785 "copyright notices.\n"
Denys Vlasenko5a7c7202010-04-20 21:02:57 -0400786 "\n"
Denys Vlasenko02b8b9b2012-05-14 23:52:57 +0200787 "Usage: busybox [function [arguments]...]\n"
Denys Vlasenkoba888262012-03-22 11:15:06 +0100788 " or: busybox --list"IF_FEATURE_INSTALLER("[-full]")"\n"
Ron Yorstond1b2ae22018-11-18 19:12:26 +0100789# if ENABLE_FEATURE_SHOW_SCRIPT && NUM_SCRIPTS > 0
790 " or: busybox --show SCRIPT\n"
791# endif
Denys Vlasenkoba888262012-03-22 11:15:06 +0100792 IF_FEATURE_INSTALLER(
793 " or: busybox --install [-s] [DIR]\n"
794 )
Denys Vlasenko5a7c7202010-04-20 21:02:57 -0400795 " or: function [arguments]...\n"
796 "\n"
Ron Yorstonae57af62015-05-30 17:13:52 +0100797 IF_NOT_FEATURE_SH_STANDALONE(
Denys Vlasenko5a7c7202010-04-20 21:02:57 -0400798 "\tBusyBox is a multi-call binary that combines many common Unix\n"
799 "\tutilities into a single executable. Most people will create a\n"
800 "\tlink to busybox for each function they wish to use and BusyBox\n"
801 "\twill act like whatever it was invoked as.\n"
Ron Yorstonae57af62015-05-30 17:13:52 +0100802 )
803 IF_FEATURE_SH_STANDALONE(
804 "\tBusyBox is a multi-call binary that combines many common Unix\n"
805 "\tutilities into a single executable. The shell in this build\n"
806 "\tis configured to run built-in utilities without $PATH search.\n"
807 "\tYou don't need to install a link to busybox for each utility.\n"
808 "\tTo run external program, use full path (/sbin/ip instead of ip).\n"
809 )
Denys Vlasenko5a7c7202010-04-20 21:02:57 -0400810 "\n"
811 "Currently defined functions:\n"
812 );
Denis Vlasenko724d1962007-10-10 14:41:07 +0000813 col = 0;
Denys Vlasenko0149f022009-05-19 18:01:42 +0200814 /* prevent last comma to be in the very last pos */
815 output_width--;
Denys Vlasenko0575c992018-11-01 13:58:16 +0100816 a = applet_names;
Ron Yorston37788982018-11-17 17:48:14 +0000817 while (*a) {
818 int len2 = strlen(a) + 2;
819 if (col >= (int)output_width - len2) {
820 full_write2_str(",\n");
821 col = 0;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000822 }
Ron Yorston37788982018-11-17 17:48:14 +0000823 if (col == 0) {
824 col = 6;
825 full_write2_str("\t");
826 } else {
827 full_write2_str(", ");
828 }
829 full_write2_str(a);
830 col += len2;
831 a += len2 - 1;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000832 }
Denys Vlasenko7d877fc2016-11-28 01:29:28 +0100833 full_write2_str("\n");
Denis Vlasenko724d1962007-10-10 14:41:07 +0000834 return 0;
835 }
836
Ron Yorstond1b2ae22018-11-18 19:12:26 +0100837# if ENABLE_FEATURE_SHOW_SCRIPT && NUM_SCRIPTS > 0
838 if (strcmp(argv[1], "--show") == 0) {
839 int n;
840 if (!argv[2])
841 bb_error_msg_and_die(bb_msg_requires_arg, "--show");
842 n = find_script_by_name(argv[2]);
843 if (n < 0)
844 bb_error_msg_and_die("script '%s' not found", argv[2]);
845 full_write1_str(get_script_content(n));
846 return 0;
847 }
848# endif
849
Denys Vlasenko8dff01d2015-03-12 17:48:34 +0100850 if (is_prefixed_with(argv[1], "--list")) {
Denys Vlasenko5a7c7202010-04-20 21:02:57 -0400851 unsigned i = 0;
852 const char *a = applet_names;
853 dup2(1, 2);
854 while (*a) {
Denys Vlasenko8e950682016-05-31 02:42:49 +0200855# if ENABLE_FEATURE_INSTALLER
Denys Vlasenkoba888262012-03-22 11:15:06 +0100856 if (argv[1][6]) /* --list-full? */
Denys Vlasenko5a7c7202010-04-20 21:02:57 -0400857 full_write2_str(install_dir[APPLET_INSTALL_LOC(i)] + 1);
Denys Vlasenko8e950682016-05-31 02:42:49 +0200858# endif
Denys Vlasenko5a7c7202010-04-20 21:02:57 -0400859 full_write2_str(a);
860 full_write2_str("\n");
861 i++;
Ron Yorston2b919582016-04-08 11:57:20 +0100862 while (*a++ != '\0')
863 continue;
Denys Vlasenko5a7c7202010-04-20 21:02:57 -0400864 }
865 return 0;
866 }
867
Denis Vlasenko724d1962007-10-10 14:41:07 +0000868 if (ENABLE_FEATURE_INSTALLER && strcmp(argv[1], "--install") == 0) {
Denys Vlasenko3b405432009-07-15 00:35:34 +0200869 int use_symbolic_links;
Denis Vlasenko724d1962007-10-10 14:41:07 +0000870 const char *busybox;
Denys Vlasenko4a2a86d2011-03-06 06:02:31 +0100871
Denis Vlasenko724d1962007-10-10 14:41:07 +0000872 busybox = xmalloc_readlink(bb_busybox_exec_path);
Denys Vlasenko4a2a86d2011-03-06 06:02:31 +0100873 if (!busybox) {
874 /* bb_busybox_exec_path is usually "/proc/self/exe".
875 * In chroot, readlink("/proc/self/exe") usually fails.
876 * In such case, better use argv[0] as symlink target
877 * if it is a full path name.
878 */
Denys Vlasenko5c942712011-03-12 06:08:28 +0100879 if (argv[0][0] != '/')
880 bb_error_msg_and_die("'%s' is not an absolute path", argv[0]);
881 busybox = argv[0];
Denys Vlasenko4a2a86d2011-03-06 06:02:31 +0100882 }
883 /* busybox --install [-s] [DIR]:
884 * -s: make symlinks
885 * DIR: directory to install links to
886 */
Denys Vlasenkoba888262012-03-22 11:15:06 +0100887 use_symbolic_links = (argv[2] && strcmp(argv[2], "-s") == 0 && ++argv);
Denys Vlasenko3b405432009-07-15 00:35:34 +0200888 install_links(busybox, use_symbolic_links, argv[2]);
Denis Vlasenko724d1962007-10-10 14:41:07 +0000889 return 0;
890 }
891
892 if (strcmp(argv[1], "--help") == 0) {
893 /* "busybox --help [<applet>]" */
Denys Vlasenko59243a82021-08-16 08:53:42 +0200894 if (!argv[2]
895# if ENABLE_FEATURE_SH_STANDALONE && ENABLE_FEATURE_TAB_COMPLETION
896 || strcmp(argv[2], "busybox") == 0 /* prevent getting "No help available" */
897# endif
898 )
Denis Vlasenko724d1962007-10-10 14:41:07 +0000899 goto help;
900 /* convert to "<applet> --help" */
Denys Vlasenkof26e5632021-03-15 17:42:25 +0100901 applet_name = argv[0] = argv[2];
Denis Vlasenko724d1962007-10-10 14:41:07 +0000902 argv[2] = NULL;
Denys Vlasenkof26e5632021-03-15 17:42:25 +0100903 if (find_applet_by_name(applet_name) >= 0) {
904 /* Make "--help foo" exit with 0: */
905 xfunc_error_retval = 0;
906 bb_show_usage();
907 } /* else: unknown applet, fall through (causes "applet not found" later) */
Denis Vlasenko724d1962007-10-10 14:41:07 +0000908 } else {
909 /* "busybox <applet> arg1 arg2 ..." */
910 argv++;
Denys Vlasenkof26e5632021-03-15 17:42:25 +0100911 /* We support "busybox /a/path/to/applet args..." too. Allows for
912 * "#!/bin/busybox"-style wrappers
913 */
914 applet_name = bb_get_last_path_component_nostrip(argv[0]);
Denis Vlasenko724d1962007-10-10 14:41:07 +0000915 }
Denis Vlasenko724d1962007-10-10 14:41:07 +0000916 run_applet_and_exit(applet_name, argv);
Denis Vlasenko724d1962007-10-10 14:41:07 +0000917}
Denys Vlasenko8e950682016-05-31 02:42:49 +0200918# endif
Denis Vlasenko724d1962007-10-10 14:41:07 +0000919
Denys Vlasenkof4f8fe82016-07-05 21:43:28 +0200920# if NUM_APPLETS > 0
Denys Vlasenko6bdfbc42021-02-18 23:30:24 +0100921void FAST_FUNC show_usage_if_dash_dash_help(int applet_no, char **argv)
Denis Vlasenko724d1962007-10-10 14:41:07 +0000922{
Denys Vlasenkocd7a38a2014-09-18 00:47:05 +0200923 /* Special case. POSIX says "test --help"
924 * should be no different from e.g. "test --foo".
925 * Thus for "test", we skip --help check.
Denys Vlasenkof26e5632021-03-15 17:42:25 +0100926 * "true", "false", "echo" are also special.
Denys Vlasenkocd7a38a2014-09-18 00:47:05 +0200927 */
Denys Vlasenkode5edad2015-04-21 16:00:41 +0200928 if (1
Denys Vlasenkof4f8fe82016-07-05 21:43:28 +0200929# if defined APPLET_NO_test
Denys Vlasenkode5edad2015-04-21 16:00:41 +0200930 && applet_no != APPLET_NO_test
Denys Vlasenkof4f8fe82016-07-05 21:43:28 +0200931# endif
932# if defined APPLET_NO_true
Denys Vlasenkode5edad2015-04-21 16:00:41 +0200933 && applet_no != APPLET_NO_true
Denys Vlasenkof4f8fe82016-07-05 21:43:28 +0200934# endif
935# if defined APPLET_NO_false
Denys Vlasenkode5edad2015-04-21 16:00:41 +0200936 && applet_no != APPLET_NO_false
Denys Vlasenkof4f8fe82016-07-05 21:43:28 +0200937# endif
Denys Vlasenkof26e5632021-03-15 17:42:25 +0100938# if defined APPLET_NO_echo
939 && applet_no != APPLET_NO_echo
940# endif
Denys Vlasenkode5edad2015-04-21 16:00:41 +0200941 ) {
Ron Yorston5a9d2b62022-05-01 09:45:37 +0100942 if (argv[1] && strcmp(argv[1], "--help") == 0) {
943 /* Make "foo --help [...]" exit with 0: */
Denys Vlasenkode5edad2015-04-21 16:00:41 +0200944 xfunc_error_retval = 0;
Denis Vlasenkobd28f6b2008-07-19 08:15:13 +0000945 bb_show_usage();
Denys Vlasenko5d783552013-01-17 11:02:21 +0100946 }
Denis Vlasenkobd28f6b2008-07-19 08:15:13 +0000947 }
Denys Vlasenko6bdfbc42021-02-18 23:30:24 +0100948}
949
950void FAST_FUNC run_applet_no_and_exit(int applet_no, const char *name, char **argv)
951{
952 int argc;
953
954 /*
955 * We do not use argv[0]: do not want to repeat massaging of
956 * "-/sbin/halt" -> "halt", for example.
957 */
958 applet_name = name;
959
960 show_usage_if_dash_dash_help(applet_no, argv);
961
Denis Vlasenko724d1962007-10-10 14:41:07 +0000962 if (ENABLE_FEATURE_SUID)
Denis Vlasenko1aa7e472007-11-28 06:49:03 +0000963 check_suid(applet_no);
Denys Vlasenko6bdfbc42021-02-18 23:30:24 +0100964
965 argc = string_array_len(argv);
Denys Vlasenko215b0ca2016-08-19 18:23:56 +0200966 xfunc_error_retval = applet_main[applet_no](argc, argv);
Denys Vlasenko6bdfbc42021-02-18 23:30:24 +0100967
Denys Vlasenko215b0ca2016-08-19 18:23:56 +0200968 /* Note: applet_main() may also not return (die on a xfunc or such) */
969 xfunc_die();
Denis Vlasenko724d1962007-10-10 14:41:07 +0000970}
Denys Vlasenkof4f8fe82016-07-05 21:43:28 +0200971# endif /* NUM_APPLETS > 0 */
Denis Vlasenko724d1962007-10-10 14:41:07 +0000972
Ron Yorston37788982018-11-17 17:48:14 +0000973# if ENABLE_BUSYBOX || NUM_APPLETS > 0
Ron Yorstonce824ae2016-06-07 12:12:07 +0100974static NORETURN void run_applet_and_exit(const char *name, char **argv)
Denis Vlasenko724d1962007-10-10 14:41:07 +0000975{
Denys Vlasenko7e8218f2016-11-18 21:42:44 +0100976# if ENABLE_BUSYBOX
Denys Vlasenko8dff01d2015-03-12 17:48:34 +0100977 if (is_prefixed_with(name, "busybox"))
Denys Vlasenkof128bdb2017-07-29 00:59:24 +0200978 exit(busybox_main(/*unused:*/ 0, argv));
Denys Vlasenko7e8218f2016-11-18 21:42:44 +0100979# endif
980# if NUM_APPLETS > 0
Ron Yorston610c4c32016-03-30 00:42:05 +0200981 /* find_applet_by_name() search is more expensive, so goes second */
Denys Vlasenkof4f8fe82016-07-05 21:43:28 +0200982 {
983 int applet = find_applet_by_name(name);
984 if (applet >= 0)
Denys Vlasenko69a5ec92017-07-07 19:08:56 +0200985 run_applet_no_and_exit(applet, name, argv);
Denys Vlasenkof4f8fe82016-07-05 21:43:28 +0200986 }
Denys Vlasenko7e8218f2016-11-18 21:42:44 +0100987# endif
Ron Yorstonce824ae2016-06-07 12:12:07 +0100988
989 /*bb_error_msg_and_die("applet not found"); - links in printf */
990 full_write2_str(applet_name);
991 full_write2_str(": applet not found\n");
992 /* POSIX: "If a command is not found, the exit status shall be 127" */
993 exit(127);
Denis Vlasenko724d1962007-10-10 14:41:07 +0000994}
Denys Vlasenko7e8218f2016-11-18 21:42:44 +0100995# endif
Denis Vlasenko724d1962007-10-10 14:41:07 +0000996
Denys Vlasenko67e15292020-06-24 13:39:13 +0200997#else /* defined(SINGLE_APPLET_MAIN) */
998
999# if NUM_SCRIPTS > 0
1000/* if SINGLE_APPLET_MAIN, these two functions are simpler: */
1001int scripted_main(int argc UNUSED_PARAM, char **argv) MAIN_EXTERNALLY_VISIBLE;
1002int scripted_main(int argc UNUSED_PARAM, char **argv)
1003{
1004# if ENABLE_SHELL_ASH
1005 int script = 0;
Denys Vlasenko03ed86b2021-09-28 17:40:59 +02001006 return ash_main(-script - 1, argv);
Denys Vlasenko67e15292020-06-24 13:39:13 +02001007# elif ENABLE_SHELL_HUSH
1008 int script = 0;
Denys Vlasenko03ed86b2021-09-28 17:40:59 +02001009 return hush_main(-script - 1, argv);
Denys Vlasenko67e15292020-06-24 13:39:13 +02001010# else
1011 return 1;
1012# endif
1013}
1014char* FAST_FUNC
1015get_script_content(unsigned n UNUSED_PARAM)
1016{
1017 char *t = unpack_bz2_data(packed_scripts, sizeof(packed_scripts),
1018 UNPACKED_SCRIPTS_LENGTH);
1019 return t;
1020}
1021# endif /* NUM_SCRIPTS > 0 */
1022
1023#endif /* defined(SINGLE_APPLET_MAIN) */
Denis Vlasenko468aea22008-04-01 14:47:57 +00001024
1025
Denis Vlasenko724d1962007-10-10 14:41:07 +00001026#if ENABLE_BUILD_LIBBUSYBOX
Denis Vlasenko85c24712008-03-17 09:04:04 +00001027int lbb_main(char **argv)
Denis Vlasenko724d1962007-10-10 14:41:07 +00001028#else
Denis Vlasenkoa60f84e2008-07-05 09:18:54 +00001029int main(int argc UNUSED_PARAM, char **argv)
Denis Vlasenko724d1962007-10-10 14:41:07 +00001030#endif
1031{
Denys Vlasenkobc14f4d2016-04-03 16:06:42 +02001032#if 0
1033 /* TODO: find a use for a block of memory between end of .bss
1034 * and end of page. For example, I'm getting "_end:0x812e698 2408 bytes"
1035 * - more than 2k of wasted memory (in this particular build)
1036 * *per each running process*!
1037 * (If your linker does not generate "_end" name, weak attribute
1038 * makes &_end == NULL, end_len == 0 here.)
1039 */
1040 extern char _end[] __attribute__((weak));
1041 unsigned end_len = (-(int)_end) & 0xfff;
1042 printf("_end:%p %u bytes\n", &_end, end_len);
1043#endif
1044
Denys Vlasenko1f7c1672009-09-06 02:12:28 +02001045 /* Tweak malloc for reduced memory consumption */
Denys Vlasenko1f7c1672009-09-06 02:12:28 +02001046#ifdef M_TRIM_THRESHOLD
1047 /* M_TRIM_THRESHOLD is the maximum amount of freed top-most memory
1048 * to keep before releasing to the OS
1049 * Default is way too big: 256k
1050 */
Denys Vlasenkofe86d6b2011-06-03 21:39:42 +02001051 mallopt(M_TRIM_THRESHOLD, 8 * 1024);
Denys Vlasenko1f7c1672009-09-06 02:12:28 +02001052#endif
1053#ifdef M_MMAP_THRESHOLD
1054 /* M_MMAP_THRESHOLD is the request size threshold for using mmap()
1055 * Default is too big: 256k
1056 */
Denys Vlasenkofe86d6b2011-06-03 21:39:42 +02001057 mallopt(M_MMAP_THRESHOLD, 32 * 1024 - 256);
Denys Vlasenko1f7c1672009-09-06 02:12:28 +02001058#endif
Denys Vlasenko7f0ebbc2016-10-03 17:42:53 +02001059#if 0 /*def M_TOP_PAD*/
1060 /* When the program break is increased, then M_TOP_PAD bytes are added
1061 * to the sbrk(2) request. When the heap is trimmed because of free(3),
1062 * this much free space is preserved at the top of the heap.
1063 * glibc default seems to be way too big: 128k, but need to verify.
1064 */
1065 mallopt(M_TOP_PAD, 8 * 1024);
1066#endif
Denys Vlasenko1f7c1672009-09-06 02:12:28 +02001067
Denis Vlasenko724d1962007-10-10 14:41:07 +00001068#if !BB_MMU
1069 /* NOMMU re-exec trick sets high-order bit in first byte of name */
1070 if (argv[0][0] & 0x80) {
1071 re_execed = 1;
1072 argv[0][0] &= 0x7f;
1073 }
1074#endif
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +01001075
1076#if defined(SINGLE_APPLET_MAIN)
Denys Vlasenko7e8218f2016-11-18 21:42:44 +01001077
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +01001078 /* Only one applet is selected in .config */
Denys Vlasenko8dff01d2015-03-12 17:48:34 +01001079 if (argv[1] && is_prefixed_with(argv[0], "busybox")) {
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +01001080 /* "busybox <applet> <params>" should still work as expected */
1081 argv++;
1082 }
1083 /* applet_names in this case is just "applet\0\0" */
1084 lbb_prepare(applet_names IF_FEATURE_INDIVIDUAL(, argv));
Denys Vlasenkod4e4fdb2017-07-03 21:31:16 +02001085# if ENABLE_BUILD_LIBBUSYBOX
1086 return SINGLE_APPLET_MAIN(string_array_len(argv), argv);
1087# else
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +01001088 return SINGLE_APPLET_MAIN(argc, argv);
Denys Vlasenkod4e4fdb2017-07-03 21:31:16 +02001089# endif
Denys Vlasenko8f0af3b2010-11-29 02:55:35 +01001090
Denys Vlasenko7e8218f2016-11-18 21:42:44 +01001091#elif !ENABLE_BUSYBOX && NUM_APPLETS == 0
1092
1093 full_write2_str(bb_basename(argv[0]));
1094 full_write2_str(": no applets enabled\n");
Denys Vlasenko03ed86b2021-09-28 17:40:59 +02001095 return 127;
Denys Vlasenko7e8218f2016-11-18 21:42:44 +01001096
1097#else
1098
1099 lbb_prepare("busybox" IF_FEATURE_INDIVIDUAL(, argv));
Denys Vlasenkof4f8fe82016-07-05 21:43:28 +02001100# if !ENABLE_BUSYBOX
Ron Yorstonba120812016-06-07 10:26:24 +01001101 if (argv[1] && is_prefixed_with(bb_basename(argv[0]), "busybox"))
1102 argv++;
Denys Vlasenkof4f8fe82016-07-05 21:43:28 +02001103# endif
Denis Vlasenko724d1962007-10-10 14:41:07 +00001104 applet_name = argv[0];
1105 if (applet_name[0] == '-')
1106 applet_name++;
1107 applet_name = bb_basename(applet_name);
Denys Vlasenko147d2ce2017-07-29 02:19:01 +02001108
Denys Vlasenko147d2ce2017-07-29 02:19:01 +02001109 /* If we are a result of execv("/proc/self/exe"), fix ugly comm of "exe" */
1110 if (ENABLE_FEATURE_SH_STANDALONE
1111 || ENABLE_FEATURE_PREFER_APPLETS
1112 || !BB_MMU
1113 ) {
Denys Vlasenko5acf5e12021-10-11 18:39:25 +02001114 if (NUM_APPLETS > 1) {
1115 /* Careful, do not trash comm of "SCRIPT.sh" -
1116 * the case when started from e.g. #!/bin/ash script.
1117 * (not limited to shells - #!/bin/awk scripts also exist)
1118 */
1119 if (re_execed_comm())
1120 set_task_comm(applet_name);
1121 }
Denys Vlasenko147d2ce2017-07-29 02:19:01 +02001122 }
Denys Vlasenko147d2ce2017-07-29 02:19:01 +02001123
Denis Vlasenko724d1962007-10-10 14:41:07 +00001124 parse_config_file(); /* ...maybe, if FEATURE_SUID_CONFIG */
Denis Vlasenko724d1962007-10-10 14:41:07 +00001125 run_applet_and_exit(applet_name, argv);
Denys Vlasenko7e8218f2016-11-18 21:42:44 +01001126
Denis Vlasenko468aea22008-04-01 14:47:57 +00001127#endif
Denis Vlasenko724d1962007-10-10 14:41:07 +00001128}