1 /* vi: set sw=4 ts=4: */
3 * Sysctl 1.01 - A utility to read and manipulate the sysctl parameters
5 * Copyright 1999 George Staikos
7 * Licensed under GPLv2 or later, see file LICENSE in this source tree.
10 * v1.01 - added -p <preload> to preload values from a file
11 * v1.01.1 - busybox applet aware by <solar@gentoo.org>
13 //config:config BB_SYSCTL
14 //config: bool "sysctl (7.4 kb)"
17 //config: Configure kernel parameters at runtime.
19 //applet:IF_BB_SYSCTL(APPLET_NOEXEC(sysctl, sysctl, BB_DIR_SBIN, BB_SUID_DROP, sysctl))
21 //kbuild:lib-$(CONFIG_BB_SYSCTL) += sysctl.o
23 //usage:#define sysctl_trivial_usage
24 //usage: "-p [-enq] [FILE...] / [-enqaw] [KEY[=VALUE]]..."
25 //usage:#define sysctl_full_usage "\n\n"
26 //usage: "Show/set kernel parameters\n"
27 //usage: "\n -p Set values from FILEs (default /etc/sysctl.conf)"
28 //usage: "\n -e Don't warn about unknown keys"
29 //usage: "\n -n Don't show key names"
30 //usage: "\n -q Quiet"
31 //usage: "\n -a Show all values"
32 /* Same as -a, no need to show it */
33 /* //usage: "\n -A Show all values in table form" */
34 //usage: "\n -w Set values"
36 //usage:#define sysctl_example_usage
37 //usage: "sysctl [-n] [-e] variable...\n"
38 //usage: "sysctl [-n] [-e] [-q] -w variable=value...\n"
39 //usage: "sysctl [-n] [-e] -a\n"
40 //usage: "sysctl [-n] [-e] [-q] -p file (default /etc/sysctl.conf)\n"
41 //usage: "sysctl [-n] [-e] -A\n"
46 FLAG_SHOW_KEYS = 1 << 0,
47 FLAG_SHOW_KEY_ERRORS = 1 << 1,
48 FLAG_TABLE_FORMAT = 1 << 2, /* not implemented */
49 FLAG_SHOW_ALL = 1 << 3,
50 FLAG_PRELOAD_FILE = 1 << 4,
51 /* NB: procps 3.2.8 does not require -w for KEY=VAL to work, it only rejects non-KEY=VAL form */
55 #define OPTION_STR "neAapwq"
57 static void sysctl_dots_to_slashes(char *name)
59 char *cptr, *last_good, *end;
62 /* Convert minimum number of '.' to '/' so that
63 * we end up with existing file's name.
65 * Example from bug 3894:
66 * net.ipv4.conf.eth0.100.mc_forwarding ->
67 * net/ipv4/conf/eth0.100/mc_forwarding
68 * NB: net/ipv4/conf/eth0/mc_forwarding *also exists*,
69 * therefore we must start from the end, and if
70 * we replaced even one . -> /, start over again,
71 * but never replace dots before the position
72 * where last replacement occurred.
74 * Another bug we later had is that
75 * net.ipv4.conf.eth0.100
76 * (without .mc_forwarding) was mishandled.
78 * To set up testing: modprobe 8021q; vconfig add eth0 100
80 end = strchrnul(name, '=');
82 *end = '.'; /* trick the loop into trying full name too */
87 while (cptr > last_good) {
90 //bb_error_msg("trying:'%s'", name);
91 if (access(name, F_OK) == 0) {
93 //bb_error_msg("replaced:'%s'", name);
104 static int sysctl_act_on_setting(char *setting)
106 int fd, retval = EXIT_SUCCESS;
107 char *cptr, *outname;
108 char *value = value; /* for compiler */
109 bool writing = (option_mask32 & FLAG_WRITE);
111 outname = xstrdup(setting);
120 cptr = strchr(setting, '=');
125 bb_error_msg("error: '%s' must be of the form name=value",
127 retval = EXIT_FAILURE;
130 value = cptr + 1; /* point to the value in name=value */
131 if (setting == cptr /* "name" can't be empty */
132 /* || !*value - WRONG: "sysctl net.ipv4.ip_local_reserved_ports=" is a valid syntax (clears the value) */
134 bb_error_msg("error: malformed setting '%s'", outname);
135 retval = EXIT_FAILURE;
139 outname[cptr - setting] = '\0';
140 /* procps 3.2.7 actually uses these flags */
141 fd = open(setting, O_WRONLY|O_CREAT|O_TRUNC, 0666);
143 fd = open(setting, O_RDONLY);
149 /* Happens for write-only settings, e.g. net.ipv6.route.flush */
152 if (option_mask32 & FLAG_SHOW_KEY_ERRORS)
153 bb_error_msg("error: '%s' is an unknown key", outname);
156 bb_perror_msg("error %sing key '%s'",
162 retval = EXIT_FAILURE;
167 //TODO: procps 3.2.7 writes "value\n", note trailing "\n"
168 xwrite_str(fd, value);
170 if (!(option_mask32 & FLAG_QUIET)) {
171 if (option_mask32 & FLAG_SHOW_KEYS)
172 printf("%s = ", outname);
178 value = cptr = xmalloc_read(fd, NULL);
181 bb_perror_msg("error reading key '%s'", outname);
182 retval = EXIT_FAILURE;
186 /* dev.cdrom.info and sunrpc.transports, for example,
187 * are multi-line. Try "sysctl sunrpc.transports"
189 while ((c = *cptr) != '\0') {
190 if (option_mask32 & FLAG_SHOW_KEYS)
191 printf("%s = ", outname);
209 static int sysctl_act_recursive(const char *path)
214 if (!(option_mask32 & FLAG_WRITE)
215 && stat(path, &buf) == 0
216 && S_ISDIR(buf.st_mode)
218 struct dirent *entry;
221 dirp = opendir(path);
224 while ((entry = readdir(dirp)) != NULL) {
225 char *next = concat_subpath_file(path, entry->d_name);
227 continue; /* d_name is "." or ".." */
228 /* if path was ".", drop "./" prefix: */
229 retval |= sysctl_act_recursive((next[0] == '.' && next[1] == '/') ?
235 char *name = xstrdup(path);
236 retval |= sysctl_act_on_setting(name);
243 /* Set sysctl's from a conf file. Format example:
244 * # Controls IP packet forwarding
245 * net.ipv4.ip_forward = 0
247 static int sysctl_handle_preload_file(const char *filename)
253 parser = config_open(filename);
254 /* Must do it _after_ config_open(): */
258 parse_flags &= ~PARSE_COLLAPSE; // NO (var==val is not var=val) - treat consecutive delimiters as one
259 parse_flags &= ~PARSE_TRIM; // NO - trim leading and trailing delimiters
260 parse_flags |= PARSE_GREEDY; // YES - last token takes entire remainder of the line
261 parse_flags &= ~PARSE_MIN_DIE; // NO - die if < min tokens found
262 parse_flags &= ~PARSE_EOL_COMMENTS; // NO (only first char) - comments are recognized even if not first char
263 parse_flags |= PARSE_ALT_COMMENTS;// YES - two comment chars: ';' and '#'
264 /* <space><tab><space>#comment is also comment, not strictly 1st char only */
265 parse_flags |= PARSE_WS_COMMENTS; // YES - comments are recognized even if there is whitespace before
266 while (config_read(parser, token, 2, 2, ";#=", parse_flags)) {
271 sysctl_dots_to_slashes(token[0]);
272 /* ^^^converted in-place. tp still points to NUL */
273 /* now, add "=TOKEN1" */
275 overlapping_strcpy(tp, token[1]);
277 sysctl_act_on_setting(token[0]);
279 if (ENABLE_FEATURE_CLEAN_UP)
280 config_close(parser);
284 int sysctl_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
285 int sysctl_main(int argc UNUSED_PARAM, char **argv)
290 opt = getopt32(argv, "+" OPTION_STR); /* '+' - stop on first non-option */
292 opt ^= (FLAG_SHOW_KEYS | FLAG_SHOW_KEY_ERRORS);
295 if (opt & FLAG_PRELOAD_FILE) {
297 option_mask32 |= FLAG_WRITE;
299 *--argv = (char*)"/etc/sysctl.conf";
300 cur_dir_fd = xopen(".", O_RDONLY | O_DIRECTORY);
302 /* xchdir("/proc/sys") is inside */
303 sysctl_handle_preload_file(*argv);
304 xfchdir(cur_dir_fd); /* files can be relative, must restore cwd */
306 return 0; /* procps-ng 3.3.10 does not flag parse errors */
309 if (opt & (FLAG_TABLE_FORMAT | FLAG_SHOW_ALL)) {
310 return sysctl_act_recursive(".");
313 //TODO: if(!argv[0]) bb_show_usage() ?
317 sysctl_dots_to_slashes(*argv);
318 retval |= sysctl_act_recursive(*argv);