Skip to content
Small utility for running commands as a non-root user.
C
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.gitignore
CMakeLists.txt
LICENSE
Makefile
README
README.md
nonroot.8
nonroot.c

README.md

nonroot - run commands as non-root

This is a small utility for starting executables as a non-privileged user, when running as the superuser (e.g. in an init-script).

The usage is very simple:

nonroot username executable [arg...]

The executable will be started with the specified arguments, after switching to the specified user. If anything goes wrong, nonroot exits with an error message. nonroot won't allow you to specify a user with UID or GID zero, to be on the safe side.

You only need a POSIX compliant system to be able to build and run nonroot.

Building and installing

The source code includes both a classic Makefile and a CMake build script. Either can be used to build and install the application.

The simplest way is to simply type make install. The Makefile also lets you specify CC, CFLAGS, DESTDIR, prefix and other variables if needed. The default values assume that you are using GCC.

License

See the LICENSE file in the source code for the license terms.

Something went wrong with that request. Please try again.