<?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 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'function.posix-getrlimit.php',
    1 => 'posix_getrlimit',
    2 => 'Retorna informa&ccedil;&otilde;es sobre limites de recursos do sistema',
  ),
  'up' => 
  array (
    0 => 'ref.posix.php',
    1 => 'Fun&ccedil;&otilde;es de 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' => 'pt_BR',
    '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">Retorna informações sobre limites de recursos do sistema</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.posix-getrlimit-description">
  <h3 class="title">Descrição</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> retorna um <span class="type"><a href="language.types.array.php" class="type array">array</a></span> de informações sobre os
   limites flexíveis e rígidos do recurso atual.
  </p>
  
<p class="para">
  Cada recurso tem um limite flexível e um limite rígido associado. O limite
  flexível é o valor que o kernel impõe ao recurso
  correspondente. O limite rígido funciona com um teto máximo para o limite flexível.
  Um processo sem privilégios pode apenas definir seu limite flexível para um valor
  entre 0 e o limite rígido e reduzir irreversivelmente seu limite rígido.
</p>

 </div>


 <div class="refsect1 parameters" id="refsect1-function.posix-getrlimit-parameters">
  <h3 class="title">Parâmetros</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">resource</code></dt>
     <dd>
      <p class="para">
       Se <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>, todos os limites de recursos atuais serão retornados.
       Caso contrário, especifique uma
       <a href="posix.constants.setrlimit.php" class="link">constante de limite de recurso</a>
       para obter um limite específico.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.posix-getrlimit-returnvalues">
  <h3 class="title">Valor Retornado</h3>
  <p class="para">
   Retorna um <span class="type"><a href="language.types.array.php" class="type array">array</a></span> associativo de elementos para cada
   limite definido. Cada limite tem um limite flexível (&quot;soft&quot;) e um limite rígido (&quot;hard&quot;).
   <table class="doctable table">
    <caption><strong>Lista de possíveis limites retornados</strong></caption>
    
     <thead>
      <tr>
       <th>Nome do limite</th>
       <th>Descrição do limite</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>core</td>
       <td>
        O tamanho máximo do arquivo de imagem de memória. Quando 0, não são criados arquivos
        de imagem de memória. Quando os arquivos de imagem forem maiores que esse tamanho, eles serão
        truncados nesse tamanho.
       </td>
      </tr>

      <tr>
       <td>totalmem</td>
       <td>
        O tamanho máximo da memória do processo, em bytes.
       </td>
      </tr>

      <tr>
       <td>virtualmem</td>
       <td>
        O tamanho máximo da memória virtual para o processo, em bytes.
       </td>
      </tr>

      <tr>
       <td>data</td>
       <td>
        O tamanho máximo do segmento de dados do processo, em bytes.
       </td>
      </tr>

      <tr>
       <td>stack</td>
       <td>
        O tamanho máximo da pilha de processos, em bytes.
       </td>
      </tr>

      <tr>
       <td>rss</td>
       <td>
        O número máximo de páginas virtuais residentes na RAM.
       </td>
      </tr>

      <tr>
       <td>maxproc</td>
       <td>
        O número máximo de processos que podem ser criados para o
        ID do usuário real do processo de chamada.
       </td>
      </tr>

      <tr>
       <td>memlock</td>
       <td>
        O número máximo de bytes de memória que podem ser bloqueados na RAM.
       </td>
      </tr>

      <tr>
       <td>cpu</td>
       <td>
        A quantidade de tempo que o processo pode usar a CPU.
       </td>
      </tr>

      <tr>
       <td>filesize</td>
       <td>
        O tamanho máximo do segmento de dados do processo, em bytes.
       </td>
      </tr>

      <tr>
       <td>openfiles</td>
       <td>
        Um a mais que o número máximo de descritores de arquivos abertos.
       </td>
      </tr>

     </tbody>
    
   </table>

   A função retorna <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> em caso de falha.
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.posix-getrlimit-changelog">
  <h3 class="title">Registro de Alterações</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Versão</th>
      <th>Descrição</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>8.3.0</td>
      <td>
       O parâmetro opcional <code class="parameter">resource</code> foi adicionado.
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 examples" id="refsect1-function.posix-getrlimit-examples">
  <h3 class="title">Exemplos</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Exemplo #1 Exemplo de uso de <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>O exemplo acima produzirá
algo semelhante a:</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">Veja Também</h3>
  <p class="para">
   <ul class="simplelist">
    <li>Página GETRLIMIT(2) do manual POSIX</li>
    <li><span class="function"><a href="function.posix-setrlimit.php" class="function" rel="rdfs-seeAlso">posix_setrlimit()</a> - Define limites de recursos do sistema</span></li>
   </ul>
  </p>
 </div>


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