From: thib Date: Sun, 31 Mar 2002 15:05:49 +0000 (+0000) Subject: *** empty log message *** X-Git-Tag: ver1564~94 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=dc7ddf854cc1d06c7a2943b5c8caf5ce8d508161;p=fcron *** empty log message *** --- diff --git a/doc/en/changes.sgml b/doc/en/changes.sgml index a2b01a0..d2ecae5 100644 --- a/doc/en/changes.sgml +++ b/doc/en/changes.sgml @@ -8,13 +8,13 @@ Foundation. A copy of the license is included in gfdl.sgml. --> - + Changes - From version 2.1.0 to 2.1.1 + From version 2.1.0 to 2.9.0 Added some new options to fcron : -y, -o, -l ; and some fcrontab options : stdout and volatile. All these permit to make fcron run in foreground, execute all the pending jobs (mainly %-jobs), and return. May be used, for instance, in a ppp-up script with a dialup connection to update a software regularly. diff --git a/doc/en/fcrondyn.1.sgml b/doc/en/fcrondyn.1.sgml index f85353d..5d0551f 100644 --- a/doc/en/fcrondyn.1.sgml +++ b/doc/en/fcrondyn.1.sgml @@ -8,7 +8,7 @@ Foundation. A copy of the license is included in gfdl.sgml. --> - + @@ -22,10 +22,210 @@ A copy of the license is included in gfdl.sgml. dialog dyn-amically with a running fcron daemon + + + fcrondyn + -c file + -i + + + fcrondyn + -c file + -x command + + + fcrondyn + -h + + - + + Description + &Fcrondyn; is a user tool intended to interact with a running fcron daemon. It can, for instance, list user's jobs loaded by fcron, run one of them, renice a running job, send a signal to a running job, etc. + + + + Options + + + + + Run &fcrondyn; in interactive mode. + + + + command + + Run command and returns immediately. See below for syntax and a list of commands. + + + + file + + Make &fcrontab; use config file file instead of default config file &etc;/&fcron.conf.location;. To interact with a running &fcron; process, &fcrontab; must use the same config file as the process. That way, several &fcron; processes can run simultaneously on an only system. + + + + + + Run in debug mode. In this mode, many informational messages will be output in order to check if anything went wrong. + + + + + + Display a brief description of the options. + + + + + + Display an informational message about &fcrontab;, including its version and the license under which it is distributed. + + + + + + + Command description + &Fcrondyn;'s command syntax is the following : +
+ command arg1 arg2 [...] +
+ An argument of a &fcrondyn; command is of one of the following type : + + Argument types of &fcrondyn;'s commands + + user + + A valid user name. + + + + jobid + + A job id given by one of &fcrondyn;'s ls* commands (i.e. an integer). + + + + sig + + A signal number, or its name (case does not matter). For instance, "term" or "15". + + + + niceval + + A job priority value. A niceval is an integer from -20 (highest priority) to 19 (lowest) (only root is allowed to use a negative value with this option). + + + + Last, but not least, the following commands are recognized (optional arguments are between []) : + + Valid &fcrondyn;'s commands + + help + h + + Print an help message about fcrondyn's commands. + + + + quit + q + + In interactive mode, quit fcrondyn. + + + + ls [user] + + List all jobs of user. When ls is run by root, all users are listed unless a user name is given as argument. See below for some explanations about the fields used by ls* commands. + + + + ls_lavgq [user] + + + + + + ls_serialq [user] + + + + + + ls_exeq [user] + + + + + + detail jobid + + Print details about a job. jobid is the one given by ls + + + + runnow jobid + + + + + + run jobid + + + + + + kill sig jobid + + + + + + renice niceval jobid + + + + + + + Fields used by <command>ls*</command> commands + + USER + + user who owns this job. + + + + ID + + job's unique identification number. + + + + R&Q + + The job has this number instances running or queued in serial or lavg queue. + + + + SCHEDULE + + next run is scheduled at this time and date. + + + + CMD + + the command that will be executed. + + + + diff --git a/doc/en/fcrontab.1.sgml b/doc/en/fcrontab.1.sgml index a1b58ce..794114b 100644 --- a/doc/en/fcrontab.1.sgml +++ b/doc/en/fcrontab.1.sgml @@ -8,7 +8,7 @@ Foundation. A copy of the license is included in gfdl.sgml. --> - + @@ -27,7 +27,7 @@ A copy of the license is included in gfdl.sgml. fcrontab -c file -n - file + file user -u user diff --git a/doc/en/todo.sgml b/doc/en/todo.sgml index d2fc36d..b6635f5 100644 --- a/doc/en/todo.sgml +++ b/doc/en/todo.sgml @@ -8,7 +8,7 @@ Foundation. A copy of the license is included in gfdl.sgml. --> - + Todo @@ -16,7 +16,7 @@ A copy of the license is included in gfdl.sgml. If you plan to help me, please send a mail at &email; to prevent two people from doing the same thing. You can send me some propositions as well. - PAM support (included in fcron, but need more tests by people using PAM) + PAM support (included in fcron, but need more tests by people using PAM - not implemented in fcrondyn) allow a non-privileged user to run fcron @@ -25,11 +25,14 @@ A copy of the license is included in gfdl.sgml. add a return code for jobs which would mean that they should not be run again (in case of an error, etc...). - possibility to display a list of jobs including their options, time and date of next execution, status, of only the running jobs, all the jobs, in order of execution or classified by user, etc. + fcrondyn : possibility to display a list of jobs including their options, time and date of next execution, status, of only the running jobs, all the jobs, in order of execution or classified by user, etc. (some of these functions or not implemented yet) run one of this job, change its nice value, stop it... + + make fcrondyn more secure and reliable + add a system of modules : at startup, fcron loads some modules (.so files). Then, when fcron should run the job, it calls a function diff --git a/fcron.c b/fcron.c index 89ae290..26dfae7 100644 --- a/fcron.c +++ b/fcron.c @@ -21,7 +21,7 @@ * `LICENSE' that comes with the fcron source distribution. */ - /* $Id: fcron.c,v 1.61 2002-03-02 17:26:47 thib Exp $ */ + /* $Id: fcron.c,v 1.62 2002-03-31 15:05:49 thib Exp $ */ #include "fcron.h" @@ -33,7 +33,7 @@ #include "socket.h" #endif -char rcs_info[] = "$Id: fcron.c,v 1.61 2002-03-02 17:26:47 thib Exp $"; +char rcs_info[] = "$Id: fcron.c,v 1.62 2002-03-31 15:05:49 thib Exp $"; void main_loop(void); void check_signal(void); @@ -144,13 +144,13 @@ usage(void) " -m n --maxserial n Set to n the max number of running serial jobs.\n" " -c f --configfile f Make fcron use config file f.\n" " -n d --newspooldir d Create d as a new spool directory.\n" - " -d --debug Set Debug mode.\n" " -f --foreground Stay in foreground.\n" " -b --background Go to background.\n" " -y --nosyslog Don't log to syslog at all.\n" " -o --once Execute all jobs that need to be run, wait for " "them,\n then return. Sets firstsleep to 0.\n" " Especially useful with -f and -y.\n" + " -d --debug Set Debug mode.\n" " -h --help Show this help message.\n" " -V --version Display version & infos about fcron.\n", FIRST_SLEEP