<refentry id="GMimeSignature">
<refmeta>
<refentrytitle role="top_of_page" id="GMimeSignature.top_of_page">GMimeSignature</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>
  GMIME Library
</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GMimeSignature</refname>
<refpurpose>Digital signatures</refpurpose>
</refnamediv>

<refsynopsisdiv id="GMimeSignature.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>
<anchor id="GMimeSignatureList"/>
<synopsis>enum                <link linkend="GMimeSignatureStatus">GMimeSignatureStatus</link>;
enum                <link linkend="GMimeSignatureError">GMimeSignatureError</link>;
                    <link linkend="GMimeSignature-struct">GMimeSignature</link>;
<link linkend="GMimeSignature"><returnvalue>GMimeSignature</returnvalue></link> *    <link linkend="g-mime-signature-new">g_mime_signature_new</link>                (<parameter><type>void</type></parameter>);
<link linkend="GMimeCertificate"><returnvalue>GMimeCertificate</returnvalue></link> *  <link linkend="g-mime-signature-get-certificate">g_mime_signature_get_certificate</link>    (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-signature-set-certificate">g_mime_signature_set_certificate</link>    (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>,
                                                         <parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="GMimeSignatureStatus"><returnvalue>GMimeSignatureStatus</returnvalue></link>  <link linkend="g-mime-signature-get-status">g_mime_signature_get_status</link>       (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-signature-set-status">g_mime_signature_set_status</link>         (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>,
                                                         <parameter><link linkend="GMimeSignatureStatus"><type>GMimeSignatureStatus</type></link> status</parameter>);
<link linkend="GMimeSignatureError"><returnvalue>GMimeSignatureError</returnvalue></link>  <link linkend="g-mime-signature-get-errors">g_mime_signature_get_errors</link>        (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-signature-set-errors">g_mime_signature_set_errors</link>         (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>,
                                                         <parameter><link linkend="GMimeSignatureError"><type>GMimeSignatureError</type></link> errors</parameter>);
<link linkend="time-t"><returnvalue>time_t</returnvalue></link>              <link linkend="g-mime-signature-get-created">g_mime_signature_get_created</link>        (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-signature-set-created">g_mime_signature_set_created</link>        (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>,
                                                         <parameter><link linkend="time-t"><type>time_t</type></link> created</parameter>);
<link linkend="time-t"><returnvalue>time_t</returnvalue></link>              <link linkend="g-mime-signature-get-expires">g_mime_signature_get_expires</link>        (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-signature-set-expires">g_mime_signature_set_expires</link>        (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>,
                                                         <parameter><link linkend="time-t"><type>time_t</type></link> expires</parameter>);

                    <link linkend="GMimeSignatureList-struct">GMimeSignatureList</link>;
<link linkend="GMimeSignatureList"><returnvalue>GMimeSignatureList</returnvalue></link> * <link linkend="g-mime-signature-list-new">g_mime_signature_list_new</link>          (<parameter><type>void</type></parameter>);
<link linkend="int"><returnvalue>int</returnvalue></link>                 <link linkend="g-mime-signature-list-length">g_mime_signature_list_length</link>        (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-signature-list-clear">g_mime_signature_list_clear</link>         (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>);
<link linkend="int"><returnvalue>int</returnvalue></link>                 <link linkend="g-mime-signature-list-add">g_mime_signature_list_add</link>           (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-signature-list-insert">g_mime_signature_list_insert</link>        (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>,
                                                         <parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-signature-list-remove">g_mime_signature_list_remove</link>        (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-signature-list-remove-at">g_mime_signature_list_remove_at</link>     (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-signature-list-contains">g_mime_signature_list_contains</link>      (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);
<link linkend="int"><returnvalue>int</returnvalue></link>                 <link linkend="g-mime-signature-list-index-of">g_mime_signature_list_index_of</link>      (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);
<link linkend="GMimeSignature"><returnvalue>GMimeSignature</returnvalue></link> *    <link linkend="g-mime-signature-list-get-signature">g_mime_signature_list_get_signature</link> (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-signature-list-set-signature">g_mime_signature_list_set_signature</link> (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>,
                                                         <parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);
</synopsis>
</refsynopsisdiv>
<refsect1 id="GMimeSignature.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----GMimeSignature
</synopsis>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----GMimeSignatureList
</synopsis>
</refsect1>

<refsect1 id="GMimeSignature.description" role="desc">
<title role="desc.title">Description</title>
<para>
A <link linkend="GMimeSignature"><type>GMimeSignature</type></link> is an object containing useful information about a
digital signature as used in signing and encrypting data.
</para>
</refsect1>
<refsect1 id="GMimeSignature.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GMimeSignatureStatus" role="enum">
<title>enum GMimeSignatureStatus</title>
<indexterm zone="GMimeSignatureStatus"><primary>GMimeSignatureStatus</primary></indexterm>
<programlisting>typedef enum {
	GMIME_SIGNATURE_STATUS_GOOD,
	GMIME_SIGNATURE_STATUS_ERROR,
	GMIME_SIGNATURE_STATUS_BAD
} GMimeSignatureStatus;
</programlisting>
<para>
A value representing the signature status for a particular
<link linkend="GMimeSignature"><type>GMimeSignature</type></link>.
</para><variablelist role="enum">
<varlistentry id="GMIME-SIGNATURE-STATUS-GOOD:CAPS" role="constant">
<term><literal>GMIME_SIGNATURE_STATUS_GOOD</literal></term>
<listitem><simpara>Good signature.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-SIGNATURE-STATUS-ERROR:CAPS" role="constant">
<term><literal>GMIME_SIGNATURE_STATUS_ERROR</literal></term>
<listitem><simpara>An error occurred.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-SIGNATURE-STATUS-BAD:CAPS" role="constant">
<term><literal>GMIME_SIGNATURE_STATUS_BAD</literal></term>
<listitem><simpara>Bad signature.
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="GMimeSignatureError" role="enum">
<title>enum GMimeSignatureError</title>
<indexterm zone="GMimeSignatureError"><primary>GMimeSignatureError</primary></indexterm>
<programlisting>typedef enum {
	GMIME_SIGNATURE_ERROR_NONE        = 0,
	GMIME_SIGNATURE_ERROR_EXPSIG      = (1 &lt;&lt; 0),  /* expired signature */
	GMIME_SIGNATURE_ERROR_NO_PUBKEY   = (1 &lt;&lt; 1),  /* no public key */
	GMIME_SIGNATURE_ERROR_EXPKEYSIG   = (1 &lt;&lt; 2),  /* expired key */
	GMIME_SIGNATURE_ERROR_REVKEYSIG   = (1 &lt;&lt; 3),  /* revoked key */
	GMIME_SIGNATURE_ERROR_UNSUPP_ALGO = (1 &lt;&lt; 4)   /* unsupported algorithm */
} GMimeSignatureError;
</programlisting>
<para>
Possible errors that a <link linkend="GMimeSignature"><type>GMimeSignature</type></link> could have.
</para><variablelist role="enum">
<varlistentry id="GMIME-SIGNATURE-ERROR-NONE:CAPS" role="constant">
<term><literal>GMIME_SIGNATURE_ERROR_NONE</literal></term>
<listitem><simpara>No error.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-SIGNATURE-ERROR-EXPSIG:CAPS" role="constant">
<term><literal>GMIME_SIGNATURE_ERROR_EXPSIG</literal></term>
<listitem><simpara>Expired signature.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-SIGNATURE-ERROR-NO-PUBKEY:CAPS" role="constant">
<term><literal>GMIME_SIGNATURE_ERROR_NO_PUBKEY</literal></term>
<listitem><simpara>No public key found.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-SIGNATURE-ERROR-EXPKEYSIG:CAPS" role="constant">
<term><literal>GMIME_SIGNATURE_ERROR_EXPKEYSIG</literal></term>
<listitem><simpara>Expired signature key.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-SIGNATURE-ERROR-REVKEYSIG:CAPS" role="constant">
<term><literal>GMIME_SIGNATURE_ERROR_REVKEYSIG</literal></term>
<listitem><simpara>Revoked signature key.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-SIGNATURE-ERROR-UNSUPP-ALGO:CAPS" role="constant">
<term><literal>GMIME_SIGNATURE_ERROR_UNSUPP_ALGO</literal></term>
<listitem><simpara>Unsupported algorithm.
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="GMimeSignature-struct" role="struct">
<title>GMimeSignature</title>
<indexterm zone="GMimeSignature-struct"><primary>GMimeSignature</primary></indexterm>
<programlisting>typedef struct _GMimeSignature GMimeSignature;</programlisting>
<para>
An object containing useful information about a signature.
</para><variablelist role="struct">
</variablelist></refsect2>
<refsect2 id="g-mime-signature-new" role="function">
<title>g_mime_signature_new ()</title>
<indexterm zone="g-mime-signature-new"><primary>g_mime_signature_new</primary></indexterm>
<programlisting><link linkend="GMimeSignature"><returnvalue>GMimeSignature</returnvalue></link> *    g_mime_signature_new                (<parameter><type>void</type></parameter>);</programlisting>
<para>
Creates a new <link linkend="GMimeSignature"><type>GMimeSignature</type></link> object.
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new <link linkend="GMimeSignature"><type>GMimeSignature</type></link> object.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-get-certificate" role="function">
<title>g_mime_signature_get_certificate ()</title>
<indexterm zone="g-mime-signature-get-certificate"><primary>g_mime_signature_get_certificate</primary></indexterm>
<programlisting><link linkend="GMimeCertificate"><returnvalue>GMimeCertificate</returnvalue></link> *  g_mime_signature_get_certificate    (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);</programlisting>
<para>
Get the signature's certificate.
</para><variablelist role="params">
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the signature's certificate.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-set-certificate" role="function">
<title>g_mime_signature_set_certificate ()</title>
<indexterm zone="g-mime-signature-set-certificate"><primary>g_mime_signature_set_certificate</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_signature_set_certificate    (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>,
                                                         <parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Set the signature's certificate.
</para><variablelist role="params">
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-get-status" role="function">
<title>g_mime_signature_get_status ()</title>
<indexterm zone="g-mime-signature-get-status"><primary>g_mime_signature_get_status</primary></indexterm>
<programlisting><link linkend="GMimeSignatureStatus"><returnvalue>GMimeSignatureStatus</returnvalue></link>  g_mime_signature_get_status       (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);</programlisting>
<para>
Get the signature status.
</para><variablelist role="params">
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the signature status.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-set-status" role="function">
<title>g_mime_signature_set_status ()</title>
<indexterm zone="g-mime-signature-set-status"><primary>g_mime_signature_set_status</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_signature_set_status         (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>,
                                                         <parameter><link linkend="GMimeSignatureStatus"><type>GMimeSignatureStatus</type></link> status</parameter>);</programlisting>
<para>
Set the status on the signature.
</para><variablelist role="params">
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>status</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignatureStatus"><type>GMimeSignatureStatus</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-get-errors" role="function">
<title>g_mime_signature_get_errors ()</title>
<indexterm zone="g-mime-signature-get-errors"><primary>g_mime_signature_get_errors</primary></indexterm>
<programlisting><link linkend="GMimeSignatureError"><returnvalue>GMimeSignatureError</returnvalue></link>  g_mime_signature_get_errors        (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);</programlisting>
<para>
Get the signature errors. If the <link linkend="GMimeSignatureStatus"><type>GMimeSignatureStatus</type></link> returned from
<link linkend="g-mime-signature-get-status"><function>g_mime_signature_get_status()</function></link> is not <link linkend="GMIME-SIGNATURE-STATUS-GOOD:CAPS"><type>GMIME_SIGNATURE_STATUS_GOOD</type></link>, then the
errors may provide a clue as to why.
</para><variablelist role="params">
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a bitfield of errors.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-set-errors" role="function">
<title>g_mime_signature_set_errors ()</title>
<indexterm zone="g-mime-signature-set-errors"><primary>g_mime_signature_set_errors</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_signature_set_errors         (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>,
                                                         <parameter><link linkend="GMimeSignatureError"><type>GMimeSignatureError</type></link> errors</parameter>);</programlisting>
<para>
Set the errors on the signature.
</para><variablelist role="params">
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>errors</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignatureError"><type>GMimeSignatureError</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-get-created" role="function">
<title>g_mime_signature_get_created ()</title>
<indexterm zone="g-mime-signature-get-created"><primary>g_mime_signature_get_created</primary></indexterm>
<programlisting><link linkend="time-t"><returnvalue>time_t</returnvalue></link>              g_mime_signature_get_created        (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);</programlisting>
<para>
Get the creation date of the signature.
</para><variablelist role="params">
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the creation date of the signature or <link linkend="1:CAPS"><literal>-1</literal></link> if unknown.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-set-created" role="function">
<title>g_mime_signature_set_created ()</title>
<indexterm zone="g-mime-signature-set-created"><primary>g_mime_signature_set_created</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_signature_set_created        (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>,
                                                         <parameter><link linkend="time-t"><type>time_t</type></link> created</parameter>);</programlisting>
<para>
Set the creation date of the signature.
</para><variablelist role="params">
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>created</parameter>&#160;:</term>
<listitem><simpara>creation date
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-get-expires" role="function">
<title>g_mime_signature_get_expires ()</title>
<indexterm zone="g-mime-signature-get-expires"><primary>g_mime_signature_get_expires</primary></indexterm>
<programlisting><link linkend="time-t"><returnvalue>time_t</returnvalue></link>              g_mime_signature_get_expires        (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);</programlisting>
<para>
Get the expiration date of the signature.
</para><variablelist role="params">
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the expiration date of the signature or <link linkend="1:CAPS"><literal>-1</literal></link> if unknown.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-set-expires" role="function">
<title>g_mime_signature_set_expires ()</title>
<indexterm zone="g-mime-signature-set-expires"><primary>g_mime_signature_set_expires</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_signature_set_expires        (<parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>,
                                                         <parameter><link linkend="time-t"><type>time_t</type></link> expires</parameter>);</programlisting>
<para>
Set the expiration date of the signature.
</para><variablelist role="params">
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>expires</parameter>&#160;:</term>
<listitem><simpara>expiration date
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GMimeSignatureList-struct" role="struct">
<title>GMimeSignatureList</title>
<indexterm zone="GMimeSignatureList-struct"><primary>GMimeSignatureList</primary></indexterm>
<programlisting>typedef struct _GMimeSignatureList GMimeSignatureList;</programlisting>
<para>
A collection of <link linkend="GMimeSignature"><type>GMimeSignature</type></link> objects.
</para><variablelist role="struct">
</variablelist></refsect2>
<refsect2 id="g-mime-signature-list-new" role="function">
<title>g_mime_signature_list_new ()</title>
<indexterm zone="g-mime-signature-list-new"><primary>g_mime_signature_list_new</primary></indexterm>
<programlisting><link linkend="GMimeSignatureList"><returnvalue>GMimeSignatureList</returnvalue></link> * g_mime_signature_list_new          (<parameter><type>void</type></parameter>);</programlisting>
<para>
Creates a new <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>.
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-list-length" role="function">
<title>g_mime_signature_list_length ()</title>
<indexterm zone="g-mime-signature-list-length"><primary>g_mime_signature_list_length</primary></indexterm>
<programlisting><link linkend="int"><returnvalue>int</returnvalue></link>                 g_mime_signature_list_length        (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>);</programlisting>
<para>
Gets the length of the list.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the number of <link linkend="GMimeSignature"><type>GMimeSignature</type></link> objects in the list.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-list-clear" role="function">
<title>g_mime_signature_list_clear ()</title>
<indexterm zone="g-mime-signature-list-clear"><primary>g_mime_signature_list_clear</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_signature_list_clear         (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>);</programlisting>
<para>
Clears the list of addresses.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-list-add" role="function">
<title>g_mime_signature_list_add ()</title>
<indexterm zone="g-mime-signature-list-add"><primary>g_mime_signature_list_add</primary></indexterm>
<programlisting><link linkend="int"><returnvalue>int</returnvalue></link>                 g_mime_signature_list_add           (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);</programlisting>
<para>
Adds a <link linkend="GMimeSignature"><type>GMimeSignature</type></link> to the <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the index of the added <link linkend="GMimeSignature"><type>GMimeSignature</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-list-insert" role="function">
<title>g_mime_signature_list_insert ()</title>
<indexterm zone="g-mime-signature-list-insert"><primary>g_mime_signature_list_insert</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_signature_list_insert        (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>,
                                                         <parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);</programlisting>
<para>
Inserts a <link linkend="GMimeSignature"><type>GMimeSignature</type></link> into the <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> at the specified
index.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>index</parameter>&#160;:</term>
<listitem><simpara>index to insert at
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-list-remove" role="function">
<title>g_mime_signature_list_remove ()</title>
<indexterm zone="g-mime-signature-list-remove"><primary>g_mime_signature_list_remove</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_signature_list_remove        (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);</programlisting>
<para>
Removes a <link linkend="GMimeSignature"><type>GMimeSignature</type></link> from the <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the specified <link linkend="GMimeSignature"><type>GMimeSignature</type></link> was removed or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>
otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-list-remove-at" role="function">
<title>g_mime_signature_list_remove_at ()</title>
<indexterm zone="g-mime-signature-list-remove-at"><primary>g_mime_signature_list_remove_at</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_signature_list_remove_at     (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>);</programlisting>
<para>
Removes a <link linkend="GMimeSignature"><type>GMimeSignature</type></link> from the <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> at the specified
index.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>index</parameter>&#160;:</term>
<listitem><simpara>index to remove
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if an <link linkend="GMimeSignature"><type>GMimeSignature</type></link> was removed or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-list-contains" role="function">
<title>g_mime_signature_list_contains ()</title>
<indexterm zone="g-mime-signature-list-contains"><primary>g_mime_signature_list_contains</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_signature_list_contains      (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);</programlisting>
<para>
Checks whether or not the specified <link linkend="GMimeSignature"><type>GMimeSignature</type></link> is contained within
the <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the specified <link linkend="GMimeSignature"><type>GMimeSignature</type></link> is contained within the
specified <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-list-index-of" role="function">
<title>g_mime_signature_list_index_of ()</title>
<indexterm zone="g-mime-signature-list-index-of"><primary>g_mime_signature_list_index_of</primary></indexterm>
<programlisting><link linkend="int"><returnvalue>int</returnvalue></link>                 g_mime_signature_list_index_of      (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);</programlisting>
<para>
Gets the index of the specified <link linkend="GMimeSignature"><type>GMimeSignature</type></link> inside the
<link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the index of the requested <link linkend="GMimeSignature"><type>GMimeSignature</type></link> within the
<link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> or <link linkend="1:CAPS"><literal>-1</literal></link> if it is not contained within the
<link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-list-get-signature" role="function">
<title>g_mime_signature_list_get_signature ()</title>
<indexterm zone="g-mime-signature-list-get-signature"><primary>g_mime_signature_list_get_signature</primary></indexterm>
<programlisting><link linkend="GMimeSignature"><returnvalue>GMimeSignature</returnvalue></link> *    g_mime_signature_list_get_signature (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>);</programlisting>
<para>
Gets the <link linkend="GMimeSignature"><type>GMimeSignature</type></link> at the specified index.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>index</parameter>&#160;:</term>
<listitem><simpara>index of <link linkend="GMimeSignature"><type>GMimeSignature</type></link> to get
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the <link linkend="GMimeSignature"><type>GMimeSignature</type></link> at the specified index or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if
the index is out of range.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-signature-list-set-signature" role="function">
<title>g_mime_signature_list_set_signature ()</title>
<indexterm zone="g-mime-signature-list-set-signature"><primary>g_mime_signature_list_set_signature</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_signature_list_set_signature (<parameter><link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>,
                                                         <parameter><link linkend="GMimeSignature"><type>GMimeSignature</type></link> *sig</parameter>);</programlisting>
<para>
Sets the <link linkend="GMimeSignature"><type>GMimeSignature</type></link> at the specified index to <parameter>sig</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignatureList"><type>GMimeSignatureList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>index</parameter>&#160;:</term>
<listitem><simpara>index of <link linkend="GMimeSignature"><type>GMimeSignature</type></link> to set
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>sig</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeSignature"><type>GMimeSignature</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>

</refentry>
