This section provides some example command lines. For each example we'll break it down, argument by argument so that you can see how the command line works.

 

In all these examples the executable to run is exceptionTracer.exe. You will need to provide the full path to exceptionTracer.exe, or add the path to exceptionTracer install directory to your $PATH.

 

32 bit application monitoring: exceptionTracer.exe

64 bit application monitoring: exceptionTracer_x64.exe

 

 

Example 1

 

exceptionTracer.exe /exe e:\om\c\test\release\test.exe /dir e:\om\c\test\release /args "-add 3 4"

 

 /exe e:\om\c\test\release\test.exe

 

 Start application /exe e:\om\c\test\release\test.exe

 

 /dir e:\om\c\test\release

 

 Start the application in e:\om\c\test\release

 

 /args "-add 3 4"

 

 Pass the arguments -add 3 4 to the application being launched

 

 

Example 2

 

exceptionTracer.exe /process 1344

 

 /process 1344

 

 Attach to process 1344 and monitor that process.

 

 

Example 3

 

Launching ExceptionTracer from your own code to monitor a process you've just started. The arguments are the same as for Example 2.

 

int attachExceptionTracerToRunningProcess(DWORD         processId,          // process id to monitor
                                          const TCHAR   *dir)               // startup dir, can be NULL
{
   CString      exceptionTracer;
   int          bRet;
 
   exceptionTracer = getExceptionTracerPath(dir);
   if (GetFileAttributes(exceptionTracer) != INVALID_FILE_ATTRIBUTES)
   {
      // only try to launch if exception tracer is a valid filename
 
      TCHAR               commandLine[1000];
      STARTUPINFO         stStartInfo;
      PROCESS_INFORMATION stProcessInfo;
 
      memset(&stStartInfo, 0, sizeof(STARTUPINFO));
      memset(&stProcessInfo, 0, sizeof(PROCESS_INFORMATION));
 
      stStartInfo.cb = sizeof(STARTUPINFO);
 
      _stprintf_s(commandLine, sizeof(commandLine) / sizeof(commandLine[0]), _T("%s /process %u"), (const TCHAR *)exceptionTracer, processId);
 
      bRet = CreateProcess(NULL,
                           commandLine,
                           NULL,
                           NULL,
                           FALSE,
                           0,
                           NULL,
                           dir,
                           &stStartInfo,
                           &stProcessInfo);
      if (bRet)
      {
         WaitForInputIdle(stProcessInfo.hProcess, 10 * 1000);   // 10 seconds
 
         CloseHandle(stProcessInfo.hProcess);
         CloseHandle(stProcessInfo.hThread);
      }
   }
   else
      bRet = FALSE;
 
   return bRet;
}