Loading

NOM

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

SYNOPSIS

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

       int _sysctl(struct __sysctl_args *args);

       Nutilisez 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  maximum  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é.

       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 ;
       utilisez syscall(2) pour l’appeler.

       Ou plutôt... ne l’appelez pas : l’utilisation de cet appel système  est
       déconseillée  depuis  bien  longtemps,  et  il est tellemnt indésirable
       quil  disparaitra  bientôt  dans  une  prochaine  version  du   noyau.
       Supprimez-le  dès  à  présent  de vos programmes ; Utilisez l’interface
       /proc/sys à la place.

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.23  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

       Cette  page  de  manuel  a  été  traduite et mise à jour par Christophe
       Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis  par
       Alain  Portal  <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Julien Cristau <jcristau@debian.org> et l’équipe
       francophone de traduction de Debian.

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