<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.posix.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'fr',
  ),
  'this' => 
  array (
    0 => 'function.posix-getrlimit.php',
    1 => 'posix_getrlimit',
    2 => 'Retourne des informations concernant les limites des ressources syst&egrave;me',
  ),
  'up' => 
  array (
    0 => 'ref.posix.php',
    1 => 'Fonctions POSIX',
  ),
  'prev' => 
  array (
    0 => 'function.posix-getpwuid.php',
    1 => 'posix_getpwuid',
  ),
  'next' => 
  array (
    0 => 'function.posix-getsid.php',
    1 => 'posix_getsid',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    'path' => 'reference/posix/functions/posix-getrlimit.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.posix-getrlimit" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">posix_getrlimit</h1>
  <p class="verinfo">(PHP 4, PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">posix_getrlimit</span> &mdash; <span class="dc-title">Retourne des informations concernant les limites des ressources système</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.posix-getrlimit-description">
  <h3 class="title">Description</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>posix_getrlimit</strong></span>(<span class="methodparam"><span class="type"><span class="type"><a href="language.types.null.php" class="type null">?</a></span><span class="type"><a href="language.types.integer.php" class="type int">int</a></span></span> <code class="parameter">$resource</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>): <span class="type"><span class="type"><a href="language.types.array.php" class="type array">array</a></span>|<span class="type"><a href="language.types.singleton.php" class="type false">false</a></span></span></div>

  <p class="para rdfs-comment">
   <span class="function"><strong>posix_getrlimit()</strong></span> retourne un <a href="language.types.array.php" class="link">tableau</a> d&#039;informations
   concernant les limites soft et hard de la ressource courante.
  </p>
  
<p class="para">
Chaque ressource a une limite soft et hard d&#039;associées. La limite
soft correspond à la valeur que le noyau force pour la ressource
correspondante. La limite hard agit comme un plafond de la limite soft.
Un processus non privilégié ne peut que définir sa limite soft en une
valeur comprise entre 0 et la limite hard, ce qui ne fera qu&#039;abaisser
sa limite hard.
</p>

 </div>


 <div class="refsect1 parameters" id="refsect1-function.posix-getrlimit-parameters">
  <h3 class="title">Liste de paramètres</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">resource</code></dt>
     <dd>
      <p class="para">
       Si <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>, toutes les limites de ressources actuelles seront renvoyées.
       Sinon, indiquer la
       <a href="posix.constants.setrlimit.php" class="link">constante de limite de ressource</a>
       afin de récupérer une limite spécifique.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.posix-getrlimit-returnvalues">
  <h3 class="title">Valeurs de retour</h3>
  <p class="para">
   Retourne un <a href="language.types.array.php" class="link">tableau</a> associatif d&#039;éléments pour chaque limite définie.
   Chaque limite a une limite soft et hard.
   <table class="doctable table">
    <caption><strong>Liste des limites possibles retournées</strong></caption>
    
     <thead>
      <tr>
       <th>Nom de la limite</th>
       <th>Description de la limite</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>core</td>
       <td>
        La taille maximale du cœur du fichier. Lorsqu&#039;elle vaut 0,
        aucun cœur de fichier n&#039;est créé. Lorsque le cœur des fichiers
        est plus grand que sa taille, il sera tronqué à cette taille.
       </td>
      </tr>

      <tr>
       <td>totalmem</td>
       <td>
        La taille maximale de la mémoire du processus, en octets.
       </td>
      </tr>

      <tr>
       <td>virtualmem</td>
       <td>
        La taille maximale de la mémoire virtuelle du processus, en octets.
       </td>
      </tr>

      <tr>
       <td>data</td>
       <td>
        La taille maximale du segment de données pour le processus, en octets.
       </td>
      </tr>

      <tr>
       <td>stack</td>
       <td>
        La taille maximale de la pile du processus, en octets.
       </td>
      </tr>

      <tr>
       <td>rss</td>
       <td>
        Le nombre maximal de pages virtuelles résident en RAM.
       </td>
      </tr>

      <tr>
       <td>maxproc</td>
       <td>
        Le nombre maximal de processus qui peuvent être créés pour l&#039;ID
        utilisateur réel du processus appelé.
       </td>
      </tr>

      <tr>
       <td>memlock</td>
       <td>
        Le nombre maximal d&#039;octets de mémoires pouvant être verrouillés en RAM.
       </td>
      </tr>

      <tr>
       <td>cpu</td>
       <td>
        Le temps que le processus est autorisé à utiliser le CPU.
       </td>
      </tr>

      <tr>
       <td>filesize</td>
       <td>
        La taille maximale du segment de données pour le processus, en octets.
       </td>
      </tr>

      <tr>
       <td>openfiles</td>
       <td>
        le nombre maximal de pointeurs de fichiers ouverts.
       </td>
      </tr>

     </tbody>
    
   </table>

   La fonction retourne <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> en cas d&#039;échec.
  </p>
  </div>


  <div class="refsect1 changelog" id="refsect1-function.posix-getrlimit-changelog">
  <h3 class="title">Historique</h3>
  <table class="doctable informaltable">
    
      <thead>
        <tr>
          <th>Version</th>
          <th>Description</th>
        </tr>

      </thead>

      <tbody class="tbody">
        <tr>
          <td>8.3.0</td>
          <td>
            Le paramètre facultatif <code class="parameter">resource</code> a été ajouté.
          </td>
        </tr>

      </tbody>
    
  </table>

</div>


 <div class="refsect1 examples" id="refsect1-function.posix-getrlimit-examples">
  <h3 class="title">Exemples</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Exemple #1 Exemple avec <span class="function"><strong>posix_getrlimit()</strong></span></strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$limits </span><span style="color: #007700">= </span><span style="color: #0000BB">posix_getrlimit</span><span style="color: #007700">();<br /><br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$limits</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>Résultat de l&#039;exemple ci-dessus est similaire à :</p></div>
    <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">Array
(
    [soft core] =&gt; 0
    [hard core] =&gt; unlimited
    [soft data] =&gt; unlimited
    [hard data] =&gt; unlimited
    [soft stack] =&gt; 8388608
    [hard stack] =&gt; unlimited
    [soft totalmem] =&gt; unlimited
    [hard totalmem] =&gt; unlimited
    [soft rss] =&gt; unlimited
    [hard rss] =&gt; unlimited
    [soft maxproc] =&gt; unlimited
    [hard maxproc] =&gt; unlimited
    [soft memlock] =&gt; unlimited
    [hard memlock] =&gt; unlimited
    [soft cpu] =&gt; unlimited
    [hard cpu] =&gt; unlimited
    [soft filesize] =&gt; unlimited
    [hard filesize] =&gt; unlimited
    [soft openfiles] =&gt; 1024
    [hard openfiles] =&gt; 1024
)</pre>
</div>
    </div>
   </div>
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.posix-getrlimit-seealso">
  <h3 class="title">Voir aussi</h3>
  <p class="para">
   <ul class="simplelist">
    <li>man page GETRLIMIT(2)</li>
    <li><span class="function"><a href="function.posix-setrlimit.php" class="function" rel="rdfs-seeAlso">posix_setrlimit()</a> - D&eacute;finit les limites pour une ressource syst&egrave;me</span></li>
   </ul>
  </p>
 </div>


</div><?php manual_footer($setup); ?>