Provided by: manpages-fr-dev_3.32d0.2p4-1_all bug

NOM

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

SYNOPSIS

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

       int _sysctl(struct __sysctl_args *args);

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

       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  qu'il  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.32 du projet man-pages Linux.  Une  description
       du  projet  et  des  instructions  pour  signaler  des  anomalies  peuvent être trouvées à
       l'adresse <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

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

       Christophe  Blaess  <URL:http://www.blaess.fr/christophe/>   (1996-2003),   Alain   Portal
       <URL: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> ».