at - Schedule the execution of a command or script file via the at command.

Author:Richard Isaacson

Synopsis

New in version 1.5.

Use this module to schedule a command or script file to run once in the future. All jobs are executed in the ‘a’ queue.

Options

parameter required default choices comments
command no
    A command to be executed in the future.
    count yes
      The count of units in the future to execute the command or script file.
      script_file no
        An existing script file to be executed in the future.
        state no present
        • present
        • absent
        The state dictates if the command or script file should be evaluated as present(added) or absent(deleted).
        unique no
          If a matching job is present a new job will not be added.
          units yes
          • minutes
          • hours
          • days
          • weeks
          The type of units in the future to execute the command or script file.

          Note

          Requires at

          Examples


          # Schedule a command to execute in 20 minutes as root.
          - at: command="ls -d / > /dev/null" count=20 units="minutes"
          
          # Match a command to an existing job and delete the job.
          - at: command="ls -d / > /dev/null" state="absent"
          
          # Schedule a command to execute in 20 minutes making sure it is unique in the queue.
          - at: command="ls -d / > /dev/null" unique=true count=20 units="minutes"