diff --git a/man2/s390_guarded_storage.2 b/man2/s390_guarded_storage.2 index 9fef19886..761b4e72c 100644 --- a/man2/s390_guarded_storage.2 +++ b/man2/s390_guarded_storage.2 @@ -5,13 +5,13 @@ s390_guarded_storage \- operations with z/Architecture guarded storage facility .nf .B #include .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