<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
 -
 -  This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
 -  project.
 -
 -  Copyright (C) 1998-2018 OpenLink Software
 -
 -  This project is free software; you can redistribute it and/or modify it
 -  under the terms of the GNU General Public License as published by the
 -  Free Software Foundation; only version 2 of the License, dated June 1991.
 -
 -  This program is distributed in the hope that it will be useful, but
 -  WITHOUT ANY WARRANTY; without even the implied warranty of
 -  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 -  General Public License for more details.
 -
 -  You should have received a copy of the GNU General Public License along
 -  with this program; if not, write to the Free Software Foundation, Inc.,
 -  51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
 -
 -
-->
<refentry id="fn_imap_get">
  <refmeta>
    <refentrytitle>imap_get</refentrytitle>
    <refmiscinfo>mail</refmiscinfo>
  </refmeta>
  <refnamediv>
    <refname>imap_get</refname>
    <refpurpose>get messages from a IMAP4 mail server.</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <funcsynopsis id="fsyn_imap_get">
      <funcprototype id="fproto_imap_get">
        <funcdef>array <function>imap_get</function></funcdef>
        <paramdef>in <parameter>host</parameter> varchar</paramdef>
        <paramdef>in <parameter>user</parameter> varchar</paramdef>
        <paramdef>in <parameter>password</parameter> varchar</paramdef>
        <paramdef>in <parameter>command</parameter> varchar</paramdef>
        <paramdef>in <parameter>folder_id</parameter> varchar</paramdef>
        <paramdef>in <parameter>list</parameter> vector</paramdef>
        <paramdef>in <parameter>use_ssl</parameter> integer</paramdef>
      </funcprototype>
    </funcsynopsis>
  </refsynopsisdiv>
  <refsect1 id="desc_imap_get"><title>Description</title>
    <para><function>imap_get</function> is used used to work with mail server
    running the IMAP4 version 4rev1 as defined in rfc3501.</para>
  </refsect1>
  <refsect1 id="params_imap_get"><title>Parameters</title>
    <refsect2>
      <title>host</title>
      <para>The host to connect with. IP address or hostname:port. There is no default for port,
      	so to connect to the standard port for IMAP, use &lt;hostname/IP address&gt;:143</para>
    </refsect2>
    <refsect2>
      <title>user</title>
      <para><type>string</type> user id in remote host.</para>
    </refsect2>
    <refsect2>
      <title>password</title>
      <para><type>string</type> password in remote host.</para>
    </refsect2>
    <refsect2>
      <title>command</title>
      <para>Command <type>string</type>. Valid values are '<emphasis>list</emphasis>',
      '<emphasis>delete</emphasis>', '<emphasis>create</emphasis>', '<emphasis>select</emphasis>',
      '<emphasis>expunge</emphasis>', '<emphasis>rename</emphasis>', '<emphasis>fetch</emphasis>',
      '<emphasis>message_delete</emphasis>', '<emphasis>message_copy</emphasis>'.</para>
    </refsect2>
    <refsect2>
      <title>folder_id</title>
      <para>IMAP4 mail box ID (e.g. 'INBOX', 'Draft' and etc) to work with.</para>
    </refsect2>
    <refsect2>
      <title>list</title>
      <para>A list of items to work with, depends on the command.</para>
    </refsect2>
    <refsect2>
      <title>use_ssl</title>
      <para>Use SSL connection, 1 - use, 0 - do not use.</para>
    </refsect2>
  </refsect1>
  <refsect1 id="ret"><title>Return Types</title>
    <para>Depends on the command value:</para>
    <itemizedlist mark="bullet">
      <listitem><emphasis>list</emphasis>: - list of mail boxes in selected mail box
      (needs folder_id, if folder_id = '' work with root of mail account). list - empty vector.
      <para>Returns: A vector of strings containing name attributes, hierarchy delimiter, name of mailbox or empty vector.</para>
      <para><ulink url="http://tools.ietf.org/html/rfc3501#page-40">See more specification details</ulink>.</para>
      <para><emphasis>Example</emphasis></para>
