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

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

 <variablelist>
  <title>
   Доступные значения флагов для параметра <parameter>flags</parameter>
   функции <function>openlog</function>
  </title>

  <varlistentry xml:id="constant.log-cons">
   <term>
    <constant>LOG_CONS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Записать сообщение в системную консоль,
     если при отправке данных в системное средство журналирования возникла ошибка.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-ndelay">
   <term>
    <constant>LOG_NDELAY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Открыть соединение со средством журналирования немедленно.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-odelay">
   <term>
    <constant>LOG_ODELAY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Отложить открытие соединения, пока не запишется первое сообщение.
     Это поведение по умолчанию.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-nowait">
   <term>
    <constant>LOG_NOWAIT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-perror">
   <term>
    <constant>LOG_PERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Дополнительно записывать сообщения в стандартный вывод ошибок <constant>STDERR</constant>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-pid">
   <term>
    <constant>LOG_PID</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Добавлять в каждое сообщение журнала PID-идентификатор процесса.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>
   Available <parameter>facility</parameter> for
   <function>openlog</function>
  </title>

  <varlistentry xml:id="constant.log-auth">
   <term>
    <constant>LOG_AUTH</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Сообщения безопасности и авторизации.
    </simpara>
    <note>
     <simpara>
      Вместо этого флага указывают флаг <constant>LOG_AUTHPRIV</constant>, если доступен.
     </simpara>
    </note>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-authpriv">
   <term>
    <constant>LOG_AUTHPRIV</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Закрытые сообщения безопасности и авторизации.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-cron">
   <term>
    <constant>LOG_CRON</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Сообщения демонов планировщика событий
     наподобие <command>cron</command> или <command>at</command>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-daemon">
   <term>
    <constant>LOG_DAEMON</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Сообщения системных демонов.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-kern">
   <term>
    <constant>LOG_KERN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Сообщения ядра системы.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-local0">
   <term>
    <constant>LOG_LOCAL0</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Флаг зарезервировали для внутренних целей.
    </simpara>
    <warning>
     <simpara>
      Константа недоступна в ОС Windows.
     </simpara>
    </warning>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-local1">
   <term>
    <constant>LOG_LOCAL1</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Флаг зарезервировали для внутренних целей.
    </simpara>
    <warning>
     <simpara>
      Константа недоступна в ОС Windows.
     </simpara>
    </warning>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-local2">
   <term>
    <constant>LOG_LOCAL2</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Флаг зарезервировали для внутренних целей.
    </simpara>
    <warning>
     <simpara>
      Константа недоступна в ОС Windows.
     </simpara>
    </warning>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-local3">
   <term>
    <constant>LOG_LOCAL3</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Флаг зарезервировали для внутренних целей.
    </simpara>
    <warning>
     <simpara>
      Константа недоступна в ОС Windows.
     </simpara>
    </warning>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-local4">
   <term>
    <constant>LOG_LOCAL4</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Флаг зарезервировали для внутренних целей.
    </simpara>
    <warning>
     <simpara>
      Константа недоступна в ОС Windows.
     </simpara>
    </warning>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-local5">
   <term>
    <constant>LOG_LOCAL5</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Флаг зарезервировали для внутренних целей.
    </simpara>
    <warning>
     <simpara>
      Константа недоступна в ОС Windows.
     </simpara>
    </warning>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-local6">
   <term>
    <constant>LOG_LOCAL6</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Флаг зарезервировали для внутренних целей.
    </simpara>
    <warning>
     <simpara>
      Константа недоступна в ОС Windows.
     </simpara>
    </warning>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-local7">
   <term>
    <constant>LOG_LOCAL7</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Флаг зарезервировали для внутренних целей.
    </simpara>
    <warning>
     <simpara>
      Константа недоступна в ОС Windows.
     </simpara>
    </warning>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-lpr">
   <term>
    <constant>LOG_LPR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Сообщения подсистемы построчной печати.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-mail">
   <term>
    <constant>LOG_MAIL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Сообщения почтовой подсистемы.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-news">
   <term>
    <constant>LOG_NEWS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Сообщения подсистемы новостей USENET.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-syslog">
   <term>
    <constant>LOG_SYSLOG</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Сообщения, которые внутренне сгенерировал системный демон <command>syslogd</command>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-user">
   <term>
    <constant>LOG_USER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Общие пользовательские сообщения.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-uucp">
   <term>
    <constant>LOG_UUCP</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Сообщения подсистемы UUCP.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>
   Доступные флаги приоритета для параметра <parameter>priority</parameter>
   функции <function>syslog</function>
  </title>

  <simpara>
   Константы приоритета перечисляются от срочных до отладочных сообщений.
  </simpara>

  <varlistentry xml:id="constant.log-emerg">
   <term>
    <constant>LOG_EMERG</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возникла аварийная ситуация, система непригодна для работы.
     Это соответствует состоянию паники.
     Обычно транслируется всем процессам.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-alert">
   <term>
    <constant>LOG_ALERT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Тревога, требуются немедленные действия. Например, при повреждении системной базы данных.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-crit">
   <term>
    <constant>LOG_CRIT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Критическая ситуация, требуется действие.
     Например, ошибки оборудования.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-err">
   <term>
    <constant>LOG_ERR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Сообщения об ошибках.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-warning">
   <term>
    <constant>LOG_WARNING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Сообщения с предупреждением.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-notice">
   <term>
    <constant>LOG_NOTICE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Сообщения с уведомлением, соответствуют состояниям, которые не относятся к состояниям об ошибке,
     но требуют отдельной обработки.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-info">
   <term>
    <constant>LOG_INFO</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Информационные сообщения.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.log-debug">
   <term>
    <constant>LOG_DEBUG</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Отладочные сообщения с информацией, которую обычно получают только
     при отладке программы.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>
   Доступные типы ресурсных записей для параметра <parameter>type</parameter>
   функции <function>dns_get_record</function>
  </title>


  <varlistentry xml:id="constant.dns-any">
   <term>
    <constant>DNS_ANY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Ресурсная запись произвольного типа.
     В большей части систем с этим флагом функция возвращает все ресурсные записи,
     но точный результат не гарантируется и зависит от результата работы библиотеки <literal>libresolv</literal>
     на конкретной платформе.
    </simpara>
    <simpara>
     Более медленный тип <constant>DNS_ALL</constant> собирает записи обо всех ресурсных записях надёжнее.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.dns-all">
   <term>
    <constant>DNS_ALL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Итеративно опрашивает сервер имён по каждому доступному типу записи.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.dns-a">
   <term>
    <constant>DNS_A</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Ресурсная запись IPv4-адреса.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.dns-aaaa">
   <term>
    <constant>DNS_AAAA</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Ресурсная запись IPv6-адреса.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.dns-a6">
   <term>
    <constant>DNS_A6</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Тип определили как часть раннего протокола IPv6, но стандарт
     <link xlink:href="&url.rfc;6563">RFC 6563</link> понизил тип до исторического.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.dns-caa">
   <term>
    <constant>DNS_CAA</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Ресурсная запись авторизации центра сертификации (англ. Certification Authority Authorization).
     Константа доступна с PHP 7.0.16 и 7.1.2.
    </simpara>
    <warning>
     <simpara>
      Константа недоступна в ОС Windows.
     </simpara>
    </warning>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.dns-cname">
   <term>
    <constant>DNS_CNAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Ресурсная запись псевдонима, канонического имени (англ. Canonical Name).
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.dns-hinfo">
   <term>
    <constant>DNS_HINFO</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Ресурсная запись с информацией о хосте (англ. Host Info). Эти значения объясняет страница
     с названиями операционных систем на сайте администрации адресного интернет-пространства IANA
     <link xlink:href="&url.iana.system-names;">Operating System Names</link>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.dns-mx">
   <term>
    <constant>DNS_MX</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Ресурсная запись почтового обменника (англ. Mail Exchanger).
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.dns-naptr">
   <term>
    <constant>DNS_NAPTR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Указатель на авторитетный источник именования (англ. Naming Authority Pointer).
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.dns-ns">
   <term>
    <constant>DNS_NS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Ресурсная запись авторитетного сервера имён (англ. Authoritative Name Server).
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.dns-ptr">
   <term>
    <constant>DNS_PTR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Ресурсная запись указателя (англ. Pointer Resource).
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.dns-soa">
   <term>
    <constant>DNS_SOA</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Ресурсная запись начала зоны (англ. Start of Authority).
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.dns-srv">
   <term>
    <constant>DNS_SRV</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Ресурсная запись локатора служб (англ. Service locator).
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.dns-txt">
   <term>
    <constant>DNS_TXT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Текстовая ресурсная запись.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

</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
-->