s390_guarded_storage.2: Minor fixes

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2018-05-02 14:31:15 +02:00
parent 6e5ba56745
commit a7091d1326
1 changed files with 13 additions and 13 deletions

View File

@ -5,13 +5,13 @@ s390_guarded_storage \- operations with z/Architecture guarded storage facility
.nf
.B #include <asm/guarded_storage.h>
.PP
.BI "int s390_guarded_storage(int " command ", stuct gs_cb *" gs_cb ");"
.BI "int s390_guarded_storage(int " command ", struct gs_cb *" gs_cb ");"
.fi
.SH DESCRIPTION
The
.BR s390_guarded_storage ()
system call enables the use of the Guarded Storage Facility
(a z/Architecture-specific feature) for user space processes.
(a z/Architecture-specific feature) for user-space processes.
.PP
.\" The description is based on
.\" http://www-05.ibm.com/de/linux-on-z-ws-us/agenda/pdfs/8_-_Linux_Whats_New_-_Stefan_Raspl.pdf
@ -21,7 +21,7 @@ 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
value and invoke a (previously set up) user-space handler if one of the guarded
regions is affected.
.PP
The
@ -31,19 +31,19 @@ argument indicates which function to perform.
The following commands are supported:
.TP
.B GS_ENABLE
Enable the guarded storage facility for the current task.
Enable the guarded storage facility for the calling task.
The initial content of the guarded storage control block will be all zeros.
After the enablement, user space code can use the "Load Guarded Storage
After enablement, user-space code can use the "Load Guarded Storage
Controls" (LGSC) instruction (or the
.BR load_gs_cb ()
function wrapper provided in the
.I asm/guarded_storage.h
header) to load an arbitrary control block.
While a task is enabled, the kernel will save and restore the current content
While a task is enabled, the kernel will save and restore the calling content
of the guarded storage registers on context switch.
.TP
.B GS_DISABLE
Disables the use of the guarded storage facility for the current task.
Disables the use of the guarded storage facility for the calling task.
The kernel will cease to save and restore the content of the guarded storage
registers, the task-specific content of these registers is lost.
.TP
@ -52,7 +52,7 @@ Set a broadcast guarded storage control block to the one provided in the
.I gs_cb
argument.
This is called per thread and associates a specific guarded storage control
block with the current task.
block with the calling task.
This control block will be used in the broadcast command
.BR GS_BROADCAST .
.TP
@ -64,10 +64,10 @@ established by the
command.
.TP
.B GS_BROADCAST
Sends a broadcast to all thread siblings of the current task.
Sends a broadcast to all thread siblings of the calling task.
Every sibling that has established a broadcast guarded storage control block
will load this control block and will be enabled for guarded storage.
The broadcast guarded storage control block is used up, a second broadcast
The broadcast guarded storage control block is consumed; a second broadcast
without a refresh of the stored control block with
.B GS_SET_BC_CB
will not have any effect.
@ -99,7 +99,7 @@ argument has failed.
.B EINVAL
The value provided in the
.I command
argument was not a valid command.
argument was not valid.
.TP
.B ENOMEM
.I command
@ -108,7 +108,7 @@ was one of
and the allocation of a new guarded storage control block has failed.
.TP
.B EOPNOTSUPP
The guarded storage is not supported by the hardware.
The guarded storage facility is not supported by the hardware.
.SH VERSIONS
.\" 916cda1aa1b412d7cf2991c3af7479544942d121, v4.12-rc1~139^2~56^2
This system call is available since Linux 4.12.
@ -130,7 +130,7 @@ The
.I gs_cb
structure has a field
.I gsepla
(Guarded Storage Event Parameter List Address), which is a user space pointer
(Guarded Storage Event Parameter List Address), which is a user-space pointer
to a Guarded Storage Event Parameter List structure (that contains the address
of the aforementioned event handler in the
.I gseha