Hallo, dies ist ein Test.
PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html
Running in File Mode
Relative path: ./../../.././../../../usr/man/man3proc/Plookup_by_addr.3proc
Real path: /usr/share/man/man3proc/Plookup_by_addr.3proc
Zurück
'\" te .\" Copyright (c) 2016, 2017, Oracle and/or its affiliates. All rights reserved. .TH Plookup_by_addr 3PROC "31 Jan 2017" "Oracle Solaris 11.4" "Process Control Library Functions" .SH NAME Plookup_by_addr, Plookup_by_name \- search the symbol tables of the victim process .SH SYNOPSIS .LP .nf #include <gelf.h> #include <libproc.h> .fi .LP .nf int Plookup_by_addr(ps_prochandle_t *Pr, uintptr_t addr, char *buf, size_t bufsize, GElf_Sym *symp, prsyminfo_t *sip) .fi .LP .nf int Plookup_by_name(ps_prochandle_t *Pr, const char *object, const char *symbol, GElf_Sym *symp, prsyminfo_t *sip) .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 \fBPlookup_by_addr()\fR function searches the symbol tables of the victim for a symbol whose address space range, \fB[st_value .. st_value + st_size)\fR, includes the address passed in the \fBaddr\fR argument. On successful lookup, the name of the symbol is copied to the buffer of the caller and the symbol table entry is copied to the \fBsymp\fR argument of the caller. If the \fBsip\fR argument is not \fBNULL\fR, extended symbol table information is copied into it, including the pointer to the buffer of the caller. So, it then becomes \fBsip->prs_name\fR. .sp .LP The \fBPlookup_by_name()\fR function searches the symbol tables of the victim for a symbol named by the \fBsymbol\fR argument, such as "atoi", in the loaded object file named by the \fBobject\fR argument, such as \fBlibc.so\fR. If object equals \fBPR_OBJ_EVERY\fR, all symbol tables in every loaded object file is searched and the first one found is the one that is returned. On successful lookup, the symbol table entry is copied to the \fBsymp\fR argument of the caller. If the \fBsip\fR argument is not \fBNULL\fR, extended symbol table information is copied into it, including the object and \fBsymbol\fR arguments of the caller which become \fBsip->prs_object\fR and \fBsip->prs_name\fR. .SH RETURN VALUES .sp .LP On successful completion, the \fBPlookup_by_addr()\fR and \fBPlookup_by_name()\fR functions return \fB0\fR. On failure, they return \fB-1\fR. This normally means that the symbol was not found. .SH ERRORS .sp .LP On failure, \fBerrno\fR is not set. .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)