NUME

       inotify_add_watch - adaugă o monitorizare la o instanță inotify inițializată

BIBLIOTECA

       Biblioteca C standard (libc, -lc)

REZUMAT

       #include <sys/inotify.h>

       int inotify_add_watch(int fd, const char *nume-rută, uint32_t masca);

DESCRIERE

       inotify_add_watch()  adaugă  o  nouă  monitorizare  sau  modifică o monitorizare existentă
       pentru fișierul a cărui locație este specificată în nume-rută; apelantul trebuie  să  aibă
       permisiunea  de  citire  pentru  acest fișier.  Argumentul fd este un descriptor de fișier
       care se referă  la  instanța  inotify  a  cărei  listă  de  monitorizare  urmează  să  fie
       modificată.   Evenimentele  care trebuie monitorizate pentru nume-rută sunt specificate în
       argumentul masca bit-mask.  A se vedea inotify(7) pentru o descriere a biților care pot fi
       definiți în masca.

       Un apel reușit la inotify_add_watch() returnează un descriptor de monitorizare unic pentru
       această instanță inotify, pentru obiectul sistemului de fișiere  (nod-i)  care  corespunde
       lui  nume-rută.   În  cazul  în  care obiectul sistemului de fișiere nu a fost monitorizat
       anterior de către această instanță  inotify,  atunci  descriptorul  de  monitorizare  este
       alocat  recent.   În  cazul în care obiectul sistemului de fișiere a fost deja monitorizat
       (poate prin intermediul unei  legături  diferite  către  același  obiect),  se  returnează
       descriptorul pentru monitorizarea existentă.

       Descriptorul  de  monitorizare  este  returnat  de  către  citirile read(2) ulterioare din
       descriptorul de fișier inotify.  Aceste citiri  preiau  structurile  inotify_event  (a  se
       vedea  inotify(7))  care indică evenimentele din sistemul de fișiere; descriptorul de ceas
       din această structură identifică obiectul pentru care a avut loc evenimentul.

VALOAREA RETURNATĂ

       În caz de succes, inotify_add_watch() returnează un descriptor de monitorizare  (un  număr
       întreg  nenegativ).  În caz de eroare, se returnează -1, iar errno este configurată pentru
       a indica eroarea.

ERORI

       EACCES Nu este permis accesul de citire la fișierul dat.

       EBADF  Descriptorul de fișier dat nu este valid.

       EEXIST masca conține IN_MASK_CREATE, iar nume-rută se referă la un fișier care  este  deja
              monitorizat de același fd.

       EFAULT nume-rută indică în afara spațiului de adrese accesibil procesului.

       EINVAL Masca  de  eveniment  dată  nu  conține  evenimente  valide; sau masca conține atât
              IN_MASK_ADD, cât și IN_MASK_CREATE; sau fd nu este un descriptor de fișier inotify.

       ENAMETOOLONG
              nume-rută este prea lung.

       ENOENT O componentă de director din nume-rută nu există  sau  este  o  legătură  simbolică
              incertă.

       ENOMEM Nu a fost disponibilă suficientă memorie pentru nucleu.

       ENOSPC Limita  utilizatorului  privind numărul total de monitorizări inotify a fost atinsă
              sau nucleul nu a reușit să aloce o resursă necesară.

       ENOTDIR
              masca conține IN_ONLYDIR, iar nume-rută nu este un director.

VERSIUNI

       Inotify a fost introdusă în nucleul Linux 2.6.13.

STANDARDE

       Acest apel de sistem este specific pentru Linux.

EXEMPLE

       A se vedea inotify(7).

CONSULTAȚI ȘI

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

TRADUCERE

       Traducerea în limba  română  a  acestui  manual  a  fost  creată  de  Remus-Gabriel  Chelu
       <remusgabriel.chelu@disroot.org>

       Această  traducere  este  documentație  gratuită;  citiți  Licența  publică  generală  GNU
       Versiunea 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  sau  o  versiune  ulterioară  cu
       privire la condiții privind drepturile de autor.  NU se asumă Nicio RESPONSABILITATE.

       Dacă  găsiți  erori  în  traducerea  acestui  manual,  vă  rugăm să trimiteți un e-mail la
       ⟨translation-team-ro@lists.sourceforge.net⟩.