> Linux Reviews > man >

inotify_add_watch


  1. inotify_add_watch.2.man


1. inotify_add_watch.2.man

Manpage of INOTIFY_ADD_WATCH

INOTIFY_ADD_WATCH

Section: Руководство программиста Linux (2)
Updated: 2006-02-07
Index Return to Main Contents
 

ИМЯ

inotify_add_watch - добавляет сторожок к инициализированному экземпляру inotify  

ОБЗОР

#include <sys/inotify.h>

int inotify_add_watch(int fd, const char *pathname, uint32_t mask);  

ОПИСАНИЕ

Вызов inotify_add_watch() добавляет новый сторожок (watch) или изменяет существующий, для файла, чьё расположение указано в pathname; вызывающий должен иметь право читать этот файл. Аргумент fd является файловым дескриптором, ссылающимся на экземпляр inotify, у которого изменяется список сторожков. Отслеживаемые с pathname события указываются маской битов в аргументе mask. Описание битов mask смотрите в inotify(7).

При успешном выполнении inotify_add_watch() возвращает уникальный дескриптор сторожка, связанный с pathname для данного экземпляра inotify. Если ранее pathname на наблюдался данным экземпляром inotify, то создаётся новый дескриптор сторожка. Если pathname уже отслеживался, то возвращается дескриптор существующего сторожка.

Дескриптор сторожка возвращается при последующих операциях read(2) из файлового дескриптора inotify. При чтении извлекаются структуры inotify_event (см. inotify(7)), указывающие на события в файловой системе; дескриптор сторожка внутри этой структуры определяет объект, для которого произошло событие.  

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При удачном завершении inotify_add_watch() возвращает неотрицательный дескриптор сторожка. При ошибке возвращается -1, а значение errno устанавливается соответствующим образом.  

ОШИБКИ

EACCES
Нет прав на чтение указанного файла.
EBADF
Указан неверный файловый дескриптор.
EFAULT
pathname указывает за пределы доступного адресного пространства.
EINVAL
Указанная маска событий не содержит допустимых событий; или fd не является файловым дескриптором inotify.
ENOMEM
Недостаточное количество памяти ядра.
ENOSPC
Достигнуто максимальное количество сторожков inotify доступных пользователю или ядру не удалось выделить необходимые ресурсы.
 

ВЕРСИИ

Inotify был добавлен в ядро Linux версии 2.6.13.  

СООТВЕТСТВИЕ СТАНДАРТАМ

Данный вызов есть только в Linux.  

СМОТРИТЕ ТАКЖЕ

inotify_init(2), inotify_rm_watch(2), inotify(7)


 

Index

ИМЯ
ОБЗОР
ОПИСАНИЕ
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
ОШИБКИ
ВЕРСИИ
СООТВЕТСТВИЕ СТАНДАРТАМ
СМОТРИТЕ ТАКЖЕ

This document was created by man2html using the manual pages.
Time: 17:41:22 GMT, October 23, 2013

SVENSKA - SVENSKA - ja