.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1993 Michael Haardt (michael@moria.de), .\" Fri Apr 2 11:32:09 MET DST 1993 .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Tue Jul 6 12:42:46 MDT 1993 .\" Added "Calling Directly" and supporting paragraphs .\" .\" Modified Sat Jul 24 15:19:12 1993 by Rik Faith .\" .\" Modified 21 Aug 1994 by Michael Chastain : .\" Added explanation of arg stacking when 6 or more args. .\" .\" Modified 10 June 1995 by Andries Brouwer .\" .\" 2007-10-23 mtk: created as a new page, by taking the content .\" specific to the _syscall() macros from intro(2). .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH _syscall 2 "2 mai 2024" "Pages du manuel de Linux 6.8" .SH NOM _syscall \- Invoquer un appel système sans prise en charge par la bibliothèque (OBSOLÈTE) .SH SYNOPSIS .nf \fB#include \fP .P Une macro _syscall .P L'appel système désiré .fi .SH DESCRIPTION La chose importante à savoir sur un appel système est son prototype. Vous devez savoir combien d'arguments il prend, leurs types et le type retour de la fonction. Il y a sept macros qui facilitent les appels du système. Elles ont la forme : .P .in +4n .EX _syscall\fIX\fP(\fItype\fP,\fInom\fP,\fItype1\fP,\fIarg1\fP,\fItype2\fP,\fIarg2\fP,...) .EE .in .P où .IP \fIX\fP est 0\[en]6, qui est le nombre d'argument pris par l'appel système .IP \fItype\fP est le type de retour de l'appel système .IP \fIname\fP est le nom de l'appel système .IP \fItypeN\fP est le type du Nième paramètre .IP \fIargN\fP est le nom du Nième paramètre .P Ces macros créent une fonction appelée \fIname\fP avec les arguments indiqués. Une fois que vous avez inclus votre _syscall() dans votre fichier source, vous pouvez appeler l'appel système par \fIname\fP. .SH FICHIERS \fI/usr/include/linux/unistd.h\fP .SH STANDARDS Linux. .SH HISTORIQUE À partir de Linux 2.6.18 environ, les macros _syscall ont été supprimées des fichiers d'en\-têtes fournis à l'espace utilisateur. Utilisez \fBsyscall\fP(2) à la place. (Certaines architectures, particulièrement ia64, n'ont jamais fourni les macros _syscall ; sur ces architectures, \fBsyscall\fP(2) était toujours nécessaire.) .SH NOTES Les macros _syscall() \fIne fournissent pas\fP de prototype. Vous devez en créer un, particulièrement les utilisateurs de C++. .P Il n'est pas obligatoire que les appels système retournent un code d'erreur seulement positif ou négatif. Vous devez lire les sources pour savoir comment les erreurs sont retournées. Généralement, il s'agit de la valeur opposée d'un code d'erreur standard, par exemple, \-\fIEPERM\fP. Les macros _syscall() retourneront le résultat \fIr\fP de l'appel système lorsque \fIr\fP n'est pas négatif, mais retournera \-1 et écrira la variable \fIerrno\fP avec \-\fIr\fP lorsque \fIr\fP est négatif. Pour ces codes d'erreurs, consultez \fBerrno\fP(3). .P .\" The preferred way to invoke system calls that glibc does not know .\" about yet is via .\" .BR syscall (2). .\" However, this mechanism can be used only if using a libc .\" (such as glibc) that supports .\" .BR syscall (2), .\" and if the .\" .I .\" header file contains the required SYS_foo definition. .\" Otherwise, the use of a _syscall macro is required. .\" Lors de la définition d'un appel système, les types d'arguments \fIdoivent\fP être passés par valeur ou par pointeur (pour les types aggrégés comme les structures). .SH EXEMPLES .\" SRC BEGIN (_syscall.c) .EX #include #include #include #include /* pour les _syscallX et autres */ #include /* pour struct sysinfo */ \& _syscall1(int, sysinfo, struct sysinfo *, info); \& int main(void) { struct sysinfo s_info; int error; \& error = sysinfo(&s_info); printf("code error = %d\en", error); printf("Uptime = %lds\enLoad: 1 min %lu / 5 min %lu / 15 min %lu\en" "RAM: total %lu / free %lu / shared %lu\en" "Memory in buffers = %lu\enSwap: total %lu / free %lu\en" "Number of processes = %d\en", 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); } .EE .\" SRC END .SS "Échantillon de sortie" .EX code error = 0 uptime = 502034s Load: 1 min 13376 / 5 min 5504 / 15 min 1152 RAM: total 15343616 / free 827392 / shared 8237056 Memory in buffers = 5066752 Swap: total 27881472 / free 24698880 Number of processes = 40 .EE .SH "VOIR AUSSI" \fBintro\fP(2), \fBsyscall\fP(2), \fBerrno\fP(3) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Jean-Philippe MENGUAL . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .