SU(1)\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 User Commands\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 SU(1)<\/p>\n
NAME\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top<\/p>\n
su – run a command with substitute user and group ID<\/p>\n
SYNOPSIS\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top<\/p>\n
su [options] [-] [user [argument…]]<\/p>\n
DESCRIPTION\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top<\/p>\n
su allows to run commands with a substitute user and group ID.<\/p>\n
When called without arguments, su defaults to running an interactive
\nshell as root.<\/p>\n
For backward compatibility, su defaults to not change the current
\ndirectory and to only set the environment variables HOME and SHELL
\n(plus USER and LOGNAME if the target user is not root).\u00a0 It is
\nrecommended to always use the –login option (instead of its shortcut
\n-) to avoid side effects caused by mixing environments.<\/p>\n
This version of su uses PAM for authentication, account and session
\nmanagement.\u00a0 Some configuration options found in other su
\nimplementations, such as support for a wheel group, have to be
\nconfigured via PAM.<\/p>\n
OPTIONS\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top<\/p>\n
-c, –command=command
\nPass command to the shell with the -c option.<\/p>\n
-f, –fast
\nPass -f to the shell, which may or may not be useful,
\ndepending on the shell.<\/p>\n
-g, –group=group
\nSpecify the primary group.\u00a0 This option is available to the
\nroot user only.<\/p>\n
-G, –supp-group=group
\nSpecify a supplemental group.\u00a0 This option is available to the
\nroot user only.<\/p>\n
-, -l, –login
\nStart the shell as a login shell with an environment similar
\nto a real login:<\/p>\n
o\u00a0\u00a0\u00a0\u00a0\u00a0 clears all the environment variables except TERM<\/p>\n
o\u00a0\u00a0\u00a0\u00a0\u00a0 initializes the environment variables HOME, SHELL,
\nUSER, LOGNAME, and PATH<\/p>\n
o\u00a0\u00a0\u00a0\u00a0\u00a0 changes to the target user’s home directory<\/p>\n
o\u00a0\u00a0\u00a0\u00a0\u00a0 sets argv[0] of the shell to ‘-‘ in order to make
\nthe shell a login shell<\/p>\n
-m, -p, –preserve-environment
\nPreserve the entire environment, i.e. it does not set HOME,
\nSHELL, USER nor LOGNAME.\u00a0 This option is ignored if the option
\n–login is specified.<\/p>\n
-s, –shell=shell
\nRun the specified shell instead of the default.\u00a0 The shell to
\nrun is selected according to the following rules, in order:<\/p>\n
o\u00a0\u00a0\u00a0\u00a0\u00a0 the shell specified with –shell<\/p>\n
o\u00a0\u00a0\u00a0\u00a0\u00a0 the shell specified in the environment variable
\nSHELL, if the –preserve-environment option is used<\/p>\n
o\u00a0\u00a0\u00a0\u00a0\u00a0 the shell listed in the passwd entry of the target
\nuser<\/p>\n
o\u00a0\u00a0\u00a0\u00a0\u00a0 \/bin\/sh<\/p>\n
If the target user has a restricted shell (i.e. not listed in
\n\/etc\/shells), the –shell option and the SHELL environment
\nvariables are ignored unless the calling user is root.<\/p>\n
–session-command=command
\nSame as -c but do not create a new session.\u00a0 (Discouraged.)<\/p>\n
-V, –version
\nDisplay version information and exit.<\/p>\n
-h, –help
\nDisplay help text and exit.<\/p>\n
SIGNALS\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top<\/p>\n
Upon receiving either SIGINT, SIGQUIT or SIGTERM, su terminates its
\nchild and afterwards terminates itself with the received signal.<\/p>\n
CONFIG FILES\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top<\/p>\n
su reads the \/etc\/default\/su and \/etc\/login.defs configuration files.
\nThe following configuration items are relevant for su(1):<\/p>\n
FAIL_DELAY (number)
\nDelay in seconds in case of an authentication failure. The number
\nmust be a non-negative integer.<\/p>\n
ENV_PATH (string)
\nDefines the PATH environment variable for a regular user.\u00a0 The
\ndefault value is \/usr\/local\/bin:\/bin:\/usr\/bin.<\/p>\n
ENV_ROOTPATH (string)
\nENV_SUPATH (string)
\nDefines the PATH environment variable for root.\u00a0 The default
\nvalue is \/usr\/local\/sbin:\/usr\/local\/bin:\/sbin:\/bin:\/usr\/sbin:
\n\/usr\/bin.<\/p>\n
ALWAYS_SET_PATH (boolean)
\nIf set to yes and –login and –preserve-environment were not
\nspecified su initializes PATH.<\/p>\n
EXIT STATUS\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top<\/p>\n
su normally returns the exit status of the command it executed.\u00a0 If
\nthe command was killed by a signal, su returns the number of the
\nsignal plus 128.<\/p>\n
Exit status generated by su itself:<\/p>\n
1\u00a0\u00a0\u00a0\u00a0\u00a0 Generic error before executing the requested command<\/p>\n
126\u00a0\u00a0\u00a0 The requested command could not be executed<\/p>\n
127\u00a0\u00a0\u00a0 The requested command was not found<\/p>\n
FILES\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top<\/p>\n
\/etc\/pam.d\/su\u00a0\u00a0\u00a0 default PAM configuration file
\n\/etc\/pam.d\/su-l\u00a0 PAM configuration file if –login is specified
\n\/etc\/default\/su\u00a0 command specific logindef config file
\n\/etc\/login.defs\u00a0 global logindef config file<\/p>\n
NOTES\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top<\/p>\n
For security reasons su always logs failed log-in attempts to the
\nbtmp file, but it does not write to the lastlog file at all.\u00a0 This
\nsolution allows to control su behavior by PAM configuration.\u00a0 If you
\nwant to use the pam_lastlog module to print warning message about
\nfailed log-in attempts then the pam_lastlog has to be configured to
\nupdate the lastlog file as well. For example by:<\/p>\n
session\u00a0 required\u00a0 pam_lastlog.so nowtmp<\/p>\n
SEE ALSO\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top<\/p>\n
runuser(8), pam(8), shells(5), login.defs(5)<\/p>\n
HISTORY\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top<\/p>\n
This su command was derived from coreutils’ su, which was based on an
\nimplementation by David MacKenzie.<\/p>\n
AVAILABILITY\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top<\/p>\n
The su command is part of the util-linux package and is available
\nfrom Linux Kernel Archive
\n\u27e8ftp:\/\/ftp.kernel.org\/pub\/linux\/utils\/util-linux\/\u27e9.<\/p>\n
COLOPHON\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top<\/p>\n
This page is part of the util-linux (a random collection of Linux
\nutilities) project.\u00a0 Information about the project can be found at
\n\u27e8https:\/\/www.kernel.org\/pub\/linux\/utils\/util-linux\/\u27e9.\u00a0 If you have a
\nbug report for this manual page, send it to
\nutil-linux@vger.kernel.org.\u00a0 This page was obtained from the
\nproject’s upstream Git repository
\n(git:\/\/git.kernel.org\/pub\/scm\/utils\/util-linux\/util-linux.git) on
\n2014-12-30.\u00a0 If you discover any rendering problems in this HTML ver\u2010
\nsion of the page, or you believe there is a better or more up-to-date
\nsource for the page, or you have corrections or improvements to the
\ninformation in this COLOPHON (which is not part of the original man\u2010
\nual page), send a mail to\u00a0man-pages@man7.org<\/p>\n
util-linux\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 July 2014\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 SU(1)<\/p>\n","protected":false},"excerpt":{"rendered":"
SU(1)\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 User Commands\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 SU(1) NAME\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top su – run a command with substitute user and group ID SYNOPSIS\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top su [options] [-] [user [argument…]] DESCRIPTION\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 top su allows to run commands with a substitute user and group ID. When called without arguments, su defaults to running an interactive shell as root. For backward compatibility, su […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_sitemap_exclude":false,"_sitemap_priority":"","_sitemap_frequency":"","footnotes":""},"categories":[8],"tags":[],"class_list":["post-359","post","type-post","status-publish","format-standard","hentry","category-shell"],"a3_pvc":{"activated":false,"total_views":0,"today_views":0},"_links":{"self":[{"href":"https:\/\/www.linuxboxen.dk\/index.php?rest_route=\/wp\/v2\/posts\/359","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.linuxboxen.dk\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.linuxboxen.dk\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.linuxboxen.dk\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.linuxboxen.dk\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=359"}],"version-history":[{"count":0,"href":"https:\/\/www.linuxboxen.dk\/index.php?rest_route=\/wp\/v2\/posts\/359\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.linuxboxen.dk\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=359"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.linuxboxen.dk\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=359"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.linuxboxen.dk\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=359"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}