Files
php-doc-ru/reference/info/functions/getrusage.xml
2023-07-17 18:53:16 +03:00

182 lines
6.8 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e947f2e12b1e321d67f6560c5f2884e6d885858f Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.getrusage" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>getrusage</refname>
<refpurpose>
Получает информацию об использовании текущего ресурса
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>array</type><type>false</type></type><methodname>getrusage</methodname>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
Это интерфейс к <command>getrusage(2)</command>. Функция получает данные,
возвращаемые из системного вызова.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
Если аргумент <parameter>mode</parameter> равен 1, getrusage будет вызвана с
<constant>RUSAGE_CHILDREN</constant>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает ассоциативный массив, содержащий данные возвращённые из системного
вызова. Имена элементов соответствуют документированным именам полей.
Возвращает &false; в случае возникновения ошибки.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>7.0.0</entry>
<entry>
Добавлен поддержка этой функции в Windows.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>getrusage</function></title>
<programlisting role="php">
<![CDATA[
<?php
$dat = getrusage();
echo $dat["ru_oublock"]; // количество операций вывода блока
echo $dat["ru_inblock"]; // количество операций приёма блока
echo $dat["ru_msgsnd"]; // количество отправленных сообщений IPC
echo $dat["ru_msgrcv"]; // количество принятых сообщений IPC
echo $dat["ru_maxrss"]; // наибольший размер установленной резидентной памяти
echo $dat["ru_ixrss"]; // суммарное значение размера разделяемой памяти
echo $dat["ru_idrss"]; // суммарное значение размера неразделяемых данных
echo $dat["ru_minflt"]; // количество исправленных страниц (лёгкая ошибка страницы)
echo $dat["ru_majflt"]; // количество ошибочных страниц (тяжёлая ошибка страницы)
echo $dat["ru_nsignals"]; // количество полученных сигналов
echo $dat["ru_nvcsw"]; // количество согласованных переключений контекста
echo $dat["ru_nivcsw"]; // количество несогласованных переключений контекста
echo $dat["ru_nswap"]; // количество свопов
echo $dat["ru_utime.tv_usec"]; // время на задачи пользователя (user time) (микросекунды)
echo $dat["ru_utime.tv_sec"]; // время на задачи пользователя (user time) (секунды)
echo $dat["ru_stime.tv_usec"]; // время на системные задачи (system time) (микросекунды)
echo $dat["ru_stime.tv_sec"]; // время на системные задачи (system time) (секунды)
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
В Windows <function>getrusage</function> возвращает только следующее:
</para>
<para>
<simplelist>
<member><literal>"ru_stime.tv_sec"</literal></member>
<member><literal>"ru_stime.tv_usec"</literal></member>
<member><literal>"ru_utime.tv_sec"</literal></member>
<member><literal>"ru_utime.tv_usec"</literal></member>
<member>
<literal>"ru_majflt"</literal> (только если <parameter>mode</parameter> -
<constant>RUSAGE_SELF</constant>)
</member>
<member>
<literal>"ru_maxrss"</literal> (только если <parameter>mode</parameter> -
<constant>RUSAGE_SELF</constant>)
</member>
</simplelist>
</para>
<para>
Если <function>getrusage</function> вызвана с <parameter>mode</parameter> равным
<literal>1</literal> (<constant>RUSAGE_CHILDREN</constant>), то будет
собираться информация по использованию ресурсов потоками (что означает, что внутри
функция будет вызываться с <constant>RUSAGE_THREAD</constant>).
</para>
</note>
<note>
<para>
В BeOS 2000, возвращается только следующее:
</para>
<para>
<simplelist>
<member><literal>"ru_stime.tv_sec"</literal></member>
<member><literal>"ru_stime.tv_usec"</literal></member>
<member><literal>"ru_utime.tv_sec"</literal></member>
<member><literal>"ru_utime.tv_usec"</literal></member>
</simplelist>
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member>Страница системной документации <command>getrusage(2)</command></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- 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
-->