1 /* vi: set sw=4 ts=4: */
3 * Mini su implementation for busybox
5 * Licensed under GPLv2 or later, see file LICENSE in this source tree.
8 //config: bool "su (19 kb)"
10 //config: select FEATURE_SYSLOG
12 //config: su is used to become another user during a login session.
13 //config: Invoked without a username, su defaults to becoming the super user.
14 //config: Note that busybox binary must be setuid root for this applet to
15 //config: work properly.
17 //config:config FEATURE_SU_SYSLOG
18 //config: bool "Log to syslog all attempts to use su"
20 //config: depends on SU
22 //config:config FEATURE_SU_CHECKS_SHELLS
23 //config: bool "If user's shell is not in /etc/shells, disallow -s PROG"
25 //config: depends on SU
27 //config:config FEATURE_SU_BLANK_PW_NEEDS_SECURE_TTY
28 //config: bool "Allow blank passwords only on TTYs in /etc/securetty"
30 //config: depends on SU
32 //applet:/* Needs to be run by root or be suid root - needs to change uid and gid: */
33 //applet:IF_SU(APPLET(su, BB_DIR_BIN, BB_SUID_REQUIRE))
35 //kbuild:lib-$(CONFIG_SU) += su.o
37 //usage:#define su_trivial_usage
38 //usage: "[-lmp] [-] [-s SH] [USER [SCRIPT ARGS / -c 'CMD' ARG0 ARGS]]"
39 //usage:#define su_full_usage "\n\n"
40 //usage: "Run shell under USER (by default, root)\n"
41 //usage: "\n -,-l Clear environment, go to home dir, run shell as login shell"
42 //usage: "\n -p,-m Do not set new $HOME, $SHELL, $USER, $LOGNAME"
43 //usage: "\n -c CMD Command to pass to 'sh -c'"
44 //usage: "\n -s SH Shell to use instead of user's default"
49 #if ENABLE_FEATURE_SU_CHECKS_SHELLS
50 /* Return 1 if SHELL is a restricted shell (one not returned by
51 * getusershell), else 0, meaning it is a standard shell. */
52 static int restricted_shell(const char *shell)
57 /*setusershell(); - getusershell does it itself*/
58 while ((line = getusershell()) != NULL) {
59 if (/* *line != '#' && */ strcmp(line, shell) == 0) {
64 if (ENABLE_FEATURE_CLEAN_UP)
73 int su_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
74 int su_main(int argc UNUSED_PARAM, char **argv)
77 char *opt_shell = NULL;
78 char *opt_command = NULL;
79 const char *opt_username = "root";
81 uid_t cur_uid = getuid();
83 #if ENABLE_FEATURE_UTMP
89 /* Note: we don't use "'+': stop at first non-option" idiom here.
90 * For su, "SCRIPT ARGS" or "-c CMD ARGS" do not stop option parsing:
91 * ARGS starting with dash will be treated as su options,
92 * not passed to shell. (Tested on util-linux 2.28).
94 flags = getopt32(argv, "mplc:s:", &opt_command, &opt_shell);
97 if (argv[0] && LONE_DASH(argv[0])) {
102 /* get user if specified */
104 opt_username = argv[0];
108 tty = xmalloc_ttyname(STDIN_FILENO);
111 tty = skip_dev_pfx(tty);
113 if (ENABLE_FEATURE_SU_SYSLOG) {
114 /* The utmp entry (via getlogin) is probably the best way to
115 * identify the user, especially if someone su's from a su-shell.
116 * But getlogin can fail -- usually due to lack of utmp entry.
117 * in this case resort to getpwuid. */
118 #if ENABLE_FEATURE_UTMP
120 if (getlogin_r(user_buf, sizeof(user_buf)) != 0)
123 pw = getpwuid(cur_uid);
124 old_user = pw ? xstrdup(pw->pw_name) : "";
126 openlog(applet_name, 0, LOG_AUTH);
129 pw = xgetpwnam(opt_username);
133 r = ask_and_check_password(pw);
135 if (ENABLE_FEATURE_SU_BLANK_PW_NEEDS_SECURE_TTY
136 && r == CHECKPASS_PW_HAS_EMPTY_PASSWORD
137 && !is_tty_secure(tty)
141 if (ENABLE_FEATURE_SU_SYSLOG)
142 syslog(LOG_NOTICE, "%c %s %s:%s",
143 '+', tty, old_user, opt_username);
146 if (ENABLE_FEATURE_SU_SYSLOG)
147 syslog(LOG_NOTICE, "%c %s %s:%s",
148 '-', tty, old_user, opt_username);
149 bb_do_delay(LOGIN_FAIL_DELAY);
150 bb_error_msg_and_die("incorrect password");
153 if (ENABLE_FEATURE_CLEAN_UP && ENABLE_FEATURE_SU_SYSLOG) {
157 if (!opt_shell && (flags & SU_OPT_mp)) {
158 /* -s SHELL is not given, but "preserve env" opt is */
159 opt_shell = getenv("SHELL");
162 #if ENABLE_FEATURE_SU_CHECKS_SHELLS
163 if (opt_shell && cur_uid != 0 && pw->pw_shell && restricted_shell(pw->pw_shell)) {
164 /* The user being su'd to has a nonstandard shell, and so is
165 * probably a uucp account or has restricted access. Don't
166 * compromise the account by allowing access with a standard
168 bb_error_msg("using restricted shell");
169 opt_shell = NULL; /* ignore -s PROG */
171 /* else: user can run whatever he wants via "su -s PROG USER".
172 * This is safe since PROG is run under user's uid/gid. */
175 opt_shell = pw->pw_shell;
178 setup_environment(opt_shell,
179 ((flags & SU_OPT_l) / SU_OPT_l * SETUP_ENV_CLEARENV)
180 + (!(flags & SU_OPT_mp) * SETUP_ENV_CHANGEENV)
181 + (!(flags & SU_OPT_l) * SETUP_ENV_NO_CHDIR),
183 IF_SELINUX(set_current_security_context(NULL);)
186 *--argv = opt_command;
187 *--argv = (char*)"-c";
190 /* A nasty ioctl exists which can stuff data into input queue:
191 * #include <sys/ioctl.h>
193 * const char *msg = "echo $UID\n";
194 * while (*msg) ioctl(0, TIOCSTI, *msg++);
197 * With "su USER -c EXPLOIT" run by root, exploit can make root shell
198 * read as input and execute arbitrary command.
199 * It's debatable whether we need to protect against this
200 * (root may hesitate to run unknown scripts interactively).
202 * Some versions of su run -c CMD in a different session:
203 * ioctl(TIOCSTI) works only on the controlling tty.
207 run_shell(opt_shell, flags & SU_OPT_l, (const char**)argv);
209 /* return EXIT_FAILURE; - not reached */