MCPcopy Create free account
hub / github.com/fabioz/PyDev.Debugger / execv

Method execv

pydevd_attach_to_process/winappdbg/debug.py:267–349  ·  view source on GitHub ↗

Starts a new process for debugging. This method uses a list of arguments. To use a command line string instead, use L{execl}. @see: L{attach}, L{detach} @type argv: list( str... ) @param argv: List of command line arguments to pass to the debugee.

(self, argv, **kwargs)

Source from the content-addressed store, hash-verified

265 return aProcess
266
267 def execv(self, argv, **kwargs):
268 """
269 Starts a new process for debugging.
270
271 This method uses a list of arguments. To use a command line string
272 instead, use L{execl}.
273
274 @see: L{attach}, L{detach}
275
276 @type argv: list( str... )
277 @param argv: List of command line arguments to pass to the debugee.
278 The first element must be the debugee executable filename.
279
280 @type bBreakOnEntryPoint: bool
281 @keyword bBreakOnEntryPoint: C{True} to automatically set a breakpoint
282 at the program entry point.
283
284 @type bConsole: bool
285 @keyword bConsole: True to inherit the console of the debugger.
286 Defaults to C{False}.
287
288 @type bFollow: bool
289 @keyword bFollow: C{True} to automatically attach to child processes.
290 Defaults to C{False}.
291
292 @type bInheritHandles: bool
293 @keyword bInheritHandles: C{True} if the new process should inherit
294 it's parent process' handles. Defaults to C{False}.
295
296 @type bSuspended: bool
297 @keyword bSuspended: C{True} to suspend the main thread before any code
298 is executed in the debugee. Defaults to C{False}.
299
300 @keyword dwParentProcessId: C{None} or C{0} if the debugger process
301 should be the parent process (default), or a process ID to
302 forcefully set as the debugee's parent (only available for Windows
303 Vista and above).
304
305 In hostile mode, the default is not the debugger process but the
306 process ID for "explorer.exe".
307
308 @type iTrustLevel: int or None
309 @keyword iTrustLevel: Trust level.
310 Must be one of the following values:
311 - 0: B{No trust}. May not access certain resources, such as
312 cryptographic keys and credentials. Only available since
313 Windows XP and 2003, desktop editions. This is the default
314 in hostile mode.
315 - 1: B{Normal trust}. Run with the same privileges as a normal
316 user, that is, one that doesn't have the I{Administrator} or
317 I{Power User} user rights. Only available since Windows XP
318 and 2003, desktop editions.
319 - 2: B{Full trust}. Run with the exact same privileges as the
320 current user. This is the default in normal mode.
321
322 @type bAllowElevation: bool
323 @keyword bAllowElevation: C{True} to allow the child process to keep
324 UAC elevation, if the debugger itself is running elevated. C{False}

Callers

nothing calls this directly

Calls 2

execlMethod · 0.95
argv_to_cmdlineMethod · 0.80

Tested by

no test coverage detected