Ubuntu Manpage: really - gain privilege or run commands a different user

Provided by: chiark-really_6.1.2+nmu1_amd64

NAME

       really - gain privilege or run commands a different user

SYNOPSIS

       really [options] [command args... ]

DESCRIPTION

       really  checks whether the caller is allowed, and if it is it changes its uids and gids (and perhaps root
       directory) according to the command line options and executes the specified command.

       If no options are specified, the uid will be set to 0 and the  gids  and  root  directory  will  be  left
       unchanged.

       If no command is specified, really will run $SHELL -i.

       A caller is allowed if it has write access to /etc/inittab and is also member of the group root.  This is
       most  easily  achieved  by  making  inittab  group-writeable  by  some  suitable group containing all the
       appropriate users, and making /etc/inittab group-owned by that group and group-writeable.  The root group
       is perhaps a good choice if it isn't being used for anything else.

OPTIONS

-u username | --user username
Sets the uid, gid, and supplementary group list, according to username's entry in the password and
group databases.

-i username | --useronly username
Sets only the uid according to username's entry in the password database.

-I uid | --uidonly uid
Sets the uid to the numeric value uid (which need not correspond to any existing user in the
password database).

-g groupname | --group groupname
groupname is looked up in the group database and its gid is appended to the process's
supplementary groups list. If this is the first gid specified it will also be set as the primary
gid.

-G gid | --gid gid
gid is appended to the process's supplementary groups list. (gid need not correspond to any
existing group in the group database.) If this is the first gid specified it will also be set as
the primary gid.

-z | --groupsclear
Clears the process's supplementary groups list. When using this option you must also specify -g
or -G. The process's groups will then be exactly those specified. The relative position of -z in
the argument list is not relevant.

-R root-dir | --chroot root-dir
The program will have its root directory set to root-dir.

Do not use this option unless you know what you are doing: Unlike chroot(8), the current working
directory will remain unchanged. This means that if the current directory isn't underneath the
specified new root, the program will still be able to access files outside the new root by using
relative pathnames. If this isn't what you want, please use the chroot utility instead.

-- Indicates the end of the options. The next argument (if present) will be interpreted as the
command name, even if it starts with a hyphen.

SECURITY CONSIDERATIONS

       really is designed so that installing it setuid root is extremely unlikely to compromise the security  of
       any  system.  It will check using access(2) whether the real user is allowed to write to /etc/inittab and
       if this check fails really will exit without even attempting to parse its command line.

       really is not designed to be resistant to malicious command  line  arguments.   Do  not  allow  untrusted
       processes  to  pass  options to really, or to specify the command to be run.  Whether it is safe to allow
       relatively untrusted processes to pass options to the command which is to be run depends on the behaviour
       of that command and its security status.

       Attempting to use really to drop privilege is dangerous unless  the  calling  environment  is  very  well
       understood.   There are many inherited process properties and resources which might be used by the callee
       to escalate its privilege to that of the (root-equivalent) caller.  For  this  function,  it  is  usually
       better to use userv if possible.

ENVIRONMENT

       really  does  not  manipulate  the  environment  at  all.  The calling program is run in exactly the same
       environment as the caller passes to really.  In particular, really will not add sbin directories to  PATH
       so  really-enabled accounts will usually need to have these directories on their configured PATH to start
       with.

       SHELL is used to find the default shell to use in interactive mode (ie, when no command is specified).

AUTHOR

       This version of really was written by Ian Jackson <ian@chiark.greenend.org.uk>.

       It and this manpage are Copyright (C) 1992-5,2004,2013 Ian Jackson <ian@chiark.greenend.org.uk>.

       really is free software; you can redistribute it and/or modify it under the  terms  of  the  GNU  General
       Public  License  as  published by the Free Software Foundation; either version 3, or (at your option) any
       later version.

       really is distributed in the hope that it will be useful, but WITHOUT  ANY  WARRANTY;  without  even  the
       implied  warranty  of  MERCHANTABILITY  or  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
       License for more details.

       You should have received a copy of the GNU General Public License along with this file; if  not,  consult
       the Free Software Foundation's website at www.fsf.org, or the GNU Project website at www.gnu.org.

AVAILABILITY

       really is currently part of chiark-utils and is available for download from ftp.chiark.greenend.org.uk in
       /users/ian/chiark-utils/, in source and pre-compiled binary form, and also from Ian Jackson's cvsweb.