Перегляд вихідного коду сторінки Signal.h

{{lowercase}}
{{Стандартна_бібліотека_С}}
'''signal.h''' — [[заголовний файл]] [[Стандартна бібліотека С|стандартної бібліотеки]] [[С (мова програмування)|мови програмування С]], що використовується для зазначення того, як програма обробляє [[сигнал (UNIX)|сигнали]] під час свого виконання. Сигнал може сповіщати про деяке відхилення від очікуваної поведінки програми (як, наприклад, ділення на нуль) або про деякі асинхронні події, що відбулися поза програмою (наприклад, якщо хтось натиснув кнопку переривання програми на клавіатурі).

Сигнал може генеруватися при виклику RAISE (посилає сигнал поточному процесові) або Kill (посилає сигнал будь-якого процесу). Кожна реалізація визначає якийсь сигнал, що генерує і визначає їх генерацію. Реалізація може визначати сигнали, які відрізняються від перерахованих тут. Стандартний заголовний файл <signal.h> може визначати додаткові макроси з іменами, які починаються з SIG, для вказання значення цих додаткових сигналів. Усі подібні значення є цілими константні виразами >= 0.

Можна вказувати обробник сигналу для усіх сигналів, окрім двох (SIGKILL та SIGSTOP не можуть бути перехоплені, блоковані або проігноровані). Обробник сигналу — функція, яка направляє виклики оточенню, коли приймає відповідний сигнал. Цільове оточення призупиняє виконання програми, доки обробник сигналу не поверне значення або викличе перехід (longjmp). Для максимальної переносимості, асинхронний обробник сигналу повинен:
* здійснювати (успішний) виклик сигналу функції
* присвоювати значення об'єктів з типом «непов'язана змінна» sig_atomic_t
* повертати управління

Якщо сигнал сповіщає про помилку всередині програми (а сигнал не асинхронний), то обробник сигналу може завешить її виконання, викликавши Abort, Exit або longjmp.

== Методи ==
*<code>int raise(int sig)</code>. Штучно викликає сигнал.

*<code>[[psignal]](int sig, const char *s)</code>, виводить на [[stderr]] рядок, який містить номер сигналу. Застосовується у [[BSD|4.3BSD]], [[Solaris (операційна система)|Solaris]] та [[Linux]], однак, не вказаний у стандартах [[POSIX]] та [[SUS]].

На тих же системах [[string.h]] містить нестандартний <code>[[strsignal]](int sig)</code>, який працює аналогічно [[strerror]].

*<code>void (*signal(int sig, void (*func)(int)))(int)</code> назначає дію, яку програма виконуватиме при отриманні сигналу <code>sig</code>. Якщо значення func рівне SIG_DFL, то відбувається обробка за замовчуванням для сигналу. Якщо значення func рівне SIG_IGN, сигнал ігнорується. В інших випадках, func вказує на функцію ''обробник сигналу'' при отриманні сигналу.

Функція func може завершуватись виконанням операції виклику або викликом функції самозавершення, виводу або переходу.

== Члени-типи ==
<code>typedef i-type sig_atomic_t</code>

== Члени-макроси ==
*SIG_DFL — Використовується для вказання способу обробки сигналів за замовчуванням.
*SIG_IGN — Використовується для ігнорування сигналу.
*SIG_ERR — Код помилки.

== Члени-константи ==
{|
|-
!Константа !!Значення !! Стандарти
|-
|[[SIGHUP]] ||Відбій ||POSIX|| 
|-
|{{li|SIGINT|Q=Q1770007}} ||Переривання ||ANSI
|-
|[[SIGQUIT]] ||Вихід ||POSIX
|-
|[[SIGILL]] ||Недопустима інструкція ||ANSI
|-
|[[SIGABRT]] ||Самозупинка ||ANSI
|-
|[[SIGTRAP]] ||Перехоплення події ||POSIX
|-
|[[SIGABRT | SIGIOT]] ||Перехоплення вводу-виводу ||4.2 BSD
|-
|{{li|SIGEMT|Q=Q4048752}} ||Перехоплення емуляції ||4.2 BSD
|-
|[[SIGFPE]] ||Виняток з плаваючою крапкою ||ANSI
|-
|[[SIGKILL]] ||Неперехоплюваний сигнал завершення ||POSIX
|-
|[[SIGBUS]] ||Помилка шини ||4.2 BSD
|-
|[[SIGSEGV]] ||Порушення сегментації ||ANSI
|-
|[[SIGSYS]] ||Неправильний аргумент у системному виклику ||4.2 BSD
|-
|[[SIGPIPE]] ||Порушення каналу ||POSIX
|-
|[[SIGALRM]] ||Завершення часу ||POSIX
|-
|[[SIGTERM]] ||Завершення ||ANSI
|-
|{{li|SIGUSR1|Q=Q4048773}} ||Користувацький сигнал 1 ||POSIX
|-
|{{li|SIGUSR2|Q=Q4048773}} ||Користувацький сигнал 2 ||POSIX
|-
|[[SIGCHLD]] ||Зміна статусу дочірнього процесу ||POSIX
|-
|[[SIGCHLD | SIGCLD]] ||Аналогічно SIGCHLD ||System V
|-
|[[SIGPWR]] ||Перезапуск після проблеми із живленням ||System V
|-
|[[SIGXCPU]] ||Обмеження процесорного часу ||POSIX
|}

== Посилання ==
*[http://www.opengroup.org/onlinepubs/009695399/basedefs/signal.h.html signal.h] {{Webarchive|url=https://web.archive.org/web/20091025174604/http://www.opengroup.org/onlinepubs/009695399/basedefs/signal.h.html |date=25 жовтня 2009 }} на [[OpenGroup]]
*[https://web.archive.org/web/20081231030403/http://www.dinkumware.com/manuals/?manual=compleat&page=signal.html Посібник по signal.h на dinkumware]

[[Категорія:Заголовні файли мови С]]