bionic (2) sysctl.2.gz

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.65 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> ».