NOM

       sysctl - Lire/écrire les paramètres système

SYNOPSIS

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

       int _sysctl(struct __sysctl_args *args);

       Remarque :  il  n'existe  pas  de  fonction  glibc autour de cet appel système ; consultez
       NOTES.

DESCRIPTION

       N'utilisez pas cet appel système ! Consultez la section NOTES.

       L'appel système _sysctl() lit et/ou écrit les paramètres du noyau.  Par  exemple,  le  nom
       d'hôte ou le nombre maximal de fichiers ouverts. L'argument a la forme

           struct __sysctl_args {
               int    *name;    /* tableau d'entiers décrivant la variable */
               int     nlen;    /* longueur de ce tableau */
               void   *oldval;  /* 0 ou adresse où stocker l'ancienne valeur */
               size_t *oldlenp; /* espace disponible pour l'ancienne valeur,
                                   remplacé par la taille réelle de cette valeur */
               void   *newval;  /* 0 ou adresse de la nouvelle valeur */
               size_t  newlen;  /* taille de la nouvelle valeur */
           };

       Cet  appel  effectue  une  recherche  dans  la  structure  arborescente  regroupée sous le
       répertoire /proc/sys, puis, si les valeurs réclamées y sont trouvées, appelle les routines
       appropriées pour lire ou modifier les valeurs.

VALEUR RENVOYÉE

       _sysctl()  renvoie  0  s'il  réussit,  et -1 s'il échoue auquel cas errno contient le code
       d'erreur.

ERREURS

       EFAULT Demande de lecture de la valeur précédente en fournissant oldval non NULL, mais pas
              de place disponible dans oldlenp.

       ENOTDIR
              name non trouvé.

       EACCES, EPERM
              Pas  de  droits  de  parcours  sur  l'un  des « répertoires » rencontrés, ou pas de
              permission de lecture avec oldval non nul, ou encore pas de  permission  d'écriture
              avec newval non nul.

CONFORMITÉ

       Cet  appel  système  est  spécifique  à  Linux  et  ne  devrait  pas être employé dans les
       programmes destinés à être portables. Un appel sysctl() est présent dans Linux  depuis  la
       version  1.3.57.  Il  existait dans BSD 4.4. Seul Linux dispose du miroir /proc/sys et les
       conventions de noms d'objets diffèrent entre Linux et BSD 4.4, mais les déclarations de la
       fonction sysctl() sont identiques sur les deux systèmes.

NOTES

       La  glibc  ne  fournit  pas  de  fonction  autour  de cet appel système ; appelez-le "avec
       syscall(2). Ou  plutôt…  ne  l'appelez  pas :  l'utilisation  de  cet  appel  système  est
       déconseillée  depuis  bien  longtemps,  et  il est tellement indésirable qu'il disparaitra
       bientôt dans une prochaine version du noyau. Depuis Linux 2.6.24, les utilisations de  cet
       appel  système  provoquent des avertissements dans le journal du noyau. Supprimez-le dès à
       présent de vos programmes ; utilisez l'interface /proc/sys à la place.

       Cet appel système n'est  disponible  que  si  le  noyau  a  été  configuré  avec  l'option
       CONFIG_SYSCTL_SYSCALL.

BOGUES

       Les noms des objets peuvent varier d'une version à l'autre du noyau, ce qui rend cet appel
       système sans intérêt pour les applications.

       Tous les objets disponibles ne sont pas correctement documentés.

       Il  n'est  pas  possible  de  changer  de  système   d'exploitation   en   écrivant   dans
       /proc/sys/kernel/ostype.

EXEMPLE

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

       int _sysctl(struct __sysctl_args *args );

       #define OSNAMESZ 100

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

           memset(&args, 0, sizeof(struct __sysctl_args));
           args.name = name;
           args.nlen = sizeof(name)/sizeof(name[0]);
           args.oldval = osname;
           args.oldlenp = &osnamelth;

           osnamelth = sizeof(osname);

       int
       main(void)
       {
           if (syscall(SYS__sysctl, &args) == -1) {
               perror("sysctl");
               exit(EXIT_FAILURE);
           }
           printf("Cette machine fonctionne avec %*s\n", osnamelth, osname);
           exit(EXIT_SUCCESS);
       }

VOIR AUSSI

       proc(5)

COLOPHON

       Cette  page  fait partie de la publication 3.57 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe    Blaess    <http://www.blaess.fr/christophe/>   (1996-2003),   Alain   Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Julien  Cristau  et  l'équipe  francophone  de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».