Skip to content

[Sync-En] pcntl_signal(): document the SIGALRM default for restart_syscalls (#5821) #1221

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
julionc merged 1 commit into from
Sep 2, 2026
Merged

[Sync-En] pcntl_signal(): document the SIGALRM default for restart_syscalls (#5821) #1221

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
74 changes: 53 additions & 21 deletions reference/pcntl/functions/pcntl-signal.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5fe0f8494374d594762e56b2d769c2828b1e0ddb Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: 3866fba43ed70c07afa89df7daf21529b09b4f3b Maintainer: PhilDaiguille Status: ready -->
<refentry xml:id="function.pcntl-signal" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>pcntl_signal</refname>
Expand Down Expand Up @@ -38,13 +37,13 @@
<varlistentry>
<term><parameter>handler</parameter></term>
<listitem>
<para>
<simpara>
El gestor de señales. Puede ser un <type>callable</type>,
que será llamado para gestionar la señal, o bien una de las dos
constantes globales <constant>SIG_IGN</constant> o <constant>SIG_DFL</constant>,
que, respectivamente, ignorarán la señal o restaurarán el gestor
de señales por defecto.
</para>
</simpara>
<para>
Si se proporciona un <type>callable</type>, debe implementar la siguiente firma:
</para>
Expand All @@ -56,7 +55,7 @@
</methodsynopsis>
<variablelist>
<varlistentry>
<term><parameter>signal</parameter></term>
<term><parameter>signo</parameter></term>
<listitem>
<simpara>
La señal a gestionar.
Expand All @@ -74,11 +73,11 @@
</variablelist>
</para>
<note>
<para>
Téngase en cuenta que cuando se configura el gestor con un método de objeto,
el contador de referencia del objeto se incrementa, lo que lo hace persistente
hasta que se cambie el gestor de señales por otro, o hasta que el script termine.
</para>
<simpara>
Cuando el gestor se configura con un método de objeto, el contador de referencia
de ese objeto se incrementa, lo que lo hace persistente hasta que el gestor
se cambie por otro, o hasta que el script termine.
</simpara>
</note>
</listitem>
</varlistentry>
Expand All @@ -89,6 +88,16 @@
Especifica si la llamada al sistema de reinicio (restarting) debe ser utilizada
cuando llega esta señal.
</para>
<note>
<simpara>
Aunque este parámetro tiene como valor predeterminado &true;, dicho valor
predeterminado no se aplica a <constant>SIGALRM</constant>: cuando
<parameter>restart_syscalls</parameter> no se pasa y
<parameter>signal</parameter> es <constant>SIGALRM</constant>,
el reinicio de las llamadas al sistema queda desactivado. Pase &true;
explícitamente para habilitarlo en <constant>SIGALRM</constant>.
</simpara>
</note>
</listitem>
</varlistentry>
</variablelist>
Expand All @@ -102,6 +111,21 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Se lanza una <exceptionname>ValueError</exceptionname> si
<parameter>signal</parameter> es menor que <literal>1</literal> o mayor o igual
a <constant>NSIG</constant>, o si <parameter>handler</parameter> es un
<type>int</type> distinto de <constant>SIG_DFL</constant> o <constant>SIG_IGN</constant>.
</simpara>
<simpara>
Se lanza una <exceptionname>TypeError</exceptionname> si
<parameter>handler</parameter> no es ni un <type>callable</type> ni un
<type>int</type>.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<para>
Expand All @@ -114,6 +138,16 @@
</row>
</thead>
<tbody>
<row>
<entry>7.4.0</entry>
<entry>
<parameter>restart_syscalls</parameter> ahora se tiene en cuenta para
<constant>SIGALRM</constant>; anteriormente el reinicio de llamadas al sistema
siempre estaba desactivado para esa señal. Cuando no se pasa el argumento,
el reinicio de llamadas al sistema permanece desactivado para
<constant>SIGALRM</constant>.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>
Expand Down Expand Up @@ -187,10 +221,10 @@ echo "Hecho\n";

<refsect1 role="notes"><!-- {{{ -->
&reftitle.notes;
<para>
<simpara>
La función <function>pcntl_signal</function> no apila
los gestores de señales, sino que los reemplaza.
</para>
</simpara>
<refsect2>
<title>Método de dispatch</title>
<para>
Expand All @@ -210,15 +244,13 @@ echo "Hecho\n";

<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><link xlink:href="https://en.wikipedia.org/wiki/Signal_(IPC)">Signal (IPC)</link> en Wikipedia</member>
<member><function>pcntl_async_signals</function></member>
<member><function>pcntl_fork</function></member>
<member><function>pcntl_signal_dispatch</function></member>
<member><function>pcntl_waitpid</function></member>
</simplelist>
</para>
<simplelist>
<member><link xlink:href="https://en.wikipedia.org/wiki/Signal_(IPC)">Signal (IPC)</link> en Wikipedia</member>
<member><function>pcntl_async_signals</function></member>
<member><function>pcntl_fork</function></member>
<member><function>pcntl_signal_dispatch</function></member>
<member><function>pcntl_waitpid</function></member>
</simplelist>
</refsect1>

</refentry>
Expand Down