<programlisting><![CDATA[
SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','list','INBOX', vector (), 1);
imap_get
VARCHAR
_______________________________________________________________________________

vector(0x00491f08)

1 Rows. -- 2090 msec.

SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','list','INBOX', vector (), 1)[0];
aref
VARCHAR
_______________________________________________________________________________

(\HasNoChildren) "/" "INBOX"


1 Rows. -- 1997 msec.

]]></programlisting>
      </listitem>
      <listitem><emphasis>delete</emphasis>: deletes the selected mail box (needs folder_id). list - empty vector.
      <para>Returns: Empty vector.</para>
      <para><ulink url="http://tools.ietf.org/html/rfc3501#page-35">See more specification details</ulink>.</para>
      <para><emphasis>Example</emphasis></para>
<programlisting><![CDATA[
SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','delete','SomeBox', vector (), 1);
imap_get
VARCHAR
_______________________________________________________________________________

vector()

1 Rows. -- 2090 msec.
]]></programlisting>
      </listitem>
      <listitem><emphasis>create</emphasis>: creates a new mail box in the selected mail box (needs folder_id). list - empty vector.
      <para>Returns: Empty vector.</para>
      <para><ulink url="http://tools.ietf.org/html/rfc3501#page-34">See more specification details</ulink>.</para>
      <para><emphasis>Example</emphasis></para>
<programlisting><![CDATA[
SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','create','INBOX/SomeBox', vector (), 1);
imap_get
VARCHAR
_______________________________________________________________________________

vector()

1 Rows. -- 2090 msec.
]]></programlisting>
      </listitem>
      <listitem><emphasis>select</emphasis>: lists all messages in the selected mail box (needs folder_id). list - empty vector.
      <para>This command gets the header fields of messages:</para>
<programlisting><![CDATA[
UID FLAGS INTERNALDATE RFC822.SIZE BODY.PEEK[HEADER.FIELDS (DATE FROM SUBJECT TO CC MESSAGE-ID REFERENCES CONTENT-TYPE CONTENT-DESCRIPTION IN-REPLY-TO REPLY-TO LINES LIST-POST X-LABEL)]
]]></programlisting>
      <para>Returns: A vector of vectors containing: UID, header fields and data separated by ' ', Data of BODY.PEEK information (the last requested parameter - BODY.PEEK[HEADER.FIELDS (DATE FROM SUBJECT TO CC MESSAGE-ID REFERENCES CONTENT-TYPE CONTENT-DESCRIPTION IN-REPLY-TO REPLY-TO LINES LIST-POST X-LABEL)]).</para>
      <para><emphasis>Example</emphasis></para>
<programlisting><![CDATA[
SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','select', 'INBOX', vector (), 1);
imap_get
VARCHAR
_______________________________________________________________________________

vector(0x004435a0)

1 Rows. -- 2293 msec.
SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','select', 'INBOX', vector (), 1)[0];
aref
VARCHAR
_______________________________________________________________________________

vector(139,0x00443d50,0x00494758)

1 Rows. -- 2293 msec.
SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','select', 'INBOX', vector (), 1)[0][1];
aref
VARCHAR
_______________________________________________________________________________

RFC822.SIZE 89126 INTERNALDATE "09-Nov-2011 22:47:59 +0000" FLAGS (NonJunk \Seen) BODY[HEADER.FIELDS (DATE FROM SUBJECT TO CC MESSAGE-ID REFERENCES CONTENT-TYPE CONTENT-DESCRIPTION IN-REPLY-TO REPLY-TO LINES LIST-POST X-LABEL)] {368}


1 Rows. -- 2230 msec.
SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','select', 'INBOX', vector (), 1)[0][2];
aref
VARCHAR
_______________________________________________________________________________

Message-ID: <4EBB0319.1050200@openlinksw.com>
Date: Wed, 09 Nov 2011 23:47:53 +0100
From: demo <demo@openlinksw.com>
To: "ods.check@gmail.com" <ods.check@gmail.com>
Subject: test from OL account with attached image
Content-Type: multipart/signed; protocol="application/pkcs7-signature"; micalg=sha1; boundary="------------ms000205010302050500060406"

1 Rows. -- 2200 msec.

]]></programlisting>
      </listitem>
      <listitem><emphasis>expunge</emphasis>: expunges (deletes messages marked for deletion) the
      selected mail box (needs folder_id). list - empty vector.
      <para>Returns: An empty vector.</para>
      <para><emphasis>Example</emphasis></para>
