<?xml version="1.0" encoding="utf-8"?>

<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.evstat" role="class">

<title>La classe EvStat</title>

<titleabbrev>EvStat</titleabbrev>

<partintro>

<section xml:id="evstat.intro">

&reftitle.intro;

<simpara>

La classe <classname>EvStat</classname> surveille

un fichier du système de fichiers afin de regarder toute modification

de ces attributs. Elle appelle la commande <emphasis>stat()</emphasis>

sur ce chemin, à intervalle régulier (ou lorsque l'OS signale une modification)

et regarde s'il a été modifié depuis la dernière fois, et appelle la

fonction de rappel si c'est le cas.

</simpara>

<simpara>

Le chemin n'a pas besoin d'exister : la modification de "le chemin existe"

vers "le chemin n'existe pas est une modification de statut comme un autre.

La condition "le chemin n'existe pas" est signifiée par la valeur 0 de

l'élément <literal>'nlink'</literal> (retourné par la méthode

<methodname>EvStat::attr</methodname>).

</simpara>

<simpara>

Le chemin ne doit pas se terminer par un slash, ou contenir des composants

spéciaux comme <literal>'.'</literal> ou <literal>..</literal>.

Le chemin doit être absolu : s'il est relatif, et que le dossier de travail

change, alors le comportement sera indéfini.

</simpara>

<simpara>

Sachant qu'il n'y a pas d'interface de notification de changement portable,

l'implémentation portable appelle simplement la commande

<emphasis>stat()</emphasis> sur le chemin pour vérifier les modifications.

Pour ce cas, un intervalle régulier peut être spécifié. S'il est spécifié,

un intervalle de <literal>0.0 </literal> (vivement recommandé) alors

une valeur par défaut non spécifiée sera utilisée (aux alentours de 5 secondes,

et peut être modifiée dynamiquement). <emphasis>libev</emphasis>

va également imposer un intervalle minimum qui est actuellement aux alentours

de <literal>0.1</literal>, ce qui est largement suffisant.

</simpara>

<simpara>

Ce type de watcher n'est pas prévu pour un nombre important de watchers

<classname>EvStat</classname>, sachant que même avec les notifications

systèmes sur les modifications supportées par l'OS, ceci prend beaucoup

de ressources.

</simpara>

</section>

<section xml:id="evstat.synopsis">

&reftitle.classsynopsis;

<classsynopsis>

<ooclass>

<classname>EvStat</classname>

</ooclass>

<classsynopsisinfo>

<ooclass>

<classname>EvStat</classname>

</ooclass>

<ooclass>

<modifier>extends</modifier>

<classname>EvWatcher</classname>

</ooclass>

</classsynopsisinfo>

<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>

<fieldsynopsis>

<modifier>public</modifier>

<varname linkend="evstat.props.path">path</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<varname linkend="evstat.props.interval">interval</varname>

</fieldsynopsis>

<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('evwatcher.synopsis')/descendant::db:fieldsynopsis)"/>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evstat')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"/>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evstat')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>

<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evwatcher')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])"/>

</classsynopsis>

</section>

<section xml:id="evstat.props">

&reftitle.properties;

<variablelist>

<varlistentry xml:id="evstat.props.interval">

<term>

<varname>interval</varname>

</term>

<listitem>

<simpara>

<emphasis>Lecture seule</emphasis>. La rapidité avec laquelle

une modification doit être détectée ; normalement, doit valoir

<literal>0.0</literal> pour laisser <emphasis>libev</emphasis>

choisir une bonne valeur.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="evstat.props.path">

<term>

<varname>path</varname>

</term>

<listitem>

<simpara>

<emphasis>Lecture seule</emphasis>. Le chemin vers le fichier

dont on souhaite surveiller les modifications de statut.

</simpara>

</listitem>

</varlistentry>

</variablelist>

</section>

</partintro>

&reference.ev.entities.evstat;

</reference>