175 lines
5.3 KiB
Groff
175 lines
5.3 KiB
Groff
.\" Copyright (c) 1983, 1991, 1993
|
|
.\" The Regents of the University of California. 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.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by the University of
|
|
.\" California, Berkeley and its contributors.
|
|
.\" 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.
|
|
.\"
|
|
.\" @(#)flock.2 8.2 (Berkeley) 12/11/93
|
|
.\" %FreeBSD: src/lib/libc/sys/flock.2,v 1.23 2004/07/02 23:52:13 ru Exp %
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.Dd December 11, 1993
|
|
.Dt FLOCK 2
|
|
.Os
|
|
.Sh ̾¾Î
|
|
.Nm flock
|
|
.Nd "³«¤¤¤¿¥Õ¥¡¥¤¥ë¾å¤ÎÌä¹ç¤»·¿¥í¥Ã¥¯¤òŬÍѤޤ¿¤Ï½üµî¤¹¤ë"
|
|
.Sh ¥é¥¤¥Ö¥é¥ê
|
|
.Lb libc
|
|
.Sh ½ñ¼°
|
|
.In sys/file.h
|
|
.Fd "#define LOCK_SH 0x01 /* ¶¦Í¥Õ¥¡¥¤¥ë¥í¥Ã¥¯ */"
|
|
.Fd "#define LOCK_EX 0x02 /* ÇÓ¾Ū¥Õ¥¡¥¤¥ë¥í¥Ã¥¯ */"
|
|
.Fd "#define LOCK_NB 0x04 /* ¥í¥Ã¥¯¤¹¤ë¤È¤¤Ë¥Ö¥í¥Ã¥¯¤·¤Ê¤¤ */"
|
|
.Fd "#define LOCK_UN 0x08 /* ¥Õ¥¡¥¤¥ë¤ò¥¢¥ó¥í¥Ã¥¯¤¹¤ë */"
|
|
.Ft int
|
|
.Fn flock "int fd" "int operation"
|
|
.Sh ²òÀâ
|
|
.Fn flock
|
|
¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¡¢¥Õ¥¡¥¤¥ëµ½Ò»Ò
|
|
.Fa fd
|
|
¤ËÂбþ¤¹¤ë¥Õ¥¡¥¤¥ë¾å¤Î
|
|
.Em Ìä¹ç¤»·¿
|
|
¥í¥Ã¥¯¤òŬÍѤޤ¿¤Ï½üµî¤·¤Þ¤¹¡£
|
|
¥í¥Ã¥¯¤òŬÍѤ¹¤ë¤Ë¤Ï¡¢
|
|
.Fa operation
|
|
°ú¿ô¤Ë
|
|
.Dv LOCK_SH
|
|
¤Þ¤¿¤Ï
|
|
.Dv LOCK_EX
|
|
¤Î¤¤¤º¤ì¤«¤È¡¢É¬ÍפǤ¢¤ì¤Ð
|
|
.Dv LOCK_NB
|
|
¤ò²Ã¤¨¤Æ»ØÄꤷ¤Þ¤¹¡£
|
|
´û¸¤Î¥í¥Ã¥¯¤ò¥¢¥ó¥í¥Ã¥¯¤¹¤ë¾ì¹ç¤Ï
|
|
.Dv operation
|
|
¤ò
|
|
.Dv LOCK_UN
|
|
¤Ë¤·¤Æ¤¯¤À¤µ¤¤¡£
|
|
.Pp
|
|
Ìä¹ç¤»·¿¥í¥Ã¥¯¤Ï¡¢¶¨Æ±¤¹¤ë¥×¥í¥»¥¹´Ö¤Ç¤Î°ì´Ó¤·¤¿¥Õ¥¡¥¤¥ëÁàºî¤ò
|
|
²Äǽ¤Ë¤·¤Þ¤¹¤¬¡¢¥Õ¥¡¥¤¥ë¤Î°ì´ÓÀ¤òÊݾڤ¹¤ë
|
|
¤â¤Î¤Ç¤Ï¤¢¤ê¤Þ¤»¤ó (¤¹¤Ê¤ï¤Á¡¢¥×¥í¥»¥¹¤ÏÌä¹ç¤»·¿¥í¥Ã¥¯¤ò»ÈÍѤ»¤º¤Ë
|
|
¥Õ¥¡¥¤¥ë¤Ë¥¢¥¯¥»¥¹¤Ç¤¤ë¤Î¤Ç¡¢¤½¤Î·ë²Ì°ì´ÓÀ¤¬¤Ê¤¯¤Ê¤ë²ÄǽÀ¤¬¤¢¤ê¤Þ¤¹)¡£
|
|
.Pp
|
|
¥í¥Ã¥¯¥á¥«¥Ë¥º¥à¤Ï
|
|
.Em ¶¦Í
|
|
¥í¥Ã¥¯¤È
|
|
.Em ÇÓ¾Ū
|
|
¥í¥Ã¥¯¤È¤¤¤¦ 2 ¤Ä¤Î¥¿¥¤¥×¤Î¥í¥Ã¥¯¤òÄ󶡤·¤Þ¤¹¡£
|
|
¤¤¤Ä¤Ç¤âÊ£¿ô¤Î¶¦Í¥í¥Ã¥¯¤ò 1 ¤Ä¤Î¥Õ¥¡¥¤¥ë¤ËŬÍѤǤ¤Þ¤¹¡£
|
|
¤·¤«¤·¡¢Æ±»þ¤Ë 1 ¤Ä¤Î¥Õ¥¡¥¤¥ë¤ËÊ£¿ô¤ÎÇÓ¾Ū¥í¥Ã¥¯¡¢
|
|
¤Þ¤¿¤Ï¶¦Í¥í¥Ã¥¯¤ÈÇÓ¾Ū¥í¥Ã¥¯¤ÎξÊý¤òŬÍѤ¹¤ë¤³¤È¤Ï¤Ç¤¤Þ¤»¤ó¡£
|
|
.Pp
|
|
ŬÀڤʥí¥Ã¥¯¤Î¥¿¥¤¥×¤ò»ØÄꤹ¤ë¤À¤±¤Ç¡¢¶¦Í¥í¥Ã¥¯¤ÏÇÓ¾Ū¥í¥Ã¥¯¤Ë
|
|
.Em ¥¢¥Ã¥×¥°¥ì¡¼¥É
|
|
¤Ç¤¡¢ÇÓ¾Ū¥í¥Ã¥¯¤ò¶¦Í¥í¥Ã¥¯¤Ë
|
|
.Em ¥À¥¦¥ó¥°¥ì¡¼¥É
|
|
¤Ç¤¤Þ¤¹¡£
|
|
¤½¤Î·ë²Ì¤È¤·¤ÆÁ°¤Î¥í¥Ã¥¯¤Ï²òÊü¤µ¤ì¤Æ
|
|
¿·¤·¤¤¥í¥Ã¥¯¤¬Å¬ÍѤµ¤ì¤Þ¤¹ (¾¤Î¥×¥í¥»¥¹¤¬¥í¥Ã¥¯¤ò¼èÆÀ¤·
|
|
²òÊü¤·¤¿¸å¤«¤â¤·¤ì¤Þ¤»¤ó)¡£
|
|
.Pp
|
|
´û¤Ë¥í¥Ã¥¯¤µ¤ì¤Æ¤¤¤ë¥ª¥Ö¥¸¥§¥¯¥È¤Ë¤Ä¤¤¤Æ¥í¥Ã¥¯¤òÍ׵᤹¤ë¤È¡¢
|
|
¥í¥Ã¥¯¤¬³ÍÆÀ¤Ç¤¤ë¤Þ¤Ç¸Æ¤Ó½Ð¤·Â¦¤Ï¥Ö¥í¥Ã¥¯¤µ¤ì¤Þ¤¹¡£
|
|
¤¿¤À¤·
|
|
.Dv LOCK_NB
|
|
¤¬
|
|
.Fa operation
|
|
¤Ë´Þ¤Þ¤ì¤ë¾ì¹ç¤Ï¥Ö¥í¥Ã¥¯¤µ¤ì¤Þ¤»¤ó¡£
|
|
Âå¤ï¤ê¤Ë¸Æ¤Ó½Ð¤·¤¬¼ºÇÔ¤·¡¢¥¨¥é¡¼
|
|
.Er EWOULDBLOCK
|
|
¤¬ÊÖ¤µ¤ì¤Þ¤¹¡£
|
|
.Sh Ãí
|
|
¥í¥Ã¥¯¤Ï¥Õ¥¡¥¤¥ë¤Ë¤«¤±¤é¤ì¤ë¤â¤Î¤Ç¤¢¤Ã¤Æ¡¢
|
|
¥Õ¥¡¥¤¥ëµ½Ò»Ò¤Ë¤«¤±¤é¤ì¤ë¤â¤Î¤Ç¤Ï¤¢¤ê¤Þ¤»¤ó¡£
|
|
¤¹¤Ê¤ï¤Á¡¢
|
|
.Xr dup 2
|
|
¤Þ¤¿¤Ï
|
|
.Xr fork 2
|
|
¤Ë¤è¤Ã¤ÆÊ£À½¤µ¤ì¤¿¥Õ¥¡¥¤¥ëµ½Ò»Ò¤Ï¡¢
|
|
¥í¥Ã¥¯¤ÎÊ£¿ô¤Î¥¤¥ó¥¹¥¿¥ó¥¹¤È¤Ï¤Ê¤é¤º¤Ë¡¢1 ¤Ä¤Î¥í¥Ã¥¯¤Ø¤ÎÊ£¿ô¤Î
|
|
»²¾È¤Ë¤Ê¤ê¤Þ¤¹¡£
|
|
¤¢¤ë¥Õ¥¡¥¤¥ë¤Ë¤Ä¤¤¤Æ¤Î¥í¥Ã¥¯¤òÊÝ»ý¤·¤Æ¤¤¤ë¥×¥í¥»¥¹¤¬¥Õ¥©¡¼¥¯¤·¡¢
|
|
»Ò¥×¥í¥»¥¹¤¬ÌÀ¼¨Åª¤Ë¤½¤Î¥Õ¥¡¥¤¥ë¤ò¥¢¥ó¥í¥Ã¥¯¤¹¤ë¾ì¹ç¡¢
|
|
¿Æ¥×¥í¥»¥¹¤Ï¤½¤Î¥í¥Ã¥¯¤ò¼º¤¤¤Þ¤¹¡£
|
|
.Pp
|
|
.Fn flock ,
|
|
.Xr fcntl 2
|
|
¤ª¤è¤Ó
|
|
.Xr lockf 3
|
|
¤Î¥í¥Ã¥¯¤Ï¸ß´¹À¤¬¤¢¤ê¤Þ¤¹¡£
|
|
°Û¤Ê¤Ã¤¿¥í¥Ã¥¯¤Î¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤ò»ÈÍѤ¹¤ë¥×¥í¥»¥¹¤Ï¡¢
|
|
Ʊ¤¸¥Õ¥¡¥¤¥ë¤ò°ÂÁ´¤Ë»ÈÍѤ¹¤ë¤³¤È¤¬¤Ç¤¤Þ¤¹¡£
|
|
¤·¤«¤·¤Ê¤¬¤é¡¢Æ±¤¸¥×¥í¥»¥¹¤ÎÆâÉô¤Ç¤Ï
|
|
¤³¤ì¤é¤Î¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Î¤¦¤Á¤Î 1 ¤Ä¤Î¤ß¤¬»ÈÍѤµ¤ì¤ë¤Ù¤¤Ç¤¹¡£
|
|
.Fn flock
|
|
¤ò²ð¤·¤Æ¤¢¤ë¥×¥í¥»¥¹¤Ë¤è¤Ã¤Æ¤¢¤ë¥Õ¥¡¥¤¥ë¤¬¥í¥Ã¥¯¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¡¢
|
|
.Xr fcntl 2
|
|
¤Þ¤¿¤Ï
|
|
.Xr lockf 3
|
|
¤ò»ÈÍѤ·¤Æ¤¤¤ë¾¤Î¥×¥í¥»¥¹¤Î»ëÅÀ¤«¤é¤Ï¡¢
|
|
¤½¤Î¥Õ¥¡¥¤¥ë¤ÎÃæ¤Î¤¢¤é¤æ¤ë¥ì¥³¡¼¥É¤Ï¥í¥Ã¥¯¤µ¤ì¤Æ¤¤¤ë¤«¤Î¤è¤¦¤Ë¸«¤¨¤Þ¤¹¡£
|
|
¤Þ¤¿¡¢¤½¤ÎµÕ¤âƱÍͤǤ¹¡£
|
|
.Pp
|
|
¥í¥Ã¥¯¤òÂԤäƥ֥í¥Ã¥¯¤·¤Æ¤¤¤ë¥×¥í¥»¥¹¤Ï¥·¥°¥Ê¥ë¤Çµ¯¤³¤µ¤ì¤ë¤«¤â¤·¤ì¤Þ¤»¤ó¡£
|
|
.Sh Ìá¤êÃÍ
|
|
.Rv -std flock
|
|
.Sh ¥¨¥é¡¼
|
|
.Fn flock
|
|
¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¼¡¤Î¾ì¹ç¤Ë¼ºÇÔ¤·¤Þ¤¹:
|
|
.Bl -tag -width Er
|
|
.It Bq Er EWOULDBLOCK
|
|
¥Õ¥¡¥¤¥ë¤Ï¤¹¤Ç¤Ë
|
|
.Dv LOCK_NB
|
|
¥ª¥×¥·¥ç¥ó¤¬»ØÄꤵ¤ì¤¿¾õÂ֤ǥí¥Ã¥¯¤µ¤ì¤Æ¤¤¤Þ¤¹¡£
|
|
.It Bq Er EBADF
|
|
°ú¿ô
|
|
.Fa fd
|
|
¤¬Ìµ¸ú¤Êµ½Ò»Ò¤ò»Ø¤·¤Æ¤¤¤Þ¤¹¡£
|
|
.It Bq Er EINVAL
|
|
°ú¿ô
|
|
.Fa fd
|
|
¤¬¥Õ¥¡¥¤¥ë°Ê³°¤Î¥ª¥Ö¥¸¥§¥¯¥È¤ò»²¾È¤·¤Æ¤¤¤Þ¤¹¡£
|
|
.It Bq Er EOPNOTSUPP
|
|
°ú¿ô
|
|
.Fa fd
|
|
¤¬¥Õ¥¡¥¤¥ë¤Î¥í¥Ã¥¯¤ò¥µ¥Ý¡¼¥È¤·¤Ê¤¤¥ª¥Ö¥¸¥§¥¯¥È¤ò»²¾È¤·¤Æ¤¤¤Þ¤¹¡£
|
|
.El
|
|
.Sh ´ØÏ¢¹àÌÜ
|
|
.Xr close 2 ,
|
|
.Xr dup 2 ,
|
|
.Xr execve 2 ,
|
|
.Xr fcntl 2 ,
|
|
.Xr fork 2 ,
|
|
.Xr open 2 ,
|
|
.Xr lockf 3
|
|
.Sh Îò»Ë
|
|
.Fn flock
|
|
¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï
|
|
.Bx 4.2
|
|
¤ÇÅо줷¤Þ¤·¤¿¡£
|