<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.xattr.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.xattr-list.php',
    1 => 'xattr_list',
    2 => 'Obtener una lista de atributos extendidos',
  ),
  'up' => 
  array (
    0 => 'ref.xattr.php',
    1 => 'Funciones de xattr',
  ),
  'prev' => 
  array (
    0 => 'function.xattr-get.php',
    1 => 'xattr_get',
  ),
  'next' => 
  array (
    0 => 'function.xattr-remove.php',
    1 => 'xattr_remove',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/xattr/functions/xattr-list.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.xattr-list" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">xattr_list</h1>
  <p class="verinfo">(PECL xattr &gt;= 0.9.0)</p><p class="refpurpose"><span class="refname">xattr_list</span> &mdash; <span class="dc-title">
   Obtener una lista de atributos extendidos
  </span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.xattr-list-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">function</span> <span class="methodname"><strong>xattr_list</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$filename</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$flags</code><span class="initializer"> = 0</span></span>): <span class="type"><a href="language.types.array.php" class="type array">array</a></span></div>

  <p class="para rdfs-comment">
   Esta función obtiene una lista de nombres de los atributos extendidos de un archivo.
  </p>
  <p class="simpara">Los atributos extendidos tienen dos espacios de nombres diferentes:
user y root. El espacio de nombres user está disponible para todos los usuarios, mientras que el espacio
de nombres root solo está disponible para usuarios con privilegios de root. xattr opera sobre el espacio
de nombres user por defecto, pero esto se puede cambiar con el parámetro
<code class="parameter">flags</code>.</p>
 </div>

 <div class="refsect1 parameters" id="refsect1-function.xattr-list-parameters">
  <h3 class="title">Parámetros</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">filename</code></dt>
     <dd>
      <p class="para">
       La ruta del archivo.
      </p>
     </dd>
    
    
     <dt><code class="parameter">flags</code></dt>
     <dd>
      <p class="para">
       <table class="doctable table">
        <caption><strong>Banderas xattr soportadas</strong></caption>
        
         <tbody class="tbody">
          <tr>
           <td><strong><code><a href="xattr.constants.php#constant.xattr-dontfollow">XATTR_DONTFOLLOW</a></code></strong></td>
           <td>No sigue el enlace simbólico pero se puede operar en este.</td>
          </tr>

          <tr>
           <td><strong><code><a href="xattr.constants.php#constant.xattr-root">XATTR_ROOT</a></code></strong></td>
           <td>
            Establece atributos en la raíz (segura) de espacio de nombres.
            Requiere privilegios de administrador.
           </td>
          </tr>

         </tbody>
        
       </table>

      </p>
     </dd>
    
   </dl>
  </p>
 </div>

 <div class="refsect1 returnvalues" id="refsect1-function.xattr-list-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   Esta función devuelve un array con los nombres de los atributos extendidos.
  </p>
 </div>

 <div class="refsect1 examples" id="refsect1-function.xattr-list-examples">
  <h3 class="title">Ejemplos</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Ejemplo #1 Imprime los nombres de todos los atributos extendidos del archivo</strong></p>
    <div class="example-contents">
<div class="phpcode"><pre><code style="color: #000000"><span style="color: #0000BB">&lt;?php
$file </span><span style="color: #007700">= </span><span style="color: #DD0000">'some_file'</span><span style="color: #007700">;
</span><span style="color: #0000BB">$root_attributes </span><span style="color: #007700">= </span><span style="color: #0000BB">xattr_list</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">, </span><span style="color: #0000BB">XATTR_ROOT</span><span style="color: #007700">);
</span><span style="color: #0000BB">$user_attributes </span><span style="color: #007700">= </span><span style="color: #0000BB">xattr_list</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">);

echo </span><span style="color: #DD0000">"Atributos Root: \n"</span><span style="color: #007700">;
foreach (</span><span style="color: #0000BB">$root_attributes </span><span style="color: #007700">as </span><span style="color: #0000BB">$attr_name</span><span style="color: #007700">) {
    </span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"%s\n"</span><span style="color: #007700">, </span><span style="color: #0000BB">$attr_name</span><span style="color: #007700">);
}

echo </span><span style="color: #DD0000">"\n Atributos usuario: \n"</span><span style="color: #007700">;
foreach (</span><span style="color: #0000BB">$user_attributes </span><span style="color: #007700">as </span><span style="color: #0000BB">$attr_name</span><span style="color: #007700">) {
    </span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"%s\n"</span><span style="color: #007700">, </span><span style="color: #0000BB">$attr_name</span><span style="color: #007700">);
}

</span><span style="color: #0000BB">?&gt;</span></code></pre></div>
    </div>

   </div>
  </p>
 </div>

 <div class="refsect1 seealso" id="refsect1-function.xattr-list-seealso">
  <h3 class="title">Véase también</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.xattr-get.php" class="function" rel="rdfs-seeAlso">xattr_get()</a> - Obtener un atributo extendido</span></li>
   </ul>
  </p>
 </div>

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