ИМЯ¶

sysctl - читает/записывает параметры системы

СИНТАКСИС¶

#include <unistd.h>
#include <linux/sysctl.h>

int _sysctl(struct __sysctl_args *args);

Замечание: В glibc нет обёрточной функции для данного системного вызова; смотрите ЗАМЕЧАНИЯ.

ОПИСАНИЕ¶

Не используйте этот системный вызов! Смотрите ЗАМЕЧАНИЯ.

Системный вызов _sysctl считывает и/или изменяет параметры ядра. К ним относятся, например, имя машины или максимальное количество открытых файлов. Параметр имеет следующую структуру:

struct __sysctl_args {


    int    *name;    /* целочисленный вектор, описывающий


                        переменную */


    int     nlen;    /* длина этого вектора */


    void   *oldval;  /* 0 или адрес старого значения */


    size_t *oldlenp; /* размер старого значения, заменяется


                        реальным размером старого значения */


    void   *newval;  /* 0 или адрес нового значения */


    size_t  newlen;  /* размер нового значения */
};

Этот вызов производит поиск в древовидной структуре, возможно, похожей на структуру каталогов /proc/sys, и, если запрашиваемый элемент найден, вызывает соответствующую процедуру, читающую или изменяющую значение.

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

При успешном выполнении _sysctl() возвращает 0. При ошибке возвращается -1, а переменной errno присваивается номер ошибки.

ОШИБКИ¶

EACCES, EPERM

Нет прав на поиск в одном из встретившихся «каталогов» или нет прав на чтение, если oldval не равно нулю; или нет прав на запись, если newval не равно нулю.

EFAULT

Был сделан запрос предыдущего значения путём установки не-NULL значения oldval, но размер места под него в oldlenp равен нулю.

ENOTDIR

name не найден.

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

Этот вызов есть только в Linux и не должен использоваться в переносимых программах. Вызов sysctl() впервые появился в Linux 1.3.57. Впервые он появился в 4.4BSD. Только в Linux существует зеркало /proc/sys, и схемы именования объектов в Linux и 4.4BSD различаются, но объявление функции sysctl() одинаково в обеих системах.

ЗАМЕЧАНИЯ¶

В glibc отсутствует обёрточная функция для этого системного вызова; вызывайте его через syscall(2). Или лучше совсем не используйте: использование данного системного вызова уже давно не рекомендуется и он так всем не нравится, что, вероятно, исчезнет в новой версии ядра. Начиная с Linux 2.6.24, при использовании данного системного вызова записывается предупреждение в журнал ядра. Удалите вызов из своих программ прямо сейчас; вместо него используйте интерфейс /proc/sys.

Данный системный вызов доступен только, если ядро было собрано с параметром CONFIG_SYSCTL_SYSCALL.

ДЕФЕКТЫ¶

Названия объектов различаются в разных версиях ядра, что делает данный вызов в приложениях бесполезным.

Не все существующие объекты описаны соответствующим образом.

В настоящее время невозможно изменить тип операционной системы путём записи в файл /proc/sys/kernel/ostype.

ПРИМЕР¶

#define _GNU_SOURCE
#include <unistd.h>
#include <sys/syscall.h>
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
#include <linux/sysctl.h>
int _sysctl(struct __sysctl_args *args );
#define OSNAMESZ 100
int
main(void)
{


    struct __sysctl_args args;


    char osname[OSNAMESZ];


    size_t osnamelth;


    int name[] = { CTL_KERN, KERN_OSTYPE };


    memset(&args, 0, sizeof(struct __sysctl_args));


    args.name = name;


    args.nlen = sizeof(name)/sizeof(name[0]);


    args.oldval = osname;


    args.oldlenp = &osnamelth;


    osnamelth = sizeof(osname);


    if (syscall(SYS__sysctl, &args) == -1) {


        perror("_sysctl");


        exit(EXIT_FAILURE);


    }


    printf("Эта машина работает в %*s\n", osnamelth, osname);


    exit(EXIT_SUCCESS);
}

СМ. ТАКЖЕ¶

proc(5)

ЗАМЕЧАНИЯ¶

Эта страница является частью проекта Linux man-pages версии 4.16. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД¶

Русский перевод этой страницы руководства был сделан Alexander Golubev <fatzer2@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Hotellook, Nikita <zxcvbnm3230@mail.ru>, Spiros Georgaras <sng@hellug.gr>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.