[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[RFR] Перевод sleep(1)

To: frdp@xxxxxxxxxxxxxx
Subject: [RFR] Перевод sleep(1)
From: Ruslan Ermilov <ru@xxxxxxxxxxx>
Date: Thu, 7 Dec 2006 19:44:40 +0300
Sender: owner-frdp@xxxxxxxxxxxxxx
User-agent: Mutt/1.5.13 (2006-08-11)

Привет!

В течение 2-х дней приветствуются замечания к переводу sleep(1).
Оригинал, перевод, и отформатированная версия перевода в аттаче.


Cheers,
-- 
Ruslan Ermilov
ru@xxxxxxxxxxx
FreeBSD committer

.\"-
.\" Copyright (c) 1990, 1993, 1994
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" This code is derived from software contributed to Berkeley by
.\" the Institute of Electrical and Electronics Engineers, Inc.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"	@(#)sleep.1	8.3 (Berkeley) 4/18/94
.\" $FreeBSD: src/bin/sleep/sleep.1,v 1.22 2005/01/16 16:41:59 ru Exp $
.\"
.Dd April 18, 1994
.Dt SLEEP 1
.Os
.Sh NAME
.Nm sleep
.Nd suspend execution for an interval of time
.Sh SYNOPSIS
.Nm
.Ar seconds
.Sh DESCRIPTION
The
.Nm
command
suspends execution for a minimum of
.Ar seconds .
.Pp
If the
.Nm
command receives a signal, it takes the standard action.
.Sh IMPLEMENTATION NOTES
The
.Dv SIGALRM
signal is not handled specially by this implementation.
.Pp
The
.Nm
command will accept and honor a non-integer number of specified seconds
(with a
.Ql .\&
character as a decimal point).
.Bf Sy
This is a non-portable extension, and its use will nearly guarantee that
a shell script will not execute properly on another system.
.Ef
.Sh EXIT STATUS
.Ex -std
.Sh EXAMPLES
To schedule the execution of a command for
.Va x
number seconds later (with
.Xr csh 1 ) :
.Pp
.Dl (sleep 1800; sh command_file >& errors)&
.Pp
This incantation would wait a half hour before
running the script command_file.
(See the
.Xr at 1
utility.)
.Pp
To reiteratively run a command (with the
.Xr csh 1 ) :
.Pp
.Bd -literal -offset indent -compact
while (1)
	if (! -r zzz.rawdata) then
		sleep 300
	else
		foreach i (`ls *.rawdata`)
			sleep 70
			awk -f collapse_data $i >> results
		end
		break
	endif
end
.Ed
.Pp
The scenario for a script such as this might be: a program currently
running is taking longer than expected to process a series of
files, and it would be nice to have
another program start processing the files created by the first
program as soon as it is finished (when zzz.rawdata is created).
The script checks every five minutes for the file zzz.rawdata,
when the file is found, then another portion processing
is done courteously by sleeping for 70 seconds in between each
awk job.
.Sh SEE ALSO
.Xr nanosleep 2 ,
.Xr sleep 3
.Sh STANDARDS
The
.Nm
command is expected to be
.St -p1003.2
compatible.
.Sh HISTORY
A
.Nm
command appeared in
.At v4 .

.\"-
.\" Copyright (c) 1990, 1993, 1994
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" This code is derived from software contributed to Berkeley by
.\" the Institute of Electrical and Electronics Engineers, Inc.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"	@(#)sleep.1	8.3 (Berkeley) 4/18/94
.\" %FreeBSD: src/bin/sleep/sleep.1,v 1.22 2005/01/16 16:41:59 ru Exp %
.\" $FreeBSDru$
.\" $FreeBSD$
.\"
.Dd 18 апреля 1994
.Dt SLEEP 1
.Os
.Sh НАЗВАНИЕ
.Nm sleep
.Nd приостановить выполнение на указанный интервал времени
.Sh СИНТАКСИС
.Nm
.Ar seconds
.Sh ОПИСАНИЕ
Команда
.Nm
приостанавливает выполнение по крайней мере на
.Ar seconds
секунд.
.Pp
Если команда
.Nm
получает сигнал, она предпринимает стандартное действие.
.Sh ОСОБЕННОСТИ РЕАЛИЗАЦИИ
Сигнал
.Dv SIGALRM
не обрабатывается никаким специальным образом в данной реализации.
.Pp
Команда
.Nm
допускает указание дробного числа секунд
(с символом
.Ql .\&
в качестве десятичной точки).
.Bf Sy
Это нестандартное расширение функциональности, и его использование может
привести к тому, что сценарий команд будет выполняться некорректно на
другой системе.
.Ef
.Sh СТАТУС ВЫХОДА
.Ex -std
.Sh ПРИМЕРЫ
Чтобы запланировать выполнение команды через
.Va x
секунд (из
.Xr csh 1 ) :
.Pp
.Dl (sleep 1800; sh command_file >& errors)&
.Pp
Это "заклинание" будет ожидать полчаса перед тем,
как выполнить сценарий команд command_file.
(Посмотрите на утилиту
.Xr at 1 . )
.Pp
Чтобы выполнить команду с повтором (из
.Xr csh 1 ) :
.Pp
.Bd -literal -offset indent -compact
while (1)
	if (! -r zzz.rawdata) then
		sleep 300
	else
		foreach i (`ls *.rawdata`)
			sleep 70
			awk -f collapse_data $i >> results
		end
		break
	endif
end
.Ed
.Pp
Сценарий, подобный этому, может быть использован в следующем случае:
программа, которая выполняется в настоящий момент и обрабатывает
ряд файлов, тратит времени больше, чем ожидалось, и было бы неплохо,
если бы другая программа начала обработку файлов, созданных первой
программой, как только та закончит свою работу (когда будет создан
файл zzz.rawdata).
Сценарий проверяет наличие файла zzz.rawdata каждые пять минут
и когда обнаруживает его, отправляет очередную порцию на обработку,
делая это вежливо, засыпая на 70 секунд перед каждым заданием awk.
.Sh СМОТРИ ТАКЖЕ
.Xr nanosleep 2 ,
.Xr sleep 3
.Sh СТАНДАРТЫ
Ожидается, что команда
.Nm
совместима с
.St -p1003.2 .
.Sh ИСТОРИЯ
Команда
.Nm
появилась в
.At v4 .

SLEEP(1)              Справочник основных команд FreeBSD              SLEEP(1)

ННААЗЗВВААННИИЕЕ
     sslleeeepp -- приостановить выполнение на указанный интервал времени

ССИИННТТААККССИИСС
     sslleeeepp _s_e_c_o_n_d_s

ООППИИССААННИИЕЕ
     Команда sslleeeepp приостанавливает выполнение по крайней мере на _s_e_c_o_n_d_s
     секунд.

     Если команда sslleeeepp получает сигнал, она предпринимает стандартное дей-
     ствие.

ООССООББЕЕННННООССТТИИ РРЕЕААЛЛИИЗЗААЦЦИИИИ
     Сигнал SIGALRM не обрабатывается никаким специальным образом в данной
     реализации.

     Команда sslleeeepp допускает указание дробного числа секунд (с символом `.' в
     качестве десятичной точки).  ЭЭттоо ннеессттааннддааррттннооее рраассшшииррееннииее ффууннккццииооннааллььнноо--
     ссттии,, ии ееггоо ииссппооллььззооввааннииее ммоожжеетт ппррииввеессттии кк ттооммуу,, ччттоо ссццееннаарриийй ккооммаанндд ббууддеетт
     ввыыппооллнняяттььссяя ннееккооррррееккттнноо ннаа ддррууггоойй ссииссттееммее..

ССТТААТТУУСС ВВЫЫХХООДДАА
     Утилита sslleeeepp возвращает 0 в случае успешного завершения и >0 в случае
     возникновения ошибки.

ППРРИИММЕЕРРЫЫ
     Чтобы запланировать выполнение команды через _x секунд (из csh(1)):

           (sleep 1800; sh command_file >& errors)&

     Это "заклинание" будет ожидать полчаса перед тем, как выполнить сценарий
     команд command_file.  (Посмотрите на утилиту at(1).)

     Чтобы выполнить команду с повтором (из csh(1)):

           while (1)
                   if (! -r zzz.rawdata) then
                           sleep 300
                   else
                           foreach i (`ls *.rawdata`)
                                   sleep 70
                                   awk -f collapse_data $i >> results
                           end
                           break
                   endif
           end

     Сценарий, подобный этому, может быть использован в следующем случае: про-
     грамма, которая выполняется в настоящий момент и обрабатывает ряд файлов,
     тратит времени больше, чем ожидалось, и было бы неплохо, если бы другая
     программа начала обработку файлов, созданных первой программой, как
     только та закончит свою работу (когда будет создан файл zzz.rawdata).
     Сценарий проверяет наличие файла zzz.rawdata каждые пять минут и когда
     обнаруживает его, отправляет очередную порцию на обработку, делая это
     вежливо, засыпая на 70 секунд перед каждым заданием awk.

ССММООТТРРИИ ТТААККЖЖЕЕ
     nanosleep(2), sleep(3)

ССТТААННДДААРРТТЫЫ
     Ожидается, что команда sslleeeepp совместима с IEEE Std 1003.2 (``POSIX.2'').

ИИССТТООРРИИЯЯ
     Команда sslleeeepp появилась в Version 4 AT&T UNIX.

FreeBSD 7.0                     18 апреля 1994                     FreeBSD 7.0

Attachment: pgpCuO3PKTq5U.pgp
Description: PGP signature

Follow-Ups:
- Re: [RFR] Перевод sleep(1)
  - From: Vyacheslav Anikin
- Re: [RFR] Перевод sleep(1)
  - From: YANDEX
- Re: [RFR] Перевод sleep(1)
  - From: Eugene Nadtochiy

Prev by Date: Re[2]: Перевод manpages
Next by Date: Re: [RFR] Перевод sleep(1)
Previous by thread: Re: [HEADS UP] обновление внешнего вида freebsd.org.ua
Next by thread: Re: [RFR] Перевод sleep(1)
Index(es):
- Date
- Thread