<?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 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.posix-getrlimit.php',
    1 => 'posix_getrlimit',
    2 => 'Devuelve informaci&oacute;n sobre los l&iacute;mites de recursos del sistema',
  ),
  'up' => 
  array (
    0 => 'ref.posix.php',
    1 => 'Funciones 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' => 'es',
    '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">Devuelve información sobre los límites de recursos del sistema</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.posix-getrlimit-description">
  <h3 class="title">Descripción</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> devuelve un <span class="type"><a href="language.types.array.php" class="type array">array</a></span>
   con información sobre los límites actuales blandos y duros del recurso.
  </p>
  
 <p class="para">
 Cada recurso tiene un límite soft y hard asociados. El límite
 soft corresponde al valor que el núcleo fuerza para el recurso
 correspondiente. El límite hard actúa como un techo del límite soft.
 Un proceso no privilegiado solo puede definir su límite soft en un
 valor comprendido entre 0 y el límite hard, lo que solo hará bajar
 su límite hard.
 </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">
       Si es <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>, se devolverán todos los límites de recursos actuales.
       De lo contrario, especifique la
       <a href="posix.constants.setrlimit.php" class="link">constante de límite de recurso</a>
       para recuperar un límite específico.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.posix-getrlimit-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   Devuelve un <span class="type"><a href="language.types.array.php" class="type array">array</a></span> asociativo de elementos para cada
   límite que esté definido. Cada límite tiene un límite blando y uno duro.
   <table class="doctable table">
    <caption><strong>Lista de límites posibles devueltos</strong></caption>
    
     <thead>
      <tr>
       <th>Nombre del límite</th>
       <th>Descripción del límite</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>core</td>
       <td>
        El tamaño máximo del fichero de memoria. Cuando es 0, no se crean ficheros de memoria.
        Cuando los ficheros de memoria son más grandes que este tamaño, se truncarán a este tamaño.
       </td>
      </tr>

      <tr>
       <td>totalmem</td>
       <td>
        El tamaño máximo de la memoria del proceso, en bytes.
       </td>
      </tr>

      <tr>
       <td>virtualmem</td>
       <td>
        El tamaño máximo de la memoria virtual para el proceso, en bytes.
       </td>
      </tr>

      <tr>
       <td>data</td>
       <td>
        El tamaño máximo del segmento de datos para el proceso, en bytes.
       </td>
      </tr>

      <tr>
       <td>stack</td>
       <td>
        El tamaño máximo de la pila del proceso, en bytes.
       </td>
      </tr>

      <tr>
       <td>rss</td>
       <td>
        El número máximo de páginas virtuales residentes en RAM
       </td>
      </tr>

      <tr>
       <td>maxproc</td>
       <td>
        El número máximo de procesos que pueden ser creados para el
        ID de usuario real del proceso llamante.
       </td>
      </tr>

      <tr>
       <td>memlock</td>
       <td>
        El número máximo de bytes de memoria que pueden ser bloqueados en RAM.
       </td>
      </tr>

      <tr>
       <td>cpu</td>
       <td>
        La cantidad de tiempo que se permite al proceso usar la CPU.
       </td>
      </tr>

      <tr>
       <td>filesize</td>
       <td>
        El tamaño máximo del segmento de datos para el proceso, en bytes.
       </td>
      </tr>

      <tr>
       <td>openfiles</td>
       <td>
        Uno más que el número máximo de descriptores de fichero abiertos.
       </td>
      </tr>

     </tbody>
    
   </table>

   La función devuelve <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> en caso de error.
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.posix-getrlimit-changelog">
  <h3 class="title">Historial de cambios</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Versión</th>
      <th>Descripción</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>8.3.0</td>
      <td>
       Se ha añadido el parámetro opcional <code class="parameter">resource</code>.
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 examples" id="refsect1-function.posix-getrlimit-examples">
  <h3 class="title">Ejemplos</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Ejemplo #1 Ejemplo 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>Resultado del ejemplo anterior es similar 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">Ver también</h3>
  <p class="para">
   <ul class="simplelist">
    <li>página del manual GETRLIMIT(2)</li>
    <li><span class="function"><a href="function.posix-setrlimit.php" class="function" rel="rdfs-seeAlso">posix_setrlimit()</a> - Establecer los l&iacute;mites de recursos del sistema</span></li>
   </ul>
  </p>
 </div>


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