17c478bd9Sstevel@tonic-gate /* 27c478bd9Sstevel@tonic-gate * CDDL HEADER START 37c478bd9Sstevel@tonic-gate * 47c478bd9Sstevel@tonic-gate * The contents of this file are subject to the terms of the 59acbbeafSnn * Common Development and Distribution License (the "License"). 69acbbeafSnn * You may not use this file except in compliance with the License. 77c478bd9Sstevel@tonic-gate * 87c478bd9Sstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 97c478bd9Sstevel@tonic-gate * or http://www.opensolaris.org/os/licensing. 107c478bd9Sstevel@tonic-gate * See the License for the specific language governing permissions 117c478bd9Sstevel@tonic-gate * and limitations under the License. 127c478bd9Sstevel@tonic-gate * 137c478bd9Sstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each 147c478bd9Sstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 157c478bd9Sstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the 167c478bd9Sstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying 177c478bd9Sstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner] 187c478bd9Sstevel@tonic-gate * 197c478bd9Sstevel@tonic-gate * CDDL HEADER END 207c478bd9Sstevel@tonic-gate */ 217c478bd9Sstevel@tonic-gate /* 229acbbeafSnn * Copyright 2006 Sun Microsystems, Inc. All rights reserved. 237c478bd9Sstevel@tonic-gate * Use is subject to license terms. 247c478bd9Sstevel@tonic-gate */ 250a47c91cSRobert Mustacchi /* 26399ca3a7SJohn Levon * Copyright (c) 2018, Joyent, Inc. All rights reserved. 27*a48fdbefSBryan Cantrill * Copyright 2024 Oxide Computer Company 280a47c91cSRobert Mustacchi */ 297c478bd9Sstevel@tonic-gate 307c478bd9Sstevel@tonic-gate #ifndef _MDB_TARGET_IMPL_H 317c478bd9Sstevel@tonic-gate #define _MDB_TARGET_IMPL_H 327c478bd9Sstevel@tonic-gate 337c478bd9Sstevel@tonic-gate #include <mdb/mdb_target.h> 347c478bd9Sstevel@tonic-gate #include <mdb/mdb_module.h> 357c478bd9Sstevel@tonic-gate #include <mdb/mdb_list.h> 367c478bd9Sstevel@tonic-gate #include <mdb/mdb_gelf.h> 379acbbeafSnn #include <sys/auxv.h> 387c478bd9Sstevel@tonic-gate 397c478bd9Sstevel@tonic-gate #ifdef __cplusplus 407c478bd9Sstevel@tonic-gate extern "C" { 417c478bd9Sstevel@tonic-gate #endif 427c478bd9Sstevel@tonic-gate 437c478bd9Sstevel@tonic-gate #ifdef _MDB 447c478bd9Sstevel@tonic-gate 457c478bd9Sstevel@tonic-gate /* 467c478bd9Sstevel@tonic-gate * Target Operations 477c478bd9Sstevel@tonic-gate * 487c478bd9Sstevel@tonic-gate * This ops vector implements the set of primitives which can be used by the 497c478bd9Sstevel@tonic-gate * debugger to interact with the target, and encompasses most of the calls 507c478bd9Sstevel@tonic-gate * found in <mdb/mdb_target.h>. The remainder of the target interface is 517c478bd9Sstevel@tonic-gate * implemented by common code that invokes these primitives or manipulates 527c478bd9Sstevel@tonic-gate * the common target structures directly. 537c478bd9Sstevel@tonic-gate */ 547c478bd9Sstevel@tonic-gate 557c478bd9Sstevel@tonic-gate typedef struct mdb_tgt_ops { 567c478bd9Sstevel@tonic-gate int (*t_setflags)(mdb_tgt_t *, int); 577c478bd9Sstevel@tonic-gate int (*t_setcontext)(mdb_tgt_t *, void *); 587c478bd9Sstevel@tonic-gate 597c478bd9Sstevel@tonic-gate void (*t_activate)(mdb_tgt_t *); 607c478bd9Sstevel@tonic-gate void (*t_deactivate)(mdb_tgt_t *); 617c478bd9Sstevel@tonic-gate void (*t_periodic)(mdb_tgt_t *); 627c478bd9Sstevel@tonic-gate void (*t_destroy)(mdb_tgt_t *); 637c478bd9Sstevel@tonic-gate 647c478bd9Sstevel@tonic-gate const char *(*t_name)(mdb_tgt_t *); 657c478bd9Sstevel@tonic-gate const char *(*t_isa)(mdb_tgt_t *); 667c478bd9Sstevel@tonic-gate const char *(*t_platform)(mdb_tgt_t *); 677c478bd9Sstevel@tonic-gate int (*t_uname)(mdb_tgt_t *, struct utsname *); 687c478bd9Sstevel@tonic-gate int (*t_dmodel)(mdb_tgt_t *); 697c478bd9Sstevel@tonic-gate 707c478bd9Sstevel@tonic-gate ssize_t (*t_aread)(mdb_tgt_t *, 717c478bd9Sstevel@tonic-gate mdb_tgt_as_t, void *, size_t, mdb_tgt_addr_t); 727c478bd9Sstevel@tonic-gate 737c478bd9Sstevel@tonic-gate ssize_t (*t_awrite)(mdb_tgt_t *, 747c478bd9Sstevel@tonic-gate mdb_tgt_as_t, const void *, size_t, mdb_tgt_addr_t); 757c478bd9Sstevel@tonic-gate 767c478bd9Sstevel@tonic-gate ssize_t (*t_vread)(mdb_tgt_t *, void *, size_t, uintptr_t); 777c478bd9Sstevel@tonic-gate ssize_t (*t_vwrite)(mdb_tgt_t *, const void *, size_t, uintptr_t); 787c478bd9Sstevel@tonic-gate ssize_t (*t_pread)(mdb_tgt_t *, void *, size_t, physaddr_t); 797c478bd9Sstevel@tonic-gate ssize_t (*t_pwrite)(mdb_tgt_t *, const void *, size_t, physaddr_t); 807c478bd9Sstevel@tonic-gate ssize_t (*t_fread)(mdb_tgt_t *, void *, size_t, uintptr_t); 817c478bd9Sstevel@tonic-gate ssize_t (*t_fwrite)(mdb_tgt_t *, const void *, size_t, uintptr_t); 827c478bd9Sstevel@tonic-gate ssize_t (*t_ioread)(mdb_tgt_t *, void *, size_t, uintptr_t); 837c478bd9Sstevel@tonic-gate ssize_t (*t_iowrite)(mdb_tgt_t *, const void *, size_t, uintptr_t); 847c478bd9Sstevel@tonic-gate 857c478bd9Sstevel@tonic-gate int (*t_vtop)(mdb_tgt_t *, mdb_tgt_as_t, uintptr_t, physaddr_t *); 867c478bd9Sstevel@tonic-gate 877c478bd9Sstevel@tonic-gate int (*t_lookup_by_name)(mdb_tgt_t *, 887c478bd9Sstevel@tonic-gate const char *, const char *, GElf_Sym *, mdb_syminfo_t *); 897c478bd9Sstevel@tonic-gate 907c478bd9Sstevel@tonic-gate int (*t_lookup_by_addr)(mdb_tgt_t *, 917c478bd9Sstevel@tonic-gate uintptr_t, uint_t, char *, size_t, GElf_Sym *, mdb_syminfo_t *); 927c478bd9Sstevel@tonic-gate 937c478bd9Sstevel@tonic-gate int (*t_symbol_iter)(mdb_tgt_t *, 947c478bd9Sstevel@tonic-gate const char *, uint_t, uint_t, mdb_tgt_sym_f *, void *); 957c478bd9Sstevel@tonic-gate 967c478bd9Sstevel@tonic-gate int (*t_mapping_iter)(mdb_tgt_t *, mdb_tgt_map_f *, void *); 977c478bd9Sstevel@tonic-gate int (*t_object_iter)(mdb_tgt_t *, mdb_tgt_map_f *, void *); 987c478bd9Sstevel@tonic-gate 997c478bd9Sstevel@tonic-gate const mdb_map_t *(*t_addr_to_map)(mdb_tgt_t *, uintptr_t); 1007c478bd9Sstevel@tonic-gate const mdb_map_t *(*t_name_to_map)(mdb_tgt_t *, const char *); 1017c478bd9Sstevel@tonic-gate struct ctf_file *(*t_addr_to_ctf)(mdb_tgt_t *, uintptr_t); 1027c478bd9Sstevel@tonic-gate struct ctf_file *(*t_name_to_ctf)(mdb_tgt_t *, const char *); 1037c478bd9Sstevel@tonic-gate 1047c478bd9Sstevel@tonic-gate int (*t_status)(mdb_tgt_t *, mdb_tgt_status_t *); 1057c478bd9Sstevel@tonic-gate int (*t_run)(mdb_tgt_t *, int, const struct mdb_arg *); 1067c478bd9Sstevel@tonic-gate int (*t_step)(mdb_tgt_t *, mdb_tgt_status_t *); 1077c478bd9Sstevel@tonic-gate int (*t_step_out)(mdb_tgt_t *, uintptr_t *); 1087c478bd9Sstevel@tonic-gate int (*t_next)(mdb_tgt_t *, uintptr_t *); 1097c478bd9Sstevel@tonic-gate int (*t_cont)(mdb_tgt_t *, mdb_tgt_status_t *); 1107c478bd9Sstevel@tonic-gate int (*t_signal)(mdb_tgt_t *, int); 1117c478bd9Sstevel@tonic-gate 1127c478bd9Sstevel@tonic-gate int (*t_add_vbrkpt)(mdb_tgt_t *, uintptr_t, 1137c478bd9Sstevel@tonic-gate int, mdb_tgt_se_f *, void *); 1147c478bd9Sstevel@tonic-gate int (*t_add_sbrkpt)(mdb_tgt_t *, const char *, 1157c478bd9Sstevel@tonic-gate int, mdb_tgt_se_f *, void *); 1167c478bd9Sstevel@tonic-gate 1177c478bd9Sstevel@tonic-gate int (*t_add_pwapt)(mdb_tgt_t *, physaddr_t, size_t, uint_t, 1187c478bd9Sstevel@tonic-gate int, mdb_tgt_se_f *, void *); 1197c478bd9Sstevel@tonic-gate int (*t_add_vwapt)(mdb_tgt_t *, uintptr_t, size_t, uint_t, 1207c478bd9Sstevel@tonic-gate int, mdb_tgt_se_f *, void *); 1217c478bd9Sstevel@tonic-gate int (*t_add_iowapt)(mdb_tgt_t *, uintptr_t, size_t, uint_t, 1227c478bd9Sstevel@tonic-gate int, mdb_tgt_se_f *, void *); 1237c478bd9Sstevel@tonic-gate 1247c478bd9Sstevel@tonic-gate int (*t_add_sysenter)(mdb_tgt_t *, int, int, mdb_tgt_se_f *, void *); 1257c478bd9Sstevel@tonic-gate int (*t_add_sysexit)(mdb_tgt_t *, int, int, mdb_tgt_se_f *, void *); 1267c478bd9Sstevel@tonic-gate int (*t_add_signal)(mdb_tgt_t *, int, int, mdb_tgt_se_f *, void *); 1277c478bd9Sstevel@tonic-gate int (*t_add_fault)(mdb_tgt_t *, int, int, mdb_tgt_se_f *, void *); 1287c478bd9Sstevel@tonic-gate 1297c478bd9Sstevel@tonic-gate int (*t_getareg)(mdb_tgt_t *, mdb_tgt_tid_t, const char *, 1307c478bd9Sstevel@tonic-gate mdb_tgt_reg_t *); 1317c478bd9Sstevel@tonic-gate int (*t_putareg)(mdb_tgt_t *, mdb_tgt_tid_t, const char *, 1327c478bd9Sstevel@tonic-gate mdb_tgt_reg_t); 1337c478bd9Sstevel@tonic-gate 1347c478bd9Sstevel@tonic-gate int (*t_stack_iter)(mdb_tgt_t *, const mdb_tgt_gregset_t *, 1357c478bd9Sstevel@tonic-gate mdb_tgt_stack_f *, void *); 1367c478bd9Sstevel@tonic-gate 1379acbbeafSnn int (*t_auxv)(mdb_tgt_t *, const auxv_t **auxvp); 138*a48fdbefSBryan Cantrill 139*a48fdbefSBryan Cantrill int (*t_thread_name)(mdb_tgt_t *, mdb_tgt_tid_t, char *, size_t); 1407c478bd9Sstevel@tonic-gate } mdb_tgt_ops_t; 1417c478bd9Sstevel@tonic-gate 1427c478bd9Sstevel@tonic-gate /* 1437c478bd9Sstevel@tonic-gate * Software Event Specifiers 1447c478bd9Sstevel@tonic-gate * 1457c478bd9Sstevel@tonic-gate * The common target layer provides support for the management of software 1467c478bd9Sstevel@tonic-gate * event specifiers, used to describe conditions under which a live executing 1477c478bd9Sstevel@tonic-gate * target program instance will stop and transfer control back to the debugger. 1487c478bd9Sstevel@tonic-gate * Software event management design is discussed in more detail in mdb_target.c. 1497c478bd9Sstevel@tonic-gate */ 1507c478bd9Sstevel@tonic-gate 1517c478bd9Sstevel@tonic-gate struct mdb_sespec; /* Software event specifier */ 1527c478bd9Sstevel@tonic-gate struct mdb_vespec; /* Virtual event specifier */ 1537c478bd9Sstevel@tonic-gate 1547c478bd9Sstevel@tonic-gate typedef struct mdb_se_ops { 1557c478bd9Sstevel@tonic-gate int (*se_ctor)(mdb_tgt_t *, struct mdb_sespec *, void *); 1567c478bd9Sstevel@tonic-gate void (*se_dtor)(mdb_tgt_t *, struct mdb_sespec *); 1577c478bd9Sstevel@tonic-gate char *(*se_info)(mdb_tgt_t *, struct mdb_sespec *, 1587c478bd9Sstevel@tonic-gate struct mdb_vespec *, mdb_tgt_spec_desc_t *, char *, size_t); 1597c478bd9Sstevel@tonic-gate int (*se_secmp)(mdb_tgt_t *, struct mdb_sespec *, void *); 1607c478bd9Sstevel@tonic-gate int (*se_vecmp)(mdb_tgt_t *, struct mdb_vespec *, void *); 1617c478bd9Sstevel@tonic-gate int (*se_arm)(mdb_tgt_t *, struct mdb_sespec *); 1627c478bd9Sstevel@tonic-gate int (*se_disarm)(mdb_tgt_t *, struct mdb_sespec *); 1637c478bd9Sstevel@tonic-gate int (*se_cont)(mdb_tgt_t *, struct mdb_sespec *, mdb_tgt_status_t *); 1647c478bd9Sstevel@tonic-gate int (*se_match)(mdb_tgt_t *, struct mdb_sespec *, mdb_tgt_status_t *); 1657c478bd9Sstevel@tonic-gate } mdb_se_ops_t; 1667c478bd9Sstevel@tonic-gate 1677c478bd9Sstevel@tonic-gate #define T_SE_END ((void *)-1L) /* Sentinel for end of t_matched list */ 1687c478bd9Sstevel@tonic-gate 1697c478bd9Sstevel@tonic-gate typedef struct mdb_sespec { 1707c478bd9Sstevel@tonic-gate mdb_list_t se_selist; /* Sespec list forward/back pointers */ 1717c478bd9Sstevel@tonic-gate mdb_list_t se_velist; /* List of layered virtual specifiers */ 1727c478bd9Sstevel@tonic-gate struct mdb_sespec *se_matched; /* Pointer to next se on matched list */ 1737c478bd9Sstevel@tonic-gate const mdb_se_ops_t *se_ops; /* Pointer to ops vector */ 1747c478bd9Sstevel@tonic-gate void *se_data; /* Private storage for ops vector */ 1757c478bd9Sstevel@tonic-gate uint_t se_refs; /* Reference count */ 1767c478bd9Sstevel@tonic-gate int se_state; /* Event specifier state */ 1777c478bd9Sstevel@tonic-gate int se_errno; /* Last error code (if error state) */ 1787c478bd9Sstevel@tonic-gate } mdb_sespec_t; 1797c478bd9Sstevel@tonic-gate 1807c478bd9Sstevel@tonic-gate typedef struct mdb_vespec { 1817c478bd9Sstevel@tonic-gate mdb_list_t ve_list; /* Vespec list forward/back pointers */ 1827c478bd9Sstevel@tonic-gate int ve_id; /* Virtual event specifier ID (VID) */ 1837c478bd9Sstevel@tonic-gate int ve_flags; /* Flags (see mdb_target.h) */ 1847c478bd9Sstevel@tonic-gate uint_t ve_refs; /* Reference count */ 1857c478bd9Sstevel@tonic-gate uint_t ve_hits; /* Count of number of times matched */ 1867c478bd9Sstevel@tonic-gate uint_t ve_limit; /* Limit on number of times matched */ 1877c478bd9Sstevel@tonic-gate mdb_sespec_t *ve_se; /* Backpointer to sespec */ 1887c478bd9Sstevel@tonic-gate mdb_tgt_se_f *ve_callback; /* Callback for event owner */ 1897c478bd9Sstevel@tonic-gate void *ve_data; /* Private storage for callback */ 1907c478bd9Sstevel@tonic-gate void *ve_args; /* Arguments for sespec constructor */ 1917c478bd9Sstevel@tonic-gate void (*ve_dtor)(struct mdb_vespec *); /* Destructor for ve_args */ 1927c478bd9Sstevel@tonic-gate } mdb_vespec_t; 1937c478bd9Sstevel@tonic-gate 1947c478bd9Sstevel@tonic-gate /* 1957c478bd9Sstevel@tonic-gate * Xdata Descriptors 1967c478bd9Sstevel@tonic-gate * 1977c478bd9Sstevel@tonic-gate * Each external data item (xdata) exported by the target has a corresponding 1987c478bd9Sstevel@tonic-gate * descriptor associated with the target. The descriptor provides the name 1997c478bd9Sstevel@tonic-gate * and description of the data, as well as the routine which is used to 2007c478bd9Sstevel@tonic-gate * retrieve the actual data or its size. 2017c478bd9Sstevel@tonic-gate */ 2027c478bd9Sstevel@tonic-gate 2037c478bd9Sstevel@tonic-gate typedef struct mdb_xdata { 2047c478bd9Sstevel@tonic-gate mdb_list_t xd_list; /* Xdata list forward/back pointers */ 2057c478bd9Sstevel@tonic-gate const char *xd_name; /* Buffer name */ 2067c478bd9Sstevel@tonic-gate const char *xd_desc; /* Buffer description */ 2077c478bd9Sstevel@tonic-gate ssize_t (*xd_copy)(mdb_tgt_t *, void *, size_t); /* Copy routine */ 2087c478bd9Sstevel@tonic-gate } mdb_xdata_t; 2097c478bd9Sstevel@tonic-gate 2107c478bd9Sstevel@tonic-gate /* 2117c478bd9Sstevel@tonic-gate * Target Structure 2127c478bd9Sstevel@tonic-gate * 2137c478bd9Sstevel@tonic-gate * The target itself contains a few common data members, and then a pointer to 2147c478bd9Sstevel@tonic-gate * the underlying ops vector and its private storage pointer. MDB can manage 2157c478bd9Sstevel@tonic-gate * multiple targets simultaneously, and the list of all constructed targets is 2167c478bd9Sstevel@tonic-gate * pointed to by the mdb_t structure. 2177c478bd9Sstevel@tonic-gate */ 2187c478bd9Sstevel@tonic-gate 2197c478bd9Sstevel@tonic-gate struct mdb_tgt { 2207c478bd9Sstevel@tonic-gate mdb_list_t t_tgtlist; /* Target list forward/back pointers */ 2217c478bd9Sstevel@tonic-gate mdb_list_t t_active; /* List of active event specifiers */ 2227c478bd9Sstevel@tonic-gate mdb_list_t t_idle; /* List of inactive event specifiers */ 2237c478bd9Sstevel@tonic-gate mdb_list_t t_xdlist; /* List of xdata descriptors */ 2247c478bd9Sstevel@tonic-gate mdb_module_t *t_module; /* Backpointer to containing module */ 2257c478bd9Sstevel@tonic-gate void *t_pshandle; /* Proc service handle (if not tgt) */ 2267c478bd9Sstevel@tonic-gate const mdb_tgt_ops_t *t_ops; /* Pointer to target ops vector */ 2277c478bd9Sstevel@tonic-gate void *t_data; /* Private storage for implementation */ 2287c478bd9Sstevel@tonic-gate mdb_tgt_status_t t_status; /* Cached target status */ 2297c478bd9Sstevel@tonic-gate mdb_sespec_t *t_matched; /* List of matched event specifiers */ 2307c478bd9Sstevel@tonic-gate uint_t t_flags; /* Mode flags (see <mdb_target.h>) */ 2317c478bd9Sstevel@tonic-gate uint_t t_vecnt; /* Total number of vespecs */ 2327c478bd9Sstevel@tonic-gate int t_vepos; /* Sequence # for next vespec id > 0 */ 2337c478bd9Sstevel@tonic-gate int t_veneg; /* Sequence # for next vespec id < 0 */ 2347c478bd9Sstevel@tonic-gate }; 2357c478bd9Sstevel@tonic-gate 2367c478bd9Sstevel@tonic-gate /* 2377c478bd9Sstevel@tonic-gate * Special functions which targets can use to fill ops vector slots: 2387c478bd9Sstevel@tonic-gate */ 2397c478bd9Sstevel@tonic-gate extern long mdb_tgt_notsup(); /* Return -1, errno EMDB_TGTNOTSUP */ 2407c478bd9Sstevel@tonic-gate extern long mdb_tgt_hwnotsup(); /* return -1, errno EMDB_TGTHWNOTSUP */ 2417c478bd9Sstevel@tonic-gate extern void *mdb_tgt_null(); /* Return NULL, errno EMDB_TGTNOTSUP */ 2427c478bd9Sstevel@tonic-gate extern long mdb_tgt_nop(); /* Return 0 for success */ 2437c478bd9Sstevel@tonic-gate 2447c478bd9Sstevel@tonic-gate /* 2457c478bd9Sstevel@tonic-gate * Utility structures for target implementations: 2467c478bd9Sstevel@tonic-gate */ 2477c478bd9Sstevel@tonic-gate #define MDB_TGT_R_PRIV 0x001 /* Privileged register */ 2487c478bd9Sstevel@tonic-gate #define MDB_TGT_R_EXPORT 0x002 /* Export register as a variable */ 2497c478bd9Sstevel@tonic-gate #define MDB_TGT_R_ALIAS 0x004 /* Alias for another register name */ 2507c478bd9Sstevel@tonic-gate #define MDB_TGT_R_XREG 0x008 /* Extended register */ 2517c478bd9Sstevel@tonic-gate #define MDB_TGT_R_FPS 0x010 /* Single-precision floating-point */ 2527c478bd9Sstevel@tonic-gate #define MDB_TGT_R_FPD 0x020 /* Double-precision floating-point */ 2537c478bd9Sstevel@tonic-gate #define MDB_TGT_R_FPQ 0x040 /* Quad-precision floating-point */ 2547c478bd9Sstevel@tonic-gate #define MDB_TGT_R_FPU 0x080 /* FPU control/status register */ 2557c478bd9Sstevel@tonic-gate #define MDB_TGT_R_RDONLY 0x100 /* Register is read-only */ 2560a47c91cSRobert Mustacchi #define MDB_TGT_R_32 0x200 /* 32-bit version of register */ 2570a47c91cSRobert Mustacchi #define MDB_TGT_R_16 0x400 /* 16-bit version of register */ 2580a47c91cSRobert Mustacchi #define MDB_TGT_R_8H 0x800 /* upper half of a 16-bit reg */ 2590a47c91cSRobert Mustacchi #define MDB_TGT_R_8L 0x1000 /* lower half of a 16-bit reg */ 2607c478bd9Sstevel@tonic-gate 2617c478bd9Sstevel@tonic-gate #define MDB_TGT_R_IS_FP(f) ((f) & 0xf0) /* Test MDB_TGT_R_FP* bits */ 2627c478bd9Sstevel@tonic-gate 2637c478bd9Sstevel@tonic-gate #define MDB_TGT_R_NVAL(n, f) ((((ulong_t)(n)) << 16UL) | (f)) 2647c478bd9Sstevel@tonic-gate #define MDB_TGT_R_NUM(v) (((v) >> 16) & 0xffff) 2657c478bd9Sstevel@tonic-gate #define MDB_TGT_R_FLAGS(v) ((v) & 0xffff) 2667c478bd9Sstevel@tonic-gate 2677c478bd9Sstevel@tonic-gate typedef struct mdb_tgt_regdesc { 2687c478bd9Sstevel@tonic-gate const char *rd_name; /* Register string name */ 2697c478bd9Sstevel@tonic-gate ushort_t rd_num; /* Register index number */ 2707c478bd9Sstevel@tonic-gate ushort_t rd_flags; /* Register flags (see above) */ 2717c478bd9Sstevel@tonic-gate } mdb_tgt_regdesc_t; 2727c478bd9Sstevel@tonic-gate 2737c478bd9Sstevel@tonic-gate /* 2747c478bd9Sstevel@tonic-gate * Utility functions for target implementations to use in order to simplify 2757c478bd9Sstevel@tonic-gate * the implementation of various routines and to insert and delete xdata 2767c478bd9Sstevel@tonic-gate * specifiers and software event specifiers. Refer to the associated comments 2777c478bd9Sstevel@tonic-gate * in mdb_target.c for more information about each function. 2787c478bd9Sstevel@tonic-gate */ 2797c478bd9Sstevel@tonic-gate 2807c478bd9Sstevel@tonic-gate extern int mdb_tgt_xdata_insert(mdb_tgt_t *, const char *, const char *, 2817c478bd9Sstevel@tonic-gate ssize_t (*)(mdb_tgt_t *, void *, size_t)); 2827c478bd9Sstevel@tonic-gate 2837c478bd9Sstevel@tonic-gate extern int mdb_tgt_xdata_delete(mdb_tgt_t *, const char *); 2847c478bd9Sstevel@tonic-gate 2857c478bd9Sstevel@tonic-gate extern int mdb_tgt_sym_match(const GElf_Sym *, uint_t); 2867c478bd9Sstevel@tonic-gate extern void mdb_tgt_elf_export(mdb_gelf_file_t *); 2877c478bd9Sstevel@tonic-gate 2887c478bd9Sstevel@tonic-gate extern int mdb_tgt_sespec_activate_one(mdb_tgt_t *t, mdb_sespec_t *); 2897c478bd9Sstevel@tonic-gate extern int mdb_tgt_sespec_activate_all(mdb_tgt_t *t); 2907c478bd9Sstevel@tonic-gate 2917c478bd9Sstevel@tonic-gate extern void mdb_tgt_sespec_idle_one(mdb_tgt_t *t, mdb_sespec_t *, int); 2927c478bd9Sstevel@tonic-gate extern void mdb_tgt_sespec_idle_all(mdb_tgt_t *t, int, int); 2937c478bd9Sstevel@tonic-gate 2947c478bd9Sstevel@tonic-gate extern void mdb_tgt_sespec_arm_one(mdb_tgt_t *t, mdb_sespec_t *); 2957c478bd9Sstevel@tonic-gate extern void mdb_tgt_sespec_arm_all(mdb_tgt_t *t); 2967c478bd9Sstevel@tonic-gate 2977c478bd9Sstevel@tonic-gate extern void mdb_tgt_sespec_idle_one(mdb_tgt_t *t, mdb_sespec_t *, int); 2987c478bd9Sstevel@tonic-gate extern void mdb_tgt_sespec_idle_all(mdb_tgt_t *t, int, int); 2997c478bd9Sstevel@tonic-gate 3007c478bd9Sstevel@tonic-gate extern void mdb_tgt_sespec_prune_one(mdb_tgt_t *t, mdb_sespec_t *); 3017c478bd9Sstevel@tonic-gate extern void mdb_tgt_sespec_prune_all(mdb_tgt_t *t); 3027c478bd9Sstevel@tonic-gate 3037c478bd9Sstevel@tonic-gate extern mdb_sespec_t *mdb_tgt_sespec_insert(mdb_tgt_t *, 3047c478bd9Sstevel@tonic-gate const mdb_se_ops_t *, mdb_list_t *); 3057c478bd9Sstevel@tonic-gate 3067c478bd9Sstevel@tonic-gate extern mdb_sespec_t *mdb_tgt_sespec_lookup_active(mdb_tgt_t *, 3077c478bd9Sstevel@tonic-gate const mdb_se_ops_t *, void *); 3087c478bd9Sstevel@tonic-gate 3097c478bd9Sstevel@tonic-gate extern mdb_sespec_t *mdb_tgt_sespec_lookup_idle(mdb_tgt_t *, 3107c478bd9Sstevel@tonic-gate const mdb_se_ops_t *, void *); 3117c478bd9Sstevel@tonic-gate 3127c478bd9Sstevel@tonic-gate extern void mdb_tgt_sespec_hold(mdb_tgt_t *, mdb_sespec_t *); 3137c478bd9Sstevel@tonic-gate extern void mdb_tgt_sespec_rele(mdb_tgt_t *, mdb_sespec_t *); 3147c478bd9Sstevel@tonic-gate 3157c478bd9Sstevel@tonic-gate extern void mdb_tgt_sespec_prune_one(mdb_tgt_t *t, mdb_sespec_t *); 3167c478bd9Sstevel@tonic-gate extern void mdb_tgt_sespec_prune_all(mdb_tgt_t *t); 3177c478bd9Sstevel@tonic-gate 3187c478bd9Sstevel@tonic-gate extern mdb_sespec_t *mdb_tgt_sespec_insert(mdb_tgt_t *, 3197c478bd9Sstevel@tonic-gate const mdb_se_ops_t *, mdb_list_t *); 3207c478bd9Sstevel@tonic-gate 3217c478bd9Sstevel@tonic-gate extern mdb_sespec_t *mdb_tgt_sespec_lookup_active(mdb_tgt_t *, 3227c478bd9Sstevel@tonic-gate const mdb_se_ops_t *, void *); 3237c478bd9Sstevel@tonic-gate 3247c478bd9Sstevel@tonic-gate extern mdb_sespec_t *mdb_tgt_sespec_lookup_idle(mdb_tgt_t *, 3257c478bd9Sstevel@tonic-gate const mdb_se_ops_t *, void *); 3267c478bd9Sstevel@tonic-gate 3277c478bd9Sstevel@tonic-gate extern void mdb_tgt_sespec_hold(mdb_tgt_t *, mdb_sespec_t *); 3287c478bd9Sstevel@tonic-gate extern void mdb_tgt_sespec_rele(mdb_tgt_t *, mdb_sespec_t *); 3297c478bd9Sstevel@tonic-gate 3307c478bd9Sstevel@tonic-gate extern int mdb_tgt_vespec_insert(mdb_tgt_t *, const mdb_se_ops_t *, 3317c478bd9Sstevel@tonic-gate int, mdb_tgt_se_f *, void *, void *, void (*)(mdb_vespec_t *)); 3327c478bd9Sstevel@tonic-gate 3337c478bd9Sstevel@tonic-gate extern mdb_vespec_t *mdb_tgt_vespec_lookup(mdb_tgt_t *, int); 3347c478bd9Sstevel@tonic-gate 3359acbbeafSnn extern int mdb_tgt_auxv(mdb_tgt_t *, const auxv_t **); 3369acbbeafSnn 3377c478bd9Sstevel@tonic-gate extern void mdb_tgt_vespec_hold(mdb_tgt_t *, mdb_vespec_t *); 3387c478bd9Sstevel@tonic-gate extern void mdb_tgt_vespec_rele(mdb_tgt_t *, mdb_vespec_t *); 3397c478bd9Sstevel@tonic-gate 3407c478bd9Sstevel@tonic-gate /* 3417c478bd9Sstevel@tonic-gate * Utility function that target implementations can use to register dcmds, 3427c478bd9Sstevel@tonic-gate * walkers, and to create named variables for registers 3437c478bd9Sstevel@tonic-gate */ 3447c478bd9Sstevel@tonic-gate extern int mdb_tgt_register_dcmds(mdb_tgt_t *, const mdb_dcmd_t *, int); 3457c478bd9Sstevel@tonic-gate extern int mdb_tgt_register_walkers(mdb_tgt_t *, const mdb_walker_t *, int); 3467c478bd9Sstevel@tonic-gate extern void mdb_tgt_register_regvars(mdb_tgt_t *, const mdb_tgt_regdesc_t *, 3477c478bd9Sstevel@tonic-gate const mdb_nv_disc_t *, int); 3487c478bd9Sstevel@tonic-gate 3497c478bd9Sstevel@tonic-gate /* 3507c478bd9Sstevel@tonic-gate * Utility functions that target implementations can use to fill in the 3517c478bd9Sstevel@tonic-gate * mdb_se_ops_t structure and vespec destructor. Each software event specifier 3527c478bd9Sstevel@tonic-gate * must minimally supply its own constructor, info function, and match function. 3537c478bd9Sstevel@tonic-gate */ 3547c478bd9Sstevel@tonic-gate 3557c478bd9Sstevel@tonic-gate extern void no_ve_dtor(mdb_vespec_t *); 3567c478bd9Sstevel@tonic-gate extern void no_se_dtor(mdb_tgt_t *, mdb_sespec_t *); 3577c478bd9Sstevel@tonic-gate 3587c478bd9Sstevel@tonic-gate extern int no_se_secmp(mdb_tgt_t *, mdb_sespec_t *, void *); 3597c478bd9Sstevel@tonic-gate extern int no_se_vecmp(mdb_tgt_t *, mdb_vespec_t *, void *); 3607c478bd9Sstevel@tonic-gate extern int no_se_arm(mdb_tgt_t *, mdb_sespec_t *); 3617c478bd9Sstevel@tonic-gate extern int no_se_disarm(mdb_tgt_t *, mdb_sespec_t *); 3627c478bd9Sstevel@tonic-gate extern int no_se_cont(mdb_tgt_t *, mdb_sespec_t *, mdb_tgt_status_t *); 3637c478bd9Sstevel@tonic-gate 3647c478bd9Sstevel@tonic-gate /* 3657c478bd9Sstevel@tonic-gate * In the initial version of MDB, the data model property is not part of the 3667c478bd9Sstevel@tonic-gate * public API. However, I am providing this as a hidden part of the ABI as 3677c478bd9Sstevel@tonic-gate * one way we can handle the situation. If this turns out to be the right 3687c478bd9Sstevel@tonic-gate * decision, we can document it later without having to rev the API version. 3697c478bd9Sstevel@tonic-gate */ 3707c478bd9Sstevel@tonic-gate #define MDB_TGT_MODEL_UNKNOWN 0 /* Unknown data model */ 3717c478bd9Sstevel@tonic-gate #define MDB_TGT_MODEL_ILP32 1 /* Target data model is ILP32 */ 3727c478bd9Sstevel@tonic-gate #define MDB_TGT_MODEL_LP64 2 /* Target data model is LP64 */ 3737c478bd9Sstevel@tonic-gate 3747c478bd9Sstevel@tonic-gate #ifdef _LP64 3757c478bd9Sstevel@tonic-gate #define MDB_TGT_MODEL_NATIVE MDB_TGT_MODEL_LP64 3767c478bd9Sstevel@tonic-gate #else 3777c478bd9Sstevel@tonic-gate #define MDB_TGT_MODEL_NATIVE MDB_TGT_MODEL_ILP32 3787c478bd9Sstevel@tonic-gate #endif 3797c478bd9Sstevel@tonic-gate 3807c478bd9Sstevel@tonic-gate extern int mdb_prop_datamodel; 3817c478bd9Sstevel@tonic-gate 3827c478bd9Sstevel@tonic-gate #endif /* _MDB */ 3837c478bd9Sstevel@tonic-gate 3847c478bd9Sstevel@tonic-gate #ifdef __cplusplus 3857c478bd9Sstevel@tonic-gate } 3867c478bd9Sstevel@tonic-gate #endif 3877c478bd9Sstevel@tonic-gate 3887c478bd9Sstevel@tonic-gate #endif /* _MDB_TARGET_IMPL_H */ 389