27. Параметры Конфигурации Системы

Функции и макрокоманды, перечисленные в этой главе дают информацию относительно параметров конфигурации операционной системы, например, ограничений пропускной способности, присутствие необязательных POSIX возможностей, и заданный по умолчанию путь для исполняемых файлов (см. Раздел 27.12 [Строковые Параметры]).

27.1 Общие Ограничения Пропускной способности

POSIX.1 и POSIX.2 стандарты определяют ряд параметров, которые описывают ограничения пропускной способности системы. Эти ограничения могут быть фиксированные константы для данной операционной системы, или они могут изменяться от машины к машине.

Каждый из следующих параметров ограничения имеет макрокоманду, которая определена в " limits.h " только, если система имеет фиксированное, однородное ограничение для рассматриваемого параметра. Если система позволяет различным файловым системам или файлам иметь различные ограничения, то макрокоманда неопределена; используйте sysconf, чтобы выяснить ограничение, которое применяется в специфическое время на специфической машине. См. Раздел 27.4 [Sysconf].

Каждый из этих параметров также имеет другую макрокоманду, с именем, начинающимся с " _POSIX ", которая дает самое низкое значение, которое ограничению позволяется иметь на любой системе POSIX. См. Раздел 27.5 [Минимумы].

       int ARG_MAX

       int CHILD_MAX

       int OPEN_MAX

       int STREAM_MAX

       int TZNAME_MAX

Эти макрокоманды ограничений всегда определяются в " limits.h ".

       int NGROUPS_MAX

       int SSIZE_MAX

Эта макрокоманда определена во всех системах POSIX, т. к. это ограничение никогда не переконфигурируется.

       int RE_DUP_MAX  (макрос)

Эта макрокоманда определена во всех POSIX.2 системах, т. к. POSIX.2 говорит, что она должна всегда определяться, даже если не имеется никакого специфического наложенного ограничения.

27.2 Полные Опции Системы

POSIX определяет некоторые системно-специфические опции, которые не все системы POSIX поддерживают. Так как эти опции обеспечиваются в ядре, а не в библиотеке, просто использование библиотек GNU C не гарантирует любой из этих возможностей; это зависит от системы, которую Вы используете.

Вы можете проверять доступность данной опции, используя макрокоманды в этом разделе, вместе с функцией sysconf. макрокоманды определены только, если Вы включаете " unistd.h ".

Для следующих макрокоманд, если макрокоманда определена в " unistd.h ", то опция обеспечивается.

Иначе, опция может или не может обеспечена; используйте sysconf для выяснения. См. Раздел 27.4 [Sysconf].

       int _POSIX_JOB_CONTROL  (макрос)

       int _POSIX_SAVED_IDS  (макрос)

Для следующих макрокоманд, если макрокоманда определена в " unistd.h ", то значение указывает, обеспечивается ли опция. Значение -1 означает нет, а любое другое значение означает да. Если макрокоманда не определена, то опция может или не может обеспечиваться; используйте sysconf для выяснения. См. Раздел 27.4 [Sysconf].

       int _POSIX2_C_DEV  (макрос)

       int _POSIX2_FORT_DEV  (макрос)

       int _POSIX2_FORT_RUN

       int _POSIX2_LOCALEDEF  (макрос)

       int _POSIX2_SW_DEV  (макрос)

27.3 Которая Версия POSIX Обеспечивается

       long int _POSIX_VERSION  (макрос)

Примечание Использования: Не пробуйте тестировать поддерживает ли система POSIX, включая " unistd.h " и тогда проверяя, определен ли _POSIX_VERSION. На не - posix системах, это возможно выдаст ошибку, т. к. там нет никакого " unistd.h ". Мы не знаем любого способа, которым Вы можете надежно проверять при трансляции, поддерживает ли ваша целевая система POSIX или существует ли " unistd.h ".

Компилятор GNU C предопределяет символ __ POSIX __, если целевая система - система POSIX. Если Вы не используете любой, другие компиляторы на системах POSIX, проверяя определенный (__ POSIX __) надежно обнаружят такие системы.

       long int _POSIX2_C_VERSION  (макрос)

