The first and most important question to ask yourself is whether the thing you're trying to do belongs in debugd. We sandbox debugd, but it still has access to many privileged parts of the system, which means any code in debugd exposes a large attack surface. In general, you should aim to have as little code as possible in debugd - if you need elevated privileges to get a piece of data, add an accessor for that piece of data in debugd, and do any analytics you need elsewhere.
Once you‘ve looked at those documents and pondered that question, here’s how you'd go about adding a new piece of data debugd can return:
Decide whether it fits logically with an existing piece of data we return. If so, you‘re going to want to hack the tool that returns the existing data; if not, you’re going to need to add a new tool.
If you're adding a new tool, append it to TOOLS in
/src/makefile. Tools follow the general pattern of having a header called
/src/foo_tool.h and an implementation file called
If you're doing anything at all complicated, add a helper (see
/src/helpers), and use
/src/process_with_output.h) to capture its output before returning it over DBus. Helpers are subprograms that we can launch in sandboxes.
Once you've added your new tool (or hacked an existing one) and added your new helper (if necessary), write an autotest (or extended the existing
platform_DebugDaemon test) to cover the feature you added. The new helper does not need to be added to
/src/helpers/module.mk; common.mk will automagically pick it up and compile it.
Test, review, submit.
Hack the debugd ebuild to install your new helper (if applicable).