Enumeration

GumInterceptorScenario

Declaration

enum Gum.InterceptorScenario

Description [src]

Whether other threads may be running the code being instrumented. When the target is known to be quiescent — for example a process freshly created with spawn() whose main thread is still suspended before main()GUM_INTERCEPTOR_SCENARIO_OFFLINE lets it rewrite more freely, e.g. overwriting past a CALL since no other thread can already be inside the call waiting to return. GUM_INTERCEPTOR_SCENARIO_ONLINE is the safe choice for live processes where such concurrency is possible.

Members

GUM_INTERCEPTOR_SCENARIO_DEFAULT

Use the interceptor’s configured default.

  • Value: 0
  • Available since: 1.0
GUM_INTERCEPTOR_SCENARIO_ONLINE

Other threads may be executing the target code, so it must be instrumented conservatively.

  • Value: 1
  • Available since: 1.0
GUM_INTERCEPTOR_SCENARIO_OFFLINE

The target is quiescent, allowing more aggressive rewriting.

  • Value: 2
  • Available since: 1.0