archived-doc-fr/reference/posix/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: be0867e6488a28518529f31e9684d61741ac7dad Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->

<appendix xml:id="posix.constants" xmlns="http://docbook.org/ns/docbook">
 &reftitle.constants;
 &extension.constants;
 <section xml:id="posix.constants.access">
  <title>Constantes <function>posix_access</function></title>
  <note>
   <para>
    Il est à noter que certaines de ces constantes peuvent ne pas être disponibles sur chaque système.
   </para>
  </note>
  <variablelist>
   <varlistentry xml:id="constant.posix-f-ok">
    <term>
     <constant>POSIX_F_OK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Vérifie si le fichier existe.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-r-ok">
    <term>
     <constant>POSIX_R_OK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Vérifie si le fichier existe et a les permissions de lecture.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-w-ok">
    <term>
     <constant>POSIX_W_OK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Vérifie si le fichier existe et a les permissions d'écriture.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-x-ok">
    <term>
     <constant>POSIX_X_OK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Vérifie si le fichier existe et a les permissions d'exécution.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </section>
 
 <section xml:id="posix.constants.mknod">
  <title>Constantes <function>posix_mknod</function></title>
  <note>
   <para>
    À noter que quelques unes d'entre elles peuvent ne pas être disponibles sur le système.
   </para>
  </note>
  <variablelist>
   <varlistentry xml:id="constant.posix-s-ifblk">
    <term>
     <constant>POSIX_S_IFBLK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Bloque les fichiers spéciaux
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-s-ifchr">
    <term>
     <constant>POSIX_S_IFCHR</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Caractère des fichiers spéciaux
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-s-ififo">
    <term>
     <constant>POSIX_S_IFIFO</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      FIFO (pipe nommé) des fichiers spéciaux
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-s-ifreg">
    <term>
     <constant>POSIX_S_IFREG</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Fichier normal
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-s-ifsock">
    <term>
     <constant>POSIX_S_IFSOCK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Socket
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </section>
 
 <section xml:id="posix.constants.setrlimit">
  <title>Constantes <function>posix_setrlimit</function></title>
  <note>
   <para>
    À noter que quelques unes d'entre elles peuvent ne pas être disponibles sur le système.
   </para>
  </note>
  <note>
   <para>
    Il est recommandé de lire les notes ci-dessous en plus du manuel utilisateur sur la
    fonction <function>setrlimit</function> du système spécifique, sachant
    qu'il peut y avoir une variation dans l'interprétation de ces limites, y
    compris entre plusieurs systèmes qui revendiquent appliquer POSIX dans
    sa globalité.
   </para>
  </note>
  <variablelist>
   <varlistentry xml:id="constant.posix-rlimit-as">
    <term>
     <constant>POSIX_RLIMIT_AS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      La taille maximale de l'espace d'adresse du processus, en octets. Voir aussi la
      directive de configuration PHP <link linkend="ini.memory-limit">memory_limit</link>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-core">
    <term>
     <constant>POSIX_RLIMIT_CORE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      La taille maximale d'un fichier cœur. Si la limite est définie à 0, aucun
      fichier cœur ne sera généré.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-cpu">
    <term>
     <constant>POSIX_RLIMIT_CPU</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      La quantité maximale de temps CPU que le processus peut utiliser,
      en secondes. Lorsque la limite soft est atteinte, un signal
      <constant>SIGXCPU</constant> sera émis, qui peut être intercepté avec
      la fonction <function>pcntl_signal</function>. Suivant les systèmes,
      des signaux <constant>SIGXCPU</constant> peuvent aussi être émis chaque
      seconde tant que la limite hard est atteinte, auquel cas, un signal
      <constant>SIGKILL</constant> non interceptable sera émis.
     </simpara>
     <simpara>
      Voir aussi la fonction <function>set_time_limit</function>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-data">
    <term>
     <constant>POSIX_RLIMIT_DATA</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      La taille maximale d'un segment de données du processus, en octets.
      Il est peu probable que cela ait un quelconque effet sur l'exécution
      de PHP tant qu'une extension est en cours d'utilisation et appelle
      la fonction <function>brk</function> ou <function>sbrk</function>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-fsize">
    <term>
     <constant>POSIX_RLIMIT_FSIZE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      La taille maximale des fichiers que le processus peut créer, en octets.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-locks">
    <term>
     <constant>POSIX_RLIMIT_LOCKS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Le nombre maximal de verrous que le processus peut créer. Ceci n'est supporté
      que sur de très vieux noyaux Linux.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-memlock">
    <term>
     <constant>POSIX_RLIMIT_MEMLOCK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Le nombre maximal d'octets qui peuvent être verrouillés en mémoire.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-msgqueue">
    <term>
     <constant>POSIX_RLIMIT_MSGQUEUE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Le nombre maximal d'octets qui peuvent être alloués pour la file
      d'attente des messages POSIX. PHP n'est pas fourni avec le support
      de la file d'attente des messages POSIX, aussi, cette limite
      n'aura aucun effet tant que l'on n'utilise pas une extension qui
      implémente ce support.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-nice">
    <term>
     <constant>POSIX_RLIMIT_NICE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      La valeur maximale à laquelle le processus peut être
      <link linkend="function.pcntl-setpriority">changé de priorité</link>.
      La valeur utilisée sera <literal>20 - limit</literal>, sachant que
      les valeurs limites de la ressource ne peuvent pas être négatives.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-nofile">
    <term>
     <constant>POSIX_RLIMIT_NOFILE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Une valeur supérieure au nombre maximal de descripteurs de fichier
      qui peut être ouvert par ce processus.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-nproc">
    <term>
     <constant>POSIX_RLIMIT_NPROC</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Le nombre maximal de processus (et/ou de threads, suivant le système)
      qui peuvent être créés pour l'ID utilisateur réel du processus.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-rss">
    <term>
     <constant>POSIX_RLIMIT_RSS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      La taille maximale du jeu résident du processus, en pages.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-rtprio">
    <term>
     <constant>POSIX_RLIMIT_RTPRIO</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      La priorité maximale temps réel qui peut être défini via les
      appels systèmes
      <function>sched_setscheduler</function> et
      <function>sched_setparam</function>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-rttime">
    <term>
     <constant>POSIX_RLIMIT_RTTIME</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      La quantité maximale de temps CPU, en microsecondes, que le processus
      peut consommer sans faire un appel système bloquant s'il utilise
      l'horloge de temps réel.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-sigpending">
    <term>
     <constant>POSIX_RLIMIT_SIGPENDING</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Le nombre maximal de signaux qui peuvent être mis en file d'attente
      pour l'ID utilisateur réel du processus.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-stack">
    <term>
     <constant>POSIX_RLIMIT_STACK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      La taille maximale de la pile du processus, en octets.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-infinity">
    <term>
     <constant>POSIX_RLIMIT_INFINITY</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Utilisé pour indiquer une valeur infinie pour une limite de ressource.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-kqueues">
    <term>
     <constant>POSIX_RLIMIT_KQUEUES</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Le nombre maximum de kqueues que cet id utilisateur est autorisé à créer (FreeBSD).
      Disponible à partir de PHP 8.1.0.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.posix-rlimit-npts">
    <term>
     <constant>POSIX_RLIMIT_NPTS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Le nombre maximum de pseudo-terminaux que cet id utilisateur est autorisé à créer (FreeBSD).
      Disponible à partir de PHP 8.1.0.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </section>
 <section xml:id="posix.constants.pathconf">
  <title>Constantes de <function>posix_pathconf</function></title>
  <variablelist>
    <varlistentry xml:id="constant.posix-pc-link-max">
      <term>
        <constant>POSIX_PC_LINK_MAX</constant>
        (<type>int</type>)
      </term>
      <listitem>
        <simpara>
          Le nombre maximum de liens qu'un fichier ou un répertoire donné peut avoir.
          Disponible à partir de PHP 8.3.0.
        </simpara>
      </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-pc-max-canon">
      <term>
        <constant>POSIX_PC_MAX_CANON</constant>
        (<type>int</type>)
      </term>
      <listitem>
        <simpara>
          Le nombre maximum d'octets dans un tampon d'entrée canonique de terminal
          (le chemin étant alors un fichier spécial de caractères).
          Disponible à partir de PHP 8.3.0.
        </simpara>
      </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-pc-max-input">
      <term>
        <constant>POSIX_PC_MAX_INPUT</constant>
        (<type>int</type>)
      </term>
      <listitem>
        <simpara>
          Le nombre maximum d'octets dans une file d'attente d'entrée de terminal
          (le chemin étant alors un fichier spécial de caractères).
          Disponible à partir de PHP 8.3.0.
        </simpara>
      </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-pc-name-max">
      <term>
        <constant>POSIX_PC_NAME_MAX</constant>
        (<type>int</type>)
      </term>
      <listitem>
        <simpara>
          Le nombre maximum de caractères pour un nom de fichier seul, sans son chemin.
          Disponible à partir de PHP 8.3.0.
        </simpara>
      </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-pc-path-max">
      <term>
        <constant>POSIX_PC_PATH_MAX</constant>
        (<type>int</type>)
      </term>
      <listitem>
        <simpara>
          Le nombre maximum de caractères pour un chemin complet.
          Disponible à partir de PHP 8.3.0.
        </simpara>
      </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-pc-pipe-buf">
      <term>
        <constant>POSIX_PC_PIPE_BUF</constant>
        (<type>int</type>)
      </term>
      <listitem>
        <simpara>
          Le nombre maximum d'octets pouvant être écrits dans un tube en une seule opération.
          Disponible à partir de PHP 8.3.0.
        </simpara>
      </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-pc-chown-restricted">
      <term>
        <constant>POSIX_PC_CHOWN_RESTRICTED</constant>
        (<type>int</type>)
      </term>
      <listitem>
        <simpara>
          Si des privilèges sont nécessaires pour autoriser <function>chown</function> à fonctionner.
          Disponible à partir de PHP 8.3.0.
        </simpara>
      </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-pc-no-trunc">
      <term>
        <constant>POSIX_PC_NO_TRUNC</constant>
        (<type>int</type>)
      </term>
      <listitem>
        <simpara>
          Si un nom de fichier (ou des fichiers sous un répertoire) est plus long que <constant>POSIX_PC_NAME_MAX</constant>.
          Disponible à partir de PHP 8.3.0.
        </simpara>
      </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-pc-alloc-size-min">
      <term>
        <constant>POSIX_PC_ALLOC_SIZE_MIN</constant>
        (<type>int</type>)
      </term>
      <listitem>
        <simpara>
          Le nombre minimum d'octets de stockage alloués pour toute partie d'un fichier.
          Disponible à partir de PHP 8.3.0.
        </simpara>
      </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-pc-alloc-symlink-max">
      <term>
        <constant>POSIX_PC_ALLOC_SYMLINK_MAX</constant>
        (<type>int</type>)
      </term>
      <listitem>
        <simpara>
          Le nombre maximum de liens symboliques qu'un fichier ou un répertoire donné peut avoir.
          Disponible à partir de PHP 8.3.0.
        </simpara>
      </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-pc-symlink-max">
     <term>
      <constant>POSIX_PC_SYMLINK_MAX</constant>
      (<type>int</type>)
     </term>
     <listitem>
      <simpara>
       Le nombre maximal d'octets dans un lien symbolique.
       Disponible à partir de PHP 8.3.0.
      </simpara>
     </listitem>
    </varlistentry>
  </variablelist>
