NOM
sysctl - Lire/écrire les paramètres système.
SYNOPSIS
#include <unistd.h>
#include <linux/sysctl.h>
int _sysctl(struct __sysctl_args *args);
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 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
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.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> ».