1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
Subject: Rename executable and man page to tsp
Forwarded: not-needed
Author: Alexander Inyukhin <shurick@sectiorb.msk.ru>
--- a/Makefile
+++ b/Makefile
@@ -56,6 +56,6 @@
install: ts
$(INSTALL) -d $(PREFIX)/bin
- $(INSTALL) ts $(PREFIX)/bin
+ $(INSTALL) ts $(PREFIX)/bin/tsp
$(INSTALL) -d $(PREFIX)/share/man/man1
- $(INSTALL) -m 644 ts.1 $(PREFIX)/share/man/man1
+ $(INSTALL) -m 644 ts.1 $(PREFIX)/share/man/man1/tsp.1
--- a/ts.1
+++ b/ts.1
@@ -5,11 +5,14 @@
.\" that should have been distributed together with this file.
.\"
.\" Note: I took the gnu 'ls' man page as an example.
-.TH TS 1 2020-12 "Task Spooler 1.0.3"
+.\"
+.\" Modified 2024-06-23 by Alexander Inyukhin <shurick@sectorb.msk.ru>
+.\"
+.TH TSP 1 2020-12 "Task Spooler 1.0.3"
.SH NAME
-ts \- task spooler. A simple unix batch system
+tsp \- task spooler. A simple unix batch system
.SH SYNOPSIS
-.BI "ts [" actions "] [" options "] [" command... ]
+.BI "tsp [" actions "] [" options "] [" command... ]
.sp
Actions:
.BI "[\-KClhV]
@@ -32,13 +35,13 @@
.BI "[\-D <"id >]
.SH DESCRIPTION
-.B ts
+.B tsp
will run by default a per user unix task queue. The user can add commands to
the queue, watch that queue at any moment, and look at the task results
(actually, standard output and exit error).
.SH SIMPLE USE
Calling
-.B ts
+.B tsp
with a command will add that command to the queue, and calling it without
commands or parameters will show the task list.
.SH COMMAND OPTIONS
@@ -113,15 +116,15 @@
.TP
.B "\-K"
Kill the
-.B ts
+.B tsp
server for the calling client. This will remove the unix socket and
all the
-.B ts
+.B tsp
processes related to the queue. This will not kill the command being
run at that time.
It is not reliable to think that
-.B ts -K
+.B tsp -K
will finish when the server is really killed. By now it is a race condition.
.TP
.B "\-C"
@@ -130,7 +133,7 @@
.B "\-l"
Show the list of jobs - to be run, running and finished - for the current queue.
This is the default behaviour if
-.B ts
+.B tsp
is called without options.
.TP
.B "\-t [id]"
@@ -186,7 +189,7 @@
.B "\-V"
Show the program version.
.SH MULTI-SLOT
-.B ts
+.B tsp
by default offers a queue where each job runs only after the previous finished.
Nevertheless, you can change the maximum number of jobs running at once with
the
@@ -252,7 +255,7 @@
.B \-S,
but the contents of the variable are read only when running
the first instance of
-.B ts.
+.B tsp.
.TP
.B "TS_MAILTO"
Send the letters with job results to the address specified in this variable.
@@ -275,7 +278,7 @@
.TP
.B "TS_SAVELIST"
If it is defined when starting the queue server (probably the first
-.B ts
+.B tsp
command run), on SIGTERM the queue status will be saved to the file pointed
by this environment variable - for example, at system shutdown.
.TP
@@ -288,12 +291,12 @@
.TP
.B /tmp/ts.error
if
-.B ts
+.B tsp
finds any internal problem, you should find an error report there.
Please send this to the author as part of the bug report.
.SH BUGS
-.B ts
+.B tsp
expects a simple command line. It does not start a shell parser.
If you want to run complex shell commands, you may want to run them through
.B sh -c 'commands...'
@@ -313,8 +316,8 @@
Lluis Batlle i Rossell
.SH NOTES
This page describes
-.B ts
+.B tsp
as in version 1.0. Other versions may differ. The file
.B TRICKS
found in the distribution package can show some ideas on special uses of
-.B ts.
+.B tsp.
|
