NOMBRE

       on_exit - registra una función para ser invocada en la terminación normal de un programa

BIBLIOTECA

       Biblioteca Estándar C (libc, -lc)

SINOPSIS

       #include <stdlib.h>

       int on_exit(void (*función)(int , void *), void *arg);

   Requisitos de Macros de Prueba de Características para glibc (véase feature_test_macros(7)):

       on_exit():
           A partir de glibc 2.19:
               _DEFAULT_SOURCE
           Anteriores a glibc 2.19:
               _BSD_SOURCE || _SVID_SOURCE

DESCRIPCIÓN

       La  función on_exit() registra la funcion dada para ser invocada en la terminación normal de un programa,
       ya sea vía exit(3)  o vía el valor retornado por la función main() del programa.  A la funcion se le pasa
       el parámetro de exit(3)  y el parámetro arg de on_exit().

       Es posible registrar la misma función varias veces: se invoca una vez para cada registro.

       When a child process is created via fork(2), it inherits copies of its parent's  registrations.   Upon  a
       successful call to one of the exec(3) functions, all registrations are removed.

VALOR DEVUELTO

       La función on_exit() devuelve el valor 0 en caso de éxito, o un valor distinto de cero en caso contrario.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).
       ┌──────────────────────────────────────────────────────────────┬────────────────────┬───────────────────┐
       │ Interfaz                                                     │ Atributo           │ Valor             │
       ├──────────────────────────────────────────────────────────────┼────────────────────┼───────────────────┤
       │ on_exit()                                                    │ Seguridad del hilo │ Multi-hilo seguro │
       └──────────────────────────────────────────────────────────────┴────────────────────┴───────────────────┘

ESTÁNDARES

       None.

HISTORIAL

       SunOS 4, glibc.  Removed in Solaris (SunOS 5).  Use the standard atexit(3)  instead.

CAVEATS

       By the time function is executed, stack (auto)  variables may already have gone out of scope.  Therefore,
       arg  should  not  be  a  pointer to a stack variable; it may however be a pointer to a heap variable or a
       global variable.

VÉASE TAMBIÉN

       _exit(2), atexit(3), exit(3)

TRADUCCIÓN

       La traducción al español de esta página del manual fue creada por Urko  Lusa  <ulusa@lacueva.ddns.org>  y
       Marcos Fouces <marcos@debian.org>

       Esta  traducción  es  documentación  libre;  lea  la GNU General Public License Version 3 o posterior con
       respecto a las condiciones de copyright.  No existe NINGUNA RESPONSABILIDAD.

       Si encuentra algún error en la traducción de esta página  del  manual,  envíe  un  correo  electrónico  a
       debian-l10n-spanish@lists.debian.org.

Páginas de Manual de Linux 6.9.1                   2 Mayo 2024                                        on_exit(3)