Print this page
    
    
      
        | Split | 
	Close | 
      
      | Expand all | 
      | Collapse all | 
    
    
          --- old/usr/src/man/man3c/inotify_rm_watch.3c
          +++ new/usr/src/man/man3c/inotify_rm_watch.3c
   1    1  '\" te
   2    2  .\"  Copyright (c) 2014, Joyent, Inc. All Rights Reserved.
   3    3  .\"  This file and its contents are supplied under the terms of the
   4    4  .\"  Common Development and Distribution License ("CDDL"), version 1.0.
   5    5  .\"  You may only use this file in accordance with the terms of version
   6    6  .\"  1.0 of the CDDL.
   7    7  .\" 
   8    8  .\"  A full copy of the text of the CDDL should have accompanied this
   9    9  .\"  source.  A copy of the CDDL is also available via the Internet at
  10   10  .\"  http://www.illumos.org/license/CDDL.
  11   11  .TH INOTIFY_RM_WATCH 3C "Sep 17, 2014"
  12   12  .SH NAME
  13   13  inotify_rm_watch \- remove a watch from an inotify instance
  14   14  .SH SYNOPSIS
  15   15  
  16   16  .LP
  17   17  .nf
  18   18  #include <sys/inotify.h>
  19   19  
  20   20  \fBint\fR \fBinotify_rm_watch\fR(\fBint\fR \fIfd\fR, \fBint\fR \fIwd\fR);
  21   21  .fi
  22   22  
  23   23  .SH DESCRIPTION
  24   24  .sp
  25   25  .LP
  26   26  The \fBinotify_rm_watch()\fR function removes the watch specified
  27   27  by \fIwd\fR from the inotify instance associated with \fIfd\fR.
  28   28  Removing a watch will induce an \fBIN_IGNORED\fR event; see
  29   29  \fBinotify\fR(5) for details.
  30   30  
  31   31  .SH RETURN VALUES
  32   32  .sp
  33   33  .LP
  34   34  Upon succesful completion, \fBinotify_add_watch()\fR returns the
  35   35  watch descriptor associated with the new watch.
  36   36  If an error occurs, -1 is returned and errno is set to indicate
  37   37  the error.
  38   38  
  39   39  .SH ERRORS
  40   40  .sp
  41   41  .LP
  42   42  \fBinotify_rm_watch()\fR will fail if:
  43   43  .sp
  44   44  .ne 2
  45   45  .na
  46   46  \fB\fBEBADF\fR\fR
  47   47  .ad
  48   48  .RS 10n
  49   49  The \fIfd\fR argument is not a valid open file descriptor.
  50   50  .RE
  51   51  
  52   52  .sp
  53   53  .ne 2
  54   54  .na
  55   55  \fB\fBEINVAL\fR\fR
  56   56  .ad
  57   57  .RS 10n
  58   58  The \fIfd\fR argument does not correspond to an
  59   59  \fBinotify\fR(5) instance as initialized with 
  60   60  \fBinotify_init\fR(3C) or \fBinotify_init1\fR(3C), or
  61   61  \fIwd\fR is not a valid watch for the specified inotify
  62   62  instance.
  63   63  .RE
  64   64  
  65   65  .sp
  66   66  .SH NOTES
  67   67  .sp
  68   68  .LP
  69   69  
  70   70  While the \fBinotify\fR(5) facility is implemented for purposes of
  71   71  offering compatibility for Linux-borne applications, native
  72   72  applications may opt to use it instead of (or in addition to) the 
  73   73  \fBPORT_SOURCE_FILE\fR capability of event ports.  See
  74   74  \fBinotify\fR(5) for details and restrictions.
  75   75  
  76   76  .SH SEE ALSO
  77   77  .sp
  78   78  .LP
  79   79  \fBinotify_init\fR(3C), \fBinotify_init1\fR(3C),
  80   80  \fBport_create\fR(3C), \fBport_associate\fR(3C), \fBport_get\fR(3C),
  81   81  \fBinotify\fR(5)
  
    | 
      ↓ open down ↓ | 
    81 lines elided | 
    
      ↑ open up ↑ | 
  
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX