sysctl

SYSCTL(2)                 Manuel du programmeur Linux                SYSCTL(2)



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.70 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 Ã
       <perkamon-fr@traduc.org>.

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



Linux                          22 décembre 2012                     SYSCTL(2)