</section>

<section xml:id="posix.constants.sysconf">
  <title>Constantes de <function>posix_sysconf</function></title>
  <variablelist>
    <varlistentry xml:id="constant.posix-sc-arg-max">
      <term>
        <constant>POSIX_SC_ARG_MAX</constant>
        (<type>int</type>)
      </term>
      <listitem>
        <simpara>
          Le nombre maximum d'octets que peuvent avoir les arguments (et les variables d'environnement).
          Disponible à partir de PHP 8.3.0.
        </simpara>
      </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-sc-pagesize">
      <term>
        <constant>POSIX_SC_PAGESIZE</constant>
        (<type>int</type>)
      </term>
      <listitem>
        <simpara>
          Le nombre d'octets de la page actuelle.
          Disponible à partir de PHP 8.3.0.
        </simpara>
      </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-sc-nprocessors-conf">
      <term>
        <constant>POSIX_SC_NPROCESSORS_CONF</constant>
        (<type>int</type>)
      </term>
      <listitem>
        <simpara>
          Le nombre de processeurs configurés dans l'ensemble du système.
          Disponible à partir de PHP 8.3.0.
        </simpara>
      </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-sc-nprocessors-onln">
      <term>
        <constant>POSIX_SC_NPROCESSORS_ONLN</constant>
        (<type>int</type>)
      </term>
      <listitem>
        <simpara>
          Le nombre de processeurs actuellement actifs dans l'ensemble du système.
          Disponible à partir de PHP 8.3.0.
        </simpara>
      </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-sc-child-max">
     <term>
      <constant>POSIX_SC_CHILD_MAX</constant>
      (<type>int</type>)
     </term>
     <listitem>
      <simpara>
       Le nombre maximal de processus simultanés par utilisateur.
       Disponible à partir de PHP 8.4.0.
      </simpara>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="constant.posix-sc-clk-tck">
     <term>
      <constant>POSIX_SC_CLK_TCK</constant>
      (<type>int</type>)
     </term>
     <listitem>
      <simpara>
       Le nombre de ticks d’horloge par seconde.
      Disponible à partir de PHP 8.4.0.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </section>
</appendix>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->