summary refs log tree commit diff
path: root/nq.c
diff options
context:
space:
mode:
authorChristian Neukirchen <chneukirchen@gmail.com>2015-07-31 15:52:11 +0200
committerChristian Neukirchen <chneukirchen@gmail.com>2015-07-31 15:52:11 +0200
commite8ca68ed89fe9d88c3a768d9c88c728996c35811 (patch)
tree9afcdfa0128a8a0a20dc49d92956af80557f1912 /nq.c
parent80a48d82b0b7568108382ecd28fc281e249ac547 (diff)
downloadnq-e8ca68ed89fe9d88c3a768d9c88c728996c35811.tar.gz
nq-e8ca68ed89fe9d88c3a768d9c88c728996c35811.tar.xz
nq-e8ca68ed89fe9d88c3a768d9c88c728996c35811.zip
introductory comment
Diffstat (limited to 'nq.c')
-rw-r--r--nq.c16
1 files changed, 15 insertions, 1 deletions
diff --git a/nq.c b/nq.c
index ccd3a7a..51e6d70 100644
--- a/nq.c
+++ b/nq.c
@@ -1,5 +1,19 @@
 /*
-##% gcc -std=c89 -Wall -g -o $STEM $FILE
+ * nq CMD... - run CMD... in background and in order, saving output to ,* files
+ *
+ * - requires POSIX.1-2008
+ * - enforcing order works like this:
+ *   - every job has a flock(2)ed file ala ",TIMESTAMP.PID"
+ *   - every job starts only after all earlier flock(2)ed files finished
+ *   - the lock is released when job terminates
+ *   - no sub-second file system time stamps are required, jobs are started with
+ *     millisecond precision
+ * - we try hard to make the currently running ,* file have +x bit
+ * - you can re-queue jobs using "sh ,jobid"
+ *
+ * To the extent possible under law, Christian Neukirchen, chneukirchen@gmail.com
+ * has waived all copyright and related or neighboring rights to this work.
+ * http://creativecommons.org/publicdomain/zero/1.0/
 */
 
 #define _POSIX_C_SOURCE 200809L