Значение этого символа не говорит ничто относительно утилит, установленных на системе.

Примечание Использования: Вы можете использовать эту макрокоманду, чтобы проверить что POSIX.1 библиотека систем поддерживает POSIX.2 также. Любая POSIX.1 система содержит " unistd.h ", так что включайте этот файл и тогда проверяйте defined (_POSIX2_C_VERSION).

27.4 Использование sysconf

Когда ваша система имеет ограничения системы с перестраиваемой конфигурацией, Вы можете использовать функцию sysconf для выяснения значений, которые применяются для любой специфической машины. Функция и связанные константы параметров объявлены в заглавном файле " unistd.h ".

Определение sysconf

       long int sysconf (int parameter)  (функция)

Нормальное возвращаемое значение из sysconf - значение, которое Вы запросили. Значение -1 возвращается, если реализация не налагает ограничения, и в случае ошибки.

Следующие errno условия ошибки определены для этой функции:

EINVAL

значение параметра недопустимо.

Константы для Sysconf Параметров

Имеются символические константы которые используют как аргументы в sysconf. Значения - все целочисленные константы (более специально, значения перечислимого типа).

       _SC_ARG_MAX

       _SC_CHILD_MAX

       _SC_OPEN_MAX

       _SC_STREAM_MAX

       _SC_TZNAME_MAX

       _SC_NGROUPS_MAX

       _SC_JOB_CONTROL

       _POSIX_JOB_CONTROL.
       _SC_SAVED_IDS

       _POSIX_SAVED_IDS.
       _SC_VERSION

       _SC_CLK_TCK

       _SC_2_C_DEV

       _SC_2_FORT_DEV

       _SC_2_FORT_RUN

       _SC_2_LOCALEDEF

       _SC_2_SW_DEV

       _SC_BC_BASE_MAX

       _SC_BC_DIM_MAX

       _SC_BC_SCALE_MAX

       _SC_BC_STRING_MAX

       _SC_COLL_WEIGHTS_MAX

       _SC_EXPR_NEST_MAX

       _SC_LINE_MAX

       _SC_EQUIV_CLASS_MAX

       _SC_VERSION

       _SC_2_VERSION

       _SC_PAGESIZE

Примеры sysconf

Мы рекомендуем, чтобы Вы сначала проверили макроопределение для параметра в котором Вы заинтересованы, и вызывали sysconf только, если макрокоманда не определена. Например, вот как проверяют обеспечивается ли управление заданиями:

                int
                have_job_control (void)
                {
                #ifdef _POSIX_JOB_CONTROL
                        return 1;
                #else
                        int value = sysconf (_SC_JOB_CONTROL);
                        if (value < 0)
                                fatal (strerror (errno));
                        return value;
                #endif
                }
       Here is how to get the value of a numeric limit:
                int
                get_child_max ()
                {
                #ifdef CHILD_MAX
                        return CHILD_MAX;
                #else
                        int value = sysconf (_SC_CHILD_MAX);
                        if (value < 0)
                                fatal (strerror (errno));
                        return value;
                #endif
                }

27.5 Минимальные Значения для Общих Ограничений Емкости

Имеются названия для POSIX минимальных верхних пределов для параметров ограничений системы.

Смысл этих значений состоит в том, что Вы можете безопасно помещать в эти ограничения без проверки, может ли специфическая система, которую Вы используете принять их.

       _POSIX_ARG_MAX

       _POSIX_CHILD_MAX

       _POSIX_NGROUPS_MAX

       _POSIX_OPEN_MAX

       _POSIX_SSIZE_MAX

       _POSIX_STREAM_MAX

       _POSIX_TZNAME_MAX

       _POSIX2_RE_DUP_MAX

27.6 Ограничения Емкости Файловой системы

POSIX.1 стандарт определяет ряд параметров, которые описывают ограничения файловой системы. Система может иметь фиксированное, однородное ограничение для параметра, но это не обычный случай. На большинстве систем, для различных файловых систем (и, для некоторых параметров, даже для различных файлов) имеются различные максимальные ограничения. Например, если Вы используете NFS для устанавливки некоторых файловых систем из других машин.

