Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../../../../../usr/man/man3proc/Pstack_iter.3proc
Real path: /usr/share/man/man3proc/Pstack_iter.3proc
Zurück

'\" te .\" Copyright (c) 2016, Oracle and/or its affiliates. All rights reserved. .TH Pstack_iter 3PROC "8 Mar 2016" "Oracle Solaris 11.4" "Process Control Library Functions" .SH NAME Pstack_iter \- walk a process or lwp stack .SH SYNOPSIS .LP .nf #include <libproc.h> .fi .LP .nf typedef int proc_stack_f( void *arg, /* the cookie given to Pstack_iter() */ prgregset_t regs, /* the frame's registers */ uint_t argc, /* argc for the frame's function */ const long *argv, /* argv for the frame's function */ int flags, /* flags describing the frame (see below) */ int sig); /* a signal number */ .fi .LP .nf int Pstack_iter(ps_prochandle_t *Pr, const prgregset_t regs, proc_stack_f *func, void *arg); .fi .SH DESCRIPTION .sp .LP The \fBPr\fR argument identifies a victim process or core file attached to the controlling process by the \fBcreate\fR and \fBgrab\fR interfaces. For more information, see the \fBPcreate\fR(3PROC) and \fBPgrab\fR(3PROC) man pages. .sp .LP The \fBPstack_iter()\fR function iterates over the stack frames of the \fBlwp\fR whose registers are referenced by the \fBregs\fR argument. The register set referenced by the \fBregs\fR argument is normally the register set of the representative \fBlwp\fR when the process is stopped. However, it can be the register set of any one of the \fBlwps\fR in the process when that \fBlwp\fR is stopped. .sp .LP For each stack frame, the specified function is called and is passed the arguments shown above in the \fBproc_stack_f()\fR type declaration. The \fBflags\fR argument is a bit-wise OR of zero or more of these flags: .sp .ne 2 .mk .na \fBPR_SIGNAL_FRAME\fR .ad .RS 19n .rt Called by a signal handler .RE .sp .ne 2 .mk .na \fBPR_FOUND_SIGNAL\fR .ad .RS 19n .rt The \fBsig\fR argument is valid .RE .sp .LP If the specified function returns non-zero, the iteration is terminated. Else, the iteration continues until all stack frames have been visited. .SH RETURN VALUES .sp .LP The \fBPstack_iter()\fR function returns zero if all stack frames are visited. Else, it returns the non-zero value returned by the specified function call that caused the iteration to terminate. .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ Interface Stability Committed _ MT-Level Unsafe .TE .sp .SH SEE ALSO .sp .LP \fBlibproc.h\fR(3HEAD), \fBlibproc\fR(3LIB), \fBPcreate\fR(3PROC), \fBPgrab\fR(3PROC), \fBproc\fR(5) .SH NOTES .sp .LP Determining the number and values of the arguments for each frame, as well as the values of all of the registers, is somewhat heuristic. Therefore, the values in the \fBregs\fR, \fBargc\fR, and \fBargv\fR arguments passed to the \fBcall-back()\fR function are not guaranteed to be correct.