1 """Python Daemon Management
3 This package aids in inspecting and managing daemon processes. A
4 program intended for running as a daemon may create PDM listeners, to
5 which PDM clients may connect in order to interact with the
8 This package contains the following modules:
10 * srv -- Server module
11 * cli -- Client module
12 * perf -- Library for implementing object for the PERF protocol
14 The protocol allows multiple management subprotocols for different
15 modes of operation. Currently, the following two management protocols
18 * The REPL protocol implements a simple read-eval-print loop which
19 accepts arbitrary Python code, executes it in the daemon process,
20 and returns its replies, all in text form. The protocol is simple,
21 generic, and has few failure modes, but is hardly suitable for
22 programmatic interaction. See the documentation for pdm.srv.repl
23 and pdm.cli.replclient for further details.
25 * The PERF protocol is intended for programmatic interaction with the
26 daemon process. Various Python modules may expose objects that
27 implement one or several of a few pre-defined interfaces that allow
28 for various forms of inspection and management of the program
29 state. See the documentation for pdm.srv.perf and
30 pdm.cli.perfclient for further details.