<?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="zeitgeist-2.0-data-source">
<refmeta>
<refentrytitle role="top_of_page" id="zeitgeist-2.0-data-source.top_of_page">data-source</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>
  ZEITGEIST-2.0 Library
</refmiscinfo>
</refmeta>
<refnamediv>
<refname>data-source</refname>
<refpurpose>Abstracts data sources used by the DataSourceRegistry extension</refpurpose>
</refnamediv>

<refsynopsisdiv id="zeitgeist-2.0-data-source.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>
<anchor id="ZeitgeistDataSource"/>
<synopsis>#define             <link linkend="ZEITGEIST-TYPE-DATA-SOURCE:CAPS">ZEITGEIST_TYPE_DATA_SOURCE</link>
<link linkend="GVariant"><returnvalue>GVariant</returnvalue></link> *          <link linkend="zeitgeist-data-source-to-variant">zeitgeist_data_source_to_variant</link>    (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);
<link linkend="ZeitgeistDataSource"><returnvalue>ZeitgeistDataSource</returnvalue></link> * <link linkend="zeitgeist-data-source-new">zeitgeist_data_source_new</link>         (<parameter><type>void</type></parameter>);
<link linkend="ZeitgeistDataSource"><returnvalue>ZeitgeistDataSource</returnvalue></link> * <link linkend="zeitgeist-data-source-new-full">zeitgeist_data_source_new_full</link>    (<parameter>const <link linkend="gchar"><type>gchar</type></link> *unique_id</parameter>,
                                                         <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                                                         <parameter>const <link linkend="gchar"><type>gchar</type></link> *description</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *templates</parameter>);
<link linkend="ZeitgeistDataSource"><returnvalue>ZeitgeistDataSource</returnvalue></link> * <link linkend="zeitgeist-data-source-new-from-variant">zeitgeist_data_source_new_from_variant</link>
                                                        (<parameter><link linkend="GVariant"><type>GVariant</type></link> *variant</parameter>,
                                                         <parameter><link linkend="gboolean"><type>gboolean</type></link> reset_running</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);
const <link linkend="gchar"><returnvalue>gchar</returnvalue></link> *       <link linkend="zeitgeist-data-source-get-unique-id">zeitgeist_data_source_get_unique_id</link> (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-data-source-set-unique-id">zeitgeist_data_source_set_unique_id</link> (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>,
                                                         <parameter>const <link linkend="gchar"><type>gchar</type></link> *value</parameter>);
const <link linkend="gchar"><returnvalue>gchar</returnvalue></link> *       <link linkend="zeitgeist-data-source-get-name">zeitgeist_data_source_get_name</link>      (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-data-source-set-name">zeitgeist_data_source_set_name</link>      (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>,
                                                         <parameter>const <link linkend="gchar"><type>gchar</type></link> *value</parameter>);
