bugreport-service: Add the ability to get coredump file from a report
[platform/core/system/crash-worker.git] / NOTES.rst
1 ============
2 Livecoredumper & livecoredump APIs
3 ============
4
5 ``livedump_pid()`` API method was created for use by system services and system
6 applications.
7
8 Applications wanting to use the API must have a special privilege
9 ``http://tizen.com/privilege/internal/livecoredump`` which can only be granted
10 manually by::
11
12     cyad -s -k MANIFESTS_GLOBAL -c User::Pkg::com.tizen.some.example.app -u 5001 -p http://tizen.com/privilege/internal/livecoredump -t ALLOW
13
14 For applications installed by RPM, you can add the above line to the ``%post``
15 section. There is no way to give this privilege to TPK applications from TPK
16 installer. In this case, the privilege should be granded externally, after the
17 TPK is installed.
18
19 System services wanting to use the API must provide appriate dbus configuration
20 that will allow such usage, eg.
21
22     <policy user="stability_monitor">
23             <allow send_destination="org.tizen.system.crash.livedump"
24                    send_interface="org.tizen.system.crash.livedump"
25                    send_member="livedump_pid"/>
26     </policy>
27