1ps_lgetregs(3PROC)     Process Control Library Functions    ps_lgetregs(3PROC)
2
3
4

NAME

6       ps_lgetregs,  ps_lsetregs,  ps_lgetfpregs,  ps_lsetfpregs, ps_lgetxreg‐
7       size, ps_lgetxregs, ps_lsetxregs -  routines  that  access  the  target
8       process register in libthread_db
9

SYNOPSIS

11       #include <proc_service.h>
12
13        ps_err_e ps_lgetregs(struct ps_prochandle *ph, lwpid_t lid,
14            prgregset_t gregset);
15
16
17       ps_err_e ps_lsetregs(struct ps_prochandle *ph, lwpid_t lid,
18            static prgregset_t gregset);
19
20
21       ps_err_e ps_lgetfpregs(struct ps_prochandle *ph, lwpid_t lid,
22            prfpregset_t *fpregs);
23
24
25       ps_err_e ps_lsetfpregs(struct ps_prochandle *ph, lwpid_t lid,
26            static prfpregset_t *fpregs);
27
28
29       ps_err_e ps_lgetxregsize(struct ps_prochandle *ph, lwpid_t lid,
30            int *xregsize);
31
32
33       ps_err_e ps_lgetxregs(struct ps_prochandle *ph, lwpid_t lid,
34            caddr_t xregset);
35
36
37       ps_err_e ps_lsetxregs(struct ps_prochandle *ph, lwpid_t lid,
38            caddr_t xregset);
39
40

DESCRIPTION

42       ps_lgetregs(),    ps_lsetregs(),    ps_lgetfpregs(),   ps_lsetfpregs(),
43       ps_lgetxregsize(), ps_lgetxregs(), ps_lsetxregs() read and write regis‐
44       ter  sets  from  lightweight processes (LWPs) within the target process
45       identified by ph. ps_lgetregs() gets the general registers of  the  LWP
46       identified  by  lid,  and ps_lsetregs() sets them. ps_lgetfpregs() gets
47       the LWP's floating point register set, while ps_lsetfpregs() sets it.
48
49   SPARC Only
50       ps_lgetxregsize(),ps_lgetxregs(), andps_lsetxregs() are SPARC-specific.
51       They  do  not  need to be defined by a controlling process on non-SPARC
52       architecture. ps_lgetxregsize() returns in *xregsize the  size  of  the
53       architecture-dependent  extra  state registers. ps_lgetxregs() gets the
54       extra state registers, and ps_lsetxregs() sets them.
55

RETURN VALUES

57       PS_OK           The call returned successfully.
58
59
60       PS_NOFPREGS     Floating point registers are neither available for this
61                       architecture nor for this process.
62
63
64       PS_NOXREGS      Extra  state registers are not available on this archi‐
65                       tecture.
66
67
68       PS_ERR          The function did not return successfully.
69
70

ATTRIBUTES

72       See attributes(5) for description of the following attributes:
73
74
75
76
77       ┌─────────────────────────────┬─────────────────────────────┐
78       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
79       ├─────────────────────────────┼─────────────────────────────┤
80       │MT Level                     │Safe                         │
81       └─────────────────────────────┴─────────────────────────────┘
82

SEE ALSO

84       libc_db(3LIB), proc_service(3PROC), attributes(5), threads(5)
85
86
87
88SunOS 5.11                        30 Jan 1998               ps_lgetregs(3PROC)
Impressum