manual/LDP_man-pages/draft/man2/inotify_rm_watch.2

   1 .\" man2/inotify_rm_watch.2 - inotify_rm_watch man page
   2 .\"
   3 .\" Copyright (C) 2005 Robert Love
   4 .\"
   5 .\" This is free documentation; you can redistribute it and/or
   6 .\" modify it under the terms of the GNU General Public License as
   7 .\" published by the Free Software Foundation; either version 2 of
   8 .\" the License, or (at your option) any later version.
   9 .\"
  10 .\" The GNU General Public License's references to "object code"
  11 .\" and "executables" are to be interpreted as the output of any
  12 .\" document formatting or typesetting system, including
  13 .\" intermediate and printed output.
  14 .\"
  15 .\" This manual is distributed in the hope that it will be useful,
  16 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  17 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18 .\" GNU General Public License for more details.
  19 .\"
  20 .\" You should have received a copy of the GNU General Public
  21 .\" License along with this manual; if not, write to the Free
  22 .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
  23 .\" USA.
  24 .\"
  25 .\" 2005-07-19 Robert Love <rlove@rlove.org> - initial version
  26 .\" 2006-02-07 mtk, minor changes
  27 .\"
  28 .\" Japanese Version Copyright (c) 2006 Akihiro MOTOKI
  29 .\"         all rights reserved.
  30 .\" Translated 2006-08-15, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.39
  31 .\"
  32 .\" WORD:       watch                   ´Æ»ë¥¢¥¤¥Æ¥à
  33 .\" WORD:       watch descriptor        ´Æ»ëÂÐ¾Ý¥Ç¥£¥¹¥¯¥ê¥×¥¿
  34 .\"
  35 .TH INOTIFY_RM_WATCH 2 2006-02-07 "Linux" "Linux Programmer's Manual"
  36 .\"O .SH NAME
  37 .SH Ì¾Á°
  38 .\"O inotify_rm_watch \- remove an existing watch from an inotify instance
  39 inotify_rm_watch \- inotify ¥¤¥ó¥¹¥¿¥ó¥¹¤«¤é´ûÂ¸¤Î´Æ»ë¥¢¥¤¥Æ¥à¤òºï½ü¤¹¤ë
  40 .\"O .SH SYNOPSIS
  41 .SH ½ñ¼°
  42 .B #include <sys/inotify.h>
  43 .sp
  44 .BI "int inotify_rm_watch(int " fd ", uint32_t " wd );
  45 .\" FIXME . The type of the second argument should probably be "int".
  46 .\" I submitted a patch to fix this.  See the LKML thread
  47 .\" "[patch] Fix type errors in inotify interfaces", 18 Nov 2008
  48 .\" Glibc bug filed: http://sources.redhat.com/bugzilla/show_bug.cgi?id=7040
  49 .\"O .SH DESCRIPTION
  50 .SH ÀâÌÀ
  51 .\"O .BR inotify_rm_watch ()
  52 .\"O removes the watch associated with the watch descriptor
  53 .\"O .I wd
  54 .\"O from the inotify instance associated with the file descriptor
  55 .\"O .IR fd .
  56 .BR inotify_rm_watch ()
  57 ¤Ï¡¢´Æ»ëÂÐ¾Ý¥Ç¥£¥¹¥¯¥ê¥×¥¿ (watch descriptor)
  58 .I wd
  59 ¤ËÂÐ±þ¤¹¤ë´Æ»ë¥¢¥¤¥Æ¥à¤ò¡¢
  60 ¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
  61 .I fd
  62 ¤ËÂÐ±þ¤¹¤ë inotify ¥¤¥ó¥¹¥¿¥ó¥¹¤«¤éºï½ü¤¹¤ë¡£
  63
  64 .\"O Removing a watch causes an
  65 .\"O .B IN_IGNORED
  66 .\"O event to be generated for this watch descriptor.
  67 .\"O (See
  68 .\"O .BR inotify (7).)
  69 ´Æ»ëÂÐ¾Ý¤òºï½ü¤¹¤ë¤È¡¢
  70 ¤³¤Î´Æ»ëÂÐ¾Ý¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ËÂÐ¤·¤Æ
  71 .B IN_IGNORED
  72 ¥¤¥Ù¥ó¥È¤¬À¸À®¤µ¤ì¤ë
  73 .RB ( inotify (7)
  74 »²¾È)¡£
  75 .\"O .SH "RETURN VALUE"
  76 .SH ÊÖ¤êÃÍ
  77 .\"O On success,
  78 .\"O .BR inotify_rm_watch ()
  79 .\"O returns zero, or \-1 if an error occurred (in which case,
  80 .\"O .I errno
  81 .\"O is set appropriately).
  82 À®¸ù¤¹¤ë¤È¡¢
  83 .BR inotify_rm_watch ()
  84 ¤Ï 0 ¤òÊÖ¤¹¡£
  85 ¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤òÊÖ¤·¡¢
  86 .I errno
  87 ¤òÅ¬ÀÚ¤ËÀßÄê¤¹¤ë¡£
  88 .\"O .SH ERRORS
  89 .SH ¥¨¥é¡¼
  90 .TP
  91 .B EBADF
  92 .\"O .I fd
  93 .\"O is not a valid file descriptor.
  94 .I fd
  95 ¤¬Í¸ú¤Ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ï¤Ê¤¤¡£
  96 .TP
  97 .B EINVAL
  98 .\"O The watch descriptor
  99 .\"O .I wd
 100 .\"O is not valid; or
 101 .\"O .I fd
 102 .\"O is not an inotify file descriptor.
 103 ´Æ»ëÂÐ¾Ý¥Ç¥£¥¹¥¯¥ê¥×¥¿
 104 .I wd
 105 ¤¬Í¸ú¤Ç¤Ê¤¤¡£¤â¤·¤¯¤Ï¡¢
 106 .I fd
 107 ¤¬ inotify ¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ï¤Ê¤¤¡£
 108 .\"O .SH VERSIONS
 109 .SH ¥Ð¡¼¥¸¥ç¥ó
 110 .\"O Inotify was merged into the 2.6.13 Linux kernel.
 111 inotify ¤Ï Linux ¥«¡¼¥Í¥ë 2.6.13 ¤ËÁÈ¤ß¹þ¤Þ¤ì¤¿¡£
 112 .\"O .SH "CONFORMING TO"
 113 .SH ½àµò
 114 .\"O This system call is Linux-specific.
 115 ¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï Linux ÆÈ¼«¤Ç¤¢¤ë¡£
 116 .\"O .SH "SEE ALSO"
 117 .SH ´ØÏ¢¹àÌÜ
 118 .BR inotify_add_watch (2),
 119 .BR inotify_init (2),
 120 .BR inotify (7)