.\" -*- coding: UTF-8 -*-
.\" Copyright (C) 1996 Andries Brouwer (aeb@cwi.nl)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" Written 11 April 1996 by Andries Brouwer <aeb@cwi.nl>
.\" 960412: Added comments from Stephen Tweedie
.\" Modified Tue Oct 22 22:28:41 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified Mon Jan  5 20:31:04 1998 by aeb.
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH sysctl 2 "31 октября 2023 г." "Linux man\-pages 6.06" 
.SH ИМЯ
sysctl \- читает/записывает параметры системы
.SH СИНТАКСИС
.nf
\fB#include <unistd.h>\fP
\fB#include <linux/sysctl.h>\fP
.P
\fB[[deprecated]] int _sysctl(struct __sysctl_args *\fP\fIargs\fP\fB);\fP
.fi
.SH ОПИСАНИЕ
\fBThis system call no longer exists on current kernels!\fP See NOTES.
.P
Системный вызов \fB_sysctl\fP считывает и/или изменяет параметры ядра. К ним
относятся, например, имя машины или максимальное количество открытых
файлов. Параметр имеет следующую структуру:
.P
.in +4n
.EX
struct __sysctl_args {
    int    *name;    /* целочисленный вектор, описывающий
                        переменную */
    int     nlen;    /* длина этого вектора */
    void   *oldval;  /* 0 или адрес старого значения */
    size_t *oldlenp; /* размер старого значения, заменяется
                        реальным размером старого значения */
    void   *newval;  /* 0 или адрес нового значения */
    size_t  newlen;  /* размер нового значения */
};
.EE
.in
.P
Этот вызов производит поиск в древовидной структуре, возможно, похожей на
структуру каталогов \fI/proc/sys\fP, и, если запрашиваемый элемент найден,
вызывает соответствующую процедуру, читающую или изменяющую значение.
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
При успешном выполнении \fB_sysctl\fP() возвращает 0. При ошибке возвращается
\-1, а переменной \fIerrno\fP присваивается номер ошибки.
.SH ОШИБКИ
.TP 
\fBEACCES\fP
.TQ
\fBEPERM\fP
Нет прав на поиск в одном из встретившихся «каталогов» или нет прав на
чтение, если \fIoldval\fP не равно нулю; или нет прав на запись, если \fInewval\fP
не равно нулю.
.TP 
\fBEFAULT\fP
Был сделан запрос предыдущего значения путём установки не\-NULL значения
\fIoldval\fP, но размер места под него в \fIoldlenp\fP равен нулю.
.TP 
\fBENOTDIR\fP
\fIname\fP не найден.
.SH СТАНДАРТЫ
Linux.
.SH ИСТОРИЯ
Linux 1.3.57.  Removed in Linux 5.5, glibc 2.32.
.P
It originated in 4.4BSD.  Only Linux has the \fI/proc/sys\fP mirror, and the
object naming schemes differ between Linux and 4.4BSD, but the declaration
of the \fBsysctl\fP()  function is the same in both.
.SH ЗАМЕЧАНИЯ
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 \fI/proc/sys\fP interface instead.
.P
Note that on older kernels where this system call still exists, it is
available only if the kernel was configured with the
\fBCONFIG_SYSCTL_SYSCALL\fP option.  Furthermore, glibc does not provide a
wrapper for this system call, necessitating the use of \fBsyscall\fP(2).
.SH ДЕФЕКТЫ
Названия объектов различаются в разных версиях ядра, что делает данный вызов
в приложениях бесполезным.
.P
Не все существующие объекты описаны соответствующим образом.
.P
В настоящее время невозможно изменить тип операционной системы путём записи
в файл \fI/proc/sys/kernel/ostype\fP.
.SH ПРИМЕРЫ
.\" SRC BEGIN (sysctl.c)
.EX
#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\en", (int) osnamelth, osname);
    exit(EXIT_SUCCESS);
}
.EE
.\" SRC END
.SH "СМ. ТАКЖЕ"
\fBproc\fP(5)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
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>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .