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

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

Synopsis

Setup

#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 buffers = %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); return(0); }

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 buffers = 5066752
Swap: total 27881472 / libre 24698880
Nombre de processus = 40

La macro _syscall() 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, 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éthose préférée pour invoquer des appels systèmes que la GlibC ne connait pas encore est de passer par syscall(2).

Dans ce paragraphe, des abréviations indiquent les variantes d'Unix, ou des standards dont les appels-système sont conformes à la description donnée dans ces pages de manuel. Il s'agit de :

SVr4

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

SVID

System V Interface Definition, comme décrit 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 également sous le nom de ISO/IEC 9945-1:1990s, ou le nom "IEEE Portable Operating System Interface for Computing Environments", comme indiqué 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) décrivant les options temps-réel des systèmes d'exploitations portables, aussi connu sous le nom de ISO/IEC 9945-1:1996, indiqué dans "Programming for the real world - POSIX.4" de Bill O. Gallmeister (O'Reilly & Associates, Inc. ISBN 1-56592-074-0).

SUS, SUSv2

Single Unix Specification. (Développées par X/Open et l'Open Group. Voir http://www.UNIX-systems.org/version2/ .)

4.3BSD/4.4BSD

Les distributions 4.3 et 4.4 de l'Unix Berkeley BSD était compatible avec 4.3.

V7

Version 7, l'Unix ancestral des Laboratoires Bell.

/usr/include/linux/unistd.h

syscall(2), errno(3)

Christophe Blaess, 1996-2003.