]> granicus.if.org Git - fcron/blob - doc/en/todo.sgml
updated changes/todo
[fcron] / doc / en / todo.sgml
1 <!-- 
2 Fcron documentation
3 Copyright 2000-2012 Thibault Godouet <fcron@free.fr>
4 Permission is granted to copy, distribute and/or modify this
5 document under the terms of the GNU Free Documentation License,
6 Version 1.1 or any later version published by the Free Software
7 Foundation.
8 A copy of the license is included in gfdl.sgml.
9 -->
10
11
12    <sect1 id="todo">
13       <title>Todo</title>
14       <para>Here are some things that should be done ... Note that some of these
15          entries are just some ideas, which <emphasis>may</emphasis> be done in
16          the long run.</para> 
17       <para>If you see something you'd really like to see implemented here, feel
18          free to send me a mail: it may make me move it to the top of my to-do list ;) .
19       </para>
20       <para>If you plan to help me, please send a mail at &email; to prevent two
21          people from doing the same thing. You can send me some propositions as
22          well, or ask me to move something to the top of the heap ;) .</para>
23       <sect2>
24          <title>High priority</title>
25          <itemizedlist>
26             <listitem>
27                <para>confirm 'make indent' options are good, and apply</para>
28             </listitem>
29          </itemizedlist>
30       </sect2>
31       <sect2>
32          <title>Low priority</title>
33          <itemizedlist>
34             <listitem>
35                <para>Use directory notifications (FAM) / inotify, and support a fcrontab
36                and a cron.d as Vixie cron does (directly included in fcron itself, not thanks to a script as now).
37                However the parsing work is done by fcrontab, and should probably keep on being done by fcrontab for
38                security and stability reasons: have fcron call fcrontab to do that job?</para>
39             </listitem>
40             <listitem>
41                <para>could be worth checking fcron for memory leaks using specialized library (just in case...)</para>
42             </listitem>
43             <listitem>
44                <para>option to put a maximum limit on the execution time of a task + terminate it if not finished yet + send email to let the user know</para>
45             </listitem>
46             <listitem>
47                <para>setting to limit the number of jobs of a single user in the serialq/lavgq to X jobs + make sure root always has Y slots that it can use in those queues (i.e. number of slots used by root + number of free slots >= Y)</para>
48             </listitem>
49             <listitem>
50                <para>Test (and use ?) docbook2x-man -- xlstproc ? cf http://antoine.ginies.free.fr/docbook/ch09.html</para>
51             </listitem>
52             <listitem>
53                <para>find way to have the non translated pages of the French translation be updated automatically (changes, todo, etc -> copied from the English doc)</para>
54             </listitem>
55             <listitem>
56                <para>use readline (if available) for fcrondyn.</para>
57             </listitem>
58             <listitem>
59                <para>add logging to a file (instead of syslog) with configuration in fcron.conf</para>
60             </listitem>
61             <listitem>
62                <para>code cleaning: create a .c/.h file for data structures
63                   (file/line lists, serial queue, lavg list, exe list),
64                   and work with them only through functions/macros.
65                + secure equivalent to str[n]{cat|copy|...}</para>
66                <para>Note: may introduce bugs, so it will be done in fcron 3.1.x, and needs to be tested thoroughly.</para>
67             </listitem>
68             <listitem>
69                <para>For environment settings, make a var substitution.</para>
70             </listitem>
71             <listitem>
72                <para>add a return code for jobs which would mean that they
73                   should not be run again (in case of an error, etc...).</para>
74             </listitem>
75             <listitem>
76                <para>PAM support (included in fcron, but needs more tests by
77                   people using PAM - not implemented in fcrondyn: is it needed
78                   in fcrondyn anyway?)</para>
79             </listitem>
80             <listitem>
81                <para>support for per user serial queue (especially for root)</para>
82             </listitem>
83             <listitem>
84                <para>add a mailsubject option, for custom mail subjects (for instance, in case of a job containing something secret -- password, etc -- in the command line).</para>
85             </listitem>
86          </itemizedlist>
87       </sect2>
88       <sect2>
89          <title>Ideas</title>
90          <itemizedlist>
91             <listitem>
92                <para>add a system of modules: at startup, fcron loads some
93                   modules (.so files). Then, when fcron should run the job, it
94                   calls a function of the module, and let it manage the job
95                   (threads?). (do linux dlopen(), etc exist on other systems?
96                   - yes: thanks Harring ;) dlopen exists on all POSIX system -
97                   even windoze - abait it does not use the same insterface of
98                   function calls. But it can be easily implemented to port to
99                   another system.).</para>
100             </listitem>
101             <listitem>
102                <para>(related to the system of modules? create a kind of
103                   dependencies?)  Add a way to run a job only if a command
104                   returns true. It would permit, for instance, to run some jobs
105                   on a laptop only if it is on AC power.</para>
106                <para>and depending on the return value of the command, cancel
107                   the execution, or wait x seconds before trying again, etc. 
108                In this case, needs change the way the jobs are queued?</para>
109             </listitem>
110             <listitem>
111                <para>add an option/module to prevent fcron from running a job if the
112                   system is running on battery (anacron does it?)</para>
113             </listitem>
114             <listitem>
115                <para>Add a way to stop a job (SIGSTOP) if the lavg gets to high,
116                   and restart it (SIGCONT) when the lavg has decreased.</para>
117             </listitem>
118             <listitem>
119                <para>Add a timeout for task completion: if a task takes more
120                   than a specified timeout, then start another script with the
121                   initial task PID as argument.  That would allow a kill with
122                   different signals (-HUP, -TERM -STOP, .... or any other action
123                   like sending a mail to sysadmin to alert him/her that a task
124                   is taking too much time and that he has to have a look at it.)
125                   (add an option to specify the cmd, and combine w/ option until)
126                </para>
127             </listitem>
128          </itemizedlist>
129       </sect2>
130    </sect1>
131
132
133 <!-- Keep this comment at the end of the file
134 Local variables:
135 mode: sgml
136 sgml-parent-document:("fcron-doc.sgml" "book" "chapter" "sect1" "")
137 End:
138 -->