1*0Sstevel@tonic-gate /* 2*0Sstevel@tonic-gate * CDDL HEADER START 3*0Sstevel@tonic-gate * 4*0Sstevel@tonic-gate * The contents of this file are subject to the terms of the 5*0Sstevel@tonic-gate * Common Development and Distribution License, Version 1.0 only 6*0Sstevel@tonic-gate * (the "License"). You may not use this file except in compliance 7*0Sstevel@tonic-gate * with the License. 8*0Sstevel@tonic-gate * 9*0Sstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 10*0Sstevel@tonic-gate * or http://www.opensolaris.org/os/licensing. 11*0Sstevel@tonic-gate * See the License for the specific language governing permissions 12*0Sstevel@tonic-gate * and limitations under the License. 13*0Sstevel@tonic-gate * 14*0Sstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each 15*0Sstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 16*0Sstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the 17*0Sstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying 18*0Sstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner] 19*0Sstevel@tonic-gate * 20*0Sstevel@tonic-gate * CDDL HEADER END 21*0Sstevel@tonic-gate */ 22*0Sstevel@tonic-gate /* 23*0Sstevel@tonic-gate * Copyright 2004 Sun Microsystems, Inc. All rights reserved. 24*0Sstevel@tonic-gate * Use is subject to license terms. 25*0Sstevel@tonic-gate */ 26*0Sstevel@tonic-gate 27*0Sstevel@tonic-gate #ifndef _SYS_FASTTRAP_H 28*0Sstevel@tonic-gate #define _SYS_FASTTRAP_H 29*0Sstevel@tonic-gate 30*0Sstevel@tonic-gate #pragma ident "%Z%%M% %I% %E% SMI" 31*0Sstevel@tonic-gate 32*0Sstevel@tonic-gate #include <sys/fasttrap_isa.h> 33*0Sstevel@tonic-gate #include <sys/dtrace.h> 34*0Sstevel@tonic-gate #include <sys/types.h> 35*0Sstevel@tonic-gate 36*0Sstevel@tonic-gate #ifdef __cplusplus 37*0Sstevel@tonic-gate extern "C" { 38*0Sstevel@tonic-gate #endif 39*0Sstevel@tonic-gate 40*0Sstevel@tonic-gate #define FASTTRAPIOC (('m' << 24) | ('r' << 16) | ('f' << 8)) 41*0Sstevel@tonic-gate #define FASTTRAPIOC_MAKEPROBE (FASTTRAPIOC | 1) 42*0Sstevel@tonic-gate #define FASTTRAPIOC_GETINSTR (FASTTRAPIOC | 2) 43*0Sstevel@tonic-gate 44*0Sstevel@tonic-gate typedef enum fasttrap_probe_type { 45*0Sstevel@tonic-gate DTFTP_NONE = 0, 46*0Sstevel@tonic-gate DTFTP_ENTRY, 47*0Sstevel@tonic-gate DTFTP_RETURN, 48*0Sstevel@tonic-gate DTFTP_OFFSETS, 49*0Sstevel@tonic-gate DTFTP_POST_OFFSETS 50*0Sstevel@tonic-gate } fasttrap_probe_type_t; 51*0Sstevel@tonic-gate 52*0Sstevel@tonic-gate typedef struct fasttrap_probe_spec { 53*0Sstevel@tonic-gate pid_t ftps_pid; 54*0Sstevel@tonic-gate fasttrap_probe_type_t ftps_type; 55*0Sstevel@tonic-gate 56*0Sstevel@tonic-gate char ftps_func[DTRACE_FUNCNAMELEN]; 57*0Sstevel@tonic-gate char ftps_mod[DTRACE_MODNAMELEN]; 58*0Sstevel@tonic-gate 59*0Sstevel@tonic-gate uint64_t ftps_pc; 60*0Sstevel@tonic-gate uint64_t ftps_size; 61*0Sstevel@tonic-gate uint64_t ftps_noffs; 62*0Sstevel@tonic-gate uint64_t ftps_offs[1]; 63*0Sstevel@tonic-gate } fasttrap_probe_spec_t; 64*0Sstevel@tonic-gate 65*0Sstevel@tonic-gate typedef struct fasttrap_instr_query { 66*0Sstevel@tonic-gate uint64_t ftiq_pc; 67*0Sstevel@tonic-gate pid_t ftiq_pid; 68*0Sstevel@tonic-gate fasttrap_instr_t ftiq_instr; 69*0Sstevel@tonic-gate } fasttrap_instr_query_t; 70*0Sstevel@tonic-gate 71*0Sstevel@tonic-gate /* 72*0Sstevel@tonic-gate * To support the fasttrap provider from very early in a process's life, 73*0Sstevel@tonic-gate * the run-time linker, ld.so.1, has a program header of type PT_SUNWDTRACE 74*0Sstevel@tonic-gate * which points to a data object which must be PT_SUNWDTRACE_SIZE bytes. 75*0Sstevel@tonic-gate * This structure mimics the fasttrap provider section of the ulwp_t structure. 76*0Sstevel@tonic-gate * When the fasttrap provider is changed to require new or different 77*0Sstevel@tonic-gate * instructions, the data object in ld.so.1 and the thread initializers in libc 78*0Sstevel@tonic-gate * (libc_init() and _thrp_create()) need to be updated to include the new 79*0Sstevel@tonic-gate * instructions, and PT_SUNWDTRACE needs to be changed to a new unique number 80*0Sstevel@tonic-gate * (while the old value gets assigned something like PT_SUNWDTRACE_1). Since the 81*0Sstevel@tonic-gate * linker must be backward compatible with old Solaris releases, it must have 82*0Sstevel@tonic-gate * program headers for each of the PT_SUNWDTRACE versions. The kernel's 83*0Sstevel@tonic-gate * elfexec() function only has to look for the latest version of the 84*0Sstevel@tonic-gate * PT_SUNWDTRACE program header. 85*0Sstevel@tonic-gate */ 86*0Sstevel@tonic-gate #define PT_SUNWDTRACE_SIZE FASTTRAP_SUNWDTRACE_SIZE 87*0Sstevel@tonic-gate 88*0Sstevel@tonic-gate #ifdef __cplusplus 89*0Sstevel@tonic-gate } 90*0Sstevel@tonic-gate #endif 91*0Sstevel@tonic-gate 92*0Sstevel@tonic-gate #endif /* _SYS_FASTTRAP_H */ 93