<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
[
  <!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
]>
<refentry id="ZeitgeistLog">
<refmeta>
<refentrytitle role="top_of_page" id="ZeitgeistLog.top_of_page">ZeitgeistLog</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>
  ZEITGEIST-2.0 Library
</refmiscinfo>
</refmeta>
<refnamediv>
<refname>ZeitgeistLog</refname>
<refpurpose>Primary access point for talking to the Zeitgeist daemon</refpurpose>
</refnamediv>

<refsynopsisdiv id="ZeitgeistLog.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>#define             <link linkend="ZEITGEIST-TYPE-LOG:CAPS">ZEITGEIST_TYPE_LOG</link>
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-insert-event">zeitgeist_log_insert_event</link>          (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> *event</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);
<link linkend="GArray"><returnvalue>GArray</returnvalue></link> *            <link linkend="zeitgeist-log-insert-event-finish">zeitgeist_log_insert_event_finish</link>   (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-insert-events">zeitgeist_log_insert_events</link>         (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *events</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);
<link linkend="GArray"><returnvalue>GArray</returnvalue></link> *            <link linkend="zeitgeist-log-insert-events-finish">zeitgeist_log_insert_events_finish</link>  (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-insert-event-no-reply">zeitgeist_log_insert_event_no_reply</link> (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> *event</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-insert-events-no-reply">zeitgeist_log_insert_events_no_reply</link>
                                                        (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *events</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-find-events">zeitgeist_log_find_events</link>           (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="ZeitgeistTimeRange"><type>ZeitgeistTimeRange</type></link> *time_range</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *event_templates</parameter>,
                                                         <parameter><link linkend="ZeitgeistStorageState"><type>ZeitgeistStorageState</type></link> storage_state</parameter>,
                                                         <parameter><link linkend="guint32"><type>guint32</type></link> num_events</parameter>,
                                                         <parameter><link linkend="ZeitgeistResultType"><type>ZeitgeistResultType</type></link> result_type</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);
<link linkend="ZeitgeistResultSet"><returnvalue>ZeitgeistResultSet</returnvalue></link> * <link linkend="zeitgeist-log-find-events-finish">zeitgeist_log_find_events_finish</link>   (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-find-event-ids">zeitgeist_log_find_event_ids</link>        (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="ZeitgeistTimeRange"><type>ZeitgeistTimeRange</type></link> *time_range</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *event_templates</parameter>,
                                                         <parameter><link linkend="ZeitgeistStorageState"><type>ZeitgeistStorageState</type></link> storage_state</parameter>,
                                                         <parameter><link linkend="guint32"><type>guint32</type></link> num_events</parameter>,
                                                         <parameter><link linkend="ZeitgeistResultType"><type>ZeitgeistResultType</type></link> result_type</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);
<link linkend="guint32"><returnvalue>guint32</returnvalue></link> *           <link linkend="zeitgeist-log-find-event-ids-finish">zeitgeist_log_find_event_ids_finish</link> (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> *result_length1</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-get-events">zeitgeist_log_get_events</link>            (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GArray"><type>GArray</type></link> *event_ids</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);
<link linkend="ZeitgeistResultSet"><returnvalue>ZeitgeistResultSet</returnvalue></link> * <link linkend="zeitgeist-log-get-events-finish">zeitgeist_log_get_events_finish</link>    (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-find-related-uris">zeitgeist_log_find_related_uris</link>     (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="ZeitgeistTimeRange"><type>ZeitgeistTimeRange</type></link> *time_range</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *event_templates</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *result_event_templates</parameter>,
                                                         <parameter><link linkend="ZeitgeistStorageState"><type>ZeitgeistStorageState</type></link> storage_state</parameter>,
                                                         <parameter><link linkend="guint32"><type>guint32</type></link> num_events</parameter>,
                                                         <parameter><link linkend="ZeitgeistRelevantResultType"><type>ZeitgeistRelevantResultType</type></link> result_type</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);
<link linkend="gchar"><returnvalue>gchar</returnvalue></link> **            <link linkend="zeitgeist-log-find-related-uris-finish">zeitgeist_log_find_related_uris_finish</link>
                                                        (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> *result_length1</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-delete-events">zeitgeist_log_delete_events</link>         (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GArray"><type>GArray</type></link> *event_ids</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);
<link linkend="ZeitgeistTimeRange"><returnvalue>ZeitgeistTimeRange</returnvalue></link> * <link linkend="zeitgeist-log-delete-events-finish">zeitgeist_log_delete_events_finish</link> (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-quit">zeitgeist_log_quit</link>                  (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-quit-finish">zeitgeist_log_quit_finish</link>           (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-install-monitor">zeitgeist_log_install_monitor</link>       (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="ZeitgeistMonitor"><type>ZeitgeistMonitor</type></link> *monitor</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-remove-monitor">zeitgeist_log_remove_monitor</link>        (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="ZeitgeistMonitor"><type>ZeitgeistMonitor</type></link> *monitor</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-remove-monitor-finish">zeitgeist_log_remove_monitor_finish</link> (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-log-get-version">zeitgeist_log_get_version</link>           (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> *major</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> *minor</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> *micro</parameter>);
<link linkend="gchar"><returnvalue>gchar</returnvalue></link> **            <link linkend="zeitgeist-log-get-extensions">zeitgeist_log_get_extensions</link>        (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> *result_length1</parameter>);
<link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             <link linkend="zeitgeist-log-datapath">zeitgeist_log_datapath</link>              (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>);
<link linkend="ZeitgeistLog"><returnvalue>ZeitgeistLog</returnvalue></link> *      <link linkend="zeitgeist-log-new">zeitgeist_log_new</link>                   (<parameter><type>void</type></parameter>);
<link linkend="ZeitgeistLog"><returnvalue>ZeitgeistLog</returnvalue></link> *      <link linkend="zeitgeist-log-get-default">zeitgeist_log_get_default</link>           (<parameter><type>void</type></parameter>);
struct              <link linkend="ZeitgeistLog-struct">ZeitgeistLog</link>;
struct              <link linkend="ZeitgeistLogClass">ZeitgeistLogClass</link>;
</synopsis>
</refsynopsisdiv>
<refsect1 id="ZeitgeistLog.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="ZeitgeistQueuedProxyWrapper">ZeitgeistQueuedProxyWrapper</link>
         +----ZeitgeistLog
</synopsis>
</refsect1>

<refsect1 id="ZeitgeistLog.description" role="desc">
<title role="desc.title">Description</title>
<para>
<para><link linkend="zeitgeist-log-new"><function><link linkend="zeitgeist-log-new"><function>zeitgeist_log_new()</function></link></function></link> encapsulates the low level access to the Zeitgeist daemon. You can use it to manage the log by inserting and deleting entries as well as do queries on the logged data.</para><para>It&apos;s important to realize that the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> class does not expose any API that does synchronous communications with the message bus - everything is asynchronous. To ease development some of the methods have variants that are &quot;fire and forget&quot; ignoring the normal return value, so that callbacks does not have to be set up.</para>
</para>
</refsect1>
<refsect1 id="ZeitgeistLog.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="ZEITGEIST-TYPE-LOG:CAPS" role="macro">
<title>ZEITGEIST_TYPE_LOG</title>
<indexterm zone="ZEITGEIST-TYPE-LOG:CAPS"><primary>ZEITGEIST_TYPE_LOG</primary></indexterm>
<programlisting>#define ZEITGEIST_TYPE_LOG (zeitgeist_log_get_type ())
</programlisting>
<para>
The type for <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link>.
</para></refsect2>
<refsect2 id="zeitgeist-log-insert-event" role="function">
<title>zeitgeist_log_insert_event ()</title>
<indexterm zone="zeitgeist-log-insert-event"><primary>zeitgeist_log_insert_event</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_insert_event          (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> *event</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);</programlisting>
<para>
Asynchronously send a set of events to the Zeitgeist daemon, requesting they be inserted into the log.
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-insert-event-finish"><function><link linkend="zeitgeist-log-insert-event-finish"><function>zeitgeist_log_insert_event_finish()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>event</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  A <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link>. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  a <link linkend="GCancellable"><type>GCancellable</type></link> to cancel the operation or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. <emphasis role="annotation">[<acronym>in</acronym>][<acronym>allow-none</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_callback_</parameter>&#160;:</term>
<listitem><simpara>callback to call when the request is satisfied. <emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_user_data_</parameter>&#160;:</term>
<listitem><simpara>the data to pass to <parameter>_callback_</parameter> function. <emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-insert-event-finish" role="function">
<title>zeitgeist_log_insert_event_finish ()</title>
<indexterm zone="zeitgeist-log-insert-event-finish"><primary>zeitgeist_log_insert_event_finish</primary></indexterm>
<programlisting><link linkend="GArray"><returnvalue>GArray</returnvalue></link> *            zeitgeist_log_insert_event_finish   (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>
Asynchronously send a set of events to the Zeitgeist daemon, requesting they be inserted into the log.
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-insert-event"><function><link linkend="zeitgeist-log-insert-event"><function>zeitgeist_log_insert_event()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>_res_</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GAsyncResult"><type>GAsyncResult</type></link></simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>location to store the error occuring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-insert-events" role="function">
<title>zeitgeist_log_insert_events ()</title>
<indexterm zone="zeitgeist-log-insert-events"><primary>zeitgeist_log_insert_events</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_insert_events         (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *events</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);</programlisting>
<para>
Asynchronously send a set of events to the Zeitgeist daemon, requesting they be inserted into the log.
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-insert-events-finish"><function><link linkend="zeitgeist-log-insert-events-finish"><function>zeitgeist_log_insert_events_finish()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>events</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  An <link linkend="GPtrArray"><type>GPtrArray</type></link> of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link>. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  a <link linkend="GCancellable"><type>GCancellable</type></link> to cancel the operation or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. <emphasis role="annotation">[<acronym>in</acronym>][<acronym>allow-none</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_callback_</parameter>&#160;:</term>
<listitem><simpara>callback to call when the request is satisfied. <emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_user_data_</parameter>&#160;:</term>
<listitem><simpara>the data to pass to <parameter>_callback_</parameter> function. <emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-insert-events-finish" role="function">
<title>zeitgeist_log_insert_events_finish ()</title>
<indexterm zone="zeitgeist-log-insert-events-finish"><primary>zeitgeist_log_insert_events_finish</primary></indexterm>
<programlisting><link linkend="GArray"><returnvalue>GArray</returnvalue></link> *            zeitgeist_log_insert_events_finish  (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>
Asynchronously send a set of events to the Zeitgeist daemon, requesting they be inserted into the log.
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-insert-events"><function><link linkend="zeitgeist-log-insert-events"><function>zeitgeist_log_insert_events()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>_res_</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GAsyncResult"><type>GAsyncResult</type></link></simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>location to store the error occuring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-insert-event-no-reply" role="function">
<title>zeitgeist_log_insert_event_no_reply ()</title>
<indexterm zone="zeitgeist-log-insert-event-no-reply"><primary>zeitgeist_log_insert_event_no_reply</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_insert_event_no_reply (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> *event</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>
Asynchronously send a set of events to the Zeitgeist daemon, requesting they be inserted into the log. This method is &amp;quot;fire and forget&amp;quot; and the caller will never know whether the events was successfully inserted or not.
</para>
<para>
<para>This method is exactly equivalent to calling <link linkend="zeitgeist-log-insert-event"><function>zeitgeist_log_insert_event()</function></link> with NULL set as <parameter>cancellable</parameter>, <parameter>callback</parameter>, and <parameter>user_data</parameter>.</para>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>event</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  A <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link>. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>location to store the error occuring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-insert-events-no-reply" role="function">
<title>zeitgeist_log_insert_events_no_reply ()</title>
<indexterm zone="zeitgeist-log-insert-events-no-reply"><primary>zeitgeist_log_insert_events_no_reply</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_insert_events_no_reply
                                                        (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *events</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>
Asynchronously send a set of events to the Zeitgeist daemon, requesting they be inserted into the log. This method is &amp;quot;fire and forget&amp;quot; and the caller will never know whether the events was successfully inserted or not.
</para>
<para>
<para>This method is exactly equivalent to calling <link linkend="zeitgeist-log-insert-event"><function>zeitgeist_log_insert_event()</function></link> with NULL set as <parameter>cancellable</parameter>, <parameter>callback</parameter>, and <parameter>user_data</parameter>.</para>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>events</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  An <link linkend="GPtrArray"><type>GPtrArray</type></link> of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link>. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>location to store the error occuring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-find-events" role="function">
<title>zeitgeist_log_find_events ()</title>
<indexterm zone="zeitgeist-log-find-events"><primary>zeitgeist_log_find_events</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_find_events           (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="ZeitgeistTimeRange"><type>ZeitgeistTimeRange</type></link> *time_range</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *event_templates</parameter>,
                                                         <parameter><link linkend="ZeitgeistStorageState"><type>ZeitgeistStorageState</type></link> storage_state</parameter>,
                                                         <parameter><link linkend="guint32"><type>guint32</type></link> num_events</parameter>,
                                                         <parameter><link linkend="ZeitgeistResultType"><type>ZeitgeistResultType</type></link> result_type</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);</programlisting>
<para>
Send a query matching a collection of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> templates to the <link linkend="zeitgeist-log-new"><function><link linkend="zeitgeist-log-new"><function>zeitgeist_log_new()</function></link></function></link>. The query will match if an event matches any of the templates. If an event template has more than one <link linkend="ZeitgeistSubject"><type>ZeitgeistSubject</type></link> the query will match if any one of the <link linkend="ZeitgeistSubject"><type>ZeitgeistSubject</type></link>s templates match.
</para>
<para>
<para>The query will be done via an asynchronous DBus call and this method will return immediately. The return value will be passed to callback as a list of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link>s. This list must be the sole argument for the callback.</para><para>If you need to do a query yielding a large (or unpredictable) result set and you only want to show some of the results at the same time (eg., by paging them), consider using <link linkend="zeitgeist-log-find-event-ids"><function><link linkend="zeitgeist-log-find-event-ids"><function>zeitgeist_log_find_event_ids()</function></link></function></link>.</para><para>In order to use this method there needs to be a mainloop runnning. Both Qt and GLib mainloops are supported.</para>
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-find-events-finish"><function><link linkend="zeitgeist-log-find-events-finish"><function>zeitgeist_log_find_events_finish()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>time_range</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  <link linkend="ZeitgeistTimeRange"><type>ZeitgeistTimeRange</type></link> A time range in which the events should be considered in. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>event_templates</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  An <link linkend="GPtrArray"><type>GPtrArray</type></link> of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link>. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>storage_state</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  <link linkend="ZeitgeistStorageState"><type>ZeitgeistStorageState</type></link> storage state. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>num_events</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  int represteing the number of events that should be returned. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>result_type</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  <link linkend="ZeitgeistResultType"><type>ZeitgeistResultType</type></link> how the events should be grouped and sorted. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  a <link linkend="GCancellable"><type>GCancellable</type></link> to cancel the operation or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. <emphasis role="annotation">[<acronym>in</acronym>][<acronym>allow-none</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_callback_</parameter>&#160;:</term>
<listitem><simpara>callback to call when the request is satisfied. <emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_user_data_</parameter>&#160;:</term>
<listitem><simpara>the data to pass to <parameter>_callback_</parameter> function. <emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-find-events-finish" role="function">
<title>zeitgeist_log_find_events_finish ()</title>
<indexterm zone="zeitgeist-log-find-events-finish"><primary>zeitgeist_log_find_events_finish</primary></indexterm>
<programlisting><link linkend="ZeitgeistResultSet"><returnvalue>ZeitgeistResultSet</returnvalue></link> * zeitgeist_log_find_events_finish   (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>
Send a query matching a collection of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> templates to the <link linkend="zeitgeist-log-new"><function><link linkend="zeitgeist-log-new"><function>zeitgeist_log_new()</function></link></function></link>. The query will match if an event matches any of the templates. If an event template has more than one <link linkend="ZeitgeistSubject"><type>ZeitgeistSubject</type></link> the query will match if any one of the <link linkend="ZeitgeistSubject"><type>ZeitgeistSubject</type></link>s templates match.
</para>
<para>
<para>The query will be done via an asynchronous DBus call and this method will return immediately. The return value will be passed to callback as a list of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link>s. This list must be the sole argument for the callback.</para><para>If you need to do a query yielding a large (or unpredictable) result set and you only want to show some of the results at the same time (eg., by paging them), consider using <link linkend="zeitgeist-log-find-event-ids"><function><link linkend="zeitgeist-log-find-event-ids"><function>zeitgeist_log_find_event_ids()</function></link></function></link>.</para><para>In order to use this method there needs to be a mainloop runnning. Both Qt and GLib mainloops are supported.</para>
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-find-events"><function><link linkend="zeitgeist-log-find-events"><function>zeitgeist_log_find_events()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>_res_</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GAsyncResult"><type>GAsyncResult</type></link></simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>location to store the error occuring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-find-event-ids" role="function">
<title>zeitgeist_log_find_event_ids ()</title>
<indexterm zone="zeitgeist-log-find-event-ids"><primary>zeitgeist_log_find_event_ids</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_find_event_ids        (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="ZeitgeistTimeRange"><type>ZeitgeistTimeRange</type></link> *time_range</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *event_templates</parameter>,
                                                         <parameter><link linkend="ZeitgeistStorageState"><type>ZeitgeistStorageState</type></link> storage_state</parameter>,
                                                         <parameter><link linkend="guint32"><type>guint32</type></link> num_events</parameter>,
                                                         <parameter><link linkend="ZeitgeistResultType"><type>ZeitgeistResultType</type></link> result_type</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);</programlisting>
<para>
Send a query matching a collection of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> templates to the <link linkend="zeitgeist-log-new"><function><link linkend="zeitgeist-log-new"><function>zeitgeist_log_new()</function></link></function></link>. The query will match if an event matches any of the templates. If an event template has more than one <link linkend="ZeitgeistSubject"><type>ZeitgeistSubject</type></link> the query will match if any one of the <link linkend="ZeitgeistSubject"><type>ZeitgeistSubject</type></link>s templates match.
</para>
<para>
<para>The query will be done via an asynchronous DBus call and this method will return immediately. The return value will be passed to callback as a list of intergers represrting <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> id&apos;s. This list must be the sole argument for the callback.</para><para>In order to use this method there needs to be a mainloop runnning. Both Qt and GLib mainloops are supported.</para>
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-find-event-ids-finish"><function><link linkend="zeitgeist-log-find-event-ids-finish"><function>zeitgeist_log_find_event_ids_finish()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>time_range</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  <link linkend="ZeitgeistTimeRange"><type>ZeitgeistTimeRange</type></link> A time range in which the events should be considered in. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>event_templates</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  An <link linkend="GPtrArray"><type>GPtrArray</type></link> of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link>. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>storage_state</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  <link linkend="ZeitgeistStorageState"><type>ZeitgeistStorageState</type></link> storage state. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>num_events</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  int represteing the number of events that should be returned. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>result_type</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  <link linkend="ZeitgeistResultType"><type>ZeitgeistResultType</type></link> how the events should be grouped and sorted. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  a <link linkend="GCancellable"><type>GCancellable</type></link> to cancel the operation or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. <emphasis role="annotation">[<acronym>in</acronym>][<acronym>allow-none</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_callback_</parameter>&#160;:</term>
<listitem><simpara>callback to call when the request is satisfied. <emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_user_data_</parameter>&#160;:</term>
<listitem><simpara>the data to pass to <parameter>_callback_</parameter> function. <emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-find-event-ids-finish" role="function">
<title>zeitgeist_log_find_event_ids_finish ()</title>
<indexterm zone="zeitgeist-log-find-event-ids-finish"><primary>zeitgeist_log_find_event_ids_finish</primary></indexterm>
<programlisting><link linkend="guint32"><returnvalue>guint32</returnvalue></link> *           zeitgeist_log_find_event_ids_finish (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> *result_length1</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>
Send a query matching a collection of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> templates to the <link linkend="zeitgeist-log-new"><function><link linkend="zeitgeist-log-new"><function>zeitgeist_log_new()</function></link></function></link>. The query will match if an event matches any of the templates. If an event template has more than one <link linkend="ZeitgeistSubject"><type>ZeitgeistSubject</type></link> the query will match if any one of the <link linkend="ZeitgeistSubject"><type>ZeitgeistSubject</type></link>s templates match.
</para>
<para>
<para>The query will be done via an asynchronous DBus call and this method will return immediately. The return value will be passed to callback as a list of intergers represrting <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> id&apos;s. This list must be the sole argument for the callback.</para><para>In order to use this method there needs to be a mainloop runnning. Both Qt and GLib mainloops are supported.</para>
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-find-event-ids"><function><link linkend="zeitgeist-log-find-event-ids"><function>zeitgeist_log_find_event_ids()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>_res_</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GAsyncResult"><type>GAsyncResult</type></link></simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>location to store the error occuring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-get-events" role="function">
<title>zeitgeist_log_get_events ()</title>
<indexterm zone="zeitgeist-log-get-events"><primary>zeitgeist_log_get_events</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_get_events            (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GArray"><type>GArray</type></link> *event_ids</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);</programlisting>
<para>
Look up a collection of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> in the <link linkend="zeitgeist-log-new"><function><link linkend="zeitgeist-log-new"><function>zeitgeist_log_new()</function></link></function></link> given a collection of event ids. This is useful for looking up the event data for events found with the find_event_ids_* family of functions.
</para>
<para>
<para>Each <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> which is not found in the <link linkend="zeitgeist-log-new"><function><link linkend="zeitgeist-log-new"><function>zeitgeist_log_new()</function></link></function></link> is represented by NULL in the resulting collection. The query will be done via an asynchronous DBus call and this method will return immediately. The returned events will be passed to callback as a list of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link>s, which must be the only argument of the function.</para><para>In order to use this method there needs to be a mainloop runnning.</para>
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-get-events-finish"><function><link linkend="zeitgeist-log-get-events-finish"><function>zeitgeist_log_get_events_finish()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>event_ids</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  a <link linkend="GArray"><type>GArray</type></link> of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> ids. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  a <link linkend="GCancellable"><type>GCancellable</type></link> to cancel the operation or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. <emphasis role="annotation">[<acronym>in</acronym>][<acronym>allow-none</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_callback_</parameter>&#160;:</term>
<listitem><simpara>callback to call when the request is satisfied. <emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_user_data_</parameter>&#160;:</term>
<listitem><simpara>the data to pass to <parameter>_callback_</parameter> function. <emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-get-events-finish" role="function">
<title>zeitgeist_log_get_events_finish ()</title>
<indexterm zone="zeitgeist-log-get-events-finish"><primary>zeitgeist_log_get_events_finish</primary></indexterm>
<programlisting><link linkend="ZeitgeistResultSet"><returnvalue>ZeitgeistResultSet</returnvalue></link> * zeitgeist_log_get_events_finish    (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>
Look up a collection of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> in the <link linkend="zeitgeist-log-new"><function><link linkend="zeitgeist-log-new"><function>zeitgeist_log_new()</function></link></function></link> given a collection of event ids. This is useful for looking up the event data for events found with the find_event_ids_* family of functions.
</para>
<para>
<para>Each <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> which is not found in the <link linkend="zeitgeist-log-new"><function><link linkend="zeitgeist-log-new"><function>zeitgeist_log_new()</function></link></function></link> is represented by NULL in the resulting collection. The query will be done via an asynchronous DBus call and this method will return immediately. The returned events will be passed to callback as a list of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link>s, which must be the only argument of the function.</para><para>In order to use this method there needs to be a mainloop runnning.</para>
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-get-events"><function><link linkend="zeitgeist-log-get-events"><function>zeitgeist_log_get_events()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>_res_</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GAsyncResult"><type>GAsyncResult</type></link></simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>location to store the error occuring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-find-related-uris" role="function">
<title>zeitgeist_log_find_related_uris ()</title>
<indexterm zone="zeitgeist-log-find-related-uris"><primary>zeitgeist_log_find_related_uris</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_find_related_uris     (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="ZeitgeistTimeRange"><type>ZeitgeistTimeRange</type></link> *time_range</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *event_templates</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *result_event_templates</parameter>,
                                                         <parameter><link linkend="ZeitgeistStorageState"><type>ZeitgeistStorageState</type></link> storage_state</parameter>,
                                                         <parameter><link linkend="guint32"><type>guint32</type></link> num_events</parameter>,
                                                         <parameter><link linkend="ZeitgeistRelevantResultType"><type>ZeitgeistRelevantResultType</type></link> result_type</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);</programlisting>
<para>
Get a list of URIs of subjects which frequently occur together with events matching event_templates. Possibly restricting to time_range or to URIs that occur as subject of events matching result_event_templates.
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-find-related-uris-finish"><function><link linkend="zeitgeist-log-find-related-uris-finish"><function>zeitgeist_log_find_related_uris_finish()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>time_range</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  <link linkend="ZeitgeistTimeRange"><type>ZeitgeistTimeRange</type></link> A time range in which the events should be considered in. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>event_templates</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  An <link linkend="GPtrArray"><type>GPtrArray</type></link> of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> describing the events to relate to. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>result_event_templates</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  An <link linkend="GPtrArray"><type>GPtrArray</type></link> of <link linkend="ZeitgeistEvent"><type>ZeitgeistEvent</type></link> desrcibing the result to be returned. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>storage_state</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  <link linkend="ZeitgeistStorageState"><type>ZeitgeistStorageState</type></link> storage state. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>num_events</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  int represteing the number of events that should be returned. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>result_type</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  <link linkend="ZeitgeistResultType"><type>ZeitgeistResultType</type></link> how the events should be grouped and sorted. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  a <link linkend="GCancellable"><type>GCancellable</type></link> to cancel the operation or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. <emphasis role="annotation">[<acronym>in</acronym>][<acronym>allow-none</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_callback_</parameter>&#160;:</term>
<listitem><simpara>callback to call when the request is satisfied. <emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_user_data_</parameter>&#160;:</term>
<listitem><simpara>the data to pass to <parameter>_callback_</parameter> function. <emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-find-related-uris-finish" role="function">
<title>zeitgeist_log_find_related_uris_finish ()</title>
<indexterm zone="zeitgeist-log-find-related-uris-finish"><primary>zeitgeist_log_find_related_uris_finish</primary></indexterm>
<programlisting><link linkend="gchar"><returnvalue>gchar</returnvalue></link> **            zeitgeist_log_find_related_uris_finish
                                                        (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> *result_length1</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>
Get a list of URIs of subjects which frequently occur together with events matching event_templates. Possibly restricting to time_range or to URIs that occur as subject of events matching result_event_templates.
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-find-related-uris"><function><link linkend="zeitgeist-log-find-related-uris"><function>zeitgeist_log_find_related_uris()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>_res_</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GAsyncResult"><type>GAsyncResult</type></link></simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>location to store the error occuring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-delete-events" role="function">
<title>zeitgeist_log_delete_events ()</title>
<indexterm zone="zeitgeist-log-delete-events"><primary>zeitgeist_log_delete_events</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_delete_events         (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GArray"><type>GArray</type></link> *event_ids</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);</programlisting>
<para>
Delete a collection of events from the zeitgeist log given their event ids.
</para>
<para>
<para>The deletion will be done asynchronously, and this method returns immediately.</para>
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-delete-events-finish"><function><link linkend="zeitgeist-log-delete-events-finish"><function>zeitgeist_log_delete_events_finish()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>event_ids</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  Array&lt;uint32&gt;. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  a <link linkend="GCancellable"><type>GCancellable</type></link> to cancel the operation or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. <emphasis role="annotation">[<acronym>in</acronym>][<acronym>allow-none</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_callback_</parameter>&#160;:</term>
<listitem><simpara>callback to call when the request is satisfied. <emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_user_data_</parameter>&#160;:</term>
<listitem><simpara>the data to pass to <parameter>_callback_</parameter> function. <emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-delete-events-finish" role="function">
<title>zeitgeist_log_delete_events_finish ()</title>
<indexterm zone="zeitgeist-log-delete-events-finish"><primary>zeitgeist_log_delete_events_finish</primary></indexterm>
<programlisting><link linkend="ZeitgeistTimeRange"><returnvalue>ZeitgeistTimeRange</returnvalue></link> * zeitgeist_log_delete_events_finish (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>
Delete a collection of events from the zeitgeist log given their event ids.
</para>
<para>
<para>The deletion will be done asynchronously, and this method returns immediately.</para>
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-delete-events"><function><link linkend="zeitgeist-log-delete-events"><function>zeitgeist_log_delete_events()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>_res_</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GAsyncResult"><type>GAsyncResult</type></link></simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>location to store the error occuring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-quit" role="function">
<title>zeitgeist_log_quit ()</title>
<indexterm zone="zeitgeist-log-quit"><primary>zeitgeist_log_quit</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_quit                  (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);</programlisting>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-quit-finish"><function><link linkend="zeitgeist-log-quit-finish"><function>zeitgeist_log_quit_finish()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  a <link linkend="GCancellable"><type>GCancellable</type></link> to cancel the operation or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. <emphasis role="annotation">[<acronym>in</acronym>][<acronym>allow-none</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_callback_</parameter>&#160;:</term>
<listitem><simpara>callback to call when the request is satisfied. <emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_user_data_</parameter>&#160;:</term>
<listitem><simpara>the data to pass to <parameter>_callback_</parameter> function. <emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-quit-finish" role="function">
<title>zeitgeist_log_quit_finish ()</title>
<indexterm zone="zeitgeist-log-quit-finish"><primary>zeitgeist_log_quit_finish</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_quit_finish           (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-quit"><function><link linkend="zeitgeist-log-quit"><function>zeitgeist_log_quit()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>_res_</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GAsyncResult"><type>GAsyncResult</type></link></simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>location to store the error occuring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-install-monitor" role="function">
<title>zeitgeist_log_install_monitor ()</title>
<indexterm zone="zeitgeist-log-install-monitor"><primary>zeitgeist_log_install_monitor</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_install_monitor       (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="ZeitgeistMonitor"><type>ZeitgeistMonitor</type></link> *monitor</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>
Install a monitor in the Zeitgeist engine that calls back when events matching event_templates are logged. The matching is done exactly as in the find_* family of methods and in Event.matches_template. Furthermore matched events must also have timestamps lying in time_range.
</para>
<para>
<para>To remove a monitor call <link linkend="remove-monitor"><function>remove_monitor()</function></link> on the returned Monitor instance.</para>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>monitor</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  A <link linkend="ZeitgeistMonitor"><type>ZeitgeistMonitor</type></link> to report back inserts and deletes. <emphasis role="annotation">[<acronym>in</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>location to store the error occuring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-remove-monitor" role="function">
<title>zeitgeist_log_remove_monitor ()</title>
<indexterm zone="zeitgeist-log-remove-monitor"><primary>zeitgeist_log_remove_monitor</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_remove_monitor        (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="ZeitgeistMonitor"><type>ZeitgeistMonitor</type></link> *monitor</parameter>,
                                                         <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> _callback_</parameter>,
                                                         <parameter><link linkend="gpointer"><type>gpointer</type></link> _user_data_</parameter>);</programlisting>
<para>
Remove a monitor from Zeitgeist engine that calls back when events matching event_templates are logged.
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-remove-monitor-finish"><function><link linkend="zeitgeist-log-remove-monitor-finish"><function>zeitgeist_log_remove_monitor_finish()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>monitor</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  A <link linkend="ZeitgeistMonitor"><type>ZeitgeistMonitor</type></link> to report back inserts and deletes. <emphasis role="annotation">[<acronym>in</acronym>][<acronym>transfer full</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_callback_</parameter>&#160;:</term>
<listitem><simpara>callback to call when the request is satisfied. <emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>_user_data_</parameter>&#160;:</term>
<listitem><simpara>the data to pass to <parameter>_callback_</parameter> function. <emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-remove-monitor-finish" role="function">
<title>zeitgeist_log_remove_monitor_finish ()</title>
<indexterm zone="zeitgeist-log-remove-monitor-finish"><primary>zeitgeist_log_remove_monitor_finish</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_remove_monitor_finish (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *_res_</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>
Remove a monitor from Zeitgeist engine that calls back when events matching event_templates are logged.
</para>
<para>
<emphasis>See also</emphasis>: <link linkend="zeitgeist-log-remove-monitor"><function><link linkend="zeitgeist-log-remove-monitor"><function>zeitgeist_log_remove_monitor()</function></link></function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>_res_</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GAsyncResult"><type>GAsyncResult</type></link></simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>location to store the error occuring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-get-version" role="function">
<title>zeitgeist_log_get_version ()</title>
<indexterm zone="zeitgeist-log-get-version"><primary>zeitgeist_log_get_version</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_log_get_version           (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> *major</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> *minor</parameter>,
                                                         <parameter><link linkend="gint"><type>gint</type></link> *micro</parameter>);</programlisting>
<para>
Gets version of currently running Zeitgeist daemon.
</para>
<para>
<para>This method will return the version of Zeitgeist daemon this instance is connected to. If you call this method right after <link linkend="zeitgeist-log-new"><function>zeitgeist_log_new()</function></link>, only zeros will be returned, a valid version number will only be returned once this instance successfully connected to the Zeitgeist daemon - ie. the value of the &quot;is-connected&quot; property must be TRUE (you can connect to the &quot;notify::is-connected&quot; signal otherwise).</para>
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>major</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  Location for the major version. <emphasis role="annotation">[<acronym>out</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>minor</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  Location for the minor version. <emphasis role="annotation">[<acronym>out</acronym>]</emphasis></simpara></listitem></varlistentry>
<varlistentry><term><parameter>micro</parameter>&#160;:</term>
<listitem><simpara>&nbsp;.  Location for the micro version. <emphasis role="annotation">[<acronym>out</acronym>]</emphasis></simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-get-extensions" role="function">
<title>zeitgeist_log_get_extensions ()</title>
<indexterm zone="zeitgeist-log-get-extensions"><primary>zeitgeist_log_get_extensions</primary></indexterm>
<programlisting><link linkend="gchar"><returnvalue>gchar</returnvalue></link> **            zeitgeist_log_get_extensions        (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> *result_length1</parameter>);</programlisting>
<para>
Gets extensions of the running Zeitgeist daemon.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>array of extenstions names strings. <emphasis role="annotation">[<acronym>array</acronym> length=result_length1]</emphasis></simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-datapath" role="function">
<title>zeitgeist_log_datapath ()</title>
<indexterm zone="zeitgeist-log-datapath"><primary>zeitgeist_log_datapath</primary></indexterm>
<programlisting><link linkend="gchar"><returnvalue>gchar</returnvalue></link> *             zeitgeist_log_datapath              (<parameter><link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> *self</parameter>);</programlisting>
<para>
Gets datapath of the running Zeitgeist daemon.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> instance</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>string datapath</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-log-new" role="function">
<title>zeitgeist_log_new ()</title>
<indexterm zone="zeitgeist-log-new"><primary>zeitgeist_log_new</primary></indexterm>
<programlisting><link linkend="ZeitgeistLog"><returnvalue>ZeitgeistLog</returnvalue></link> *      zeitgeist_log_new                   (<parameter><type>void</type></parameter>);</programlisting>
</refsect2>
<refsect2 id="zeitgeist-log-get-default" role="function">
<title>zeitgeist_log_get_default ()</title>
<indexterm zone="zeitgeist-log-get-default"><primary>zeitgeist_log_get_default</primary></indexterm>
<programlisting><link linkend="ZeitgeistLog"><returnvalue>ZeitgeistLog</returnvalue></link> *      zeitgeist_log_get_default           (<parameter><type>void</type></parameter>);</programlisting>
<para>
Get a unique instance of <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link>, that you can share in your application without caring about memory management.
</para>
<para>
<para>See <link linkend="zeitgeist-log-new"><function>zeitgeist_log_new()</function></link> for more information.</para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>ZeitgeistLog.</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ZeitgeistLog-struct" role="struct">
<title>struct ZeitgeistLog</title>
<indexterm zone="ZeitgeistLog-struct"><primary>ZeitgeistLog</primary></indexterm>
<programlisting>struct ZeitgeistLog;</programlisting>
<para>
Primary access point for talking to the Zeitgeist daemon
</para>
<para>
<para><link linkend="zeitgeist-log-new"><function><link linkend="zeitgeist-log-new"><function>zeitgeist_log_new()</function></link></function></link> encapsulates the low level access to the Zeitgeist daemon. You can use it to manage the log by inserting and deleting entries as well as do queries on the logged data.</para><para>It&apos;s important to realize that the <link linkend="ZeitgeistLog"><type>ZeitgeistLog</type></link> class does not expose any API that does synchronous communications with the message bus - everything is asynchronous. To ease development some of the methods have variants that are &quot;fire and forget&quot; ignoring the normal return value, so that callbacks does not have to be set up.</para>
</para></refsect2>
<refsect2 id="ZeitgeistLogClass" role="struct">
<title>struct ZeitgeistLogClass</title>
<indexterm zone="ZeitgeistLogClass"><primary>ZeitgeistLogClass</primary></indexterm>
<programlisting>struct ZeitgeistLogClass {
	ZeitgeistQueuedProxyWrapperClass parent_class;
};
</programlisting>
<para>
The class structure for <link linkend="ZEITGEIST-TYPE-LOG:CAPS"><literal>ZEITGEIST_TYPE_LOG</literal></link>. All the fields in this structure are private and should never be accessed directly.
</para><variablelist role="struct">
<varlistentry><term><link linkend="ZeitgeistQueuedProxyWrapperClass"><type>ZeitgeistQueuedProxyWrapperClass</type></link>&#160;<structfield id="ZeitgeistLogClass.parent-class">parent_class</structfield>;</term>
<listitem><simpara>the parent class structure</simpara></listitem>
</varlistentry>
</variablelist></refsect2>

</refsect1>

</refentry>
