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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
|
dropnroll(8)
============
NAME
----
dropnroll - drop'n'roll daemon
SYNOPSIS
--------
....
dropnroll
[ -h|--help ]
[ -D|--nodaemonize ]
[ -u|--username <username> ]
[ -g|--groupname <groupname> ]
[ -C|--chroot <path> ]
[ -P|--write-pid <filename> ]
[ -L|--log <target>:<level>[,<param1>[,<param2>[..]]] ]
[ -U|--debug ]
[ -s|--command-sock <unix sock> ]
[ -x|--script <script> ]
[ -m|--max-children <#of children> ]
[ -p|--children-policy (defer|drop|kill-oldest) ]
[ -r|--children-min-runtime <secs> ]
[ -d|--dir <path> ]
....
DESCRIPTION
-----------
*dropnroll* is a small daemon which can be used to watch one or more
directories for new files. When a new file is detected an external program will
get started.
Additional directories can be added to the daemon's watch list using a simple
unix socket based command interface.
OPTIONS
-------
The following options can be passed to the *dropnroll* daemon:
*-D, --nodaemonize*::
This option instructs *dropnroll* to run in foreground
instead of becoming a daemon which is the default.
*-u, --username '<username>'*::
run as this user. If no group is specified (*-g*) the default group of
the user is used. The default is to not drop privileges.
*-g, --groupname '<groupname>'*::
run as this group. If no username is specified (*-u*) this gets ignored.
The default is to not drop privileges.
*-C, --chroot '<path>'*::
Instruct *dropnroll* to run in a chroot jail. The default is
to not run in chroot.
*-P, --write-pid '<filename>'*::
Instruct *dropnroll* to write it's pid to this file. The default is
to not create a pid file.
*-L, --log '<target>:<level>[,<param1>[,<param2>[..]]]'*::
add log target to logging system. This can be invoked several times
in order to log to different targets at the same time. Every target
hast its own log level which is a number between 0 and 5. Where 0 means
disabling log and 5 means debug messages are enabled. +
The file target can be used more the once with different levels.
If no target is provided at the command line a single target with the
config *syslog:3,dropnroll,daemon* is added. +
The following targets are supported:
'syslog';; log to syslog daemon, parameters <level>[,<logname>[,<facility>]]
'file';; log to file, parameters <level>[,<path>]
'stdout';; log to standard output, parameters <level>
'stderr';; log to standard error, parameters <level>
*-U, --debug*::
This option instructs *dropnroll* to run in debug mode. It implicits *-D*
(don't daemonize) and adds a log target with the configuration
'stdout:5' (logging with maximum level). In future releases there might
be additional output when this option is supplied.
*-s|--command-sock '<unix sock>'*::
*dropnroll* will listen on this unix socket for incoming commands. See next
chapter for details. If there are directories specified using the *--dir*
option and this is kept empty the command socket is deactivated. If no directories
are added it defaults to /var/run/dropnroll/cmd.sock
*-x|--script '<script>'*::
The script which should be called when a new file is found. The following parameter
are passed to the scipt:
'<path>';; the path to the folder containing the new file
'<filename>';; the name of the new file relative to <path>
'<filesize>';; the size of the file right after the event was received, this can be
used to determine wheter the file is complete. The script should
consider a file to be complete when it size doesn't change 3-5seconds
after the event got received.
*-m|--max-children '<#of children>'*::
Limits the total concurrent executions of *-x|--script*. A value of 0 means no limit.
*-p|--children-policy '(defer|drop|kill-oldest)'*::
Specifies what *dropnroll* should do when the client limit has been reached:
'defer';; defer the execution of *--script* until the number of children is below the limit
'drop';; ingore the new file and don't call *--script*
'kill-oldest';; kill the oldest child (using SIGKILL)
*-r|--children-min-runtime '<secs>'*::
For the kill-oldest policy this sets the minimum number of seconds a child needs to run
before it can be killed.
*-d|--dir '<path>'*::
Add '<path>' to the watch list. This can be invoked serveral times.
COMMAND INTERFACE
-----------------
*dropnroll* is listening for incoming commands at the unix socket speciefied by the
*-s|--command-sock* parameter. You can connect to this socket for example using
socat:
# socat UNIX-CONNECT:/var/run/dropnroll/dropnroll.sock STDIO
All commands have to end with '\n'. The following commands are supported:
*add <path>*::
Add a path to the list of directories to be watched. If the command succeds nothing
is returned. In case of an error a string of the form "Error: <reason>\n" is returned.
*remove <path>*::
Remove the path from the list of directories. If the command succeds nothing
is returned. In case of an error a string of the form "Error: <reason>\n" is returned.
*status*::
Returns the complete list of all directories of the watch list.
*listen (request|status|none)*::
Add the client to the status and or request listeners. When no parameter is passed to
this command the client listens to all messages.
A status listener gets a list of all directories whenever somebody else adds or removes
a path to the watch list. It also receives the list when somebody sends a status command
to the daemon.
A request listener also receives add and remove requests by other clients connected to
the command interface.
*log <text>*::
Print <text> to the logtargets of the daemon.
BUGS
----
Most likely there are some bugs in *dropnroll*. If you find a bug, please let
the developers know at equinox@spreadspace.org. Of course, patches are preferred.
AUTHORS
-------
Christian Pointner <equinox@spreadspace.org>
COPYING
-------
Copyright \(C) 2009-2015 Christian Pointner. This program is free
software: you can redistribute it and/or modify it under the terms
of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or any later version.
|
