-.TH S390_GUARDED_STORAGE 2 2018-01-14 "Linux Programmer's Manual"
+.\" Copyright (C) 2018 Eugene Syromyatnikov <evgsyr@gmail.com>
+.\"
+.\" %%%LICENSE_START(VERBATIM)
+.\" Permission is granted to make and distribute verbatim copies of this
+.\" manual provided the copyright notice and this permission notice are
+.\" preserved on all copies.
+.\"
+.\" Permission is granted to copy and distribute modified versions of this
+.\" manual under the conditions for verbatim copying, provided that the
+.\" entire resulting derived work is distributed under the terms of a
+.\" permission notice identical to this one.
+.\"
+.\" Since the Linux kernel and libraries are constantly changing, this
+.\" manual page may be incorrect or out-of-date. The author(s) assume no
+.\" responsibility for errors or omissions, or for damages resulting from
+.\" the use of the information contained herein. The author(s) may not
+.\" have taken the same level of care in the production of this manual,
+.\" which is licensed free of charge, as they might when working
+.\" professionally.
+.\"
+.\" Formatted or processed versions of this manual, if unaccompanied by
+.\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
+.\"
+.TH S390_GUARDED_STORAGE 2 2019-03-06 "Linux Programmer's Manual"
.SH NAME
s390_guarded_storage \- operations with z/Architecture guarded storage facility
.SH SYNOPSIS
.\" http://publibfi.boulder.ibm.com/epubs/pdf/dz9zr011.pdf
The guarded storage facility is a hardware feature that allows marking up to
64 memory regions (as of z14) as guarded;
-reading a pointer with a newly introduced "Load Guarded" (LGG) or "Load Logical
-and Shift Guarded" (LLGFSG) instructions will cause a range check on the loaded
-value and invoke a (previously set up) user-space handler if one of the guarded
-regions is affected.
+reading a pointer with a newly introduced "Load Guarded" (LGG)
+or "Load Logical and Shift Guarded" (LLGFSG) instructions will cause
+a range check on the loaded value and invoke a (previously set up)
+user-space handler if one of the guarded regions is affected.
.PP
The
.\" The command description is copied from v4.12-rc1~139^2~56^2 commit message
.PP
The
.I gs_cb
-argument specifies the address of a guarded storage control block structure and
-is currently used only by the
+argument specifies the address of a guarded storage control block structure
+and is currently used only by the
.B GS_SET_BC_CB
command; all other aforementioned commands ignore this argument.
.SH RETURN VALUE
.BR syscall (2)
to call it.
.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 is available in "z/Architecture Principles of Operations"
+The description of the guarded storage facility along with related
+instructions and Guarded Storage Control Block and
+Guarded Storage Event Parameter List structure layouts
+is available in "z/Architecture Principles of Operations"
beginning from the twelfth edition.
.PP
The
structure has a field
.I gsepla
(Guarded Storage Event Parameter List Address), which is a user-space pointer
-to a Guarded Storage Event Parameter List structure (that contains the address
+to a Guarded Storage Event Parameter List structure
+(that contains the address
of the aforementioned event handler in the
.I gseha
field), and its layout is available as a