GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  REX::COMMANDS::CRON (3)

.ds Aq ’

NAME

Rex::Commands::Cron - Simple Cron Management

CONTENTS

DESCRIPTION

With this Module you can manage your cronjobs.

SYNOPSIS



 use Rex::Commands::Cron;

 cron add => "root", {
        minute => 5,
        hour  => *,
        day_of_month   => *,
        month => *,
        day_of_week => *,
        command => /path/to/your/cronjob,
      };

 cron list => "root";

 cron delete => "root", 3;



EXPORTED FUNCTIONS

cron_entry($name, CW%option)

Manage cron entries.



 cron_entry "reload-httpd",
   ensure       => "present",
   command      => "/etc/init.d/httpd restart",
   minute       => "1,5",
   hour         => "11,23",
   month        => "1,5",
   day_of_week  => "1,3",
   day_of_month => "1,3,5",
   user         => "root",
   on_change    => sub { say "cron added"; };

 # remove an entry
 cron_entry "reload-httpd",
   ensure       => "absent",
   command      => "/etc/init.d/httpd restart",
   minute       => "1,5",
   hour         => "11,23",
   month        => "1,5",
   day_of_week  => "1,3",
   day_of_month => "1,3,5",
   user         => "root",
   on_change    => sub { say "cron removed."; };



cron($action => CW$user, ...)

With this function you can manage cronjobs.

List cronjobs.



 use Rex::Commands::Cron;
 use Data::Dumper;

 task "listcron", "server1", sub {
   my @crons = cron list => "root";
   print Dumper(\@crons);
 };



Add a cronjob.

This example will add a cronjob running on minute 1, 5, 19 and 40. Every hour and every day.



 use Rex::Commands::Cron;
 use Data::Dumper;

 task "addcron", "server1", sub {
    cron add => "root", {
      minute => "1,5,19,40",
      command => /path/to/your/cronjob,
    };
 };



This example will add a cronjob running on the 1st, 3rd and 5th day of January and May, but only when it’s a Monday or Wednesday. On those days, the job will run when the hour is 11 or 23, and the minute is 1 or 5 (in other words at 11:01, 11:05, 23:01 and 23:05).



 task "addcron", "server1", sub {
    cron add => "root", {
      minute => "1,5",
      hour  => "11,23",
      month  => "1,5",
      day_of_week => "1,3",
      day_of_month => "1,3,5",
      command => /path/to/your/cronjob,
    };
 };



Delete a cronjob.

This example will delete the 4th cronjob. Counting starts with zero (0).



 task "delcron", "server1", sub {
    cron delete => "root", 3;
 };



Managing Environment Variables inside cron.



 task "mycron", "server1", sub {
    cron env => user => add => {
      MYVAR => "foo",
    };

    cron env => user => delete => $index;
    cron env => user => delete => 1;

    cron env => user => "list";
 };



Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 REX::COMMANDS::CRON (3) 2016-03-07

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.