archived-doc-ru/reference/eio/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4e53894013ec0d223e2723ece46447ba00d5baf5 Maintainer: malferov Status: ready -->
<!-- Reviewed: no -->
<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="eio.constants">
 &reftitle.constants;
 &extension.constants;

 <para>Константы приоритета запроса:
  <variablelist>
<!--{{{ EIO_PRI_* -->
   <varlistentry xml:id="constant.eio-pri-min">
    <term>
     <constant>EIO_PRI_MIN</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Минимальный приоритет запроса.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-pri-default">
    <term>
     <constant>EIO_PRI_DEFAULT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Приоритет по умолчанию для запроса.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-pri-max">
    <term>
     <constant>EIO_PRI_MAX</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Максимальный приоритет запроса.
     </simpara>
    </listitem>
   </varlistentry>
   <!--}}}-->
  </variablelist>
 </para>

 <para>Аргумент параметра <parameter>whence</parameter> функции <function>eio_seek</function>:
  <variablelist>
   <varlistentry xml:id="constant.eio-seek-set">
    <term>
     <constant>EIO_SEEK_SET</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Смещение <parameter>offset</parameter> устанавливается в положение, равное заданному количеству байтов от начала файла.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-seek-cur">
    <term>
     <constant>EIO_SEEK_CUR</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Смещение устанавливается в положение, равное сумме байтов текущего
      положения смещения и количеству байтов в параметре <parameter>offset</parameter> от начала файла.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-seek-end">
    <term>
     <constant>EIO_SEEK_END</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Смещение устанавливается за пределы конца файла в положение, равное количеству байтов параметра <parameter>offset</parameter>.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </para>

 <para>
  Флаги, с которыми работает функция <function>eio_readdir</function>:
  <variablelist>

<!--{{{ EIO_READDIR_* -->
   <varlistentry xml:id="constant.eio-readdir-dents">
    <term>
     <constant>EIO_READDIR_DENTS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Флаг функции <function>eio_readdir</function>. При установке флага аргумент с результатом вызова callback-функции
      становится массивом со следующими ключами:
      <literal>'names'</literal> — массив имён каталогов
      элемента <literal>'dents'</literal> — массива массивов, которые подобны структуре языка C
      <literal>struct eio_dirent</literal> со следующими ключами для каждого:
      <literal>'name'</literal> — название каталога;
      <literal>'type'</literal> — константа семейства <emphasis>EIO_DT_*</emphasis>;
      <literal>'inode'</literal> — номер индексного дескриптора, если доступен,
      иначе не указывается;
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-readdir-dirs-first">
    <term>
     <constant>EIO_READDIR_DIRS_FIRST</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      При установке флага имена вернутся в том порядке,
      в котором вероятные каталоги идут первыми, в оптимальном статистическом порядке.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-readdir-stat-order">
    <term>
     <constant>EIO_READDIR_STAT_ORDER</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      При установке флага имена вернутся в порядке,
      который оптимален для получения информации о каждом из имён через <literal>stat</literal>-функцию.
      Порядок, который вернёт флаг, скорее всего, будет самым быстрым,
      если планируется вызов функции <function>stat</function> на каждом файле заданного каталога.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-readdir-found-unknown">
    <term>
     <constant>EIO_READDIR_FOUND_UNKNOWN</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>

     </simpara>
    </listitem>
   </varlistentry>
<!--}}}-->

<!--{{{ EIO_DT_* -->
   <varlistentry xml:id="constant.eio-dt-unknown">
    <term>
     <constant>EIO_DT_UNKNOWN</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Неизвестный тип узла каталога. Файловые системы часто возвращают этот тип.
      Чтобы получить тип узла, требуется дополнительный вызов функции <function>stat</function>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-fifo">
    <term>
     <constant>EIO_DT_FIFO</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Тип узла — FIFO.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-chr">
    <term>
     <constant>EIO_DT_CHR</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Тип узла.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-mpc">
    <term>
     <constant>EIO_DT_MPC</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Тип узла — мультиплексное символьное устройство, которое работает в связке
      файловой системы V7 и операционной системы Coherent.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-dir">
    <term>
     <constant>EIO_DT_DIR</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Тип узла — каталог.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-nam">
    <term>
     <constant>EIO_DT_NAM</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     Тип узла — специальный именованный файл ОС Xenix.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-blk">
    <term>
     <constant>EIO_DT_BLK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Тип узла.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-mpb">
    <term>
     <constant>EIO_DT_MPB</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Тип узла — мультиплексное блочное устройство, которое работает в связке
      файловой системы V7 и операционной системы Coherent.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-reg">
    <term>
     <constant>EIO_DT_REG</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Тип узла.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-nwk">
    <term>
     <constant>EIO_DT_NWK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-cmp">
    <term>
     <constant>EIO_DT_CMP</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Специальный сетевой тип узла операционной системы HP-UX.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-lnk">
    <term>
     <constant>EIO_DT_LNK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Тип узла — ссылка.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-sock">
    <term>
     <constant>EIO_DT_SOCK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Тип узла — сокет.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-door">
    <term>
     <constant>EIO_DT_DOOR</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Тип узла — Solaris Door.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-wht">
    <term>
     <constant>EIO_DT_WHT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Тип узла.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-dt-max">
    <term>
     <constant>EIO_DT_MAX</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Наибольшее значение типа узла.
     </simpara>
    </listitem>
   </varlistentry>

<!--}}}-->

  </variablelist>
 </para>
 <para>
  Режимы доступа для аргумента параметра <parameter>flags</parameter>
  функции <function>eio_open</function>:
  <variablelist>

