NAZWA

       sysctl - odczytuje/zapisuje parametry systemu

SKŁADNIA

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

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

OPIS

       To wywołanie systemowe już nie istnieje w aktualnych jądrach! Zob. UWAGI.

       _sysctl() odczytuje i/lub ustawia parametry jądra. Na przykład: nazwę stacji, maksymalną liczbę otwartych
       plików. Argument wywołania ma postać

           struct __sysctl_args {
                   int    *name;       /* wektor liczb całkowitych opisujący zmienną */
                   int     nlen;       /* długość tego wektora */
                   void   *oldval;     /* 0 lub adres, gdzie zachować starą wartość */
                   size_t *oldlenp;    /* ilość miejsca na starą wartość,
                                          nadpisywana przez rzeczywisty jej rozmiar */
                   void   *newval;     /* 0 lub adres nowej wartości */
                   size_t  newlen;     /* rozmiar nowej wartości */
           };

       Wywołanie  to  dokonuje  przeszukiwania  struktury  drzewiastej,  prawdopodobnie  przypominającej  drzewo
       katalogowe z /proc/sys, i jeśli żądany element  zostanie  znaleziony,  wywołuje  odpowiednią  funkcję  do
       odczytania lub zmodyfikowania wartości.

WARTOŚĆ ZWRACANA

       Po  pomyślnym  zakończeniu, _sysctl() zwraca 0. W przeciwnym wypadku zwracane jest -1 i ustawiane errno w
       sposób określający rodzaj błędu.

BŁĘDY

       EACCES
       EPERM  Brak uprawnień do przeszukiwania jednego z napotkanych „katalogów”, lub  brak  praw  odczytu,  gdy
              oldval było niezerowe, lub brak praw zapisu, gdy newval było niezerowe.

       EFAULT Wywołanie  żądało  poprzedniej  wartości  przez  ustawienie oldval na nie-NULL, lecz zezwalając na
              zerową wielkość w oldlenp.

       ENOTDIR
              name nie zostało znalezione.

STANDARDY

       Linux.

HISTORIA

       Linux 1.3.57. Usunięte w: Linuksie 5.5, glibc 2.32.

       Pochodzi z 4.4BSD. Jedynie Linux posiada jego odwzorowanie w /proc/sys  a  konwencje  nazywania  obiektów
       różnią się między Linuksem i 4.4BSD, lecz deklaracja funkcji sysctl() jest taka sama w obu przypadkach.

UWAGI

       Używanie  tego  wywołania systemowego było od dawna odradzane: od Linuksa 2.6.24, korzystanie z wywołania
       powodowało wypisywanie ostrzeżeń w dzienniku jądra, a w Linuksie 5.5 ostatecznie je  usunięto.  W  zamian
       należy używać interfejsu /proc/sys.

       Proszę  zauważyć, że na starszych jądrach, w których to wywołanie systemowe wciąż istnieje, jest dostępne
       jedynie, jeśli jądro  skonfigurowano  z  opcją  CONFIG_SYSCTL_SYSCALL.  Co  więcej,  glibc  nie  zapewnia
       opakowania tego wywołania, co zmusza do korzystania z syscall(2).

USTERKI

       Nazwy  obiektów  różnią  się  między  wersjami  jądra,  czyniąc  to wywołanie systemowe bezużytecznym dla
       aplikacji.

       Nie wszystkie dostępne obiekty są odpowiednio udokumentowane.

       Nie jest jeszcze możliwe zmienianie systemu operacyjnego przez zapis do /proc/sys/kernel/ostype.

PRZYKŁADY

       #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("Na tym komputerze działa %*s\n", (int) osnamelth, osname);
           exit(EXIT_SUCCESS);
       }

ZOBACZ TAKŻE

       proc(5)

TŁUMACZENIE

       Autorami polskiego tłumaczenia niniejszej strony podręcznika  są:  Przemek  Borys  <pborys@dione.ids.pl>,
       Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl> i Michał Kułach <michal.kulach@gmail.com>

       Niniejsze  tłumaczenie  jest  wolną  dokumentacją.  Bliższe informacje o warunkach licencji można uzyskać
       zapoznając  się  z  GNU General Public License w wersji 3  lub  nowszej.   Nie   przyjmuje   się   ŻADNEJ
       ODPOWIEDZIALNOŚCI.

       Błędy  w  tłumaczeniu  strony  podręcznika  prosimy  zgłaszać  na  adres  listy  dyskusyjnej manpages-pl-
       list@lists.sourceforge.net.

Linux man-pages 6.8                              2 maja 2024 r.                                        sysctl(2)