Linux API. Исчерпывающее руководство

Название «макрос проверки возможностей» может показаться странным, но, если взглянуть на него с точки зрения реализации, можно найти вполне определенный смысл. В реализации решается, какие свойства, доступные в каждом заголовке, нужно сделать видимыми путем проверки (с помощью #if), какие значения приложение определило для этих макросов.

Соответствующими стандартами установлены следующие макросы проверки возможностей (то есть их можно портировать на все системы, поддерживающие эти стандарты).

• _POSIX_SOURCE — если он задан (с любым значением), то предоставляет определения, соответствующие POSIX.1-1990 и ISO C (1990). Этот макрос заменен макросом _POSIX_C_SOURCE.

• _POSIX_C_SOURCE — если он определен со значением 1, то он производит такой же эффект, что и макрос _POSIX_SOURCE. Если он задан со значением большим или равным 199309, то также предоставляет определения для POSIX.1b (работа с системами реального времени). Если он приведен со значением, большим или равным 199506, то он также предоставляет определения для POSIX.1c (работа с потоками). Если он задан со значением 200112, то также предоставляет определения для базовой спецификации POSIX.1-2001 (то есть с включением XSI-расширения). (До выхода версии 2.3.3 заголовки glibc не интерпретировали значение 200112 для _POSIX_C_SOURCE.) Если макрос приведен со значением 200809, то он также предоставляет определения для базовой спецификации POSIX.1-2008. (До выхода версии 2.10 заголовочные файлы glibc не интерпретировали значение 200809 для _POSIX_C_SOURCE.)

• _XOPEN_SOURCE — если он задан (с любым значением), то предоставляет определения, соответствующие POSIX.1, POSIX.2 и X/Open (XPG4). Если он приведен со значением 500 или выше, то также предоставляет определения расширений SUSv2 (UNIX 98 и XPG5). Присвоение значения 600 или выше дополнительно приводит к предоставлению определения расширений SUSv3 XSI (UNIX 03) и расширений C99. (До выхода версии 2.2 заголовки glibc не интерпретировали значение 600 для _XOPEN_SOURCE.) Задание значения 700 или выше также приводит к предоставлению определения расширений SUSv4 XSI. (До выхода версии 2.10 заголовки glibc не интерпретировали значение 700 для _XOPEN_SOURCE.) Значения 500, 600 и 700 для _XOPEN_SOURCE были выбраны потому, что SUSv2, SUSv3 и SUSv4 являются соответственно выпусками Issues 5, 6 и 7 спецификаций X/Open.

Для glibc предназначены следующие макросы проверки возможностей.

• _BSD_SOURCE — если он задан (с любым значением), то предоставляет определения, соответствующие BSD. Явная установка одного лишь этого макроса приводит к тому, что в случае редких конфликтов стандартов предпочтение отдается определениям, соответствующим BSD.

• _SVID_SOURCE — если макрос приведен (с любым значением), то он предоставляет определения System V Interface Definition (SVID).

• _GNU_SOURCE — если он задан (с любым значением), то предоставляет все определения, предусмотренные предыдущими макросами, а также определения различных GNU-расширений.

Когда компилятор GNU C вызывается без специальных ключей, то по умолчанию определяются _POSIX_SOURCE, _POSIX_C_SOURCE=200809 (200112 с glibc версий от 2.5 до 2.9 или 199506 с glibc версии ниже 2.4), _BSD_SOURCE и _SVID_SOURCE.

Если определены отдельные макросы или компилятор вызван в одном из стандартных режимов (например, cc — ansi или cc — std=c99), то предоставляются только запрошенные определения. Существует одно исключение: если _POSIX_C_SOURCE не задан каким-либо другим образом и компилятор не вызван в одном из стандартных режимов, то _POSIX_C_SOURCE определяется со значением 200809 (200112 с glibc версий от 2.4 до 2.9 или 199506 с glibc версии ниже 2.4).

Несколько макросов дополняют друг друга, поэтому можно, к примеру, воспользоваться следующей командой cc для явного выбора тех же установок макросов, которые предоставляются по умолчанию:

$ cc — D_POSIX_SOURCE — D_POSIX_C_SOURCE=199506 \

— D_BSD_SOURCE — D_SVID_SOURCE prog.c

Дополнительную информацию, уточняющую значения, присваиваемые каждому макросу проверки возможностей, можно найти в заголовочном файле и на странице руководства feature_test_macros(7).

_POSIX_C_SOURCE, _XOPEN_SOURCE и POSIX.1/SUS

В POSIX.1-2001/SUSv3 указаны только макросы проверки возможностей _POSIX_C_SOURCE и _XOPEN_SOURCE с требованием, чтобы в соответствующих приложениях они были определены со значениями 200112 и 600. Определение _POSIX_C_SOURCE со значением 200112 обеспечивает соответствие базовой спецификации POSIX.1-2001 (то есть соответствие POSIX, исключая XSI-расширение). Определение _XOPEN_SOURCE со значением 600 обеспечивает соответствие спецификации SUSv3 (то есть соответствие XSI — базовой спецификации плюс XSI-расширению). То же самое относится к POSIX.1-2008/SUSv4 с требованием, чтобы два макроса были определены со значениями 200809 и 700.