mirror of https://github.com/mkerrisk/man-pages
s390_guarded_storage.2: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
6e5ba56745
commit
a7091d1326
|
@ -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
|
||||
|
|
Loading…
Reference in New Issue