Skip to content

[Sync-En] sem, shmop: document errors on detached segments, auto_release warning and shmop fixes #1478

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 2 commits into from
Oct 21, 2026
Merged

[Sync-En] sem, shmop: document errors on detached segments, auto_release warning and shmop fixes #1478

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a69791e
[Sync-En] sem, shmop: document errors on detached segments, auto_rele…
lacatoire Oct 21, 2026
bfd2725
Merge branch 'master' into sync-en/sysv-shmop-sem
julionc Oct 21, 2026
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
20 changes: 20 additions & 0 deletions reference/sem/entities.ent
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 589b2024573a14b6a4d286e5ec9aad614b36c6fa Maintainer: lacatoire Status: ready -->
<!-- Reviewed: no -->
<!--
See `manual.xml` for XML namespaces defaults.
Keep the lines under 79 columns, to make the process of manual
translation easier, and to avoid wrap-around in some other contexts.
-->
<entities xmlns = "http://docbook.org/ns/docbook"
xmlns:xlink = "http://www.w3.org/1999/xlink"
translate = "yes">

<entity name="ext.sem.shm-detached-error">
<simpara>
Lanza un <exceptionname>Error</exceptionname> si <parameter>shm</parameter>
ya ha sido liberado con <function>shm_detach</function>.
</simpara>
</entity>

