summaryrefslogtreecommitdiffstats
path: root/man2/intro.2
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:41:07 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:41:07 +0000
commit3af6d22bb3850ab2bac67287e3a3d3b0e32868e5 (patch)
tree3ee7a3ec64525911fa865bb984c86d997d855527 /man2/intro.2
parentAdding debian version 6.05.01-1. (diff)
downloadmanpages-3af6d22bb3850ab2bac67287e3a3d3b0e32868e5.tar.xz
manpages-3af6d22bb3850ab2bac67287e3a3d3b0e32868e5.zip
Merging upstream version 6.7.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man2/intro.2')
-rw-r--r--man2/intro.212
1 files changed, 6 insertions, 6 deletions
diff --git a/man2/intro.2 b/man2/intro.2
index ef3d8cf..74af07c 100644
--- a/man2/intro.2
+++ b/man2/intro.2
@@ -6,7 +6,7 @@
.\" new _syscall(2) page, and substantially enhanced and rewrote
.\" the remaining material on this page.
.\"
-.TH intro 2 2023-02-05 "Linux man-pages 6.05.01"
+.TH intro 2 2023-10-31 "Linux man-pages 6.7"
.SH NAME
intro \- introduction to system calls
.SH DESCRIPTION
@@ -19,7 +19,7 @@ wrapper functions which perform the steps required
the system call.
Thus, making a system call looks the same as invoking a normal
library function.
-.PP
+.P
In many cases, the C library wrapper function does nothing more than:
.IP \[bu] 3
copying arguments and the unique system call number to the
@@ -32,7 +32,7 @@ setting
.I errno
if the system call returns an error number when the kernel returns the
CPU to user mode.
-.PP
+.P
However, in a few cases, a wrapper function may do rather more than this,
for example, performing some preprocessing
of the arguments before trapping to kernel mode,
@@ -42,7 +42,7 @@ try to note the details of both the (usually GNU) C library API
interface and the raw system call.
Most commonly, the main DESCRIPTION will focus on the C library interface,
and differences for the system call are covered in the NOTES section.
-.PP
+.P
For a list of the Linux system calls, see
.BR syscalls (2).
.SH RETURN VALUE
@@ -54,12 +54,12 @@ system call returns a negative value, the wrapper copies the
absolute value into the
.I errno
variable, and returns \-1 as the return value of the wrapper.
-.PP
+.P
The value returned by a successful system call depends on the call.
Many system calls return 0 on success, but some can return nonzero
values from a successful call.
The details are described in the individual manual pages.
-.PP
+.P
In some cases,
the programmer must define a feature test macro in order to obtain
the declaration of a system call from the header file specified