Skip to content

Latest commit

 

History

History
31 lines (21 loc) · 1.03 KB

File metadata and controls

31 lines (21 loc) · 1.03 KB

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.