</entities>
1 change: 1 addition & 0 deletions reference/sem/functions/sem-get.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e1ed939373254ebf51ed7822d1a700eb4abeb3a1 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sem-get">
Expand Down
7 changes: 6 additions & 1 deletion reference/sem/functions/shm-detach.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5b7646656eb183ea568b8261d6d87a10a1b961c7 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 589b2024573a14b6a4d286e5ec9aad614b36c6fa Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-detach">
<refnamediv>
Expand Down Expand Up @@ -45,6 +45,11 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
&ext.sem.shm-detached-error;
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
Expand Down
15 changes: 11 additions & 4 deletions reference/sem/functions/shm-get-var.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 589b2024573a14b6a4d286e5ec9aad614b36c6fa Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-get-var">
<refnamediv>
Expand All @@ -17,8 +17,8 @@
</methodsynopsis>
<simpara>
<function>shm_get_var</function> devuelve la variable
identificada por <parameter>variable_key</parameter>, en
el segmento de memoria compartida identificado por <parameter>shm_identifier</parameter>.
identificada por <parameter>key</parameter>, en
el segmento de memoria compartida identificado por <parameter>shm</parameter>.
La variable siempre está presente en la memoria
compartida.
</simpara>
Expand Down Expand Up @@ -50,9 +50,16 @@
&reftitle.returnvalues;
<simpara>
Devuelve la variable correspondiente a la clave dada.
Si la clave no existe, se emite un <constant>E_WARNING</constant>
y se devuelve &false;.
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
&ext.sem.shm-detached-error;
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
Expand Down Expand Up @@ -82,7 +89,7 @@
<member><function>shm_has_var</function></member>
<member><function>shm_put_var</function></member>
</simplelist>
</refsect1>
</refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Expand Down
9 changes: 7 additions & 2 deletions reference/sem/functions/shm-has-var.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 589b2024573a14b6a4d286e5ec9aad614b36c6fa Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-has-var">
<refnamediv>
Expand Down Expand Up @@ -35,7 +35,7 @@
<term><parameter>key</parameter></term>
<listitem>
<simpara>
El nombre de la variable.
La clave de la variable.
</simpara>
</listitem>
</varlistentry>
Expand All @@ -49,6 +49,11 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
&ext.sem.shm-detached-error;
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
Expand Down
7 changes: 6 additions & 1 deletion reference/sem/functions/shm-put-var.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 589b2024573a14b6a4d286e5ec9aad614b36c6fa Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-put-var">
<refnamediv>
Expand Down Expand Up @@ -70,6 +70,11 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
&ext.sem.shm-detached-error;
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
Expand Down
7 changes: 6 additions & 1 deletion reference/sem/functions/shm-remove-var.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 589b2024573a14b6a4d286e5ec9aad614b36c6fa Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-remove-var">
<refnamediv>
Expand Down Expand Up @@ -51,6 +51,11 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
&ext.sem.shm-detached-error;
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
Expand Down
7 changes: 6 additions & 1 deletion reference/sem/functions/shm-remove.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 589b2024573a14b6a4d286e5ec9aad614b36c6fa Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-remove">
<refnamediv>
Expand Down Expand Up @@ -42,6 +42,11 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
&ext.sem.shm-detached-error;
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
Expand Down
14 changes: 12 additions & 2 deletions reference/shmop/functions/shmop-delete.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 41d34439ea8cae2bb1204264c1bce15d88284503 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: b189a6891d709765f37c6843cbf4f58d44ed847b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shmop-delete">
<refnamediv>
Expand All @@ -14,7 +14,9 @@
<methodparam><type>Shmop</type><parameter>shmop</parameter></methodparam>
</methodsynopsis>
<simpara>
<function>shmop_delete</function> se utiliza para destruir un bloque de memoria compartida.
<function>shmop_delete</function> marca un bloque de memoria compartida para su
eliminación. El bloque solo se destruye cuando todos los procesos se han
desvinculado de él.
</simpara>
</refsect1>
<refsect1 role="parameters">
Expand All @@ -38,6 +40,14 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Si el bloque no puede marcarse para su eliminación, por ejemplo porque el
usuario actual no es su propietario, se emite un <constant>E_WARNING</constant>.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
Expand Down
22 changes: 12 additions & 10 deletions reference/shmop/functions/shmop-open.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 41d34439ea8cae2bb1204264c1bce15d88284503 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: b189a6891d709765f37c6843cbf4f58d44ed847b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shmop-open">
<refnamediv>
Expand Down Expand Up @@ -49,7 +49,7 @@
</listitem>
<listitem>
<simpara>
<literal>"c"</literal> para creación (utiliza <literal>IPC_CREATE</literal>)
<literal>"c"</literal> para creación (utiliza <literal>IPC_CREAT</literal>)
utilice esta opción para crear un nuevo bloque, o, si un
segmento con el mismo identificador existe, intentar acceder a él en
modo lectura y escritura.
Expand All @@ -66,9 +66,9 @@
<listitem>
<simpara>
<literal>"n"</literal> crea un nuevo segmento de memoria compartida
(utiliza <literal>IPC_CREATE|IPC_EXCL</literal>). Utilice esta opción
(utiliza <literal>IPC_CREAT|IPC_EXCL</literal>). Utilice esta opción
cuando se quiera crear un nuevo segmento de memoria
compartida a menos que ya exista uno corrupto con la
compartida, pero que falle si ya existe uno con la
misma opción. Esto es muy útil por razones de seguridad, para evitar
agujeros de seguridad que exploten la carrera por los recursos.
</simpara>
Expand Down Expand Up @@ -115,8 +115,9 @@
<refsect1 role="errors">
&reftitle.errors;
<simpara>
Si <parameter>mode</parameter> es inválido, o si <parameter>size</parameter> es inferior o igual a cero,
se lanza una <classname>ValueError</classname>.
Si <parameter>mode</parameter> es inválido, o si <parameter>size</parameter> es inferior o igual a cero
para los modos <literal>"c"</literal> y <literal>"n"</literal>,
se lanza una <exceptionname>ValueError</exceptionname>.
En otros casos de fallo, se emite un <constant>E_WARNING</constant>.
</simpara>
</refsect1>
Expand All @@ -135,15 +136,16 @@
<row>
<entry>8.0.0</entry>
<entry>
<parameter>shmop</parameter> ahora espera una instancia de <classname>Shmop</classname>
anteriormente se esperaba un <type>resource</type>.
En caso de éxito, esta función devuelve ahora una instancia de <classname>Shmop</classname>;
anteriormente se devolvía un <type>resource</type>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Si <parameter>mode</parameter> es inválido, o si <parameter>size</parameter> es inferior o igual a cero,
se lanza una <classname>ValueError</classname>; anteriormente, se emitía un <constant>E_WARNING</constant> en su lugar,
Si <parameter>mode</parameter> es inválido, o si <parameter>size</parameter> es inferior o igual a cero
para los modos <literal>"c"</literal> y <literal>"n"</literal>,
se lanza una <exceptionname>ValueError</exceptionname>; anteriormente, se emitía un <constant>E_WARNING</constant> en su lugar,
y la función devolvía &false;.
</entry>
</row>
Expand Down
6 changes: 3 additions & 3 deletions reference/shmop/functions/shmop-write.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 41d34439ea8cae2bb1204264c1bce15d88284503 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: b189a6891d709765f37c6843cbf4f58d44ed847b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shmop-write">
<refnamediv>
Expand Down Expand Up @@ -62,8 +62,8 @@
<refsect1 role="errors">
&reftitle.errors;
<simpara>
Si <parameter>offset</parameter> está fuera de límite, o si un segmento de memoria compartida
de solo lectura debe ser escrito, se levanta una <classname>ValueError</classname>.
Si <parameter>offset</parameter> está fuera de rango, se lanza una <exceptionname>ValueError</exceptionname>.
Si el segmento de memoria compartida se abrió en modo solo lectura, se lanza un <exceptionname>Error</exceptionname>.
</simpara>
</refsect1>

Expand Down
Loading