intro

NOM

intro, _syscall - Introduction à la section des appels système

DESCRIPTION

Ce chapitre décrit les appels système de Linux. Pour avoir une liste des appels système disponibles dans Linux 2, voyez la page syscalls(2).

Appel Direct

Dans la plupart des cas, il n'est pas nécessaire d'invoquer directement un appel système, mais il arrive parfois que la bibliothèque C standard n'implémente pas une fonction utile. Dans ce cas, le programmeur doit invoquer manuellement l'appel système en utilisant soit une des macros _syscall, soit syscall(2). La dernière technique est décrite dans syscall(2). Cette page décrit les macros _syscall et inclut quelques notes sur quand utiliser l'un ou l'autre mécanisme.

Synopsis

#include <linux/unistd.h>

une macro _syscall

L'appel système désiré

Setup

La chose la plus importante à connaître concernant un appel système est son prototype. Vous devez connaître le nombre d'arguments, leurs types, et le type de retour de la fonction. Il y a 6 macros simplifiant l'appel effectif au système. Elles ont la forme :
_syscallX(type,name,type1,arg1,type2,arg2,...)
avec X dans l'intervalle 0-5, correspondant au nombre d'arguments de l'appel système.
type est le type de la valeur renvoyée par l'appel système.
name est le nom de l'appel système.
typeN est le type du Nième argument.
argN est le nom du Nième argument.
Ces macros créent une fonction appelée name avec les arguments spécifiés. Une fois inclus le _syscall() dans le fichier source, on effectue l'appel système avec name.

FICHIERS

/usr/include/linux/unistd.h

CONFORMITÉ

Des abréviations indiquent les variantes d'Unix, ou les normes dont les appels système sont conformes à la description donnée dans ces pages de manuel. Voir standards(7).

NOTES

La macro _syscall() ne crée pas de prototype. Il faut le fournir vous-même, principalement en C++.

Les appels système ne renvoient pas nécessairement des code d'erreurs tous positifs ou négatifs. Vous devez lire les sources pour vérifier le retour en erreur. Généralement, ce sont des codes d'erreur négatifs, par exemple -EPERM. La macro _syscall() renverra le résultat r de l'appel système quand r est positif ou nul, mais renverra -1 sinon, en positionnant errno à -r quand r est négatif. Pour les codes d'erreur, voir errno(3).

Certains appels système, comme mmap(2), nécessitent plus de cinq arguments. Ceci est géré en plaçant les arguments sur la pile et en passant un pointeur sur le bloc d'arguments.

La méthode préférée pour invoquer des appels système que la glibc ne connait pas encore est de passer par syscall(2). Toutefois, ce mécanisme ne peut être utilisé que si on utilise une libc (comme la glibc) qui supporte syscall(2) et si le fichier en-tête <sys/syscall.h> contient la définition SYS_foo nécessaire. Autrement, l'utilisation d'une macro _syscall est nécessaire.

Certaines architectures, particulièrement ia64, ne fournissent pas de macros _syscall. Sur ces architecture, il faut utiliser syscall(2).

EXEMPLE

 #include <stdio.h>
 #include <errno.h>
 #include <linux/unistd.h>       /* les macros _syscallX */
 #include <linux/kernel.h>       /* pour struct sysinfo  */
 
 _syscall1(int, sysinfo, struct sysinfo *, info);
 
 /*
  * Note : Si vous copiez directement depuis le source nroff
  * de cette page, n'oubliez pas d'enlever les backslashes
  * supplémentaires dans les printf.
  */
 
 int
 main(void)
 {
     struct sysinfo s_info;
     int error;
 
     error = sysinfo(&s_info);
     printf("code d'erreur = %d\n", error);
     printf("Uptime = %lds\nCharge: 1 min %lu / 5 min %lu / 15 min %lu\n"
            "RAM : totale %lu / libre %lu / partagée %lu\n"
            "Mémoire dans tampons = %lu\nSwap : total %lu / libre %lu\n"
            "Nombre de processus = %d\n",
            s_info.uptime, s_info.loads[0],
            s_info.loads[1], s_info.loads[2],
            s_info.totalram, s_info.freeram,
            s_info.sharedram, s_info.bufferram,
            s_info.totalswap, s_info.freeswap,
            s_info.procs);
     exit(EXIT_SUCCESS);
 }
 

Exemple d'exécution

 code d'erreur = 0
 uptime = 502034s
 Charge: 1 min 13376 / 5 min 5504 / 15 min 1152
 RAM: totale 15343616 / libre 827392 / partagée 8237056
 Mémoire dans tampons = 5066752
 Swap: total 27881472 / libre 24698880
 Nombre de processus = 40
 

VOIR AUSSI

syscall(2), errno(3), feature_test_macros(7), standards(7)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 10 octobre 1996 et révisée le 28 novembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 intro ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.