<!--{{{ EIO_O_*-->
   <varlistentry xml:id="constant.eio-o-rdonly">
    <term>
     <constant>EIO_O_RDONLY</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-o-wronly">
    <term>
     <constant>EIO_O_WRONLY</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-o-rdwr">
    <term>
     <constant>EIO_O_RDWR</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-o-nonblock">
    <term>
     <constant>EIO_O_NONBLOCK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-o-append">
    <term>
     <constant>EIO_O_APPEND</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-o-creat">
    <term>
     <constant>EIO_O_CREAT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-o-trunc">
    <term>
     <constant>EIO_O_TRUNC</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-o-excl">
    <term>
     <constant>EIO_O_EXCL</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-o-fsync">
    <term>
     <constant>EIO_O_FSYNC</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
<!--}}}-->

  </variablelist>
 </para>
 <para>
  Флаги аргументов параметра <parameter>mode</parameter> функции <function>eio_open</function>:
  <variablelist>

<!--{{{ EIO_S_I*-->
   <varlistentry xml:id="constant.eio-s-irusr">
    <term>
     <constant>EIO_S_IRUSR</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-s-iwusr">
    <term>
     <constant>EIO_S_IWUSR</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-s-ixusr">
    <term>
     <constant>EIO_S_IXUSR</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-s-irgrp">
    <term>
     <constant>EIO_S_IRGRP</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-s-iwgrp">
    <term>
     <constant>EIO_S_IWGRP</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-s-ixgrp">
    <term>
     <constant>EIO_S_IXGRP</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-s-iroth">
    <term>
     <constant>EIO_S_IROTH</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-s-iwoth">
    <term>
     <constant>EIO_S_IWOTH</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-s-ixoth">
    <term>
     <constant>EIO_S_IXOTH</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-s-ifreg">
    <term>
     <constant>EIO_S_IFREG</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-s-ifchr">
    <term>
     <constant>EIO_S_IFCHR</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-s-ifblk">
    <term>
     <constant>EIO_S_IFBLK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-s-ififo">
    <term>
     <constant>EIO_S_IFIFO</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-s-ifsock">
    <term>
     <constant>EIO_S_IFSOCK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
<!--}}}-->


  </variablelist>
 </para>
 <para>
  Флаги функции <function>eio_sync_file_range</function>:
  <variablelist>

<!--{{{ EIO_SYNC_FILE_*-->
   <varlistentry xml:id="constant.eio-sync-file-range-wait-before">
    <term>
     <constant>EIO_SYNC_FILE_RANGE_WAIT_BEFORE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-sync-file-range-write">
    <term>
     <constant>EIO_SYNC_FILE_RANGE_WRITE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.eio-sync-file-range-wait-after">
    <term>
     <constant>EIO_SYNC_FILE_RANGE_WAIT_AFTER</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
<!--}}}-->


  </variablelist>
 </para>
 <para>
  Флаги функции <function>eio_fallocate</function>:
  <variablelist>

   <varlistentry xml:id="constant.eio-falloc-fl-keep-size">
    <term>
     <constant>EIO_FALLOC_FL_KEEP_SIZE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>

  </variablelist>
 </para>

 <note xmlns="http://docbook.org/ns/docbook">
  <simpara>
   У констант семейства <emphasis>EIO_S_I*</emphasis> те же значения, что и у их POSIX-аналогов —
   констант семейства <emphasis>S_I*</emphasis>.
  </simpara>
 </note>

 <note xmlns="http://docbook.org/ns/docbook">
  <simpara>
   У констант семейства <emphasis>EIO_SYNC_FILE_*</emphasis> те же значения, что и у их аналогов —
   констант семейства <emphasis>SYNC_FILE_**</emphasis>.
  </simpara>
 </note>

 <note xmlns="http://docbook.org/ns/docbook">
  <simpara>
   У констант семейства <emphasis>EIO_O_*</emphasis> те же значения, что и у их POSIX-аналогов —
   констант семейства <emphasis>O_*</emphasis>.
  </simpara>
 </note>
</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
-->