Provided by: fcron_3.0.1-1.3_i386 bug

NAME

       fcrondyn - dialog dyn-amically with a running fcron daemon

SYNOPSIS

       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

       -i     Run  fcrondyn  in  interactive  mode.  fcrondyn  is  also run in
              interactive mode when no option is given.

       -x command
              Run command and returns immediately. See below for syntax and  a
              list of commands.

       -c file
              Make  fcrondyn  use  config  file file instead of default config
              file /etc/fcron.conf. To interact with a running fcron  process,
              fcrondyn must use the same config file as the process. That way,
              several fcron  processes  can  run  simultaneously  on  an  only
              system.

       -d     Run  in  debug  mode.  In this mode, many informational messages
              will be output in order to check if anything went wrong.

       -h     Display a brief description of the options.

       -V     Display an informational message about fcrondyn,  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]
              Same as ls, but list only the jobs which are in the load-average
              queue (i.e. which are waiting for a lower  load  average  to  be
              run).

       ls_serialq [user]
              Same as ls, but list only the jobs which are in the serial queue
              (i.e. which are waiting for other jobs to be finished).

       ls_exeq [user]
              Same as ls, but list only the jobs which are running.

       detail jobid
              Print details about a job. jobid is the one given by ls.

       runnow jobid
              Instead of waiting for the next scheduled  execution  time,  run
              the  job  now.  The next execution time is changed as if the job
              had run on schedule.

       run jobid
              Run the job now. Its next execution time is not changed.

       kill sig jobid
              Send a signal to a running job.

       renice niceval jobid
              Change the priority of a running job.  "FIELDS  USED  BY  DETAIL
              AND     LS* COMMANDS"

       ID     Job’s unique identification number.

       USER   User who owns this job.

       PID    The pid of the running job.

       INDEX  Index  of  the job in the serial queue (i.e. it will be run when
              all the jobs of an inferior index have been run)

       R&Q    The job has this number instances of the given  task  which  are
              either running or queued in the serial or lavg queue.

       OPTIONS
              List of main options which are set for the task.  L for the jobs
              which run only under a given system Load average  (option  lavg,
              lavg1, lavg5 and lavg15), LO (Load average Once) if only at most
              one instance of the task can be in the load average queue  at  a
              given  time  (option  lavgonce),  S  for serialized jobs (option
              serial), SO for the jobs which will be serialized only  for  the
              next execution (Serial Once), and ES if several instances of the
              same job can run simultaneously (option exesev).

       LAVG   3 values, corresponding to the 1,  5,  and  15-minute  (in  this
              order)  system  load  average values below which the job will be
              run, otherwise it will be queued until the system  load  average
              is appropriate (see lavg option).

       UNTIL  Field corresponding to the until option.

       STRICT Field corresponding to the strict option. Y for yes, N for no.

       SCHEDULE
              Next  run  is  scheduled at this time and date. Please note that
              fcrondyn prints the next execution time and  date  in  the  time
              zone of the system where fcron is running, and not the time zone
              which can be defined for using option timezone.

       CMD    The command that will be executed.

RETURN VALUES

       Fcrondyn returns 0 on normal exit and 1 on error.

CONFORMING TO

       Should be POSIX compliant.

FILES

       /etc/fcron.conf
              Configuration file for fcron, fcrontab  and  fcrondyn:  contains
              paths (spool dir, pid file) and default programs to use (editor,
              shell, etc). See fcron.conf(5) for more details.

       /etc/fcron.allow
              Users allowed to use fcrontab and fcrondyn (one name  per  line,
              special name "all" acts for everyone)

       /etc/fcron.deny
              Users  who  are  not  allowed to use fcrontab and fcrondyn (same
              format as allow file)

       /etc/pam.d/fcron (or /etc/pam.conf)
              PAM configuration file for fcron. Take a look at pam(8) for more
              details.

SEE ALSO

       fcrontab(1),

       fcrondyn(1),

       fcrontab(5),

       fcron.conf(5),

       fcron(8).

       If  you’re  learning  how to use fcron from scratch, I suggest that you
       read the HTML version of the documentation (if your are not reading  it
       right  now! :) ): the content is the same, but it is easier to navigate
       thanks to the hyperlinks.

AUTHOR

       Thibault Godouet <fcron@free.fr>