LDP: Update original to LDP v3.68

[linuxjm/LDP_man-pages.git] / original / man2 / _syscall.2

diff --git a/original/man2/_syscall.2 b/original/man2/_syscall.2
index 82d2319..694740d 100644 (file)
--- a/original/man2/_syscall.2
+++ b/original/man2/_syscall.2
@@ -57,21 +57,29 @@ They have the form:
 .PP
 where
 .IP
-\fIX\fP is 0\(en6, which are the number of arguments taken by the
+.I X
+is 0\(en6, which are the number of arguments taken by the
 system call
 .IP
-\fItype\fP is the return type of the system call
+.I type
+is the return type of the system call
 .IP
-\fIname\fP is the name of the system call
+.I name
+is the name of the system call
 .IP
-\fItypeN\fP is the Nth argument's type
+.I typeN
+is the Nth argument's type
 .IP
-\fIargN\fP is the name of the Nth argument
+.I argN
+is the name of the Nth argument
 .PP
-These macros create a function called \fIname\fP with the arguments you
+These macros create a function called
+.I name
+with the arguments you
 specify.
 Once you include the _syscall() in your source file,
-you call the system call by \fIname\fP.
+you call the system call by
+.IR name .
 .SH FILES
 .I /usr/include/linux/unistd.h
 .SH CONFORMING TO
@@ -87,7 +95,9 @@ on those architectures,
 .BR syscall (2)
 was always required.)
 
-The _syscall() macros \fIdo not\fP produce a prototype.
+The _syscall() macros
+.I "do not"
+produce a prototype.
 You may have to
 create one, especially for C++ users.
 
@@ -95,15 +105,26 @@ System calls are not required to return only positive or negative error
 codes.
 You need to read the source to be sure how it will return errors.
 Usually, it is the negative of a standard error code,
-for example, \-\fBEPERM\fP.
-The _syscall() macros will return the result \fIr\fP of the system call
-when \fIr\fP is nonnegative, but will return \-1 and set the variable
+for example,
+.RI \- EPERM .
+The _syscall() macros will return the result
+.I r
+of the system call
+when
+.I r
+is nonnegative, but will return \-1 and set the variable
 .I errno
-to \-\fIr\fP when \fIr\fP is negative.
+to
+.RI \- r
+when
+.I r
+is negative.
 For the error codes, see
 .BR errno (3).
 
-When defining a system call, the argument types \fImust\fP be
+When defining a system call, the argument types
+.I must
+be
 passed by-value or by-pointer (for aggregates like structs).
 .\" The preferred way to invoke system calls that glibc does not know
 .\" about yet is via
@@ -164,3 +185,12 @@ Number of processes = 40
 .BR intro (2),
 .BR syscall (2),
 .BR errno (3)
+.SH COLOPHON
+This page is part of release 3.68 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.