Not Found

The requested URL was not found on this server.

Additionally, a 404 Not Found error was encountered while trying to use an ErrorDocument to handle the request.

1#@!#!123s

: / opt / remi / php82 / root / usr / share / doc / pecl / luasandbox / docbook / luasandbox /

Filename : pauseusagetimer.xml

back

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->

<refentry xml:id="luasandbox.pauseusagetimer" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>LuaSandbox::pauseUsageTimer</refname>
  <refpurpose>Pause the CPU usage timer</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <modifier>public</modifier> <type>bool</type><methodname>LuaSandbox::pauseUsageTimer</methodname>
   <void />
  </methodsynopsis>
  <para>
   Pauses the CPU usage timer.
  </para>
  <para>
   This only has effect when called from within a callback from Lua. When
   execution returns to Lua, the timer will be automatically unpaused. If
   a new call into Lua is made, the timer will be unpaused for the
   duration of that call.
  </para>
  <para>
   If a PHP callback calls into Lua again with timer not paused, and then
   that Lua function calls into PHP again, the second PHP call will not be
   able to pause the timer. The logic is that even though the second PHP
   call would avoid counting the CPU usage against the limit, the first
   call still counts it.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  &no.function.parameters;
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Returns a <type>bool</type> indicating whether the timer is now paused.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Manipulating the usage timer</title>
    <programlisting role="php">
<![CDATA[
<?php

// create a new LuaSandbox and set a CPU limit
$sandbox = new LuaSandbox();
$sandbox->setCPULimit( 1 );

function doWait( $t ) {
    $end = microtime( true ) + $t;
    while ( microtime( true ) < $end ) {
        // waste CPU cycles
    }
}

// Register a PHP callback
$sandbox->registerLibrary( 'php', [
    'test' => function () use ( $sandbox ) {
        $sandbox->pauseUsageTimer();
        doWait( 5 );

        $sandbox->unpauseUsageTimer();
        doWait( 0.1 );
    },
    'test2' => function () use ( $sandbox ) {
        $sandbox->pauseUsageTimer();
        $sandbox->unpauseUsageTimer();
        doWait( 1.1 );
    }
] );

echo "This should not time out...\n";
$sandbox->loadString( 'php.test()' )->call();

echo "This should time out.\n";
try {
    $sandbox->loadString( 'php.test2()' )->call();
    echo "It did not?\n";
} catch ( LuaSandboxTimeoutError $ex ) {
    echo "It did! " . $ex->getMessage() . "\n";
}

?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
This should not time out...
This should time out.
It did! The maximum execution time for this script was exceeded
]]>
    </screen>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><methodname>LuaSandbox::setCPULimit</methodname></member>
    <member><methodname>LuaSandbox::unpauseUsageTimer</methodname></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
-->

Name	Size	Last Modified	Owner	Permissions
callfunction.xml	2.699 KB	December 13 2023 11:34:49	root	0644
disableprofiler.xml	1.486 KB	December 13 2023 11:34:49	root	0644
enableprofiler.xml	2.108 KB	December 13 2023 11:34:49	root	0644
getcpuusage.xml	1.984 KB	December 13 2023 11:34:49	root	0644
getmemoryusage.xml	1.638 KB	December 13 2023 11:34:49	root	0644
getpeakmemoryusage.xml	1.637 KB	December 13 2023 11:34:49	root	0644
getprofilerfunctionreport.xml	3.314 KB	December 13 2023 11:34:49	root	0644
getversioninfo.xml	1.895 KB	December 13 2023 11:34:49	root	0644
loadbinary.xml	2.09 KB	December 13 2023 11:34:49	root	0644
loadstring.xml	2.799 KB	December 13 2023 11:34:49	root	0644
pauseusagetimer.xml	3.434 KB	December 13 2023 11:34:49	root	0644
registerlibrary.xml	3.132 KB	December 13 2023 11:34:49	root	0644
setcpulimit.xml	3.105 KB	December 13 2023 11:34:49	root	0644
setmemorylimit.xml	2.521 KB	December 13 2023 11:34:49	root	0644
unpauseusagetimer.xml	1.597 KB	December 13 2023 11:34:49	root	0644
wrapphpfunction.xml	2.438 KB	December 13 2023 11:34:49	root	0644

2017 © D7net \| D704T team