| librtld_db.3 (210678) | librtld_db.3 (210769) |
|---|---|
| 1.\"- 2.\" Copyright (c) 2010 The FreeBSD Foundation 3.\" All rights reserved. 4.\" 5.\" This software was developed by Rui Paulo under sponsorship from 6.\" the FreeBSD Foundation. 7.\" 8.\" Redistribution and use in source and binary forms, with or without --- 12 unchanged lines hidden (view full) --- 21.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" SUCH DAMAGE. 28.\" | 1.\"- 2.\" Copyright (c) 2010 The FreeBSD Foundation 3.\" All rights reserved. 4.\" 5.\" This software was developed by Rui Paulo under sponsorship from 6.\" the FreeBSD Foundation. 7.\" 8.\" Redistribution and use in source and binary forms, with or without --- 12 unchanged lines hidden (view full) --- 21.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" SUCH DAMAGE. 28.\" |
| 29.\" $FreeBSD: head/lib/librtld_db/librtld_db.3 210678 2010-07-31 14:26:10Z rpaulo $ | 29.\" $FreeBSD: head/lib/librtld_db/librtld_db.3 210769 2010-08-02 15:15:24Z uqs $ |
| 30.\" 31.Dd June 10, 2010 32.Dt LIBRTLD_DB 3 33.Os 34.Sh NAME 35.Nm librtld_db 36.Nd library for run-time linker debugging 37.Sh LIBRARY 38.Lb librtld_db 39.Sh SYNOPSIS 40.In rtld_db.h 41.Ft void 42.Fo rd_delete 43.Fa "rd_agent_t *rdap" 44.Fc 45.Ft char * 46.Fo rd_errstr | 30.\" 31.Dd June 10, 2010 32.Dt LIBRTLD_DB 3 33.Os 34.Sh NAME 35.Nm librtld_db 36.Nd library for run-time linker debugging 37.Sh LIBRARY 38.Lb librtld_db 39.Sh SYNOPSIS 40.In rtld_db.h 41.Ft void 42.Fo rd_delete 43.Fa "rd_agent_t *rdap" 44.Fc 45.Ft char * 46.Fo rd_errstr |
| 47.Fa "rd_err_e rderr" | 47.Fa "rd_err_e rderr" |
| 48.Fc 49.Ft rd_err_e 50.Fo rd_event_addr 51.Fa "rd_agent_t *rdap, rd_notify_t *notify" 52.Fc 53.Ft rd_err_e 54.Fo rd_event_enable 55.Fa "rd_agent_t *rdap, int onoff" --- 23 unchanged lines hidden (view full) --- 79.Fa "struct proc_handle *php" 80.Fc 81.Ft rd_err_e 82.Fo rd_objpad_enable 83.Fa "rd_agent_t *rdap, size_t padsize" 84.Fc 85.Ft rd_err_e 86.Fo rd_plt_resolution | 48.Fc 49.Ft rd_err_e 50.Fo rd_event_addr 51.Fa "rd_agent_t *rdap, rd_notify_t *notify" 52.Fc 53.Ft rd_err_e 54.Fo rd_event_enable 55.Fa "rd_agent_t *rdap, int onoff" --- 23 unchanged lines hidden (view full) --- 79.Fa "struct proc_handle *php" 80.Fc 81.Ft rd_err_e 82.Fo rd_objpad_enable 83.Fa "rd_agent_t *rdap, size_t padsize" 84.Fc 85.Ft rd_err_e 86.Fo rd_plt_resolution |
| 87.Fa "rd_agent_t *rdap, uintptr_t pc, struct proc *proc 88.Fa "uintptr_t plt_base, rd_plt_info_t *rpi" | 87.Fa "rd_agent_t *rdap, uintptr_t pc, struct proc *proc" 88.Fa "uintptr_t plt_base, rd_plt_info_t *rpi" |
| 89.Fc 90.Ft rd_err_e 91.Fo rd_reset 92.Fa "rd_agent_t *rdap" 93.Fc 94.Sh DESCRIPTION 95The 96.Nm librtld_db 97library provides a debugging interface to the run-time linker (rtld). 98This library must be used along with 99.Xr libproc 3 . 100.Pp 101Most library functions take a 102.Ft rd_agent_t 103argument. | 89.Fc 90.Ft rd_err_e 91.Fo rd_reset 92.Fa "rd_agent_t *rdap" 93.Fc 94.Sh DESCRIPTION 95The 96.Nm librtld_db 97library provides a debugging interface to the run-time linker (rtld). 98This library must be used along with 99.Xr libproc 3 . 100.Pp 101Most library functions take a 102.Ft rd_agent_t 103argument. |
| 104This argument is an opaque structure containing information associated with | 104This argument is an opaque structure containing information associated with |
| 105the current status of the agent. 106.Pp 107Before you start using 108.Nm 109you should call 110.Fn rd_init 111with the 112.Ft RD_VERSION --- 45 unchanged lines hidden (view full) --- 158.Fn rl_iter_f . 159.Sh RETURN VALUES 160Most functions return an 161.Ft rd_err_e 162type error. 163The error codes are described in the header file for this library. 164You can get the error string using 165.Fn rd_errstr . | 105the current status of the agent. 106.Pp 107Before you start using 108.Nm 109you should call 110.Fn rd_init 111with the 112.Ft RD_VERSION --- 45 unchanged lines hidden (view full) --- 158.Fn rl_iter_f . 159.Sh RETURN VALUES 160Most functions return an 161.Ft rd_err_e 162type error. 163The error codes are described in the header file for this library. 164You can get the error string using 165.Fn rd_errstr . |
| 166.Sh CAVEATS 167The functions 168.Fn rd_event_enable , 169.Fn rd_log , 170.Fn rd_objpad_enable 171and 172.Fn rd_plt_resolution 173are not yet implemented. | |
| 174.Sh SEE ALSO 175.Xr ld 1 , 176.Xr ld-elf.so.1 1 , 177.Xr ld.so 1 , 178.Xr libproc 3 , 179.Xr rtld 1 180.Sh HISTORY 181The | 166.Sh SEE ALSO 167.Xr ld 1 , 168.Xr ld-elf.so.1 1 , 169.Xr ld.so 1 , 170.Xr libproc 3 , 171.Xr rtld 1 172.Sh HISTORY 173The |
| 182.Nm librtld_db | 174.Nm librtld_db |
| 183library first appeared in | 175library first appeared in |
| 184.Fx 9.0 | 176.Fx 9.0 |
| 185and was modeled after the same library present in the Solaris operating system. 186.Sh AUTHORS 187The 188.Nm librtld_db 189library and this manual page were written by | 177and was modeled after the same library present in the Solaris operating system. 178.Sh AUTHORS 179The 180.Nm librtld_db 181library and this manual page were written by |
| 190.An Rui Paulo Aq rpaulo@FreeBSD.org | 182.An Rui Paulo Aq rpaulo@FreeBSD.org |
| 191under sponsorship from the FreeBSD Foundation. | 183under sponsorship from the FreeBSD Foundation. |
| 184.Sh CAVEATS 185The functions 186.Fn rd_event_enable , 187.Fn rd_log , 188.Fn rd_objpad_enable 189and 190.Fn rd_plt_resolution 191are not yet implemented. |
|