home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / TOP / USR / SRC / vcron.t.Z / vcron.t / VCRON / MAN / crontab2.man < prev    next >
Text File  |  1988-11-15  |  5KB  |  200 lines
  1.  
  2.  
  3.  
  4.      CRONTAB(5)         UNIX 5.0 (19 March 1987)        CRONTAB(5)
  5.  
  6.  
  7.  
  8.      NAME
  9.       crontab - tables for driving Vixie's Cron
  10.  
  11.      DESCRIPTION
  12.       A crontab file contains instructions to the crond(8) daemon
  13.       of the general form: "run this command at this time on this
  14.       date".  Each user has    their own crontab, and commands    in any
  15.       given    crontab    will be    executed as the    user who owns the
  16.       crontab.  Uucp and News will usually have their own
  17.       crontabs, eliminating    the need for explicitly    running    "su
  18.       news"    as part    of a cron command.
  19.  
  20.       Blank    lines and leading spaces and tabs are ignored.    Lines
  21.       whose    first non-space    character is a number-sign (`#') are
  22.       comments, and    are ignored.  Note that    comments are not
  23.       allowed on the same line as cron commands, since they    will
  24.       be taken to be part of the command.  Similarly, comments are
  25.       not allowed on the same line as environment variable
  26.       settings.
  27.  
  28.       An active line in a crontab will be either an    environment
  29.       setting or a cron command.  An environment setting is    of the
  30.       form,
  31.  
  32.           name = value
  33.  
  34.       where    the spaces around the equal-sign (`=') are optional,
  35.       and any subsequent spaces in value will be part of the value
  36.       assigned to name.  The value string may be placed in quotes
  37.       (single or double, but matching) to preserve leading or
  38.       trailing blanks.
  39.  
  40.       Several environment variables    are set    up automatically by
  41.       the crond(8) daemon from the /etc/passwd line    of the
  42.       crontab's owner: USER, HOME, and SHELL.  HOME    and SHELL may
  43.       be overridden    by settings in the crontab; USER may not.
  44.  
  45.       (Note: for UUCP, always set SHELL=/bin/sh, or    crond(8) will
  46.       cheerfully try to execute your commands using
  47.       /usr/lib/uucp/uucico.)
  48.  
  49.       (Another note: the USER variable is sometimes    called LOGNAME
  50.       or worse on System V... on these systems, you    should set
  51.       LOGNAME rather than USER.)
  52.  
  53.       In addition to USER, HOME, and SHELL,    crond(8) will look at
  54.       MAILTO if it has any reason to send mail as a    result of
  55.       running commands in "this" crontab.  If MAILTO is defined
  56.       (and non-empty), mail    is sent    to the user so named.  If
  57.       MAILTO is defined but    empty (MAILTO=""), no mail will    be
  58.       sent.     Otherwise mail    is sent    to the owner of    the crontab.
  59.       This option is useful    if you decide on /bin/mail instead of
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 2/10/88)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      CRONTAB(5)         UNIX 5.0 (19 March 1987)        CRONTAB(5)
  71.  
  72.  
  73.  
  74.       /usr/lib/sendmail as your mailer when    you install cron --
  75.       /bin/mail doesn't do aliasing, and UUCP usually doesn't read
  76.       its mail.
  77.  
  78.       The format of    a cron command is very much the    V7 standard,
  79.       with a number    of extensions.    Each line has five time    and
  80.       date fields, followed    by a command.  The time    and date
  81.       fields are: minute, hour, day    of month, month, and day of
  82.       week.     Lists and/or ranges are allowed, as in    "1-3,7-9"; a
  83.       step value is    also allowed, so that if you want to run a
  84.       command every    two hours, you can say "0-23/2"    instead    of
  85.       listing every    second hour.  Months or    days of    the week may
  86.       be specified by name,    using the first    three letters of the
  87.       name.     Numerics are also allowed for this, but this is
  88.       mostly a backward-compatibility issue    -- names are nicer.
  89.  
  90.       Spaces or tabs subsequent to the one that seperates the last
  91.       time/date field from the command are considered part of the
  92.       command.  Percent-signs (`%')    in the command,    unless escaped
  93.       with backslash (`\'),    will be    changed    into newline
  94.       characters, and all data after the first `%' will be sent to
  95.       the command as standard input.
  96.  
  97.      EXAMPLES
  98.       # use    /bin/sh    to run commands, no matter what    /etc/passwd says
  99.       SHELL=/bin/sh
  100.       # mail any output to `paul', no matter whose crontab this is
  101.       MAILTO=paul
  102.       #
  103.       5 0 *    * *      echo "run five minutes after midnight, every day"
  104.       15 14    1 * *      echo "run at 2:15pm on the first of every month"
  105.       23 0-23/2 * *    * echo "run 23 minutes after midn, 2am,    4am ..., everyday"
  106.       5 4 *    * sun      echo "run at 5 after 4 every sunday"
  107.  
  108.      SEE ALSO
  109.       Crond(8), crontab(1)
  110.  
  111.      EXTENSIONS
  112.       When specifying day of week, both day    0 and day 7 will be
  113.       considered Sunday.  Berkeley and ATT seem to disagree    about
  114.       this.
  115.  
  116.       Lists    and ranges are allowed to co-exist in the same field.
  117.       "1-3,7-9" would be rejected by ATT or    BSD cron -- they want
  118.       to see "1-3" or "7,8,9" ONLY.
  119.  
  120.       Ranges can include "steps", so "1-9/2" is the    same as
  121.       "1,3,5,7,9".
  122.  
  123.       Names    of months or days of the week can be specified by
  124.       name.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 2/10/88)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      CRONTAB(5)         UNIX 5.0 (19 March 1987)        CRONTAB(5)
  137.  
  138.  
  139.  
  140.       Environment variables    can be set in the crontab.  In BSD or
  141.       ATT, the environment handed to child processes is basically
  142.       the one from /etc/rc.
  143.  
  144.       Command output is mailed to the crontab owner    (BSD can't do
  145.       this), can be    mailed to a person other than the crontab
  146.       owner    (SysV can't do this), or the feature can be turned off
  147.       and no mail will be sent at all (SysV    can't do this either).
  148.  
  149.      AUTHOR
  150.       Paul Vixie
  151.       ucbvax!dual!ptsfa!vixie!paul
  152.       ptsfa!vixie!paul@ames.ARPA
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 2/10/88)
  196.  
  197.  
  198.  
  199.  
  200.