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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.