manhole

provides remote debugging access to Python processes

TLDR

Connect to process
$ manhole [pid]
Connect to Unix socket
$ manhole [/var/run/manhole.sock]
Connect with timeout
$ manhole -t [30] [pid]
Verbose connection
$ manhole -v [pid]

SYNOPSIS

manhole [options] target

DESCRIPTION

manhole provides remote debugging access to Python processes. It opens an interactive Python shell.The tool connects to processes running the manhole library. Useful for debugging live applications.

PARAMETERS

TARGET

Process ID or socket path.
-t SECONDS
Connection timeout.
-v
Verbose output.
--help
Display help information.

CAVEATS

Target must use manhole library. Security considerations for production. Python-specific.

HISTORY

manhole was created to provide runtime debugging access to Python applications without restart.

SEE ALSO

gdb(1), strace(1), python(1)