Print this page 
15254 %ymm registers not restored after signal handler
15367 x86 getfpregs() summons corrupting %xmm ghosts
15333 want x86 /proc xregs support (libc_db, libproc, mdb, etc.)
15336 want libc functions for extended ucontext_t
15334 want ps_lwphandle-specific reg routines
15328 FPU_CW_INIT mistreats reserved bit
15335 i86pc fpu_subr.c isn't really platform-specific
15332 setcontext(2) isn't actually noreturn
15331 need <sys/stdalign.h>
Change-Id: I7060aa86042dfb989f77fc3323c065ea2eafa9ad
Conflicts:
    usr/src/uts/common/fs/proc/prcontrol.c
    usr/src/uts/intel/os/archdep.c
    usr/src/uts/intel/sys/ucontext.h
    usr/src/uts/intel/syscall/getcontext.c
Split Close
Expand all
Collapse all
          --- old/usr/src/man/man3proc/ps_lgetregs.3proc
          +++ new/usr/src/man/man3proc/ps_lgetregs.3proc
   1    1  '\" te
   2    2  .\"  Copyright (c) 1998 Sun Microsystems, Inc.  All Rights Reserved
   3    3  .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4    4  .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5    5  .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6      -.TH PS_LGETREGS 3PROC "September 12, 2020"
        6 +.\" Copyright 2023 Oxide Computer Company
        7 +.TH PS_LGETREGS 3PROC "January 23, 2023"
   7    8  .SH NAME
   8    9  ps_lgetregs, ps_lsetregs, ps_lgetfpregs, ps_lsetfpregs, ps_lgetxregsize,
   9   10  ps_lgetxregs, ps_lsetxregs \- routines that access the target process register
  10   11  in libthread_db
  11   12  .SH SYNOPSIS
  12   13  .nf
  13   14  #include <proc_service.h>
  14   15  
  15   16  \fBps_err_e\fR \fBps_lgetregs\fR(\fBstruct ps_prochandle *\fR\fIph\fR, \fBlwpid_t\fR \fIlid\fR,
  16   17       \fBprgregset_t\fR \fIgregset\fR);
↓ open down ↓ 36 lines elided ↑ open up ↑ 
  53   54  .fi
  54   55  
  55   56  .SH DESCRIPTION
  56   57  \fBps_lgetregs()\fR, \fBps_lsetregs()\fR, \fBps_lgetfpregs()\fR,
  57   58  \fBps_lsetfpregs()\fR, \fBps_lgetxregsize()\fR, \fBps_lgetxregs()\fR,
  58   59  \fBps_lsetxregs()\fR read and write register sets from lightweight processes
  59   60  (\fBLWP\fRs) within the target process identified by \fIph\fR.
  60   61  \fBps_lgetregs()\fR gets the general registers of the \fBLWP\fR identified by
  61   62  \fIlid\fR, and \fBps_lsetregs()\fR sets them. \fBps_lgetfpregs()\fR gets the
  62   63  \fBLWP\fR's floating point register set, while \fBps_lsetfpregs()\fR sets it.
  63      -.SS "SPARC Only"
  64      -\fBps_lgetxregsize()\fR, \fBps_lgetxregs()\fR, and \fBps_lsetxregs()\fR are
  65      -SPARC-specific. They do not need to be defined by a controlling process on
  66      -non-SPARC architecture. \fBps_lgetxregsize()\fR returns in
  67      -\fB*\fR\fIxregsize\fR the size of the architecture-dependent extra state
  68      -registers. \fBps_lgetxregs()\fR gets the extra state registers, and
  69      -\fBps_lsetxregs()\fR sets them.
       64 +.LP
       65 +\fBps_lgetxregsize()\fR, \fBps_lgetxregs()\fR, and \fBps_lsetxregs()\fR are used
       66 +to get and set the extended register set. Support for an extended register set
       67 +depends on the instruction-set archicture. On platforms without support for
       68 +these, controlling processes wlil still need to define them; however, they are
       69 +allowed to simply return errors.
       70 +.LP
       71 +\fBps_lgetxregsize()\fR returns in \fB*\fR\fIxregsize\fR the size of the
       72 +architecture-dependent extra state registers. \fBps_lgetxregs()\fR gets the
       73 +extra state registers, and \fBps_lsetxregs()\fR sets them. When getting the
       74 +registers, the size of \fIxregset\fR must be at least the size returned by
       75 +\fBps_lgetxregsize()\fR.
  70   76  .SH RETURN VALUES
  71   77  .ne 2
  72   78  .na
  73   79  \fB\fBPS_OK\fR \fR
  74   80  .ad
  75   81  .RS 16n
  76   82  The call returned successfully.
  77   83  .RE
  78   84  
  79   85  .sp
  80   86  .ne 2
  81   87  .na
  82      -\fB\fBPS_NOFPREGS\fR \fR
       88 +\fB\fBPS_NOFREGS\fR \fR
  83   89  .ad
  84   90  .RS 16n
  85   91  Floating point registers are neither available for this architecture nor for
  86   92  this process.
  87   93  .RE
  88   94  
  89   95  .sp
  90   96  .ne 2
  91   97  .na
  92   98  \fB\fBPS_NOXREGS\fR \fR
↓ open down ↓ 33 lines elided ↑ open up ↑ 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX