Initial commit
[compctl.git] / README
blob92f00960ad00dfffe0041614b93c10ec96855d1f
1 **Computations under control** will run a specificed program as
2 a non-interactive computation process, allowing it to be listed
3 and regulated by the user of the computer.
5 To avoid needless use of setuid, it uses a simple client-server
6 architecture. On boot, compctld daemon is started (as root),
7 sets up the cgroup infrastructure and accepts requests from clients
8 for moving a process to cgroup, killing a cgroup'd process and
9 tweaking the cgroup limits.
11 The client compctl interface simply queries the server using
12 a synchronous protocol over a UNIX socket. First, the client
13 sends a SCM_CREDENTIALS ancilliary message. Then, it follows
14 with a CRLF-terminated command string and receives a CRLF-terminated
15 reply string. Connection is closed immediately on breach of protocol.
18 You can tweak some simple compile-time configuration variables
19 in file 'common.h'. Build everything using the `make` command.
20 Then, arrange compctld to be run on boot and put compctl in $PATH
21 for your users to enjoy.