<programlisting><![CDATA[
SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','expunge', 'INBOX', vector (), 1);
imap_get
VARCHAR
_______________________________________________________________________________

vector()

1 Rows. -- 3541 msec.
]]></programlisting>
      </listitem>
      <listitem><emphasis>rename</emphasis>: renames selected mail box. folder_id is not used,
      folder_id = ''. list - vector of 2 names: old and new.
      <para>Returns: Empty vector.</para>
      <para><ulink url="http://tools.ietf.org/html/rfc3501#page-37">See more specification details</ulink>.</para>
      <para><emphasis>Example</emphasis></para>
<programlisting><![CDATA[
SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','rename', '', vector ('Travel', 'New Travel'), 1);
imap_get
VARCHAR
_______________________________________________________________________________

vector()

1 Rows. -- 2013 msec.

]]></programlisting>
      </listitem>
      <listitem><emphasis>fetch</emphasis>: fetches messages from the selected mail box (needs folder_id).
      folder_id is id of selected mail box, list - vector of UIDs of messages.
      <para>Returns: A vector of vectors containing: UID and data of BODY.PEEK[] information (full message data).</para>
      <para><emphasis>Example</emphasis></para>
      <para>Get the list and UIDs of messages:</para>
<programlisting><![CDATA[
SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','select', 'INBOX', vector (), 1)[0];
aref
VARCHAR
_______________________________________________________________________________

vector(139,0x00443d50,0x00494758)

1 Rows. -- 2215 msec.
]]></programlisting>
      <para>Then get full data of message by its mail box id and UID:</para>
