.\" -*- coding: UTF-8 -*-
.\" Copyright 2005, Robert Love <rlove@rlove.org>
.\" Copyright 2006, Michael Kerrisk <mtk.manpages@gmail.com>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH inotify_add_watch 2 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
inotify_add_watch \- إضافة مراقبة إلى نسخة inotify مهيأة
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <sys/inotify.h>\fP
.P
\fBint inotify_add_watch(int \fP\fIfd\fP\fB, const char *\fP\fIpath\fP\fB, uint32_t \fP\fImask\fP\fB);\fP
.fi
.SH الوصف
تضيف \fBinotify_add_watch\fP() مراقبة جديدة، أو تعدل مراقبة موجودة، للملف الذي
يحدد موقعه في \fIpath\fP؛ يجب أن يكون لدى المستدعي صلاحية قراءة لهذا
الملف. الوسيط \fIfd\fP هو واصف ملف يشير إلى نسخة inotify التي سيتم تعديل قائمة
مراقبتها. تحدد الأحداث المراد مراقبتها لـ \fIpath\fP في وسيط قناع البت
\fImask\fP. انظر \fBinotify\fP(7) لوصف البتات التي يمكن تعيينها في \fImask\fP.
.P
يعيد استدعاء ناجح لـ \fBinotify_add_watch\fP() واصف مراقبة فريد لنسخة inotify
هذه، لكائن نظام الملفات (inode) الذي يتوافق مع \fIpath\fP. إذا لم يكن كائن نظام
الملفات مراقبًا سابقًا بواسطة نسخة inotify هذه، فإن واصف المراقبة يخصص
حديثًا. إذا كان كائن نظام الملفات مراقبًا بالفعل (ربما عبر رابط مختلف لنفس
الكائن)، فإن واصف المراقبة الحالية يعاد.
.P
يعاد واصف المراقبة بواسطة استدعاءات \fBread\fP(2) لاحقة من واصف ملف
inotify. تجلب هذه القراءات بنى \fIinotify_event\fP (انظر \fBinotify\fP(7)) التي
تشير إلى أحداث نظام الملفات؛ يحدد واصف المراقبة داخل هذه البنية الكائن الذي
حدث له الحدث.
.SH "قيمة الإرجاع"
عند النجاح، يعيد \fBinotify_add_watch\fP() واصف مراقبة (عدد صحيح غير سالب). عند
الخطأ، يعاد \-1 ويضبط \fIerrno\fP للإشارة إلى الخطأ.
.SH الأخطاء
.TP 
\fBEACCES\fP
الوصول للقراءة إلى الملف المعطى غير مسموح به.
.TP 
\fBEBADF\fP
واصف الملف المعطى غير صالح.
.TP 
\fBEEXIST\fP
يحتوي \fImask\fP على \fBIN_MASK_CREATE\fP ويشير \fIpath\fP إلى ملف مراقب بالفعل
بواسطة نفس \fIfd\fP.
.TP 
\fBEFAULT\fP
يشير \fIpath\fP إلى خارج مساحة العنوان القابلة للوصول للعملية.
.TP 
\fBEINVAL\fP
لا يحتوي قناع الحدث المعطى على أحداث صالحة؛ أو يحتوي \fImask\fP على كل من
\fBIN_MASK_ADD\fP و \fBIN_MASK_CREATE\fP؛ أو \fIfd\fP ليس واصف ملف inotify.
.TP 
\fBENAMETOOLONG\fP
المسار \fIpath\fP طويل جداً.
.TP 
\fBENOENT\fP
مكون الدليل في \fIpath\fP غير موجود أو أنه وصلة رمزية معلقة.
.TP 
\fBENOMEM\fP
ذاكرة النواة المتوفرة غير كافية.
.TP 
\fBENOSPC\fP
وصل حد المستخدم على العدد الإجمالي لمراقبات inotify أو فشلت النواة في تخصيص
مورد مطلوب.
.TP 
\fBENOTDIR\fP
يحتوي \fImask\fP على \fBIN_ONLYDIR\fP و \fIpath\fP ليس دليلاً.
.SH المعايير
لينكس.
.SH التاريخ
لينكس 2.6.13.
.SH أمثلة
انظر \fBinotify\fP(7).
.SH "انظر أيضًا"
\fBinotify_init\fP(2), \fBinotify_rm_watch\fP(2), \fBinotify\fP(7)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .