ИМЯ

on_exit - регистрирует функцию для вызова в случае нормального завершения процесса

ОБЗОР

#include <stdlib.h>

int on_exit(void (*function)(int , void *), void *arg);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

on_exit():
начиная с glibc 2.19:
_DEFAULT_SOURCE
в glibc 2.19 и старее:
_BSD_SOURCE || _SVID_SOURCE

ОПИСАНИЕ

Функция on_exit() регистрирует указанную function для вызова в случае нормального завершения процесса с помощью exit(3) или при выходе из функции main(). Функции function передаётся аргумент состояния, указанный в последнем вызове exit(3), а также аргумент arg из on_exit().

Одна функция может быть зарегистрирована несколько раз: она вызывается один раз для каждой регистрации.

Когда дочерний процесс создаётся через fork(2), он наследует копии регистраций родителя. При успешном выполнении одной из функций exec(3) все регистрации снимаются.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

Функция on_exit() при успешном выполнении возвращает 0, в противном случае — ненулевое значение.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

СООТВЕТСТВИЕ СТАНДАРТАМ

Эта функция впервые появилась в SunOS 4, но также она присутствует в glibc. В Solaris (SunOS 5) её уже нет. Избегайте этой функции и используйте вместо нее стандартную atexit(3).

ЗАМЕЧАНИЯ

К моменту выполнения function стек переменных (auto) уже может пропасть из области видимости. Поэтому arg не должен быть указателем на переменную в стеке; однако он может быть указателем на переменную в куче или глобальную переменную.

СМОТРИТЕ ТАКЖЕ

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