<programlisting><![CDATA[
SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','fetch', 'INBOX', vector (139), 1);
imap_get
VARCHAR
_______________________________________________________________________________

vector(0x00442410)

1 Rows. -- 3807 msec.

SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','fetch', 'INBOX', vector (139), 1) [0][1];
aref
VARCHAR
_______________________________________________________________________________


Warning 01004: [OpenLink][Virtuoso ODBC Driver]CL077: Data truncated in column 1 of the result-setr(aref, type 242)
at line 1 of Top-Level: select imap_get ('imap.gmail.com:993','ods.check','openlink','fetch', 'INBOX', vector (139), 1)[0][1]
Delivered-To: ods.check@gmail.com
Received: by 43.18.75.3 with SMTP id um9cs133471icb; Wed, 9 Nov 2011 14:48:00 -0800 (PST)
Received: by 101.43.13.258 with SMTP id d19mr8062565vdh.48.1320878879524; Wed, 09 Nov 2011 14:47:59 -0800 (PST)
Return-Path: <demo@openlinksw.com>
Received: from mail.openlinksw.com (mail.openlinksw.com. [25.138.12.16])by mx.google.com with ESMTPS id pm6si1474987vcb.111.2013.04.12.81.63.84 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 09 Nov 2011 14:47:59 -0800 (PST)
Received-SPF: pass (google.com: best guess record for domain of demo@openlinksw.com designates 81.134.67.27 as permitted sender) client-ip=25.138.12.16;
Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of demo@openlinksw.com designates 25.138.12.16 as permitted sender) smtp.mail=demo@openlinksw.com
Received: from example.com ([152.114.12.11] helo=[152.114.12.146]) by mail.openlinksw.com with esmtp (Exim 4.74) (envelope-from <demo@openlinksw.com>) id 1ROGw0-0004Oj-5a for ods.check@gmail.com; Wed, 09 Nov 2011 17:47:58 -0500
Message-ID: <4EBB0319.1050200@openlinksw.com>
Date: Wed, 09 Nov 2011 23:47:53 +0100
From: demo <demo@openlinksw.com>
User-Agent: Mozilla/5.0 (Windows NT 5.1; rv:7.0.1) Gecko/20110929 Thunderbird/7.0.1
MIME-Version: 1.0
To: "ods.check@gmail.com" <ods.check@gmail.com>
Subject: test from OL account with attached image
Content-Type: multipart/signed; protocol="application/pkcs7-signature"; micalg=sha1; boundary="------------ms000205010302050500060406"

This is a cryptographically signed message in MIME format.

--------------ms000205010302050500060406
Content-Type: multipart/mixed; boundary="------------080604090408010101040005"

This is a multi-part message in MIME format.
--------------080604090408010101040005
Content-Type: multipart/alternative; boundary="------------060001020305030405060601"

--------------060001020305030405060601
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: quoted-printable

*simple test*

--------------060001020305030405060601
Content-Type: text/html; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

<html>
  <head>
    <meta http-equiv=3D"content-type" content=3D"text/html; charset=3DISO=-8859-1">
  </head>
  <body bgcolor=3D"#FFFFFF" text=3D"#000000">
    <b>simple test</b><br>
  </body>
</html>

--------------060001020305030405060601--

--------------080604090408010101040005
Content-Type: image/png; name="a1.png"
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="a1.png"

iVBORw0KGgoAAAANSUhEUgAAAyAAAAFNCAIAAAB355ySAAAACXBIWXMAAAsTAAALEwEAmpwY
AAAgAElEQVR4nOydeYBOVR/Hf+ecuz7bbBhj7PtOlBBCJEqpJJIslWiP9k2ifZeS0qp6W942
9Zbe9nqVSqUQIesw+/Isdz/L+8edmYaeEaUMnk9o5j7nufec3/mec3/3d8+COOcAgBACAADg
nGOM80vjn/ywOa84lpUWCKhyWdwK6cqg7i2aZqf5CYQQAGB79KPvNv24sfCMgR1bN84CIRBC
QgjLoW9/uX5HaWzMwE659SIAAmMMKVKkSJEiRYoUhwfId5UAwPe0dvOELMdjHg+F1JoHq30s
3y3jjGOCq8+AEKp211KkSJEiRYoUKQ5DfnOwfHwnSQhgQigSqT7uUkYQxggJ4Bjjah9LCI4x
2e2kQggQQmCEBQBCfuJ/oDApUqRIkSJFihR1gd0dLB/fJfKdLQBAlX9BiN9CXLulqfa6qo/U
PPh3FiFFihQpUqRIkaJukdzBSpEiRYoUKVKkSPGnScWWUqRIkSJFihQp9jMpBytFihQpUqRI
kWI/I/3vx43dm2dbrnegc5IiRYoUKVKkSHEoIEmSFDdtgjEGpMiSIku4Tq2wgJBHOYAAAJmk
gm21wgEY4wCAEZBDZkpBZe0DAi6R3WeqHlJUlRRApHR+EHDAlZkSzO9ByKOMMyY4JXXpJvYP
gBCmAmFCEEJ1SA8IeYy7HnU9engO9aaUSQCAEIQjgX99/O3W/JI65WARIgk7PvGEPk9/sgo4
O9DZqbtIstI26GQ07/T596sPGQdLVlQ9vmPEyac8/+4XUt3pNf4GJEnm8ZLJpw19/N1vDrd7
w8HIAVcmkSRhlE8+edATS1fglGAAAECSZREruuCsUUs3Gsqh3FskARMpXrTthM4NF/53JYa6
4spIsgLxwnEjhoZCoZprCxxWoHe/XDWocwtJlSVFOdCZSYIZK4/HYtmNmx3ojNR1PnjvnaHD
TzrQudjPHJKFSsr2zRtyGuZIeuhAZyTFXnHAlVm8c7seCITSsw5gHuoaG9eubt6i5foKoR3S
8e7fQ2Rly6+/dG2cnpHd+EDnZRc2rF0VCGXpwRBjh2l8RAIAAcAY37KzJGHZdSqCJSlK4Y7t
rRukrdpWxKlXh3JWx9CD4bhhx6jYuGWHdKg80gbCkR0lFQDw3YbtdSju/TegaPqGjTuCkYzt
BQkkDtOe6CAiEIrsPKDKVFRt88btR7Zt/mtFIeL0n89AHUTVA2s378ht0jxuURfXlSjOP4Mk
I8vhlLKfthYBqyvDqTU98PPW/J

1 Rows. -- 3338 msec.

]]></programlisting>
      </listitem>
      <listitem><emphasis>message_delete</emphasis>: deletes messages from mail box (needs folder_id).
      folder_id is id of selected mail box, list - vector of UIDs of messages.
      <para>Returns: empty vector.</para>
      <para><emphasis>Example</emphasis></para>
