Page MenuHomeFreeBSD
Files F148649731

D55750.id173562.diff
No OneTemporary
Actions

D55750.id173562.diff
View Options

diff --git a/lib/libsys/sigreturn.2 b/lib/libsys/sigreturn.2
--- a/lib/libsys/sigreturn.2
+++ b/lib/libsys/sigreturn.2
@@ -25,7 +25,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd September 6, 2013
+.Dd March 11, 2026
.Dt SIGRETURN 2
.Os
.Sh NAME
@@ -47,17 +47,25 @@
restored from the context structure pointed to by
.Fa scp .
The system call does not return;
-the users stack pointer, frame pointer, argument pointer,
-and processor status longword are restored from the context.
-Execution resumes at the specified pc.
-This system call is used by the trampoline code and
-.Xr longjmp 3
+the whole userspace context as specified by
+.Fa scp ,
+including the userspace stack pointer, all general-purpose registers,
+coprocessor state, process status register, and program counter
+are restored from the context.
+Execution resumes at the program counter from the specified context.
+.Pp
+This system call is used by the kernel-provided signal trampoline code,
+located in the virtual DSO (VDSO) on some architectures or as raw code
+in the shared page if VDSO is not provided,
when returning from a signal to the previously executing program.
.Sh RETURN VALUES
If successful, the system call does not return.
-Otherwise, a value of -1 is returned and
+Otherwise, a value of -1 may be returned, with
.Va errno
-is set to indicate the error.
+set to indicate the error.
+Some conditions detected by hardware result in the delivery of
+a synchronous trap signal to the thread, in addition to or instead of
+setting the system call error code.
.Sh ERRORS
The
.Fn sigreturn

File Metadata

Mime Type
text/plain
Expires
Fri, Mar 20, 8:47 AM (4 h, 14 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
29567737
Default Alt Text
D55750.id173562.diff (1 KB)

Event Timeline