Man Sysctl en français
SYSCTL(2)                 Manuel du programmeur Linux                SYSCTL(2)



 

NOM


       sysctl - Lire/ecrire les parametres systeme.

 

SYNOPSIS


       #include 
       #include 
       #include 
       #include 

       _syscall1(int, _sysctl, struct __sysctl_args *, args)
               /* L'utilisation de syscall(2) est preferable ; voir intro(2) */

       int _sysctl(struct __sysctl_args *args);

 

DESCRIPTION






       L'appel  systeme _sysctl() lit et/ou ecrit les parametres du noyau. Par
       exemple, le nom d'hote  ou  le  nombre  maximum  de  fichiers  ouverts.
       L'argument a la forme

       struct __sysctl_args {
               int *name;        /* integer vector describing variable */
               int nlen;         /* length of this vector */
               void *oldval;     /* 0 or address where to store old value */
               size_t *oldlenp;  /* available room for old value,
                                    overwritten by actual size of old value */
               void *newval;     /* 0 or address of new value */
               size_t newlen;    /* size of new value */
       };

       Cet  appel  effectue  une  recherche  dans  la  structure  arborescente
       regroupee sous le repertoire /proc/sys, puis, si les valeurs  reclamees
       y sont trouvees, appelle les routines appropriees pour lire ou modifier
       les valeurs.


 

EXEMPLE


       #include 
       #include 
       #include 

       _syscall1(int, _sysctl, struct __sysctl_args *, args);
       int sysctl(int *name, int nlen, void *oldval, size_t *oldlenp,
                  void *newval, size_t newlen)
       {
               struct __sysctl_args args={name,nlen,oldval,oldlenp,newval,newlen};
               return _sysctl(&args);
       }

       #define SIZE(x) sizeof(x)/sizeof(x[0])
       #define OSNAMESZ 100

       char osname[OSNAMESZ];
       int osnamelth;
       int name[] = { CTL_KERN, KERN_OSTYPE };

       main(){
               osnamelth = SIZE(osname);
               if (sysctl(name, SIZE(name), osname, &osnamelth, 0, 0))
                       perror("sysctl");
               else
                       printf("Cette machine fonctionne avec %*s\n", osnamelth, osname);
               return 0;
       }


 

VALEUR RENVOYEE


       _sysctl() renvoie 0 s'il reussit, et -1 s'il echoue  auquel  cas  errno
       contient le code d'erreur.

 

ERREURS


       EFAULT Demande de lecture de la valeur precedente en fournissant oldval
              non NULL, mais pas de place disponible dans

 

       ENOTDIR


              name non trouve.

       EPERM  pas de droits de parcours sur l'un des  repertoires  rencontres,
              ou  pas  de permission de lecture avec oldval non nul, ou encore
              pas de permission d'ecriture avec newval non nul.  oldlenp.

 

CONFORMITE


       Cet appel systeme est specifique Linux et ne doit pas etre employe dans
       les  programmes  destines  a  etre  portables.   Un  appel sysctl() est
       present 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 different entre Linux et BSD 4.4, mais les declarations de  la
       fonction sysctl(2) sont identiques sur les deux systemes.

 

BOGUES


       Les  noms  des  objets peuvent varier d'une version a l'autre du noyau.
       CET APPEL-SYSTEME N'A AUCUN INTERET  POUR  LES  APPLICATIONS.  Utilisez
       l'interface /proc/sys a la place.
       Tous les objets disponibles ne sont pas proprement documentes.
       Il  n'est pas possible de changer de systeme d'exploitation en ecrivant
       dans /proc/sys/kernel/ostype.

 

VOIR AUSSI


       proc(5)

 

TRADUCTION


       Ce  document  est  une  traduction  realisee  par   Christophe   Blaess
         le  15 octobre 1996  et  revisee le
       7 decembre 2006.

       L'equipe de traduction a fait le maximum pour realiser  une  adaptation
       francaise de qualite. La version anglaise la plus a jour de ce document
       est  toujours  consultable  via  la  commande :   LANG=C man 2 sysctl .
       N'hesitez  pas  a  signaler  a l'auteur ou au traducteur, selon le cas,
       toute erreur dans cette page de manuel.



Linux 1.3.85                     11 avril 1996                       SYSCTL(2)