.\" -*- coding: UTF-8 -*- .\" Copyright (C) 2005 Robert Love .\" and Copyright, 2006 Michael Kerrisk .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" 2005-07-19 Robert Love - initial version .\" 2006-02-07 mtk, various changes .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH inotify_add_watch 2 "30 марта 2023 г." "Linux man\-pages 6.05.01" .SH ИМЯ inotify_add_watch \- добавляет сторожок к инициализированному экземпляру inotify .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .PP \fBint inotify_add_watch(int \fP\fIfd\fP\fB, const char *\fP\fIpathname\fP\fB, uint32_t \fP\fImask\fP\fB);\fP .fi .SH ОПИСАНИЕ Вызов \fBinotify_add_watch\fP() добавляет новый сторожок (watch) или изменяет существующий, для файла, чьё расположение указано в \fIpathname\fP; вызывающий должен иметь право читать этот файл. Аргумент \fIfd\fP является файловым дескриптором, ссылающимся на экземпляр inotify, у которого изменяется список сторожков. Отслеживаемые с \fIpathname\fP события указываются маской битов в аргументе \fImask\fP. Описание битов \fImask\fP смотрите в \fBinotify\fP(7). .PP При успешном выполнении \fBinotify_add_watch\fP() возвращает уникальный дескриптор сторожка данного экземпляра inotify, для объекта файловой системы (иноды), связанной с \fIpathname\fP. Если ранее объект файловой системы не наблюдался данным экземпляром inotify, то создаётся новый дескриптор сторожка. Если объект файловой системы уже отслеживался (возможно, через другую ссылку на тот же объект), то возвращается дескриптор существующего сторожка. .PP Дескриптор сторожка возвращается при последующих операциях \fBread\fP(2) из файлового дескриптора inotify. При чтении извлекаются структуры \fIinotify_event\fP (см. \fBinotify\fP(7)), указывающие на события в файловой системе; дескриптор сторожка внутри этой структуры определяет объект, для которого произошло событие. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" On success, \fBinotify_add_watch\fP() returns a watch descriptor (a nonnegative integer). On error, \-1 is returned and \fIerrno\fP is set to indicate the error. .SH ОШИБКИ .TP \fBEACCES\fP Нет прав на чтение указанного файла. .TP \fBEBADF\fP Указан неверный файловый дескриптор. .TP \fBEEXIST\fP В \fImask\fP содержится \fBIN_MASK_CREATE\fP и \fIpathname\fP ссылается на файл, который уже отслеживается тем же \fIfd\fP. .TP \fBEFAULT\fP \fIpathname\fP указывает за пределы доступного адресного пространства. .TP \fBEINVAL\fP Указанная маска событий не содержит допустимых событий; \fImask\fP содержит \fBIN_MASK_ADD\fP и \fBIN_MASK_CREATE\fP одновременно; \fIfd\fP не является файловым дескриптором inotify. .TP \fBENAMETOOLONG\fP Слишком длинное значение аргумента \fIpathname\fP. .TP \fBENOENT\fP Один из каталогов в \fIpathname\fP не существует или является повисшей символьной ссылкой. .TP \fBENOMEM\fP Недостаточное количество памяти ядра. .TP \fBENOSPC\fP Достигнуто максимальное количество сторожков inotify доступных пользователю или ядру не удалось выделить необходимые ресурсы. .TP \fBENOTDIR\fP В значении \fImask\fP содержится \fBIN_ONLYDIR\fP и \fIpathname\fP не является каталогом. .SH СТАНДАРТЫ Linux. .SH ИСТОРИЯ Linux 2.6.13. .SH ПРИМЕРЫ Смотрите \fBinotify\fP(7). .SH "СМ. ТАКЖЕ" \fBinotify_init\fP(2), \fBinotify_rm_watch\fP(2), \fBinotify\fP(7) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Azamat Hackimov , Dmitriy S. Seregin , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .