From 56cfe81cfb4ee0133c7e16c63cf720b6be0a16a0 Mon Sep 17 00:00:00 2001
From: Alejandro Colomar <alx.manpages@gmail.com>
Date: Sat, 15 May 2021 20:20:23 +0200
Subject: [PATCH] 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>
---
 man2/s390_guarded_storage.2 | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/man2/s390_guarded_storage.2 b/man2/s390_guarded_storage.2
index 1d4cb5777..747c45c3a 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