aboutsummaryrefslogtreecommitdiffstats
path: root/man2
diff options
context:
space:
mode:
authorAlejandro Colomar <alx.manpages@gmail.com>2021-05-15 20:20:23 +0200
committerMichael Kerrisk <mtk.manpages@gmail.com>2021-05-17 20:04:30 +1200
commit56cfe81cfb4ee0133c7e16c63cf720b6be0a16a0 (patch)
treec85b91b9b1cd3f60bbaf970636112922b751b321 /man2
parentcc6f5bf20f632fd53540bbc81d75f9401c159e26 (diff)
downloadman-pages-56cfe81cfb4ee0133c7e16c63cf720b6be0a16a0.tar.gz
s390_guarded_storage.2: Use syscall(SYS_...); for system calls without a wrapper
Also document why each header is needed. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man2')
-rw-r--r--man2/s390_guarded_storage.216
1 files changed, 10 insertions, 6 deletions
diff --git a/man2/s390_guarded_storage.2 b/man2/s390_guarded_storage.2
index 1d4cb57775..747c45c3a9 100644
--- a/man2/s390_guarded_storage.2
+++ b/man2/s390_guarded_storage.2
@@ -27,13 +27,20 @@
s390_guarded_storage \- operations with z/Architecture guarded storage facility
.SH SYNOPSIS
.nf
-.B #include <asm/guarded_storage.h>
+.BR "#include <asm/guarded_storage.h> " "/* Definition of " GS_* " constants */"
+.BR "#include <sys/syscall.h> " \
+"/* Definition of " SYS_* " constants */"
+.B #include <unistd.h>
.PP
-.BI "int s390_guarded_storage(int " command ", struct gs_cb *" gs_cb ");"
+.BI "int syscall(SYS_s390_guarded_storage, int " command ,
+.BI " struct gs_cb *" gs_cb );
.fi
.PP
.IR Note :
-There is no glibc wrapper for this system call; see NOTES.
+glibc provides no wrapper for
+.BR s390_guarded_storage (2),
+necessitating the use of
+.BR syscall (2).
.SH DESCRIPTION
The
.BR s390_guarded_storage ()
@@ -144,9 +151,6 @@ This Linux-specific system call is available only on the s390 architecture.
.PP
The guarded storage facility is available beginning with System z14.
.SH NOTES
-Glibc does not provide a wrapper for this system call; call it using
-.BR syscall (2).
-.PP
The description of the guarded storage facility along with related
instructions and Guarded Storage Control Block and
Guarded Storage Event Parameter List structure layouts