git.infodrom.org Git - infodrom/manpages-de/blob - man2/sysctl.2

   1 .\" Copyright (C) 1996 Andries Brouwer (aeb@cwi.nl)
   2 .\"
   3 .\" Permission is granted to make and distribute verbatim copies of this
   4 .\" manual provided the copyright notice and this permission notice are
   5 .\" preserved on all copies.
   6 .\"
   7 .\" Permission is granted to copy and distribute modified versions of this
   8 .\" manual under the conditions for verbatim copying, provided that the
   9 .\" entire resulting derived work is distributed under the terms of a
  10 .\" permission notice identical to this one
  11 .\"
  12 .\" Since the Linux kernel and libraries are constantly changing, this
  13 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  14 .\" responsibility for errors or omissions, or for damages resulting from
  15 .\" the use of the information contained herein.  The author(s) may not
  16 .\" have taken the same level of care in the production of this manual,
  17 .\" which is licensed free of charge, as they might when working
  18 .\" professionally.
  19 .\"
  20 .\" Formatted or processed versions of this manual, if unaccompanied by
  21 .\" the source, must acknowledge the copyright and authors of this work.
  22 .\"
  23 .\" Written 11 April 1996 by Andries Brouwer (aeb@cwi.nl)
  24 .\" 960412: Added comments from Stephen Tweedie
  25 .\" Translated to German Mon Jun 24 13:15:00 1996 by Patrick Rother <krd@gulu.net>
  26 .\"
  27 .TH SYSCTL 2 "24. Juni 1996" "Linux 1.3.85" "Bibliotheksfunktionen"
  28 .SH NAME
  29 sysctl \- lese/schreibe Systemparameter
  30 .SH ÜBERSICHT
  31 .B #include <unistd.h>
  32 .sp
  33 .B #include <linux/unistd.h>
  34 .sp
  35 .B #include <linux/sysctl.h>
  36 .sp
  37 .B _syscall1(int, _sysctl, struct __sysctl_args *, args);
  38 .sp
  39 .BI "int _sysctl(struct __sysctl_args *" args );
  40 .SH BESCHREIBUNG
  41 Der Aufruf
  42 .B _sysctl
  43 liest und/oder schreibt Kernel-Parameter, zum Beispiel den Rechnernamen
  44 oder die maximale Anzahl geöffneter Dateien.  Das Argument hat die Form
  45 .PP
  46 .nf
  47 struct __sysctl_args {
  48         int *name;        /* ganzzahliger Vektor, der eine Variable
  49                              beschreibt */
  50         int nlen;         /* Länge dieses Vektors */
  51         void *oldval;     /* 0 oder Adresse, wo der alte Wert gespeichert
  52                              werden soll */
  53         size_t *oldlenp;  /* freier Raum für den alten Wert, überschrieben
  54                              durch die aktuelles Größe des alten Wertes */
  55         void *newval;     /* 0 oder Adresse des neuen Wertes */
  56         size_t newlen;    /* Länge des neuen Wertes */
  57 };
  58 .fi
  59 .PP
  60 Dieser Aufruf sucht in einer Baumstruktur, die möglicherweise
  61 einer Verzeichnisstruktur unter
  62 .BR /proc/sys
  63 ähnelt, und ruft, wenn der geforderte Punkt gefunden wird, eine entsprechende
  64 Routine auf, um den Wert zu lesen oder zu verändern.
  65
  66 .SH "BEISPIEL"
  67 .nf
  68 #include <linux/unistd.h>
  69 #include <linux/types.h>
  70 #include <linux/sysctl.h>
  71
  72 _syscall1(int, _sysctl, struct __sysctl_args *, args);
  73 int sysctl(int *name, int nlen, void *oldval, size_t *oldlenp,
  74            void *newval, size_t newlen)
  75 {
  76         struct __sysctl_args args={name,nlen,oldval,oldlenp,newval,newlen};
  77         return _sysctl(&args);
  78 }
  79
  80 #define SIZE(x) sizeof(x)/sizeof(x[0])
  81 #define OSNAMESZ 100
  82
  83 char osname[OSNAMESZ];
  84 int osnamelth;
  85 int name[] = { CTL_KERN, KERN_OSTYPE };
  86
  87 main(){
  88         osnamelth = SIZE(osname);
  89         if (sysctl(name, SIZE(name), osname, &osnamelth, 0, 0))
  90                 perror("sysctl");
  91         else
  92                 printf("This machine is running %*s\en", osnamelth, osname);
  93         return 0;
  94 }
  95 .fi
  96
  97 .SH "RÜCKGABEWERTE"
  98 Bei erfolgreicher beendigung gibt
  99 .B _sysctl
 100 0 zurück. Anderenfalls wird ein Wert von \-1 zurückgegeben und
 101 .I errno
 102 gesetzt, um den Fehler anzuzeigen.
 103 .SH FEHLER
 104 .TP
 105 .B ENOTDIR
 106 .I name
 107 wurde nicht gefunden.
 108 .TP
 109 .B EPERM
 110 Keine Such-Berechtigung für eines der auftretenden `Verzeichnisse',
 111 oder keine Leseberechtigung wenn
 112 .I oldval
 113 nicht null war, oder keine Schreibberechtigung wenn
 114 .I newval
 115 nicht null war.
 116 .TP
 117 .B EFAULT
 118 Der Aufruf fragte nach dem vorherigen Wert durch setzen von
 119 .I oldval
 120 auf nicht null, aber erlaubte Null Raum in
 121 .IR oldlenp .
 122 .SH "KONFORM ZU"
 123 Dieser Aufruf ist Linux-spezifisch.
 124 .SH GESCHICHTE
 125 Einen Aufruf
 126 .B sysctl
 127 gibt es in Linux seit Version 1.3.57.  Er entstand in BSD-4.4.
 128 Ausschließlich Linux hat das Abbild
 129 .IR /proc/sys .
 130 Schemata der Objektbenennung unterscheiden sich in Linux und BSD 4.4,
 131 aber die Deklaration der Funktion
 132 .BR sysctl (2)
 133 sind in beiden die gleiche.
 134 .SH BUGS
 135 Nicht alles verfügbaren Objekte sind richtig dokumentiert.
 136 .br
 137 Es ist noch nicht möglich, das Betriebssystem durch schreiben nach
 138 .IR /proc/sys/kernel/ostype
 139 zu ändern.
 140 .SH "SIEHE AUCH"
 141 .BR proc (5).