.\"
.\" Copyright (c) 1993 Michael Haardt (u31b3hs@pool.informatik.rwth-aachen.de), Fri Apr  2 11:32:09 MET DST 1993
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
.\" USA.
.\"
.\" Tue Jul  6 12:42:46 MDT 1993 (dminer@nyx.cs.du.edu)
.\" Added "Calling Directly" and supporting paragraphs
.\"
.\" Modified Sat Jul 24 15:19:12 1993 by Rik Faith (faith@cs.unc.edu)
.\"
.\" Modified 21 Aug 1994 by Michael Chastain (mec@shell.portal.com):
.\"   Added explanation of arg stacking when 6 or more args.
.\"
.\" Modified 10 June 1995 by Andries Brouwer (aeb@cwi.nl)
.\"
.\" 
.\" Traduction  10/10/1996 Christophe BLAESS (ccb@club-internet.fr)
.\" Mise a jour 8/04/97
.\" Mise  jour 21/09/1998 LDP-man-pages-1.20
.TH INTRO 2 "21 Septembre 1998" "Linux" "Manuel du programmeur Linux"
.SH NOM
intro \- Introduction  la section des appels systmes.
.SH DESCRIPTION
Ce chapitre dcrit les appels systmes de Linux.
Pour avoir une liste des 164 appels systmes disponibles dans Linux 2.0,
voyez la page syscalls(2). 
.SS "Appel Direct"
Dans la plupart des cas il n'est pas ncessaire d'invoquer directement
un appel systme, mais il arrive parfois que la bibliothque C standard
n'implmente pas une fonction utile.
.SS "Synopsis"
#include <linux/unistd.h>

une macro _syscall

L'appel systeme dsir

.SS Setup

La chose la plus importante  connatre concernant un appel systme
est son prototype. Vous devez connatre le nombre d'arguments, leurs
types, et le type de retour de la fonction.
Il y a 6 macros simplifiant l'appel effectif au systme.
Elles ont la forme :
.sp
.RS
.RI _syscall X ( type , name , type1 , arg1 , type2 , arg2 ,...)
.RS
.HP 1.0i
avec \fIX\fP dans l'intervalle 0\(en5, correspondant au nombre d'arguments
de l'appel systme.
.HP
\fItype\fP est le type de la valeur renvoye par l'appel systme.
.HP
\fIname\fP est le nom de l'appel systme.
.HP
\fItypeN\fP est le type du Nime argument.
.HP
\fIargN\fP est le nom du Nime argument.
.RE
.RE
.sp
Ces macros crent une fonction appele \fIname\fP avec les arguments
spcifis. Une fois inclus le  _syscall() dans le fichier source,
on effectue l'appel systme avec \fIname\fP.
.SH EXEMPLE
.nf
.sp
#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
 * supplmentaires 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"
                "Mmoire 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);
}
.fi
.SH "EXEMPLE D'XCUTION"
.nf
code d'erreur = 0
uptime = 502034s
Charge: 1 min 13376 / 5 min 5504 / 15 min 1152
RAM: totale 15343616 / libre 827392 / partagee 8237056
Mmoire dans buffers = 5066752
Swap: total 27881472 / libre 24698880
Nombre de processus = 40
.fi
.SH NOTES
La macro _syscall() ne cre
.B pas
de prototype. Il faut le fournir vous\-mme, principalement en C++.
.sp
Les appels systmes ne renvoient pas ncessairement des code d'erreurs
tous positifs ou ngatifs. Vous devez lire les sources pour vrifier
le retour en erreur. Gnralement, ce sont des codes d'erreur ngatifs,
par exemple \-\fBEPERM\fP.

La macro _syscall() renverra le rsultat \fIr\fP de l'appel systme
quand \fIr\fP est positif ou nul, mais renverra \-1 sinon, en
positionnant la variable
.I errno
a \-\fIr\fP.
.sp
Certains appels systmes, comme
.BR mmap ,
ncessitent plus de cinq arguments. Ceci est gr en plaant les
arguments sur la pile et en passant un pointeur sur le bloc d'arguments.
.SH CONFORMIT
Dans ce paragraphe, des abrviations indiquent les variantes d'Unix,
ou des standards dont les appels-systmes sont conformes  la description
donne dans ces pages de manuel. Il s'agit de :
.TP
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)
.TP
SVID
System V Interface Definition, comme dcrit dans "The System V Interface
Definition, Fourth Edition", disponible
ftp://ftp.fpk.novell.com/pub/unix-standards/svid sous forme de fichier Postscript.
.TP
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.
.TP
POSIX.1b
IEEE Std 1003.1b-1993 (POSIX.1b standard) dcrivant les options temps-rel
des systmes 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).
.TP
4.3BSD/4.4BSD
Les distributions 4.3 et 4.4 de l'Unix Berkeley BSD tait compatible
avec 4.3.
.TP
V7
Version 7, l'Unix ancestral des Laboratoires Bell.
.SH FICHIERS
.I /usr/include/linux/unistd.h
.SH AUTEURS
Dans l'en-tte de la page de manuel se trouvent le nom des auteurs
et les conditions de copyright. Ceci peut changer suivant les pages !

.SH VERSION FRANCAISE

La traduction de la section 2 des pages de manuel a t effectue en
tentant de rester le plus fidle possible au texte original.
Il nous est arriv cependant d'ajouter certains commentaires explicatifs
supplmentaires, et mme quelques exemples.

Dans la partie 
.B NOM 
des pages, on trouvera souvent entre parenthses
un terme anglais correspondant au mot franais. Loin de nous
l'ide de vouloir expliquer au lecteur que
.I filesystem
signifie
.I systme de fichiers,
mais ceci largit les possibilits de
recherche des pages avec la commande
.IR apropos (1)

Pour que cette commande fonctionne, il vous faut modifier le script
.B makewhatis
(souvent dans /usr/sbin) afin qu'il accepte l'identificateur de
section 
.B NOM
 galit avec
.BR NAME.


Nous avons galement uniformis l'ensemble des en-ttes et bas de pages
de la section 2.

.SH TRADUCTION
Christophe Blaess, 1997.