I. NOM

intro - Introduction à la section des appels système

II. DESCRIPTION

La section 2 des manuels décrit les appels système Linux. Un appel système est un point d'entrée dans le noyau Linux. Généralement, les appels système ne sont pas invoqués directement : à la place, la plupart des appels système ont des fonctions enveloppes correspondantes dans la bibliothèque C qui effectuent les étapes nécessaires (par exemple, déroutement (trap) en mode noyau) afin d'invoquer l'appel système. Ainsi, faire un appel système ressemble à la même chose que d'invoquer une fonction de la bibliothèque. Pour avoir une liste des appels système de Linux, consultez la page syscalls(2).

III. VALEUR RENVOYÉE

En cas d'erreur, la plupart des appels système renvoient une valeur d'erreur négative (c'est-à-dire, la valeur opposée de l'une des constantes décrites dans errno(3)). La fonction enveloppe de la bibliothèque C cache ce détail à l'appelant : lorsqu'un appel système renvoie une valeur négative, la fonction enveloppe met dans la variable errno la valeur absolue de cette valeur de retour et renvoie -1 comme sa valeur de retour. La valeur renvoyée par un appel système réussi dépend de l'appel. Beaucoup d'appels système renvoient 0 lorsqu'ils réussissent, mais certains renvoient parfois une valeur non nulle dans ce cas. Les détails sont décrits dans leur page de manuel associée. Dans certains cas, le programmeur doit définir une macro de test de fonctionnalités afin d'obtenir la déclaration d'un appel système du fichier d'en-tête spécifié dans la section SYNOPSIS de la page de manuel (si elle est nécessaire, cette macro de test de fonctionnalités doit être définie avant d'inclure tout fichier d'en(hytête). Dans de tels cas, la macro nécessaire est décrite dans la page de manuel. Pour plus d'informations sur les macros de test de fonctionnalités, consultez feature_test_macros(7).

IV. CONFORMITÉ

Certains termes et abréviations sont utilisés pour indiquer les variantes d'UNIX ou les normes auxquelles les appels de cette section se conforment. Consultez standards(7).

V. NOTES

V-A. Appel Direct

Dans la plupart des cas, il n'est pas nécessaire d'invoquer un appel système directement, mais il arrive parfois que la bibliothèque standard de C n'implémente pas une fonction pourtant utile. Dans ce cas, le programmeur doit invoquer l'appel système à la main, en utilisant syscall(2). Auparavant il était aussi possible d'utiliser les macros _syscall, qui sont décrites dans _syscall(2).

V-B. Auteurs et termes de copyright

Consultez les en-têtes de la source de chaque page de manuel pour connaître le(s) auteur(s) et conditions de copyright. Ils peuvent être différents selon les pages.

VI. VOIR AUSSI

VII. COLOPHON

Cette page fait partie de la publication 3.52 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/.

VIII. TRADUCTION

Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <http://manpagesfr.free.fr/> (2003-2006). Julien Cristau et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».