home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / textual / zap / zapman / manpage
Text File  |  1998-03-26  |  5KB  |  97 lines
  1. AT(1)                       NetBSD Reference Manual                      AT(1)
  2.  
  3. NNAAMMEE
  4.      aatt,, bbaattcchh,, aattqq,, aattrrmm - queue, examine, or delete jobs for later execution
  5.  
  6. SSYYNNOOPPSSIISS
  7.      aatt [--qq _q_u_e_u_e] [--ff _f_i_l_e] [--mm] _t_i_m_e
  8.  
  9.      aattqq [--qq _q_u_e_u_e] [--vv]
  10.  
  11.      aattrrmm _j_o_b [_j_o_b _._._.]
  12.  
  13.      bbaattcchh [--ff _f_i_l_e] [--mm]
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.      The aatt and bbaattcchh utilities read commands from the standard input or a
  17.      specified file which are to be executed at a later time, using sh(1).
  18.  
  19.      The functions of the commands are as follows:
  20.  
  21.      aatt      Executes commands at a specified time.
  22.  
  23.      aattqq     Lists the user's pending jobs, unless the user is the superuser.
  24.              In that case, everybody's jobs are listed.
  25.  
  26.      aattrrmm    Deletes jobs.
  27.  
  28.      bbaattcchh   executes commands when system load levels  permit.  In other
  29.              words, it executes the commands when the load average drops below
  30.              a specified level.
  31.  
  32.      For both aatt and bbaattcchh, the working directory, environment (except for the
  33.      variables TTEERRMM, TTEERRMMCCAAPP, DDIISSPPLLAAYY, and __) and the umask are retained from
  34.      the time of invocation.  The user will be mailed the standard output and
  35.      standard error from his commands if any output is generated.  If aatt is
  36.      executed from a su(1) shell, the owner of the login shell will receive
  37.      the mail.
  38.  
  39. OOPPTTIIOONNSS
  40.      The available options are as follows:
  41.  
  42.      --qq _q_u_e_u_e
  43.              Use the specified queue.  A queue designation consists of a sin-
  44.              gle letter; valid queue designation range from _a to _l. The _a
  45.              queue is the default, and _b is the batch queue.  Queues with
  46.              higher letters run with increased niceness.  If aattqq is given a
  47.              specific queue, it will only show jobs pending in that queue.
  48.  
  49.      --mm      Send mail to the user when the job has completed, even if there
  50.              was no output.
  51.  
  52.      --ff _f_i_l_e
  53.              Reads the job from _f_i_l_e rather than the standard input.
  54.  
  55.      --vv      Shows completed but not yet deleted jobs in the queue.
  56.  
  57. TTIIMMEE SSPPEECCIIFFIICCAATTIIOONN
  58.      AAtt allows some moderately complex time specifications.  It accepts times
  59.      of the form _H_H_M_M or _H_H_:_M_M to run a job at a specific time of day.  If
  60.      that time is already passed, the next day is assumed.  You may also spec-
  61.      ify mmiiddnniigghhtt, nnoooonn, or tteeaattiimmee (4PM) and you can give a time of day suf-
  62.      fixed with AAMM or PPMM for running in the morning or the evening.  You can
  63.      also specify the date on which the job will be run by giving a date in
  64.      the form _m_o_n_t_h_-_n_a_m_e _d_a_y with an optional _y_e_a_r, or giving a date of the
  65.      form _M_M_D_D_Y_Y, _M_M_/_D_D_/_Y_Y or _D_D_._M_M_._Y_Y. You can also give times like nnooww ++
  66.      _c_o_u_n_t _t_i_m_e_-_u_n_i_t_s, where the time units can be mmiinnuutteess,, hhoouurrss,, ddaayyss,, or
  67.      wweeeekkss You can suffix the time with ttooddaayy to run the job today, or
  68.      ttoommoorrrrooww to run the job tomorrow.
  69.  
  70.      For example, to run a job at 4PM three days from now, you would specify a
  71.      time of 44PPMM ++ 33 ddaayyss. To run a job at 10:00AM on on July 31, you would
  72.      specify a time of 1100AAMM JJuull 3311. Finally, to run a job at 1AM tomorrow, you
  73.      would specify a time of 11AAMM ttoommoorrrrooww.
  74.  
  75. FFIILLEESS
  76.      /var/at/jobs      Directory containing job files
  77.      /var/at/spool     Directory containing output spool files
  78.      /var/at/lockfile  Job-creation lock file.
  79.      /var/run/utmp
  80.  
  81. SSEEEE AALLSSOO
  82.      cron(8),  nice(1),  sh(1),  atrun(8)
  83.  
  84. AAUUTTHHOORR
  85.      Thomas Koenig, ig25@rz.uni-karlsruhe.de
  86.  
  87. BBUUGGSS
  88.      Traditional access control to aatt and bbaattcchh via the files _/_v_a_r_/_a_t_/_a_t_._a_l_l_o_w
  89.      and _/_v_a_r_/_a_t_/_a_t_._d_e_n_y is not implemented.
  90.  
  91.      If the file _/_v_a_r_/_r_u_n_/_u_t_m_p is not available or corrupted, or if the user
  92.      is not logged in at the time aatt is invoked, the mail is sent to the
  93.      userid found in the environment variable LLOOGGNNAAMMEE. If that is undefined or
  94.      empty, the current userid is assumed.
  95.  
  96. NetBSD 0.9a                      June 24, 1996                               2
  97.