Каждая из следующих макрокоманд определена в " limits.h " только, если система имеет фиксированное, однородное ограничение для рассматриваемого параметра. Если система позволяет различным файловым системам или файлам иметь различные ограничения, то макрокоманда неопределена; используйте pathconf или fpathconf, чтобы выяснить ограничение, которое применяется к специфическому файлу. См. Раздел 27.9 [Pathconf].

Каждый параметр также имеет другую макрокоманду, с именем, начинающимся с " _POSIX ", которая дает самое низкое значение, которое ограничению позволяется иметь на любой POSIX системе. См. Раздел 27.8 [Минимумы Файла].

       int LINK_MAX     (макрос)

       int MAX_CANON    (макрос)

       int MAX_INPUT    (макрос)

       int NAME_MAX     (макрос)

       int PATH_MAX     (макрос)

       int PIPE_BUF     (макрос)

Это - альтернативные имена макрокоманд.

       int MAXNAMLEN    (макрос)

       int FILENAME_MAX (макрос)

В отличие от PATH_MAX, эта макрокоманда определена, даже если не имеется никакого фактического наложенного ограничения. В таком случае, значение - обычно очень большое количество. Так всегда в системе GNU.

Примечание Использования: Не используйте FILENAME_MAX как размер массива, чтобы сохранить имя файла! Вы не можете возможно делать массив таким большим! Используйте динамическое резервирование (см. Главу 3 [Распределение памяти]).

27.7 Необязательные Возможности в Поддержке Файлов

POSIX определяет некоторые системно-специфические опции в системных вызовах для файлов. Некоторые системы поддерживают эти опции, а другие - нет. Так как эти опции обеспечиваются в ядре, а не в библиотеке, просто использование библиотеки GNU С не гарантирует, что любая из этих возможностей обеспечивается; это зависит от системы, которую Вы используете. Они могут также изменяться между файловыми системами на одиночной машине.

Этот раздел описывает макрокоманды, которые Вы можете проверять, чтобы определить, обеспечивается ли специфическая опция на вашей машине. Если данная макрокоманда определена в " unistd.h ", то значение, говорит обеспечивается ли соответствующая возможность. (Значение -1 указывает нет; любое другое значение указывает да.) если макрокоманда неопределена, это означает специфические файлы могут и не поддерживать эту возможность.

Так как все машины, которые поддерживают библиотеку GNU C также поддерживают NFS, можно делать общее утверждение относительно того, все ли файловые системы поддерживают возможности _POSIX_NO_TRUNC и _POSIX_CHOWN_RESTRICTED. Так что эти имена никогда не определены как макрокоманды в библиотеке GNU C.

       int _POSIX_CHOWN_RESTRICTED  (макрос)

       int _POSIX_NO_TRUNC  (макрос)

       unsigned char _POSIX_VDISABLE  (макрос)

Если одна из этих макрокоманд является неопределенной, это означает что эта опция может быть определена в действительности для некоторых файлов и не определена для других. Чтобы запрашивать относительно специфического файла, вызовите pathconf или fpathconf. См. Раздел 27.9 [Pathconf].

27.8 Минимальные Значения для Ограничений Файловой системы

Имеются имена для POSIX минимальных верхних пределов для некоторых из вышеупомянутых параметров.

Смысл этих значений состоит в том, что Вы можете безопасно помещать в эти ограничения без проверки, может ли специфическая система, которую Вы используете принять их.

       _POSIX_LINK_MAX

       _POSIX_MAX_CANON

       _POSIX_MAX_INPUT

       _POSIX_NAME_MAX

       _POSIX_PATH_MAX

       _POSIX_PIPE_BUF

27.9 Использование pathconf

Когда ваша машина позволяет различным файлам иметь различные значения для параметра файловой системы, Вы можете использовать функции в этом разделе, чтобы выяснить значение, которое применяется к любому специфическому файлу.

Эти функции и связанные константы для аргумента parameter объявлены в заглавном файле " unistd.h ".

       long int pathconf (const char *filename, int parameter)  (функция)

Аргумент parameter должен быть одной из " _PC_ " констант, перечисленных ниже.