<programlisting><![CDATA[
SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','message_delete', 'INBOX', vector(139), 1);
imap_get
VARCHAR
_______________________________________________________________________________

vector()

1 Rows. -- 2262 msec.
]]></programlisting>
      </listitem>
      <listitem><emphasis>message_copy</emphasis>: copies messages from select mail box to another.
folder_id is id of selected mail box, list - vector of: first vector item is an id of target mail box, and UIDs of messages.
      <para>Returns: empty vector.</para>
      <para><emphasis>Example</emphasis></para>
<programlisting><![CDATA[
SQL> select imap_get ('imap.gmail.com:993','ods.check','openlink','message_copy', 'INBOX', vector('Travel', 139), 1);
imap_get
VARCHAR
_______________________________________________________________________________

vector()

1 Rows. -- 2262 msec.
]]></programlisting>
      </listitem>
    </itemizedlist>
  </refsect1>
  <refsect1 id="errors_imap_get"><title>Errors</title>
    <table><title>Errors signalled by all commands</title>
      <tgroup cols="4">
        <thead><row><entry>SQLState</entry><entry>Error Code</entry><entry>Error Text</entry><entry>Description</entry></row></thead>
	      <tbody>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM001</errorcode></entry>
	          <entry><errorname>Cannot resolve host in imap_get</errorname></entry>
	          <entry></entry>
	        </row>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM002</errorcode></entry>
	          <entry><errorname>Cannot connect in imap_get</errorname></entry>
	          <entry></entry>
	        </row>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM003</errorcode></entry>
	          <entry><errorname>No response from remote IMAP server</errorname></entry>
	          <entry></entry>
	        </row>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM004</errorcode></entry>
	          <entry><errorname>Could not login to remote IMAP server. Please check user or password parameters.</errorname></entry>
	          <entry></entry>
	        </row>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM005</errorcode></entry>
	          <entry><errorname>CAPABILITY command to remote IMAP server failed</errorname></entry>
	          <entry></entry>
	        </row>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM010</errorcode></entry>
	          <entry><errorname>Failed reading output of LIST command on remote IMAP server</errorname></entry>
	          <entry></entry>
	        </row>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM007</errorcode></entry>
	          <entry><errorname>Cannot resolve host in imap_get</errorname></entry>
	          <entry></entry>
	        </row>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM008</errorcode></entry>
	          <entry><errorname>Cannot resolve host in imap_get</errorname></entry>
	          <entry></entry>
	        </row>
	      </tbody>
      </tgroup>
    </table>

    <table><title>Errors signalled by command "delete":</title>
      <tgroup cols="4">
        <thead><row><entry>SQLState</entry><entry>Error Code</entry><entry>Error Text</entry><entry>Description</entry></row></thead>
	      <tbody>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM011</errorcode></entry>
	          <entry><errorname>There must be folder name to delete (5th argument)</errorname></entry>
	          <entry></entry>
	        </row>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM012</errorcode></entry>
	          <entry><errorname>DELETE command to remote IMAP server failed</errorname></entry>
	          <entry></entry>
	        </row>
	      </tbody>
      </tgroup>
    </table>

   <table><title>Errors signalled by command "create":</title>
      <tgroup cols="4">
        <thead><row><entry>SQLState</entry><entry>Error Code</entry><entry>Error Text</entry><entry>Description</entry></row></thead>
	      <tbody>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM015</errorcode></entry>
	          <entry><errorname>There must be folder name to create (5th argument)</errorname></entry>
	          <entry></entry>
	        </row>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM016</errorcode></entry>
	          <entry><errorname>CREATE command to remote IMAP server failed</errorname></entry>
	          <entry></entry>
	        </row>
	      </tbody>
      </tgroup>
    </table>

   <table><title>Errors signalled by command "select":</title>
      <tgroup cols="4">
        <thead><row><entry>SQLState</entry><entry>Error Code</entry><entry>Error Text</entry><entry>Description</entry></row></thead>
	      <tbody>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM019</errorcode></entry>
	          <entry><errorname>SELECT command to remote IMAP server failed</errorname></entry>
	          <entry></entry>
	        </row>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM027</errorcode></entry>
	          <entry><errorname>Failed reading output of FETCH command on remote IMAP server</errorname></entry>
	          <entry></entry>
	        </row>
	      </tbody>
      </tgroup>
    </table>


   <table><title>Errors signalled by command "expunge":</title>
      <tgroup cols="4">
        <thead><row><entry>SQLState</entry><entry>Error Code</entry><entry>Error Text</entry><entry>Description</entry></row></thead>
	      <tbody>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM020</errorcode></entry>
	          <entry><errorname>EXPUNGE command to remote IMAP server failed</errorname></entry>
	          <entry></entry>
	        </row>
	      </tbody>
      </tgroup>
    </table>


    <table><title>Errors signalled by command "rename":</title>
      <tgroup cols="4">
        <thead><row><entry>SQLState</entry><entry>Error Code</entry><entry>Error Text</entry><entry>Description</entry></row></thead>
	      <tbody>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM028</errorcode></entry>
	          <entry><errorname>There must be 2 string items in vector of argument 6 (old folder name to rename and a new name)</errorname></entry>
	          <entry></entry>
	        </row>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM029</errorcode></entry>
	          <entry><errorname>There must be 2 string items in vector of argument 6 (old folder name to rename and a new name)</errorname></entry>
	          <entry></entry>
	        </row>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM030</errorcode></entry>
	          <entry><errorname>command to remote IMAP server failed</errorname></entry>
	          <entry></entry>
	        </row>
	      </tbody>
      </tgroup>
    </table>

   <table><title>Errors signalled by command "fetch":</title>
      <tgroup cols="4">
        <thead><row><entry>SQLState</entry><entry>Error Code</entry><entry>Error Text</entry><entry>Description</entry></row></thead>
	      <tbody>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM032</errorcode></entry>
	          <entry><errorname>SELECT command to remote IMAP server failed</errorname></entry>
	          <entry></entry>
	        </row>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM033</errorcode></entry>
	          <entry><errorname>No messages in list</errorname></entry>
	          <entry></entry>
	        </row>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM034</errorcode></entry>
	          <entry><errorname>There must be integer items in vector of argument 6</errorname></entry>
	          <entry></entry>
	        </row>
	      </tbody>
      </tgroup>
    </table>


   <table><title>Errors signalled by command "delete":</title>
      <tgroup cols="4">
        <thead><row><entry>SQLState</entry><entry>Error Code</entry><entry>Error Text</entry><entry>Description</entry></row></thead>
	      <tbody>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM035</errorcode></entry>
	          <entry><errorname>Error in IMAP command UID STORE</errorname></entry>
	          <entry></entry>
	        </row>
	      </tbody>
      </tgroup>
    </table>


    <table><title>Errors signalled by incorrect command value:</title>
      <tgroup cols="4">
        <thead><row><entry>SQLState</entry><entry>Error Code</entry><entry>Error Text</entry><entry>Description</entry></row></thead>
	      <tbody>
	        <row>
	          <entry><errorcode></errorcode></entry>
	          <entry><errorcode>IM042</errorcode></entry>
	          <entry><errorname>No such command (5th parameter) in protocol</errorname></entry>
	          <entry></entry>
	        </row>
	      </tbody>
      </tgroup>
    </table>

  </refsect1>
  <refsect1 id="seealso"><title>See Also</title>
    <para><link linkend="fn_pop3_get"><function>pop3_get</function></link></para>
    <para><ulink url="http://www.ietf.org/rfc/rfc3501">RFC3501</ulink></para>
  </refsect1>
</refentry>