1 //===-- DNB.h ---------------------------------------------------*- C++ -*-===// 2 // 3 // The LLVM Compiler Infrastructure 4 // 5 // This file is distributed under the University of Illinois Open Source 6 // License. See LICENSE.TXT for details. 7 // 8 //===----------------------------------------------------------------------===// 9 // 10 // Created by Greg Clayton on 3/23/07. 11 // 12 //===----------------------------------------------------------------------===// 13 14 #ifndef __DNB_h__ 15 #define __DNB_h__ 16 17 #include "DNBDefs.h" 18 #include <mach/thread_info.h> 19 #include <string> 20 21 typedef bool (*DNBShouldCancelCallback) (void *); 22 23 void DNBInitialize (); 24 void DNBTerminate (); 25 26 nub_bool_t DNBSetArchitecture (const char *arch); 27 28 //---------------------------------------------------------------------- 29 // Process control 30 //---------------------------------------------------------------------- 31 nub_process_t DNBProcessLaunch (const char *path, 32 char const *argv[], 33 const char *envp[], 34 const char *working_directory, // NULL => dont' change, non-NULL => set working directory for inferior to this 35 const char *stdin_path, 36 const char *stdout_path, 37 const char *stderr_path, 38 bool no_stdio, 39 nub_launch_flavor_t launch_flavor, 40 int disable_aslr, 41 char *err_str, 42 size_t err_len); 43 44 nub_process_t DNBProcessAttach (nub_process_t pid, struct timespec *timeout, char *err_str, size_t err_len); 45 nub_process_t DNBProcessAttachByName (const char *name, struct timespec *timeout, char *err_str, size_t err_len); 46 nub_process_t DNBProcessAttachWait (const char *wait_name, nub_launch_flavor_t launch_flavor, bool ignore_existing, struct timespec *timeout, useconds_t interval, char *err_str, size_t err_len, DNBShouldCancelCallback should_cancel = NULL, void *callback_data = NULL); 47 // Resume a process with exact instructions on what to do with each thread: 48 // - If no thread actions are supplied (actions is NULL or num_actions is zero), 49 // then all threads are continued. 50 // - If any thread actions are supplied, then each thread will do as it is told 51 // by the action. A default actions for any threads that don't have an 52 // explicit thread action can be made by making a thread action with a tid of 53 // INVALID_NUB_THREAD. If there is no default action, those threads will 54 // remain stopped. 55 nub_bool_t DNBProcessResume (nub_process_t pid, const DNBThreadResumeAction *actions, size_t num_actions); 56 nub_bool_t DNBProcessHalt (nub_process_t pid); 57 nub_bool_t DNBProcessDetach (nub_process_t pid); 58 nub_bool_t DNBProcessSignal (nub_process_t pid, int signal); 59 nub_bool_t DNBProcessKill (nub_process_t pid); 60 nub_size_t DNBProcessMemoryRead (nub_process_t pid, nub_addr_t addr, nub_size_t size, void *buf); 61 nub_size_t DNBProcessMemoryWrite (nub_process_t pid, nub_addr_t addr, nub_size_t size, const void *buf); 62 nub_addr_t DNBProcessMemoryAllocate (nub_process_t pid, nub_size_t size, uint32_t permissions); 63 nub_bool_t DNBProcessMemoryDeallocate (nub_process_t pid, nub_addr_t addr); 64 int DNBProcessMemoryRegionInfo (nub_process_t pid, nub_addr_t addr, DNBRegionInfo *region_info); 65 std::string DNBProcessGetProfileData (nub_process_t pid, DNBProfileDataScanType scanType); 66 nub_bool_t DNBProcessSetEnableAsyncProfiling (nub_process_t pid, nub_bool_t enable, uint64_t interval_usec, DNBProfileDataScanType scan_type); 67 68 //---------------------------------------------------------------------- 69 // Process status 70 //---------------------------------------------------------------------- 71 nub_bool_t DNBProcessIsAlive (nub_process_t pid); 72 nub_state_t DNBProcessGetState (nub_process_t pid); 73 nub_bool_t DNBProcessGetExitStatus (nub_process_t pid, int *status); 74 nub_bool_t DNBProcessSetExitStatus (nub_process_t pid, int status); 75 nub_size_t DNBProcessGetNumThreads (nub_process_t pid); 76 nub_thread_t DNBProcessGetCurrentThread (nub_process_t pid); 77 nub_thread_t DNBProcessGetCurrentThreadMachPort (nub_process_t pid); 78 nub_thread_t DNBProcessSetCurrentThread (nub_process_t pid, nub_thread_t tid); 79 nub_thread_t DNBProcessGetThreadAtIndex (nub_process_t pid, nub_size_t thread_idx); 80 nub_bool_t DNBProcessSyncThreadState (nub_process_t pid, nub_thread_t tid); 81 nub_addr_t DNBProcessGetSharedLibraryInfoAddress (nub_process_t pid); 82 nub_bool_t DNBProcessSharedLibrariesUpdated (nub_process_t pid); 83 nub_size_t DNBProcessGetSharedLibraryInfo (nub_process_t pid, nub_bool_t only_changed, DNBExecutableImageInfo **image_infos); 84 nub_bool_t DNBProcessSetNameToAddressCallback (nub_process_t pid, DNBCallbackNameToAddress callback, void *baton); 85 nub_bool_t DNBProcessSetSharedLibraryInfoCallback (nub_process_t pid, DNBCallbackCopyExecutableImageInfos callback, void *baton); 86 nub_addr_t DNBProcessLookupAddress (nub_process_t pid, const char *name, const char *shlib); 87 nub_size_t DNBProcessGetAvailableSTDOUT (nub_process_t pid, char *buf, nub_size_t buf_size); 88 nub_size_t DNBProcessGetAvailableSTDERR (nub_process_t pid, char *buf, nub_size_t buf_size); 89 nub_size_t DNBProcessGetAvailableProfileData (nub_process_t pid, char *buf, nub_size_t buf_size); 90 nub_size_t DNBProcessGetStopCount (nub_process_t pid); 91 uint32_t DNBProcessGetCPUType (nub_process_t pid); 92 93 //---------------------------------------------------------------------- 94 // Process executable and arguments 95 //---------------------------------------------------------------------- 96 const char * DNBProcessGetExecutablePath (nub_process_t pid); 97 const char * DNBProcessGetArgumentAtIndex (nub_process_t pid, nub_size_t idx); 98 nub_size_t DNBProcessGetArgumentCount (nub_process_t pid); 99 100 //---------------------------------------------------------------------- 101 // Process events 102 //---------------------------------------------------------------------- 103 nub_event_t DNBProcessWaitForEvents (nub_process_t pid, nub_event_t event_mask, bool wait_for_set, struct timespec* timeout); 104 void DNBProcessResetEvents (nub_process_t pid, nub_event_t event_mask); 105 106 //---------------------------------------------------------------------- 107 // Thread functions 108 //---------------------------------------------------------------------- 109 const char * DNBThreadGetName (nub_process_t pid, nub_thread_t tid); 110 nub_bool_t DNBThreadGetIdentifierInfo (nub_process_t pid, nub_thread_t tid, thread_identifier_info_data_t *ident_info); 111 nub_state_t DNBThreadGetState (nub_process_t pid, nub_thread_t tid); 112 nub_bool_t DNBThreadGetRegisterValueByID (nub_process_t pid, nub_thread_t tid, uint32_t set, uint32_t reg, DNBRegisterValue *value); 113 nub_bool_t DNBThreadSetRegisterValueByID (nub_process_t pid, nub_thread_t tid, uint32_t set, uint32_t reg, const DNBRegisterValue *value); 114 nub_size_t DNBThreadGetRegisterContext (nub_process_t pid, nub_thread_t tid, void *buf, size_t buf_len); 115 nub_size_t DNBThreadSetRegisterContext (nub_process_t pid, nub_thread_t tid, const void *buf, size_t buf_len); 116 uint32_t DNBThreadSaveRegisterState (nub_process_t pid, nub_thread_t tid); 117 nub_bool_t DNBThreadRestoreRegisterState (nub_process_t pid, nub_thread_t tid, uint32_t save_id); 118 nub_bool_t DNBThreadGetRegisterValueByName (nub_process_t pid, nub_thread_t tid, uint32_t set, const char *name, DNBRegisterValue *value); 119 nub_bool_t DNBThreadGetStopReason (nub_process_t pid, nub_thread_t tid, DNBThreadStopInfo *stop_info); 120 const char * DNBThreadGetInfo (nub_process_t pid, nub_thread_t tid); 121 //---------------------------------------------------------------------- 122 // Breakpoint functions 123 //---------------------------------------------------------------------- 124 nub_bool_t DNBBreakpointSet (nub_process_t pid, nub_addr_t addr, nub_size_t size, nub_bool_t hardware); 125 nub_bool_t DNBBreakpointClear (nub_process_t pid, nub_addr_t addr); 126 127 //---------------------------------------------------------------------- 128 // Watchpoint functions 129 //---------------------------------------------------------------------- 130 nub_bool_t DNBWatchpointSet (nub_process_t pid, nub_addr_t addr, nub_size_t size, uint32_t watch_flags, nub_bool_t hardware); 131 nub_bool_t DNBWatchpointClear (nub_process_t pid, nub_addr_t addr); 132 uint32_t DNBWatchpointGetNumSupportedHWP (nub_process_t pid); 133 134 const DNBRegisterSetInfo * 135 DNBGetRegisterSetInfo (nub_size_t *num_reg_sets); 136 nub_bool_t DNBGetRegisterInfoByName (const char *reg_name, DNBRegisterInfo* info); 137 138 //---------------------------------------------------------------------- 139 // Printf style formatting for printing values in the inferior memory 140 // space and registers. 141 //---------------------------------------------------------------------- 142 nub_size_t DNBPrintf (nub_process_t pid, nub_thread_t tid, nub_addr_t addr, FILE *file, const char *format); 143 144 //---------------------------------------------------------------------- 145 // Other static nub information calls. 146 //---------------------------------------------------------------------- 147 const char * DNBStateAsString (nub_state_t state); 148 nub_bool_t DNBResolveExecutablePath (const char *path, char *resolved_path, size_t resolved_path_size); 149 150 #endif 151