Нормальное возвращаемое значение из pathconf - значение, которое Вы запросили. Значение -1 будет возвращено, если реализация не налагает ограничений, и в случае ошибки.

В вышеупомянутом случае, errno не установлена, в то время как в последнем случае, errno установлена, чтобы указать причину проблемы. Так что единственый способ использовать эту функцию robustly состоит в том, чтобы сохранить 0 в errno перед ее вызовом.

Кроме обычных синтаксических ошибок имени файла (см. Раздел 6.2.3 [Ошибки Имени файла]), следующие условия ошибки определены для этой функции:

EINVAL

значение параметра недопустимо, или реализация не поддерживает параметр для специфического файла.

       long int fpathconf (int filedes, int parameter)  (функция)

Следующие errno условия ошибки определены для этой функции:

EBADF

filedes аргумент - не допустимый описатель файла.

EINVAL

значение параметра недопустимо, или реализация не поддерживает параметр для специфического файла.

       _PC_LINK_MAX

       _PC_MAX_CANON

       _PC_MAX_INPUT

       _PC_NAME_MAX

       _PC_PATH_MAX

       _PC_PIPE_BUF

       _PC_CHOWN_RESTRICTED

       _PC_NO_TRUNC

       _PC_VDISABLE

27.10 Ограничения для Утилит

POSIX.2 стандарт определяет некоторые ограничения системы, к которым Вы можете обращаться через sysconf, которые относятся к поведению некоторых утилит а не к поведению библиотеки или операционной системы.

Библиотека GNU C определяет макрокоманды для этих ограничений, и sysconf возвращает значения для них, если Вы спрашиваете; но эти значения не передают никакую значимую информацию. Они - просто самые маленькие значения которые POSIX. 2 разрешает.

       int BC_BASE_MAX  (макрос)

       int BC_SCALE_MAX (макрос)

       int BC_DIM_MAX   (макрос)

       int BC_STRING_MAX        (макрос)

       int BC_DIM_MAX   (макрос)

       int COLL_WEIGHTS_MAX     (макрос)

       int EXPR_NEST_MAX        (макрос)

       int LINE_MAX     (макрос)

27.11 Минимальные Значения для Пределов Утилит

       _POSIX2_BC_BASE_MAX

       _POSIX2_BC_DIM_MAX

       _POSIX2_BC_SCALE_MAX

       _POSIX2_BC_STRING_MAX

       _POSIX2_COLL_WEIGHTS_MAX

       _POSIX2_EXPR_NEST_MAX

       _POSIX2_LINE_MAX

27.12 Строковые Параметры

POSIX. 2 определяет способ получить строковые параметры из операционной системы - функцией confstr:

       size_t confstr (int parameter, char *buf, size_t len)  (функция)

Нормальное возвращаемое значение из confstr - длина строкового значения, о котором Вы просили. Если Вы обеспечиваете пустой указатель для buf, то confstr, не пробует сохранять строку; она только возвращает длину. Значение 0 указывает ошибку.

Если строка, о которой Вы просили, слишком длинная для буфера (то есть длиньше чем len - 1), то confstr сохраняет только то что помещается (оставляя участок памяти для пустого символа завершения). Вы можете понять, что это случилось, потому что confstr возвращает значение больше чем или равный len.

Следующие errno условия ошибки определены для этой функции:

EINVAL

значение параметра недопустимо.

_CS_PATH значение этого параметра - рекомендуемый заданный по умолчанию путь для поиска исполняемых файлов. Это - путь, который пользователь имеет по умолчанию только после регистрации.

Способ использовать confstr без любого произвольного ограничения строкового размера состоит в том, чтобы вызвать ее дважды: сначала вызвать ее, чтобы получить длину, зарезервировать буфер соответственно, и тогда вызывать confstr снова, чтобы заполнить буфер, примерно так:

        char *
        get_default_path (void)
        {
                size_t len = confstr (_CS_PATH, NULL, 0);
                char *buffer = (char *) xmalloc (len);
                if (confstr (_CS_PATH, buf, len + 1) == 0) {
                        free (buffer);
                        return NULL;
                }
                return buffer;
         }