Rechercher une page de manuel
sysctl
Langue: fr
Version: 18 juillet 2003 (openSuse - 09/10/07)
Section: 2 (Appels système)
NOM
sysctl - Lire / écrire les paramètres système.SYNOPSIS
#include <unistd.h>#include <linux/unistd.h>
#include <linux/sysctl.h>
_syscall1(int, _sysctl, struct __sysctl_args *, args);
int _sysctl(struct __sysctl_args *args);
DESCRIPTION
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 formestruct __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 regroupée sous le repertoire /proc/sys, puis, si les valeurs réclamées y sont trouvées, appelle les routines appropriées pour lire ou modifier les valeurs.
EXEMPLE
#include <linux/unistd.h> #include <linux/types.h> #include <linux/sysctl.h> _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 RENVOYÉE
_sysctl renvoie 0 s'il réussit, et -1 s'il échoue auquel cas errno contient le code d'erreur.ERREURS
- 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.
- EFAULT
- Demande de lecture de la valeur précédente en fournissant oldval non NULL, mais pas de place disponible dans oldlenp.
CONFORMITÉ
Cet appel système est spécifique Linux et ne doit pas être employé dans les programmes destinés à être portables. Un appem sysctl est présent dans Linux depuis la version 1.3.57. Il existait dans BSD 4.4. Seul Linux dispose du mirroir /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(2) sont identiques sur les deux systèmes.BOGUES
Les noms des objets peuvent varier d'une version à l'autre du noyau. CET APPEL-SYSTEME N'A AUCUN INTERET POUR LES APPLICATIONS. Utilisez l'interface /proc/sys à la place.Tous les objets disponibles ne sont pas proprement documentés.
Il n'est pas possible de changer de système d'exploitation en écrivant dans /proc/sys/kernel/ostype.
VOIR AUSSI
proc(5)TRADUCTION
Christophe Blaess, 1996-2003.Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre