bin/sleep/sleep.1

   1 .\"     $NetBSD: sleep.1,v 1.23 2016/08/12 02:36:38 sevan Exp $
   2 .\"
   3 .\" Copyright (c) 1990, 1993, 1994
   4 .\"     The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to Berkeley by
   7 .\" the Institute of Electrical and Electronics Engineers, Inc.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\" 3. Neither the name of the University nor the names of its contributors
  18 .\"    may be used to endorse or promote products derived from this software
  19 .\"    without specific prior written permission.
  20 .\"
  21 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  22 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  25 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31 .\" SUCH DAMAGE.
  32 .\"
  33 .\"     @(#)sleep.1     8.3 (Berkeley) 4/18/94
  34 .\"
  35 .Dd August 12, 2016
  36 .Dt SLEEP 1
  37 .Os
  38 .Sh NAME
  39 .Nm sleep
  40 .Nd suspend execution for an interval of time
  41 .Sh SYNOPSIS
  42 .Nm
  43 .Ar seconds
  44 .Sh DESCRIPTION
  45 The
  46 .Nm
  47 utility
  48 suspends execution for a minimum of
  49 .Ar seconds .
  50 It is usually used to schedule the execution of other commands (see
  51 .Sx EXAMPLES
  52 below).
  53 .Pp
  54 Note: The
  55 .Nx
  56 .Nm
  57 command will accept and honor a non-integer number of specified seconds.
  58 This is a non-portable extension, and its use will nearly guarantee that
  59 a shell script will not execute properly on another system.
  60 .Pp
  61 When the
  62 .Dv SIGINFO
  63 signal is received, the estimate of the amount of seconds left to
  64 sleep is printed on the standard output.
  65 .Sh EXIT STATUS
  66 The
  67 .Nm
  68 utility exits with one of the following values:
  69 .Bl -tag -width flag
  70 .It Li \&0
  71 On successful completion, or if the signal
  72 .Dv SIGALRM
  73 was received.
  74 .It Li \&\*[Gt]\&0
  75 An error occurred.
  76 .El
  77 .Sh EXAMPLES
  78 To schedule the execution of a command for 1800 seconds later:
  79 .Pp
  80 .Dl (sleep 1800; sh command_file \*[Gt]\*[Am] errors)\*[Am]
  81 .Pp
  82 This incantation would wait half an hour before
  83 running the script command_file.
  84 (See the
  85 .Xr at 1
  86 utility.)
  87 .Pp
  88 To reiteratively run a command (with
  89 .Xr csh 1 ) :
  90 .Pp
  91 .Bd -literal -offset indent -compact
  92 while (1)
  93         if (! -r zzz.rawdata) then
  94                 sleep 300
  95         else
  96                 foreach i (*.rawdata)
  97                         sleep 70
  98                         awk -f collapse_data $i \*[Gt]\*[Gt] results
  99                 end
 100                 break
 101         endif
 102 end
 103 .Ed
 104 .Pp
 105 The scenario for a script such as this might be: a program currently
 106 running is taking longer than expected to process a series of
 107 files, and it would be nice to have
 108 another program start processing the files created by the first
 109 program as soon as it is finished (when zzz.rawdata is created).
 110 The script checks every five minutes for the file zzz.rawdata,
 111 when the file is found, then another portion processing
 112 is done courteously by sleeping for 70 seconds in between each
 113 awk job.
 114 .Sh SEE ALSO
 115 .Xr at 1 ,
 116 .Xr nanosleep 2 ,
 117 .Xr sleep 3
 118 .Sh STANDARDS
 119 The
 120 .Nm
 121 command is expected to be
 122 .St -p1003.2
 123 compatible.
 124 .Sh HISTORY
 125 A
 126 .Nm
 127 utility appeared in
 128 .At v4 .