НАИМЕНОВАНИЕ

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

ОБЗОР

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

       [[deprecated]] int _sysctl(struct __sysctl_args *args);

ОПИСАНИЕ

       This system call no longer exists on current kernels! See NOTES.

       Системный  вызов  _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.

ИСТОРИЯ

       Linux 1.3.57.  Removed in Linux 5.5, glibc 2.32.

       It  originated  in  4.4BSD.   Only  Linux  has the /proc/sys mirror, and the object naming schemes differ
       between Linux and 4.4BSD, but the declaration of the sysctl()  function is the same in both.

ПРИМЕЧАНИЯ

       Use of this system call was long discouraged: since Linux 2.6.24, uses of  this  system  call  result  in
       warnings  in  the  kernel  log, and in Linux 5.5, the system call was finally removed.  Use the /proc/sys
       interface instead.

       Note that on older kernels where this system call still exists, it is available only if  the  kernel  was
       configured with the CONFIG_SYSCTL_SYSCALL option.  Furthermore, glibc does not provide a wrapper for this
       system call, necessitating the use of syscall(2).

ОШИБКИ

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

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

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

ПРИМЕРЫ

       #define _GNU_SOURCE
       #include <stdio.h>
       #include <stdlib.h>
       #include <string.h>
       #include <sys/syscall.h>
       #include <unistd.h>

       #include <linux/sysctl.h>

       #define ARRAY_SIZE(arr)  (sizeof(arr) / sizeof((arr)[0]))

       int _sysctl(struct __sysctl_args *args);

       #define OSNAMESZ 100

       int
       main(void)
       {
           int                   name[] = { CTL_KERN, KERN_OSTYPE };
           char                  osname[OSNAMESZ];
           size_t                osnamelth;
           struct __sysctl_args  args;

           memset(&args, 0, sizeof(args));
           args.name = name;
           args.nlen = ARRAY_SIZE(name);
           args.oldval = osname;
           args.oldlenp = &osnamelth;

           osnamelth = sizeof(osname);

           if (syscall(SYS__sysctl, &args) == -1) {
               perror("_sysctl");
               exit(EXIT_FAILURE);
           }
           printf("This machine is running %*s\n", (int) osnamelth, osname);
           exit(EXIT_SUCCESS);
       }

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

       proc(5)

ПЕРЕВОД

       Русский перевод этой страницы руководства разработал(и)  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> и Kirill Rekhov <krekhov.dev@gmail.com>

       Этот  перевод является свободной программной документацией; он распространяется на условиях общедоступной
       лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html  версии  3  или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

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

Справочные страницы Linux 6.9.1                  15 июня 2024 г.                                       sysctl(2)