[HOME]

Path : /usr/share/doc/abrt-dbus-2.1.11/html/
Upload :
Current File : //usr/share/doc/abrt-dbus-2.1.11/html/re01.html

<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>org.freedesktop.Problems</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="Problems API"><link rel="up" href="ch02.html" title="Chapter&#160;2.&#160;Interfaces"><link rel="prev" href="ch02.html" title="Chapter&#160;2.&#160;Interfaces"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">
          <code class="literal">org.freedesktop.Problems</code>
        </th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02.html">Prev</a>&#160;</td><th width="60%" align="center">Chapter&#160;2.&#160;Interfaces</th><td width="20%" align="right">&#160;</td></tr></table><hr></div><div class="refentry"><a name="org.freedesktop.Problems"></a><div class="titlepage"></div><div class="refnamediv"><h2><span class="refentrytitle">
          <code class="literal">org.freedesktop.Problems</code>
        </span></h2><p>org.freedesktop.Problems &#8212; The Problems Service manages all the crashes.</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="refsect2"><a name="methods"></a><h3>Methods</h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">NewProblem</b>
              (</code></td><td>IN Dict&lt;String,String&gt; <var class="pdparam">problem_data</var>, </td></tr><tr><td>&#160;</td><td>OUT String <var class="pdparam">problem_id</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">GetProblems</b>
              (</code></td><td>OUT Array&lt;String&gt; <var class="pdparam">response</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">GetForeignProblems</b>
              (</code></td><td>OUT Array&lt;String&gt; <var class="pdparam">response</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">GetAllProblems</b>
              (</code></td><td>OUT Array&lt;String&gt; <var class="pdparam">response</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">GetInfo</b>
              (</code></td><td>IN String <var class="pdparam">problem_dir</var>, </td></tr><tr><td>&#160;</td><td>IN Array&lt;String&gt; <var class="pdparam">element_names</var>, </td></tr><tr><td>&#160;</td><td>OUT Dict&lt;String,String&gt; <var class="pdparam">response</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">SetElement</b>
              (</code></td><td>IN String <var class="pdparam">problem_dir</var>, </td></tr><tr><td>&#160;</td><td>IN String <var class="pdparam">name</var>, </td></tr><tr><td>&#160;</td><td>IN String <var class="pdparam">value</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">DeleteElement</b>
              (</code></td><td>IN String <var class="pdparam">problem_dir</var>, </td></tr><tr><td>&#160;</td><td>IN String <var class="pdparam">name</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">TestElementExists</b>
              (</code></td><td>IN String <var class="pdparam">problem_dir</var>, </td></tr><tr><td>&#160;</td><td>IN String <var class="pdparam">name</var>, </td></tr><tr><td>&#160;</td><td>OUT Boolean <var class="pdparam">response</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">GetProblemData</b>
              (</code></td><td>IN String <var class="pdparam">problem_dir</var>, </td></tr><tr><td>&#160;</td><td>OUT Dict&lt;String,Int32&gt; <var class="pdparam">problem_data</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">ChownProblemDir</b>
              (</code></td><td>IN String <var class="pdparam">problem_dir</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">DeleteProblem</b>
              (</code></td><td>IN Array&lt;String&gt; <var class="pdparam">problem_dir</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">FindProblemByElementInTimeRange</b>
              (</code></td><td>IN String <var class="pdparam">element</var>, </td></tr><tr><td>&#160;</td><td>IN String <var class="pdparam">value</var>, </td></tr><tr><td>&#160;</td><td>IN Int64 <var class="pdparam">timestamp_from</var>, </td></tr><tr><td>&#160;</td><td>IN Int64 <var class="pdparam">timestamp_to</var>, </td></tr><tr><td>&#160;</td><td>IN Boolean <var class="pdparam">all_users</var>, </td></tr><tr><td>&#160;</td><td>OUT Array&lt;String&gt; <var class="pdparam">response</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">Quit</b>
              (</code></td><td><code>void)</code>;</td><td>&#160;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect2"><a name="signals"></a><h3>Signals</h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">Crash</b>
              (</code></td><td>OUT String <var class="pdparam">package</var>, </td></tr><tr><td>&#160;</td><td>OUT String <var class="pdparam">problem_id</var>, </td></tr><tr><td>&#160;</td><td>OUT String <var class="pdparam">uid</var>, </td></tr><tr><td>&#160;</td><td>OUT String <var class="pdparam">uuid</var>, </td></tr><tr><td>&#160;</td><td>OUT String <var class="pdparam">duphash</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div></div><div class="refsection"><a name="methods"></a><h2>Methods</h2><div class="refsection"><a name="org.freedesktop.Problems.NewProblem"></a><h3>
            <code class="literal">org.freedesktop.Problems.NewProblem</code>
          </h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">NewProblem</b>
              (</code></td><td>IN Dict&lt;String,String&gt; <var class="pdparam">problem_data</var>, </td></tr><tr><td>&#160;</td><td>OUT String <var class="pdparam">problem_id</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div><p>Creates a new problem and returns it's identifier.</p><p>
                    </p><div class="example"><a name="NewProblem_example_python"></a><p class="title"><b>Example&#160;2.1.&#160;How to create a new problems in Python</b></p><div class="example-contents"><pre class="programlisting">

#!/usr/bin/env python
import dbus

bus = dbus.SystemBus()

proxy = bus.get_object("org.freedesktop.problems",
                                  '/org/freedesktop/problems')

problems = dbus.Interface(proxy, dbus_interface='org.freedesktop.problems')

description = {"analyzer"    : "libreport",
               "reason"      : "Application has been killed",
               "backtrace"   : "die()",
               "executable"  : "/usr/bin/foo"}

problems.NewProblem(description)

                        </pre></div></div><p><br class="example-break">
                    </p><div class="example"><a name="NewProblem_example_bash"></a><p class="title"><b>Example&#160;2.2.&#160;How to create a new problems in Bash</b></p><div class="example-contents"><pre class="programlisting">

#!/usr/bin/bash
dbus-send --system --type=method_call --print-reply \
          --dest=org.freedesktop.problems /org/freedesktop/problems \
          org.freedesktop.problems.NewProblem \
          dict:string:string:analyzer,libreport,reason,"Application has been killed",backtrace,"die()",executable,"/usr/bin/true"

                        </pre></div></div><p><br class="example-break">
                </p><div class="glosslist"><dl><dt><span class="glossterm">
                <code class="literal">problem_data</code>
              </span></dt><dd class="glossdef"><p>
                        A dictionary describing problem. There are few commonly recognized fields but the dictionary can hold anything you need.
                        </p><div class="variablelist"><dl class="variablelist"><dt><span class="term">analyzer</span></dt><dd><p>This field should be always present. The field defines a type of problem. If the item is not provided, <span class="bold"><strong>libreport</strong></span> string is used by default.</p></dd><dt><span class="term">reason</span></dt><dd><p>This field should contain a short human readable text describing the problem.</p></dd><dt><span class="term">time</span></dt><dd><p>This field is filled automaticaly.</p></dd><dt><span class="term">uid</span></dt><dd><p>Only a user with root priviledges can pass this field. For all other users the field is filled by caller's uid.</p></dd><dt><span class="term">executable</span></dt><dd><p>This is mandatory field and must contain a valid path to an executable.</p></dd><dt><span class="term">component</span></dt><dd><p>A name of package which a problematic application belongs to. If this field is provided, <span class="bold"><strong>the executable field becomes optional</strong></span>.</p></dd><dt><span class="term">uuid</span></dt><dd><p>Machine readable identifier of a kind of the problem. ABRT uses this field for <span class="bold"><strong>local duplicates searching</strong></span>.</p></dd><dt><span class="term">duphash</span></dt><dd><p>Machine readable identifier of a kind of the problem. ABRT uses this field for <span class="bold"><strong>global duplicates searching</strong></span>.</p></dd></dl></div><p>
                    </p></dd><dt><span class="glossterm">
                <code class="literal">problem_id</code>
              </span></dt><dd class="glossdef"><p>An indentifier of the new problem</p></dd></dl></div></div><div class="refsection"><a name="org.freedesktop.Problems.GetProblems"></a><h3>
            <code class="literal">org.freedesktop.Problems.GetProblems</code>
          </h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">GetProblems</b>
              (</code></td><td>OUT Array&lt;String&gt; <var class="pdparam">response</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div><p>Gets a list of problem identifiers for problems visible by the caller.</p><p>
                    </p><div class="example"><a name="GetProblems_example_python"></a><p class="title"><b>Example&#160;2.3.&#160;How to get the list of problems in Python</b></p><div class="example-contents"><pre class="programlisting">

#!/usr/bin/env python
import dbus

bus = dbus.SystemBus()

proxy = bus.get_object("org.freedesktop.problems",
                                  '/org/freedesktop/problems')

problems = dbus.Interface(proxy, dbus_interface='org.freedesktop.problems')
prblms = problems.GetProblems()

                        </pre></div></div><p><br class="example-break">
                </p><div class="glosslist"><dl><dt><span class="glossterm">
                <code class="literal">response</code>
              </span></dt><dd class="glossdef"><p>List of problem identifiers</p></dd></dl></div></div><div class="refsection"><a name="org.freedesktop.Problems.GetForeignProblems"></a><h3>
            <code class="literal">org.freedesktop.Problems.GetForeignProblems</code>
          </h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">GetForeignProblems</b>
              (</code></td><td>OUT Array&lt;String&gt; <var class="pdparam">response</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div><p>Gets a list of problem identifiers for problems not directly accessible by the caller.</p><div class="glosslist"><dl><dt><span class="glossterm">
                <code class="literal">response</code>
              </span></dt><dd class="glossdef"><p>List of problem identifiers</p></dd></dl></div></div><div class="refsection"><a name="org.freedesktop.Problems.GetAllProblems"></a><h3>
            <code class="literal">org.freedesktop.Problems.GetAllProblems</code>
          </h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">GetAllProblems</b>
              (</code></td><td>OUT Array&lt;String&gt; <var class="pdparam">response</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div><p>Gets a list of problems visible by the caller.</p><div class="glosslist"><dl><dt><span class="glossterm">
                <code class="literal">response</code>
              </span></dt><dd class="glossdef"><p>List of problem identifiers</p></dd></dl></div></div><div class="refsection"><a name="org.freedesktop.Problems.GetInfo"></a><h3>
            <code class="literal">org.freedesktop.Problems.GetInfo</code>
          </h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">GetInfo</b>
              (</code></td><td>IN String <var class="pdparam">problem_dir</var>, </td></tr><tr><td>&#160;</td><td>IN Array&lt;String&gt; <var class="pdparam">element_names</var>, </td></tr><tr><td>&#160;</td><td>OUT Dict&lt;String,String&gt; <var class="pdparam">response</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div><p>Gets a value of problem's element.</p><p>
                    </p><div class="example"><a name="GetInfo_example_python"></a><p class="title"><b>Example&#160;2.4.&#160;How to use GetInfo() method to print out a nice list of problems</b></p><div class="example-contents"><pre class="programlisting">

#!/usr/bin/env python
from sys import stdout
import dbus
from datetime import datetime

bus = dbus.SystemBus()

proxy = bus.get_object("org.freedesktop.problems",
                          '/org/freedesktop/problems')

problems = dbus.Interface(proxy, dbus_interface='org.freedesktop.problems')

for prblmid in problems.GetProblems():
    kv = problems.GetInfo(prblmid, ["time", "count", "package", "reason"])

    date = datetime.fromtimestamp(float(kv["time"]))
    count = int(kv.get("count", 0))
    package = str(kv.get("package", ""))
    reason = str(kv.get("reason", ""))

    stdout.write("{0} {1:-3} {2:30} : {3}\n".format(date, count, package, reason))

                        </pre></div></div><p><br class="example-break">
                </p><div class="glosslist"><dl><dt><span class="glossterm">
                <code class="literal">problem_dir</code>
              </span></dt><dd class="glossdef"><p>Identifier of problem from which we want to get info.</p></dd><dt><span class="glossterm">
                <code class="literal">element_names</code>
              </span></dt><dd class="glossdef"><p>A list of names of required info.</p></dd><dt><span class="glossterm">
                <code class="literal">response</code>
              </span></dt><dd class="glossdef"><p>A list of values of the requested elements.</p></dd></dl></div></div><div class="refsection"><a name="org.freedesktop.Problems.SetElement"></a><h3>
            <code class="literal">org.freedesktop.Problems.SetElement</code>
          </h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">SetElement</b>
              (</code></td><td>IN String <var class="pdparam">problem_dir</var>, </td></tr><tr><td>&#160;</td><td>IN String <var class="pdparam">name</var>, </td></tr><tr><td>&#160;</td><td>IN String <var class="pdparam">value</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div><p>Sets a value of problem's element.</p><div class="glosslist"><dl><dt><span class="glossterm">
                <code class="literal">problem_dir</code>
              </span></dt><dd class="glossdef"><p>An identifier of problem.</p></dd><dt><span class="glossterm">
                <code class="literal">name</code>
              </span></dt><dd class="glossdef"><p>A name of set element.</p></dd><dt><span class="glossterm">
                <code class="literal">value</code>
              </span></dt><dd class="glossdef"><p>A value of problem's element.</p></dd></dl></div></div><div class="refsection"><a name="org.freedesktop.Problems.DeleteElement"></a><h3>
            <code class="literal">org.freedesktop.Problems.DeleteElement</code>
          </h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">DeleteElement</b>
              (</code></td><td>IN String <var class="pdparam">problem_dir</var>, </td></tr><tr><td>&#160;</td><td>IN String <var class="pdparam">name</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div><p>Deletes problem's element.</p><div class="glosslist"><dl><dt><span class="glossterm">
                <code class="literal">problem_dir</code>
              </span></dt><dd class="glossdef"><p>An identifier of problem.</p></dd><dt><span class="glossterm">
                <code class="literal">name</code>
              </span></dt><dd class="glossdef"><p>A name of deleted element.</p></dd></dl></div></div><div class="refsection"><a name="org.freedesktop.Problems.TestElementExists"></a><h3>
            <code class="literal">org.freedesktop.Problems.TestElementExists</code>
          </h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">TestElementExists</b>
              (</code></td><td>IN String <var class="pdparam">problem_dir</var>, </td></tr><tr><td>&#160;</td><td>IN String <var class="pdparam">name</var>, </td></tr><tr><td>&#160;</td><td>OUT Boolean <var class="pdparam">response</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div><p>Checks whether the element exists.</p><div class="glosslist"><dl><dt><span class="glossterm">
                <code class="literal">problem_dir</code>
              </span></dt><dd class="glossdef"><p>An identifier of problem.</p></dd><dt><span class="glossterm">
                <code class="literal">name</code>
              </span></dt><dd class="glossdef"><p>A name of checked element.</p></dd><dt><span class="glossterm">
                <code class="literal">response</code>
              </span></dt><dd class="glossdef"><p>True if the element exists; otherwise false.</p></dd></dl></div></div><div class="refsection"><a name="org.freedesktop.Problems.GetProblemData"></a><h3>
            <code class="literal">org.freedesktop.Problems.GetProblemData</code>
          </h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">GetProblemData</b>
              (</code></td><td>IN String <var class="pdparam">problem_dir</var>, </td></tr><tr><td>&#160;</td><td>OUT Dict&lt;String,Int32&gt; <var class="pdparam">problem_data</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div><p>Returns problem's data.</p><div class="glosslist"><dl><dt><span class="glossterm">
                <code class="literal">problem_dir</code>
              </span></dt><dd class="glossdef"><p>An identifier of problem.</p></dd><dt><span class="glossterm">
                <code class="literal">problem_data</code>
              </span></dt><dd class="glossdef"><p>A dictionary where keys are element names and values are triplets (element libreport flags, element size, element contents).</p></dd></dl></div></div><div class="refsection"><a name="org.freedesktop.Problems.ChownProblemDir"></a><h3>
            <code class="literal">org.freedesktop.Problems.ChownProblemDir</code>
          </h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">ChownProblemDir</b>
              (</code></td><td>IN String <var class="pdparam">problem_dir</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div><p>Assures ownership of a specified problem for the caller.</p><div class="glosslist"><dl><dt><span class="glossterm">
                <code class="literal">problem_dir</code>
              </span></dt><dd class="glossdef"><p>An indetifier of the problem.</p></dd></dl></div></div><div class="refsection"><a name="org.freedesktop.Problems.DeleteProblem"></a><h3>
            <code class="literal">org.freedesktop.Problems.DeleteProblem</code>
          </h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">DeleteProblem</b>
              (</code></td><td>IN Array&lt;String&gt; <var class="pdparam">problem_dir</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div><p>Deletes a specified problem.</p><div class="glosslist"><dl><dt><span class="glossterm">
                <code class="literal">problem_dir</code>
              </span></dt><dd class="glossdef"><p>An identifier of problem to be deleted.</p></dd></dl></div></div><div class="refsection"><a name="org.freedesktop.Problems.FindProblemByElementInTimeRange"></a><h3>
            <code class="literal">org.freedesktop.Problems.FindProblemByElementInTimeRange</code>
          </h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">FindProblemByElementInTimeRange</b>
              (</code></td><td>IN String <var class="pdparam">element</var>, </td></tr><tr><td>&#160;</td><td>IN String <var class="pdparam">value</var>, </td></tr><tr><td>&#160;</td><td>IN Int64 <var class="pdparam">timestamp_from</var>, </td></tr><tr><td>&#160;</td><td>IN Int64 <var class="pdparam">timestamp_to</var>, </td></tr><tr><td>&#160;</td><td>IN Boolean <var class="pdparam">all_users</var>, </td></tr><tr><td>&#160;</td><td>OUT Array&lt;String&gt; <var class="pdparam">response</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div><p>Finds an problem having an element's value and has been created in specified time range.</p><div class="glosslist"><dl><dt><span class="glossterm">
                <code class="literal">element</code>
              </span></dt><dd class="glossdef"><p>A name of searched element.</p></dd><dt><span class="glossterm">
                <code class="literal">value</code>
              </span></dt><dd class="glossdef"><p>A value of the searched element.</p></dd><dt><span class="glossterm">
                <code class="literal">timestamp_from</code>
              </span></dt><dd class="glossdef"><p>Beginnig of required time range.</p></dd><dt><span class="glossterm">
                <code class="literal">timestamp_to</code>
              </span></dt><dd class="glossdef"><p>End of required time range.</p></dd><dt><span class="glossterm">
                <code class="literal">all_users</code>
              </span></dt><dd class="glossdef"><p>Perform a look up in all system problems.</p></dd><dt><span class="glossterm">
                <code class="literal">response</code>
              </span></dt><dd class="glossdef"><p>List of problem idnetifiers.</p></dd></dl></div></div><div class="refsection"><a name="org.freedesktop.Problems.Quit"></a><h3>
            <code class="literal">org.freedesktop.Problems.Quit</code>
          </h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">Quit</b>
              (</code></td><td><code>void)</code>;</td><td>&#160;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div><p>Kills the service.</p></div></div><div class="refsection"><a name="signals"></a><h2>Signals</h2><div class="refsection"><a name="org.freedesktop.Problems.Crash"></a><h3>
            <code class="literal">org.freedesktop.Problems.Crash</code>
          </h3><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">
                <b class="fsfunc">Crash</b>
              (</code></td><td>OUT String <var class="pdparam">package</var>, </td></tr><tr><td>&#160;</td><td>OUT String <var class="pdparam">problem_id</var>, </td></tr><tr><td>&#160;</td><td>OUT String <var class="pdparam">uid</var>, </td></tr><tr><td>&#160;</td><td>OUT String <var class="pdparam">uuid</var>, </td></tr><tr><td>&#160;</td><td>OUT String <var class="pdparam">duphash</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div><p>A new system problem has been detected. This is the second variant of the Crash signal with additional argument <span class="emphasis"><em>uid</em></span></p><div class="glosslist"><dl><dt><span class="glossterm">
                <code class="literal">package</code>
              </span></dt><dd class="glossdef"><p>List of problem idnetifiers.</p></dd><dt><span class="glossterm">
                <code class="literal">problem_id</code>
              </span></dt><dd class="glossdef"><p>An identifier of the newly created problem.</p></dd><dt><span class="glossterm">
                <code class="literal">uid</code>
              </span></dt><dd class="glossdef"><p>UID of user who reported this problem.</p></dd><dt><span class="glossterm">
                <code class="literal">uuid</code>
              </span></dt><dd class="glossdef"><p>UUID - a weak problem identifier usuful for local duplicates look up.</p></dd><dt><span class="glossterm">
                <code class="literal">duphash</code>
              </span></dt><dd class="glossdef"><p>DUPHASH - a strong problem identifier usuful for global duplicates look up.</p></dd></dl></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Up</a></td><td width="40%" align="right">&#160;</td></tr><tr><td width="40%" align="left" valign="top">Chapter&#160;2.&#160;Interfaces&#160;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&#160;</td></tr></table></div></body></html>