[PATCH v5] abort.3: clarify consequences of calling abort

[PATCH v5] abort.3: clarify consequences of calling abort

[Tomáš Golembiovský]

Clarify that atexit/on_exit are not called because those are called only
on normal process termination (as documented on their respective manual
pages).

Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Stefan Puiu <stefan.puiu@gmail.com>
Signed-off-by: Tomáš Golembiovský <tgolembi@redhat.com>
---

v5 changes:
* split .BR items to separate lines as sugested by G. Branden Robinson
* changed "abort" to "abort.3" in commit message title

 man3/abort.3 | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/man3/abort.3 b/man3/abort.3
index c63eace5e..3e1fbbbf5 100644
--- a/man3/abort.3
+++ b/man3/abort.3
@@ -47,6 +47,12 @@ function will still terminate the process.
 It does this by restoring the default disposition for
 .B SIGABRT
 and then raising the signal for a second time.
+.PP
+As with other cases of abnormal termination the functions registered with
+.BR atexit (3)
+and
+.BR on_exit (3)
+are not called.
 .SH RETURN VALUE
 The
 .BR abort ()
-- 
2.41.0

Re: [PATCH v5] abort.3: clarify consequences of calling abort

[Alejandro Colomar]

[-- Attachment #1.1: Type: text/plain, Size: 1490 bytes --]

Hi Tomáš,

On 2023-07-26 14:59, Tomáš Golembiovský wrote:
> Clarify that atexit/on_exit are not called because those are called only
> on normal process termination (as documented on their respective manual
> pages).
> 
> Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
> Cc: Stefan Puiu <stefan.puiu@gmail.com>
> Signed-off-by: Tomáš Golembiovský <tgolembi@redhat.com>
> ---
> 
> v5 changes:
> * split .BR items to separate lines as sugested by G. Branden Robinson
> * changed "abort" to "abort.3" in commit message title

Patch applied.  Thanks!

I've included your test program in the commit message.
It was very useful!

<https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/commit/?id=80e3024bde68ee3fa55cfd87728b81f94ec931df>

Cheers,
Alex

> 
>  man3/abort.3 | 6 ++++++
>  1 file changed, 6 insertions(+)
> 
> diff --git a/man3/abort.3 b/man3/abort.3
> index c63eace5e..3e1fbbbf5 100644
> --- a/man3/abort.3
> +++ b/man3/abort.3
> @@ -47,6 +47,12 @@ function will still terminate the process.
>  It does this by restoring the default disposition for
>  .B SIGABRT
>  and then raising the signal for a second time.
> +.PP
> +As with other cases of abnormal termination the functions registered with
> +.BR atexit (3)
> +and
> +.BR on_exit (3)
> +are not called.
>  .SH RETURN VALUE
>  The
>  .BR abort ()

-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]