diff options
author | Christian Hesse <mail@eworm.de> | 2013-12-20 11:50:21 +0100 |
---|---|---|
committer | Christian Hesse <mail@eworm.de> | 2013-12-20 11:50:21 +0100 |
commit | 63d42efc9dc3f5cf13856cf08aaa807bfd8982e5 (patch) | |
tree | 4f6eabe0c281f6acc748c4a7e6cc879477dcd28d /README.md | |
parent | dd04fc241d46541704b3223b9df93d83a5575e27 (diff) | |
download | nullshell-63d42efc9dc3f5cf13856cf08aaa807bfd8982e5.tar.gz nullshell-63d42efc9dc3f5cf13856cf08aaa807bfd8982e5.tar.zst |
initial commit
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 45 |
1 files changed, 44 insertions, 1 deletions
@@ -1,4 +1,47 @@ nullshell ========= -do nothing but print asterisks, can be used for login shell +**do nothing but print asterisks, can be used for login shell** + +This is a minimal program that does nothing but print asteriks every now +and then. It is intended to be used for login shell with accounts +accessible via secure shell that are used for secure tunneling but +should not allow to execute commands. + +Requirements +------------ + +To compile and run `nullshell` you need: + +* nothing (this is plain C) +* [markdown](http://daringfireball.net/projects/markdown/) (HTML documentation) + +Additionally it is expected to have `make` and a C compiler around to +successfully compile. + +Build and install +----------------- + +Building and installing is very easy. Just run: + +> make + +followed by: + +> make install + +This will place an executable at `/usr/bin/nullshell`. + +Usage +----- + +To create a new user `user` with `nullshell` as login shell just run: + +> useradd -s /usr/bin/nullshell user + +Or to make `nullshell` the login shell for an existing user `user`: + +> usermod -s /usr/bin/nullshell user + +Make sure `/usr/bin/nullshell` is listed in `/etc/shells` if your system +expects this. |