INTRO(2)

NOM
intro - Introduction a la section des appels systemes.

DESCRIPTION
Ce chapitre decrit les appels systemes de Linux.

  Appel Direct
Dans la plupart des cas il n'est pas necessaire d'invoquer directement un appel systeme, mais il arrive parfois que la bibliotheque C standard n'implemente pas une fonction utile.

  Synopsis
#include <linux/unistd.h> une macro _syscall L'appel systeme desire

  Setup
La chose la plus importante a connaitre concernant un appel systeme est son prototype. Vous devez connaitre le nombre d'arguments, leurs types, et le type de retour de la fonction. Il y a 6 macros simplifiant l'appel effectif au systeme. 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 systeme.

        type est le type de la valeur renvoyee par l'appel systeme.

        name est le nom de l'appel systeme.

        typeN est le type du Nieme argument.

        argN est le nom du Nieme argument.

Ces macros creent une fonction appelee name avec les arguments specifies. Une fois inclus le _syscall() dans le fichier source, on effectue l'appel systeme avec name.

EXEMPLE

#include <stdio.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
 * supplementaires 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 = %ds\nCharge: 1 min %d / 5 min %d / 15 min %d\n"
                "RAM: totale %d / libre %d / partagee %d\n"
                "Memoire dans buffers = %d\nSwap: total %d / libre %d\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);
	return(0);
}

EXEMPLE D'EXECUTION
code d'erreur = 0
uptime = 502034s
Charge: 1 min 13376 / 5 min 5504 / 15 min 1152
RAM: totale 15343616 / libre 827392 / partagee 8237056
Memoire dans buffers = 5066752
Swap: total 27881472 / libre 24698880
Nombre de processus = 40

NOTES
La macro _syscall() ne cree pas de prototype. Il faut le fournir vous-meme, principalement en C++.

Les appels systemes ne renvoient pas necessairement des code d'erreurs tous positifs ou negatifs. Vous devez lire les sources pour verifier le retour en erreur. Generalement, ce sont des codes d'erreur negatifs, par exemple -EPERM. La macro _syscall() renverra le resultat r de l'appel systeme quand r est positif ou nul, mais renverra -1 sinon, en positionnant la variable errno a -r.

Certains appels systemes, comme mmap, necessitent plus de cinq arguments. Ceci est gere en placant les arguments sur la pile et en passant un pointeur sur le bloc d'arguments.

CONFORMITE
Dans ce paragraphe, des abbreviations indiquent les variantes d'Unix, ou des standards dont les appels-systemes sont conformes a la description donnee dans ces pages de manuel. Il s'agit de :

SVr4
    System V Release 4 Unix, comme indique dans "Programmer's Reference Manual: Operating System API (Intel processors)" (Prentice-Hall 1992, ISBN 0-13-951294-2)

SVID
    System V Interface Definition, comme descrit dans "The System V Interface Definition, Fourth Edition", disponible ftp://ftp.fpk.novell.com/pub/unix-standards/svid sous forme de fichier Postscript.

POSIX.1
    IEEE 1003.1-1990 part 1, connu egalement sous le nom de ISO/IEC 9945-1:1990s, ou le nom "IEEE Portable Operating System Interface for Computing Environments", comme indique dans Donald Lewine "POSIX Programmer's Guide" (O'Reilly & Associates, Inc., 1991, ISBN 0-937175-73-0.

POSIX.1b
    IEEE Std 1003.1b-1993 (POSIX.1b standard) decrivant les options temps-reel des systemes d'exploitations portables, aussi connu sous le nom de ISO/IEC 9945-1:1996, indique dans "Programming for the real world - POSIX.4" de Bill O. Gallmeister (O'Reilly & Associates, Inc. ISBN 1-56592-074-0).

4.3BSD/4.4BSD
    Les distributions 4.3 et 4.4 de l'Unix Berkeley Unix. 4.4BSD etait compatible avec 4.3.

V7  Version 7, l'Unix ancestral des Laboratoires Bell.

FICHIERS
/usr/include/linux/unistd.h

AUTEURS
Dans l'en-tete de la page de manuel se trouvent le nom des auteurs et les conditions de copyright. Ceci peut changer suivant les pages !

VERSION FRANCAISE
La traduction de la section 2 des pages de manuel a ete effectuee en tentant de rester le plus fidele possible au texte original. Il nous est arrive cependant d'ajouter certains commentaires explicatifs supplementaires, et meme quelques exemples. Dans la partie NOM des pages, on trouvera souvent entre parentheses un terme anglais correspondant au mot francais. Loin de nous l'idee de vouloir expliquer au lecteur que filesystem signifie systeme de fichiers, mais ceci elargit les possibilites de recherche des pages avec la commande apropos(1) Pour que cette commande fonctionne, il vous faut modifier le script makewhatis (souvent dans /usr/sbin) afin qu'il accepte l'identificateur de section NOM a egalite avec NAME. Nous avons egalement uniformise l'ensemble des en-tetes et bas de pages de la section 2.