aboutsummaryrefslogtreecommitdiff
path: root/ru_RU.KOI8-R/man/man1/lockf.1
diff options
context:
space:
mode:
Diffstat (limited to 'ru_RU.KOI8-R/man/man1/lockf.1')
-rw-r--r--ru_RU.KOI8-R/man/man1/lockf.1141
1 files changed, 141 insertions, 0 deletions
diff --git a/ru_RU.KOI8-R/man/man1/lockf.1 b/ru_RU.KOI8-R/man/man1/lockf.1
new file mode 100644
index 0000000000..ba1d1aead4
--- /dev/null
+++ b/ru_RU.KOI8-R/man/man1/lockf.1
@@ -0,0 +1,141 @@
+.\"
+.\" Copyright (C) 1998 John D. Polstra. All rights reserved.
+.\"
+.\" 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.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY JOHN D. POLSTRA 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 JOHN D. POLSTRA 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.
+.\"
+.\" %FreeBSD: src/usr.bin/lockf/lockf.1,v 1.18.2.2 2007/11/14 19:25:04 ru Exp %
+.\" $FreeBSDru: frdp/doc/ru_RU.KOI8-R/man/man1/lockf.1,v 1.5 2007/11/20 13:50:08 ru Exp $
+.\" $FreeBSD$
+.\"
+.Dd 7 июля 1998
+.Os
+.Dt LOCKF 1
+.Sh НАЗВАНИЕ
+.Nm lockf
+.Nd выполнить команду, удерживая блокировку на файле
+.Sh СИНТАКСИС
+.Nm
+.Op Fl ks
+.Op Fl t Ar секунды
+.Ar файл
+.Ar команда
+.Op Ar аргументы
+.Sh ОПИСАНИЕ
+Утилита
+.Nm
+запрашивает эксклюзивную блокировку файла
+.Ar файл ,
+создавая его при необходимости
+.Bf Em
+и удаляя файл при завершении, если это не было запрещено явно.
+.Ef
+Удерживая полученную блокировку, утилита выполняет указанную команду
+с заданными аргументами.
+Когда
+.Ar команда
+завершается,
+.Nm
+снимает блокировку и, если не указана опция
+.Fl k ,
+удаляет
+.Ar файл .
+Используется механизм блокировок в
+.Bx Ns -стиле ,
+описанный в
+.Xr flock 2 ;
+одно лишь существование файла
+.Ar файл
+не является признаком установленной блокировки.
+.Pp
+Если утилита
+.Nm
+используется для обеспечения конкурентности между несколькими
+процессами, рекомендуется использовать опцию
+.Fl k .
+Она гарантирует порядок блокировки, а также реализует
+алгоритм с повышенной производительностью, который минимизирует
+нагрузку на процессор, связанную с конкурентным удалением
+файла, разблокировкой и новым запросом блокировки.
+Следует отметить, что если опция
+.Fl k
+не используется, то порядок блокировки не гарантируется.
+.Pp
+Имеются следующие опции:
+.Bl -tag -width ".Fl t Ar секунды"
+.It Fl k
+Оставлять (не удалять) файл блокировки после завершения
+работы команды.
+.It Fl s
+Не выводить никаких сообщений.
+Невозможность получения блокировки отразится лишь на статусе завершения.
+.It Fl t Ar секунды
+Установить максимальное время ожидания получения блокировки.
+По умолчанию,
+.Nm
+будет ждать бесконечно долго.
+Если же задан этот параметр, утилита будет ждать не более указанного
+числа секунд, после чего прекратит свои попытки получения блокировки.
+Может быть указано значение 0, тогда
+.Nm
+завершится с ошибкой, если не удалось получить блокировку сразу же.
+В случае, если время ожидания истекло,
+.Ar команда
+.Em не
+выполняется.
+.El
+.Pp
+Ни при каких обстоятельствах
+.Nm
+не нарушит блокировку, удерживаемую другим процессом.
+.Sh СТАТУС ЗАВЕРШЕНИЯ
+Если блокировка была успешна получена,
+.Nm
+возвращает статус завершения команды
+.Ar команда .
+В противном случае, будет возвращён один из следующих
+кодов, определённых в
+.Xr sysexits 3 :
+.Bl -tag -width ".Dv EX_CANTCREAT"
+.It Dv EX_TEMPFAIL
+Указанный файл блокировки уже заблокирован другим процессом.
+.It Dv EX_CANTCREAT
+Утилита
+.Nm
+не смогла создать файл блокировки, например, из-за недостаточных
+прав доступа.
+.It Dv EX_USAGE
+Неверный синтаксис командной строки, переданной
+.Nm .
+.It Dv EX_OSERR
+Неожиданный сбой системного вызова (например,
+.Xr fork 2 ) .
+.El
+.Sh СМОТРИ ТАКЖЕ
+.Xr flock 2 ,
+.Xr sysexits 3
+.Sh ИСТОРИЯ
+Утилита
+.Nm
+появилась во
+.Fx 2.2 .
+.Sh АВТОРЫ
+.An John Polstra Aq jdp@polstra.com