> diff --git a/man2/ptrace.2 b/man2/ptrace.2 > index 575062971..57958119b 100644 > --- a/man2/ptrace.2 > +++ b/man2/ptrace.2 > @@ -2322,6 +2322,63 @@ result, to the real parent (to the real parent only when the > whole multithreaded process exits). > If the tracer and the real parent are the same process, > the report is sent only once. > +.SS The layout and operation of the NT_X86_XSTATE regset Should rather have a complete table of NT_* entries first. The others can be dummies for now. > +On x86(_64), the values of extended registers can be obtained as an xstate buffer, > +accessed through the NT_X86_XSTATE option to > +.B PTRACE_GETREGSET. > +The layout of this area is relatively complex (and described below). It is > +in general not safe to assume that a buffer obtained using > +.B PTRACE_GETREGSET > +may be set back to any task using > +.B PTRACE_SETREGSET > +while resulting in a task that has equivalent register state (see below for > +details). It is also not safe to assume that the buffer is a valid xsave area > +that may be restored using the > +.I xrstor > +instruction, nor is it safe to assume that any extended state component is > +located at a particular fixed offset. Instead the following algorithm should be used to > +compute the offset of any given state component within the xsave buffer: > +.IP 1. 3 > +Obtain the kernel xsave component bitmask from the software-reserved area of the > +xstate buffer. The software-reserved area beings at offset 464 into the xsave It would be better to put some struct defining this into the kernel uapi and then reference that instead of magic numbers. > +buffer and the first 64 bits of this area contain the kernel xsave component bitmask > +.IP 2. > +Compute the offset of each state component by adding the sizes of all prior state > +components that are enabled in the kernel xsave component bitmask, aligning to 64 byte boundaries along the way. This > +format matches that of a compacted xsave area with XCOMP_BV set to the The sizes of these areas should probably also be in the uapi include > +kernel component bitmask. Further details on the layout of the compacted xsave > +area may be found in the Intel architecture manual, but note that the xsave > +buffer returned from ptrace will have its XCOMP_BV set to 0. The note seems disconnected. You'll have to explain it here. > +Thus, to obtain an xsave area that may be set back to the tracee, all unused > +state components must first be re-set to the correct initial state for the > +corresponding state component, and the XSTATE_BV bitfield must subsequently > +be adjusted to match the kernel xstate component bitmask (obtained as > +described above). I wonder if we shouldn't just fix the kernel to do this properly on its own. Presumably it won't break any existing user space. It seems more a bug than something that should be a documented ABI. > + > +The value of the kernel's state component bitmask is determined on boot and > +need not be equivalent to the maximal set of state components supported by the > +CPU (as enumerated through CPUID). Okay so how should someone get it? Looks like that's a hole in the kernel API that we need to fix somehow. > + > .SH RETURN VALUE > On success, the > .B PTRACE_PEEK* > -- > 2.25.1 >
