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

       This  function  comes  from SunOS 4, but is also present in glibc.  It no longer occurs in
       Solaris (SunOS 5).  Portable application should avoid this function, and use the  standard
       atexit(3)  instead.

NOTAS

       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
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  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⟩.