]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man2/s390_guarded_storage.2
ipc.5: Remove old link to svipc.7/sysvipc.7 page
[thirdparty/man-pages.git] / man2 / s390_guarded_storage.2
index 761b4e72c54078599aac377c671358000b7c4ff5..319d3a22871261e5b90183d7444c9eee779e4311 100644 (file)
@@ -1,4 +1,28 @@
-.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
@@ -19,10 +43,10 @@ system call enables the use of the Guarded Storage Facility
 .\" 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
@@ -74,8 +98,8 @@ will not have any effect.
 .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
@@ -121,9 +145,10 @@ Glibc does not provide a wrapper for this system call, use
 .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
@@ -131,7 +156,8 @@ 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