const <link linkend="gchar"><returnvalue>gchar</returnvalue></link> *       <link linkend="zeitgeist-data-source-get-description">zeitgeist_data_source_get_description</link>
                                                        (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-data-source-set-description">zeitgeist_data_source_set_description</link>
                                                        (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>,
                                                         <parameter>const <link linkend="gchar"><type>gchar</type></link> *value</parameter>);
<link linkend="GPtrArray"><returnvalue>GPtrArray</returnvalue></link> *         <link linkend="zeitgeist-data-source-get-event-templates">zeitgeist_data_source_get_event_templates</link>
                                                        (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-data-source-set-event-templates">zeitgeist_data_source_set_event_templates</link>
                                                        (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *value</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="zeitgeist-data-source-get-enabled">zeitgeist_data_source_get_enabled</link>   (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-data-source-set-enabled">zeitgeist_data_source_set_enabled</link>   (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>,
                                                         <parameter><link linkend="gboolean"><type>gboolean</type></link> value</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="zeitgeist-data-source-get-running">zeitgeist_data_source_get_running</link>   (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-data-source-set-running">zeitgeist_data_source_set_running</link>   (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>,
                                                         <parameter><link linkend="gboolean"><type>gboolean</type></link> value</parameter>);
<link linkend="gint64"><returnvalue>gint64</returnvalue></link>              <link linkend="zeitgeist-data-source-get-timestamp">zeitgeist_data_source_get_timestamp</link> (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="zeitgeist-data-source-set-timestamp">zeitgeist_data_source_set_timestamp</link> (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>,
                                                         <parameter><link linkend="gint64"><type>gint64</type></link> value</parameter>);
struct              <link linkend="ZeitgeistDataSource-struct">ZeitgeistDataSource</link>;
struct              <link linkend="ZeitgeistDataSourceClass">ZeitgeistDataSourceClass</link>;
<link linkend="GPtrArray"><returnvalue>GPtrArray</returnvalue></link> *         <link linkend="zeitgeist-data-sources-from-variant">zeitgeist_data_sources_from_variant</link> (<parameter><link linkend="GVariant"><type>GVariant</type></link> *sources_variant</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);
<link linkend="GVariant"><returnvalue>GVariant</returnvalue></link> *          <link linkend="zeitgeist-data-sources-to-variant">zeitgeist_data_sources_to_variant</link>   (<parameter><link linkend="GHashTable"><type>GHashTable</type></link> *sources</parameter>);
#define             <link linkend="ZEITGEIST-DATA-SOURCES-SIG-DATASOURCES:CAPS">ZEITGEIST_DATA_SOURCES_SIG_DATASOURCES</link>
</synopsis>
</refsynopsisdiv>
<refsect1 id="zeitgeist-2.0-data-source.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----ZeitgeistDataSource
</synopsis>
</refsect1>
<refsect1 id="zeitgeist-2.0-data-source.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="ZeitgeistDataSource--description">description</link>&quot;              <link linkend="gchar"><type>gchar</type></link>*                : Read / Write
  &quot;<link linkend="ZeitgeistDataSource--enabled">enabled</link>&quot;                  <link linkend="gboolean"><type>gboolean</type></link>              : Read / Write
  &quot;<link linkend="ZeitgeistDataSource--event-templates">event-templates</link>&quot;          <link linkend="GPtrArray"><type>GPtrArray</type></link>*            : Read / Write
  &quot;<link linkend="ZeitgeistDataSource--name">name</link>&quot;                     <link linkend="gchar"><type>gchar</type></link>*                : Read / Write
  &quot;<link linkend="ZeitgeistDataSource--running">running</link>&quot;                  <link linkend="gboolean"><type>gboolean</type></link>              : Read / Write
  &quot;<link linkend="ZeitgeistDataSource--timestamp">timestamp</link>&quot;                <link linkend="gint64"><type>gint64</type></link>                : Read / Write
  &quot;<link linkend="ZeitgeistDataSource--unique-id">unique-id</link>&quot;                <link linkend="gchar"><type>gchar</type></link>*                : Read / Write
</synopsis>
</refsect1>

<refsect1 id="zeitgeist-2.0-data-source.description" role="desc">
<title role="desc.title">Description</title>
<para>
<para>ZeitgeistDataSource represents a data source used to insert events into Zeitgeist. The data sources are identified using the unique_id property, and when querying the data source registry you get other interesting information like timestamp of the last action of the data source, flag whether it is currently running etc.</para>
</para>
</refsect1>
<refsect1 id="zeitgeist-2.0-data-source.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="ZEITGEIST-TYPE-DATA-SOURCE:CAPS" role="macro">
<title>ZEITGEIST_TYPE_DATA_SOURCE</title>
<indexterm zone="ZEITGEIST-TYPE-DATA-SOURCE:CAPS"><primary>ZEITGEIST_TYPE_DATA_SOURCE</primary></indexterm>
<programlisting>#define ZEITGEIST_TYPE_DATA_SOURCE (zeitgeist_data_source_get_type ())
</programlisting>
<para>
The type for <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link>.
</para></refsect2>
<refsect2 id="zeitgeist-data-source-to-variant" role="function">
<title>zeitgeist_data_source_to_variant ()</title>
<indexterm zone="zeitgeist-data-source-to-variant"><primary>zeitgeist_data_source_to_variant</primary></indexterm>
<programlisting><link linkend="GVariant"><returnvalue>GVariant</returnvalue></link> *          zeitgeist_data_source_to_variant    (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);</programlisting>
<variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-new" role="function">
<title>zeitgeist_data_source_new ()</title>
<indexterm zone="zeitgeist-data-source-new"><primary>zeitgeist_data_source_new</primary></indexterm>
<programlisting><link linkend="ZeitgeistDataSource"><returnvalue>ZeitgeistDataSource</returnvalue></link> * zeitgeist_data_source_new         (<parameter><type>void</type></parameter>);</programlisting>
<para>
ZeitgeistDataSource
</para>
<para>
<para>Abstracts data sources used by the ZeitgeistDataSourceRegistry extension</para><para>ZeitgeistDataSource represents a data source used to insert events into Zeitgeist. The data sources are identified using the unique_id property, and when querying the data source registry you get other interesting information like timestamp of the last action of the data source, flag whether it is currently running etc.</para>
</para></refsect2>
<refsect2 id="zeitgeist-data-source-new-full" role="function">
<title>zeitgeist_data_source_new_full ()</title>
<indexterm zone="zeitgeist-data-source-new-full"><primary>zeitgeist_data_source_new_full</primary></indexterm>
<programlisting><link linkend="ZeitgeistDataSource"><returnvalue>ZeitgeistDataSource</returnvalue></link> * zeitgeist_data_source_new_full    (<parameter>const <link linkend="gchar"><type>gchar</type></link> *unique_id</parameter>,
                                                         <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                                                         <parameter>const <link linkend="gchar"><type>gchar</type></link> *description</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *templates</parameter>);</programlisting>
<variablelist role="params">
<varlistentry><term><parameter>unique_id</parameter>&#160;:</term>
<listitem><simpara>&nbsp;</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>&nbsp;</simpara></listitem></varlistentry>
<varlistentry><term><parameter>description</parameter>&#160;:</term>
<listitem><simpara>&nbsp;</simpara></listitem></varlistentry>
<varlistentry><term><parameter>templates</parameter>&#160;:</term>
<listitem><simpara>&nbsp;</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-new-from-variant" role="function">
<title>zeitgeist_data_source_new_from_variant ()</title>
<indexterm zone="zeitgeist-data-source-new-from-variant"><primary>zeitgeist_data_source_new_from_variant</primary></indexterm>
<programlisting><link linkend="ZeitgeistDataSource"><returnvalue>ZeitgeistDataSource</returnvalue></link> * zeitgeist_data_source_new_from_variant
                                                        (<parameter><link linkend="GVariant"><type>GVariant</type></link> *variant</parameter>,
                                                         <parameter><link linkend="gboolean"><type>gboolean</type></link> reset_running</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<variablelist role="params">
<varlistentry><term><parameter>variant</parameter>&#160;:</term>
<listitem><simpara>&nbsp;</simpara></listitem></varlistentry>
<varlistentry><term><parameter>reset_running</parameter>&#160;:</term>
<listitem><simpara>&nbsp;</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. <emphasis role="annotation">[<acronym>error-domains</acronym> ZeitgeistDataModelError]</emphasis></simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-get-unique-id" role="function">
<title>zeitgeist_data_source_get_unique_id ()</title>
<indexterm zone="zeitgeist-data-source-get-unique-id"><primary>zeitgeist_data_source_get_unique_id</primary></indexterm>
<programlisting>const <link linkend="gchar"><returnvalue>gchar</returnvalue></link> *       zeitgeist_data_source_get_unique_id (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);</programlisting>
<para>
Get and return the current value of the <link linkend="ZeitgeistDataSource--unique-id"><type>"unique-id"</type></link> property.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance to query</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>the value of the <link linkend="ZeitgeistDataSource--unique-id"><type>"unique-id"</type></link> property</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-set-unique-id" role="function">
<title>zeitgeist_data_source_set_unique_id ()</title>
<indexterm zone="zeitgeist-data-source-set-unique-id"><primary>zeitgeist_data_source_set_unique_id</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_data_source_set_unique_id (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>,
                                                         <parameter>const <link linkend="gchar"><type>gchar</type></link> *value</parameter>);</programlisting>
<para>
Set the value of the <link linkend="ZeitgeistDataSource--unique-id"><type>"unique-id"</type></link> property to <parameter>value</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance to modify</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>the new value of the <link linkend="ZeitgeistDataSource--unique-id"><type>"unique-id"</type></link> property</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-get-name" role="function">
<title>zeitgeist_data_source_get_name ()</title>
<indexterm zone="zeitgeist-data-source-get-name"><primary>zeitgeist_data_source_get_name</primary></indexterm>
<programlisting>const <link linkend="gchar"><returnvalue>gchar</returnvalue></link> *       zeitgeist_data_source_get_name      (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);</programlisting>
<para>
Get and return the current value of the <link linkend="ZeitgeistDataSource--name"><type>"name"</type></link> property.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance to query</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>the value of the <link linkend="ZeitgeistDataSource--name"><type>"name"</type></link> property</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-set-name" role="function">
<title>zeitgeist_data_source_set_name ()</title>
<indexterm zone="zeitgeist-data-source-set-name"><primary>zeitgeist_data_source_set_name</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_data_source_set_name      (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>,
                                                         <parameter>const <link linkend="gchar"><type>gchar</type></link> *value</parameter>);</programlisting>
<para>
Set the value of the <link linkend="ZeitgeistDataSource--name"><type>"name"</type></link> property to <parameter>value</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance to modify</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>the new value of the <link linkend="ZeitgeistDataSource--name"><type>"name"</type></link> property</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-get-description" role="function">
<title>zeitgeist_data_source_get_description ()</title>
<indexterm zone="zeitgeist-data-source-get-description"><primary>zeitgeist_data_source_get_description</primary></indexterm>
<programlisting>const <link linkend="gchar"><returnvalue>gchar</returnvalue></link> *       zeitgeist_data_source_get_description
                                                        (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);</programlisting>
<para>
Get and return the current value of the <link linkend="ZeitgeistDataSource--description"><type>"description"</type></link> property.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance to query</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>the value of the <link linkend="ZeitgeistDataSource--description"><type>"description"</type></link> property</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-set-description" role="function">
<title>zeitgeist_data_source_set_description ()</title>
<indexterm zone="zeitgeist-data-source-set-description"><primary>zeitgeist_data_source_set_description</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_data_source_set_description
                                                        (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>,
                                                         <parameter>const <link linkend="gchar"><type>gchar</type></link> *value</parameter>);</programlisting>
<para>
Set the value of the <link linkend="ZeitgeistDataSource--description"><type>"description"</type></link> property to <parameter>value</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance to modify</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>the new value of the <link linkend="ZeitgeistDataSource--description"><type>"description"</type></link> property</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-get-event-templates" role="function">
<title>zeitgeist_data_source_get_event_templates ()</title>
<indexterm zone="zeitgeist-data-source-get-event-templates"><primary>zeitgeist_data_source_get_event_templates</primary></indexterm>
<programlisting><link linkend="GPtrArray"><returnvalue>GPtrArray</returnvalue></link> *         zeitgeist_data_source_get_event_templates
                                                        (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);</programlisting>
<para>
Get and return the current value of the <link linkend="ZeitgeistDataSource--event-templates"><type>"event-templates"</type></link> property.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance to query</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>the value of the <link linkend="ZeitgeistDataSource--event-templates"><type>"event-templates"</type></link> property</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-set-event-templates" role="function">
<title>zeitgeist_data_source_set_event_templates ()</title>
<indexterm zone="zeitgeist-data-source-set-event-templates"><primary>zeitgeist_data_source_set_event_templates</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_data_source_set_event_templates
                                                        (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>,
                                                         <parameter><link linkend="GPtrArray"><type>GPtrArray</type></link> *value</parameter>);</programlisting>
<para>
Set the value of the <link linkend="ZeitgeistDataSource--event-templates"><type>"event-templates"</type></link> property to <parameter>value</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance to modify</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>the new value of the <link linkend="ZeitgeistDataSource--event-templates"><type>"event-templates"</type></link> property</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-get-enabled" role="function">
<title>zeitgeist_data_source_get_enabled ()</title>
<indexterm zone="zeitgeist-data-source-get-enabled"><primary>zeitgeist_data_source_get_enabled</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            zeitgeist_data_source_get_enabled   (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);</programlisting>
<para>
Get and return the current value of the <link linkend="ZeitgeistDataSource--enabled"><type>"enabled"</type></link> property.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance to query</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>the value of the <link linkend="ZeitgeistDataSource--enabled"><type>"enabled"</type></link> property</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-set-enabled" role="function">
<title>zeitgeist_data_source_set_enabled ()</title>
<indexterm zone="zeitgeist-data-source-set-enabled"><primary>zeitgeist_data_source_set_enabled</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_data_source_set_enabled   (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>,
                                                         <parameter><link linkend="gboolean"><type>gboolean</type></link> value</parameter>);</programlisting>
<para>
Set the value of the <link linkend="ZeitgeistDataSource--enabled"><type>"enabled"</type></link> property to <parameter>value</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance to modify</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>the new value of the <link linkend="ZeitgeistDataSource--enabled"><type>"enabled"</type></link> property</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-get-running" role="function">
<title>zeitgeist_data_source_get_running ()</title>
<indexterm zone="zeitgeist-data-source-get-running"><primary>zeitgeist_data_source_get_running</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            zeitgeist_data_source_get_running   (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);</programlisting>
<para>
Get and return the current value of the <link linkend="ZeitgeistDataSource--running"><type>"running"</type></link> property.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance to query</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>the value of the <link linkend="ZeitgeistDataSource--running"><type>"running"</type></link> property</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-set-running" role="function">
<title>zeitgeist_data_source_set_running ()</title>
<indexterm zone="zeitgeist-data-source-set-running"><primary>zeitgeist_data_source_set_running</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_data_source_set_running   (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>,
                                                         <parameter><link linkend="gboolean"><type>gboolean</type></link> value</parameter>);</programlisting>
<para>
Set the value of the <link linkend="ZeitgeistDataSource--running"><type>"running"</type></link> property to <parameter>value</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance to modify</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>the new value of the <link linkend="ZeitgeistDataSource--running"><type>"running"</type></link> property</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-get-timestamp" role="function">
<title>zeitgeist_data_source_get_timestamp ()</title>
<indexterm zone="zeitgeist-data-source-get-timestamp"><primary>zeitgeist_data_source_get_timestamp</primary></indexterm>
<programlisting><link linkend="gint64"><returnvalue>gint64</returnvalue></link>              zeitgeist_data_source_get_timestamp (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>);</programlisting>
<para>
Get and return the current value of the <link linkend="ZeitgeistDataSource--timestamp"><type>"timestamp"</type></link> property.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance to query</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>the value of the <link linkend="ZeitgeistDataSource--timestamp"><type>"timestamp"</type></link> property</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-source-set-timestamp" role="function">
<title>zeitgeist_data_source_set_timestamp ()</title>
<indexterm zone="zeitgeist-data-source-set-timestamp"><primary>zeitgeist_data_source_set_timestamp</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                zeitgeist_data_source_set_timestamp (<parameter><link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> *self</parameter>,
                                                         <parameter><link linkend="gint64"><type>gint64</type></link> value</parameter>);</programlisting>
<para>
Set the value of the <link linkend="ZeitgeistDataSource--timestamp"><type>"timestamp"</type></link> property to <parameter>value</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="ZeitgeistDataSource"><type>ZeitgeistDataSource</type></link> instance to modify</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>the new value of the <link linkend="ZeitgeistDataSource--timestamp"><type>"timestamp"</type></link> property</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ZeitgeistDataSource-struct" role="struct">
<title>struct ZeitgeistDataSource</title>
<indexterm zone="ZeitgeistDataSource-struct"><primary>ZeitgeistDataSource</primary></indexterm>
<programlisting>struct ZeitgeistDataSource;</programlisting>
</refsect2>
<refsect2 id="ZeitgeistDataSourceClass" role="struct">
<title>struct ZeitgeistDataSourceClass</title>
<indexterm zone="ZeitgeistDataSourceClass"><primary>ZeitgeistDataSourceClass</primary></indexterm>
<programlisting>struct ZeitgeistDataSourceClass {
	GObjectClass parent_class;
};
</programlisting>
<para>
The class structure for <link linkend="ZEITGEIST-TYPE-DATA-SOURCE:CAPS"><literal>ZEITGEIST_TYPE_DATA_SOURCE</literal></link>. All the fields in this structure are private and should never be accessed directly.
</para><variablelist role="struct">
<varlistentry><term><link linkend="GObjectClass"><type>GObjectClass</type></link>&#160;<structfield id="ZeitgeistDataSourceClass.parent-class">parent_class</structfield>;</term>
<listitem><simpara>the parent class structure</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-sources-from-variant" role="function">
<title>zeitgeist_data_sources_from_variant ()</title>
<indexterm zone="zeitgeist-data-sources-from-variant"><primary>zeitgeist_data_sources_from_variant</primary></indexterm>
<programlisting><link linkend="GPtrArray"><returnvalue>GPtrArray</returnvalue></link> *         zeitgeist_data_sources_from_variant (<parameter><link linkend="GVariant"><type>GVariant</type></link> *sources_variant</parameter>,
                                                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the (null) instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>sources_variant</parameter>&#160;:</term>
<listitem><simpara>&nbsp;</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. <emphasis role="annotation">[<acronym>error-domains</acronym> ZeitgeistDataModelError]</emphasis></simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="zeitgeist-data-sources-to-variant" role="function">
<title>zeitgeist_data_sources_to_variant ()</title>
<indexterm zone="zeitgeist-data-sources-to-variant"><primary>zeitgeist_data_sources_to_variant</primary></indexterm>
<programlisting><link linkend="GVariant"><returnvalue>GVariant</returnvalue></link> *          zeitgeist_data_sources_to_variant   (<parameter><link linkend="GHashTable"><type>GHashTable</type></link> *sources</parameter>);</programlisting>
<variablelist role="params">
<varlistentry><term><parameter>self</parameter>&#160;:</term>
<listitem><simpara>the (null) instance</simpara></listitem></varlistentry>
<varlistentry><term><parameter>sources</parameter>&#160;:</term>
<listitem><simpara>&nbsp;</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ZEITGEIST-DATA-SOURCES-SIG-DATASOURCES:CAPS" role="macro">
<title>ZEITGEIST_DATA_SOURCES_SIG_DATASOURCES</title>
<indexterm zone="ZEITGEIST-DATA-SOURCES-SIG-DATASOURCES:CAPS"><primary>ZEITGEIST_DATA_SOURCES_SIG_DATASOURCES</primary></indexterm>
<programlisting>#define ZEITGEIST_DATA_SOURCES_SIG_DATASOURCES "a(sssa(" ZEITGEIST_UTILS_SIG_EVENT ")bxb)"
</programlisting>
</refsect2>

</refsect1>
<refsect1 id="zeitgeist-2.0-data-source.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="ZeitgeistDataSource--description" role="property"><title>The <literal>&quot;description&quot;</literal> property</title>
<indexterm zone="ZeitgeistDataSource--description"><primary>ZeitgeistDataSource:description</primary></indexterm>
<programlisting>  &quot;description&quot;              <link linkend="gchar"><type>gchar</type></link>*                : Read / Write</programlisting>
<para>description.</para><para>Default value: NULL</para>
</refsect2>
<refsect2 id="ZeitgeistDataSource--enabled" role="property"><title>The <literal>&quot;enabled&quot;</literal> property</title>
<indexterm zone="ZeitgeistDataSource--enabled"><primary>ZeitgeistDataSource:enabled</primary></indexterm>
<programlisting>  &quot;enabled&quot;                  <link linkend="gboolean"><type>gboolean</type></link>              : Read / Write</programlisting>
<para>enabled.</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="ZeitgeistDataSource--event-templates" role="property"><title>The <literal>&quot;event-templates&quot;</literal> property</title>
<indexterm zone="ZeitgeistDataSource--event-templates"><primary>ZeitgeistDataSource:event-templates</primary></indexterm>
<programlisting>  &quot;event-templates&quot;          <link linkend="GPtrArray"><type>GPtrArray</type></link>*            : Read / Write</programlisting>
<para>event-templates.</para></refsect2>
<refsect2 id="ZeitgeistDataSource--name" role="property"><title>The <literal>&quot;name&quot;</literal> property</title>
<indexterm zone="ZeitgeistDataSource--name"><primary>ZeitgeistDataSource:name</primary></indexterm>
<programlisting>  &quot;name&quot;                     <link linkend="gchar"><type>gchar</type></link>*                : Read / Write</programlisting>
<para>name.</para><para>Default value: NULL</para>
</refsect2>
<refsect2 id="ZeitgeistDataSource--running" role="property"><title>The <literal>&quot;running&quot;</literal> property</title>
<indexterm zone="ZeitgeistDataSource--running"><primary>ZeitgeistDataSource:running</primary></indexterm>
<programlisting>  &quot;running&quot;                  <link linkend="gboolean"><type>gboolean</type></link>              : Read / Write</programlisting>
<para>running.</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="ZeitgeistDataSource--timestamp" role="property"><title>The <literal>&quot;timestamp&quot;</literal> property</title>
<indexterm zone="ZeitgeistDataSource--timestamp"><primary>ZeitgeistDataSource:timestamp</primary></indexterm>
<programlisting>  &quot;timestamp&quot;                <link linkend="gint64"><type>gint64</type></link>                : Read / Write</programlisting>
<para>timestamp.</para><para>Default value: 0</para>
</refsect2>
<refsect2 id="ZeitgeistDataSource--unique-id" role="property"><title>The <literal>&quot;unique-id&quot;</literal> property</title>
<indexterm zone="ZeitgeistDataSource--unique-id"><primary>ZeitgeistDataSource:unique-id</primary></indexterm>
<programlisting>  &quot;unique-id&quot;                <link linkend="gchar"><type>gchar</type></link>*                : Read / Write</programlisting>
<para>unique-id.</para><para>Default value: NULL</para>
</refsect2>
</refsect1>

</refentry>
