Go to the first, previous, next, last section, table of contents.

Concrete API

POP3

/* Prefix pop3_ is reserved */
#include <mailutils/pop3.h>

The purpose of the Post Office Protocol Version 3 (POP3) is to permit a client to download a maildrop from a remote server. It does not provide complex or extensive operation on the maildrop. When the client successfully authenticates, the server acquires an exclusive access lock on the mailbox and holds it the entire duration of the session. After the authentication, the session enters transaction state and the client may issues commands to access messages in the mailbox.

Authorization state @itemize @bullet @item User @item Pass @item Quit @item Capa (extension) @item Auth (extension) @end itemize
Transaction state @itemize @bullet @item Stat @item List @item Retr @item Dele @item Noop @item Rset @item Top @item Uidl (extension) @item Quit @item Capa (extension) @end itemize

When the command Quit is issue the session enters the update state. The servers removes all messages marked deleted, releases the exclusive lock and closes the TCP connection.

Commands

An opaque structure pop3_t is use as a handle for the session, it is allocated and initialized by calling pop3_create (). All Functions will wait for a reply from the POP3 server before returning. The duration of the wait can be set by calling pop3_set_timeout (), the default is 10 minutes(1). Once a successful connection is established with pop3_connect (), two builtins authentications are provided pop3_apop () or pop3_user ()/pop3_pass (). The pop3_stat () and pop3_list () functions can be use to get the number and size of messages. Downloading of messages is done via a stream provided by pop3_retr () or pop3_top ()(2). The stream_t should be destroyed to indicate to the library that the action is finished. POP3 only provide a single channel for operation, it means only one operation can be done at a time, all the functions will return MU_ERROR_OPERATION_IN_PROGRESS if call during another operation. The functions pop3_list_all (), pop3_uidl_all () and pop3_capa () return iterators pop3_list_current (), pop3_uidl_current () are provided as cover function to format the string return by iterator_current (), iterator_destroy () must be call to release any resources.

In a multithreaded application, only one thread should access pop3_t handles.

Initialization

Function: int pop3_create (pop3_t * pop3)

Allocate and initialize a pop3 handle.

MU_ERROR_NO_MEMORY
MU_ERROR_INVALID_PARAMETER

Function: void pop3_destroy (pop3_t *pop3)

When a POP3 session is finished, the structure must be free ()'ed to reclaim memory.

Function: int pop3_connect (pop3_t, const char *host, unsigned port, int flags)

A connection is established by calling pop3d_open (), the previous connection is close first. If non-blocking the function should be recalled until the return value is not MU_ERROR_TRY_AGAIN or MU_ERROR_IN_PROGRESS.

MU_ERROR_NO_MEMORY
MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_IN_PROGRESS
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED
MU_ERROR_TIMEOUT
MU_ERROR_NO_LOCK

Carrier

Function: int pop3_set_carrier (pop3_t, stream_t carrier);

The type of stream use to contact as server will be set to carrier in the pop3_t handle. Any previous carrier stream in the handle, will be close and release.

MU_ERROR_INVALID_PARAMETER

Function: int pop3_get_carrier (pop3_t, stream_t *carrier);

Return the pop3_t carrier. If none was set, a new tcp stream will be created.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_NO_MEMORY

Apop

Function: int pop3_apop (pop3_t, const char *user, const char *secret)

Apop offers an alternative to User/Pass authentication. For intermittent use of POP3, like checking for new mail, it is the preferred the authentication. It reduces the risk of password capture. The user and the shared secret are pass to pop3_apop (), the MD5 digest is calculated by applying the times tamp given by the server in the greeting followed by the secret.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Capa

Function: int pop3_capa (pop3_t, pop3_capa_iterator_t *iterator)

The Capa command is send to the sever and the list of capabilities is return in an iterator. iterator_current () gives an allocated string that should be free ()'ed. Caution: The iterator must be destroy after use, it will discard any remaining responses from CAPA and clear the way for new operations.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

#include <stdio.h>
#include <stdlib.h>
#include <mailutils/pop3.h>

void print_capabilities (pop3_t pop3)
{
   iterator_t iterator;
   status = pop3_capa (pop3, &iterator);
   if (status == 0)
    {
        for (iterator_first (iterator);
             !iterator_is_done (iterator);
             iterator_next (iterator))
          {
              char *capa;
              if (iterator_current (iterator, &capa) == 0)
               {;
                   printf ("CAPA: %s\n", capa);
                   free (capa);
               }
          }
        pop3_capa_destroy (&iterator);
    }
   else
     printf ("NONE\n");
}

Dele

Function: int pop3_dele (pop3_t, unsigned msgno)

Sends a Dele to the servers who will mark the msgno for deletion. The msgno may not refer to a message already marked deleted. If successful any future reference to msgno in other operations will be an error, unless unmarked by RSET.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

List

Function: int pop3_list (pop3_t, unsigned msgno, size_t *size)

Sends a List for a specific msgno and returns the size.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Function: int pop3_list_all (pop3_t, iterator_t *iterator)

Sends A List with no argument to the server. The iterator must be destroy after use, it will discard any remaining response from LIST and clear the way for new operations. A cover function pop3_list_current () around to scan properly the string return by the iterator_current ().

#include <stdio.h>
#include <stdlib.h>
#include <mailutils/pop3.h>

void print_list (pop3_t pop3)
{
   iterator_t iterator;
   status = pop3_list_all (pop3, &iterator);
   if (status == 0)
    {
        for (iterator_first (iterator);
             !iterator_is_done (iterator);
             iterator_next (iterator))
          {
              unsigned int msgno, size;
              if (pop3_list_current (iterator, &msgno, &size) == 0)
               {
                   printf ("LIST: %d %d\n", msgno, size);
               }
          }
        iterator (&iterator);
    }
   else
     printf ("NONE\n");
}

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Function: int pop3_list_current (pop3_t, unsigned int *msgno, size_t *size)

Cover functions around iterator_current () from an iterator created by pop3_list_all () to format the result.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Noop

Function: int pop3_noop (pop3_t)

Sends a NOOP, useful to reset the timeout on the server.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Pass

Function: int pop3_pass (pop3_t, const char *passwd)

Sends the PASS, to authenticate after the USER command.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Quit

Function: int pop3_quit (pop3_t)

Enter the UPDATE state. The server will delete all messages marked deleted before closing the connection.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Retr

Function: int pop3_retr (pop3_t, unsigned msgno, stream_t *)

If successful a stream_t is created to allow downloading of the message, byte-stuff lines or handle internally, CRLFs are converted to LF. All other operations will fail until the stream is destroyed by the caller.

#include <stdio.h>
#include <mailutils/pop3.h>

int
print_message (pop3_t pop3, unsigned int msgno)
{
   stream_t stream;
   int status = pop3_retr (pop3, msgno, &stream);
   if (status == 0)
    {
       size_t n = 0;
       char buf[128];
       while ((stream_readline (stream, buf, sizeof buf, &n) == 0)
              && n)
         printf ("%s", buf);
       stream_release (stream);
    }
   return status;
}

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Rset

Function: int pop3_rset (pop3_t)

Sends a RSET to unmark the messages marked as deleted.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Stat

Function: int pop3_stat (pop3_t, unsigned msgno, unsigned *msg_count, size_t *size)

The number of messages in the mailbox and the size of the mailbox in octets. Caution: The size is in RFC822 where line termination is CRLF, messages marked as deleted are not counted in either total.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Top

Function: int pop3_top (pop3_t, unsigned int msgno, unsigned int lines, stream_t *stream)

If successful a stream is created to allow downloading of the header, byte-stuff lines or handle internally, CRLFs are converted to LF. All other operations will failed until the stream is destroyed by the caller.

#include <stdio.h>
#include <mailutils/pop3.h>

int
print_top (pop3_t pop3, unsigned int msgno, unsigned int lines)
{
    stream_t stream;
    int status = pop3_top (pop3, msgno, lines, &stream);
    if (status == 0)
     {
        size_t n = 0;
        char buf[128];
        while ((stream_readline (stream, buf, sizeof buf, &n) == 0)
               && n)
          printf ("%s", buf);
        stream_release (stream);
     }
  return status;
}

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Uidl

Function: int pop3_uidl (pop3_t, unsigned int msgno, char **uidl)

The Uniq Identifier is return in uidl, the string must be free ()'ed, by the caller.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Function: int pop3_uidl_all (pop3_t, iterator_t * iterator)

An iterator object is return to iterate through the response and must be destroyed by the caller.

#include <stdio.h>
#include <stdlib.h>
#include <mailutils/pop3.h>

void print_uidl (pop3_t pop3)
{
   iterator_t iterator;
   status = pop3_uidl_all (pop3, &iterator);
   if (status == 0)
    {
        for (iterator_first (iterator);
             !iterator_is_done (iterator);
             iterator_next (iterator))
          {
              unsigned int msgno;
              char *uidl;
              if (pop3_uidl_current (iterator, &msgno, &uidl) == 0)
               {
                   printf ("LIST: %d %s\n", msgno, uidl);
                   free (uidl);
               }
          }
        iterator (&iterator);
    }
   else
     printf ("NONE\n");
}

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Function: int pop3_uidl_current (iterator_t iterator, unsigned int *msgno, char **uidl)

Cover functions around iterator_current () from an iterator created by pop3_uidl_all () to format the result. The variable uidl should be free ()'ed.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

User

Function: int pop3_user (pop3_t, const char *user)

Sends the User command.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Help functions

Function: int pop3_writeline (pop3_t, const char *format, ...);

Copy in the internal buffer of pop3_t the string, pop3_send () should be called later to flush the string to the POP3 server.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Function: int pop3_sendline (pop3_t, const char *cmd);

Cover function for pop3_writeline () and pop3_send ().

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Function: int pop3_send (pop3_t, const char *cmd);

Flushes out the strings written by pop3_writeline () in the internal buffer to the channel.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Function: int pop3_response (pop3_t, char *buffer, size_t len, size_t *plen)

The last response from the last command is save and can be examine after a failure or success.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_IO
MU_ERROR_TIMEOUT
MU_ERROR_TRY_AGAIN
MU_ERROR_OPERATION_DENIED

Timeout

Function: int pop3_set_timeout (pop3_t, int timeout)

Set the timeout time for I/O on the carrier. The default is 10 minutes. The timeout is given in milliseconds.

Function: int pop3_get_timeout (pop3_t, int *timeout)

Get the timeout time for I/O on the carrier. The timeout is given in milliseconds.

IMAP4

/* Prefix imap4_ is reserved */
#include <mailutils/imap4.h>

Internet Message Access Protocol - Version (4rev1). Not implemented.

Commands

Initialization

Function: int imap4_create (imap4_t *)

Function: int imap4_open (imap4_t, const char *hostname, unsigned int port, int flags)

Function: int imap4d_set_timeout (imap4_t, unsigned int seconds)

Append

Function: int imap4_append (imap4_t)

Capability

Function: int imap4_capability (imap4_t)

Create

Function: int imap4_create_mailbox (imap4_t, const char *mbox)

Check

Function: int imap4_check (imap4_t)

Close

Function: int imap4_close (imap4_t)

Copy

Function: int imap4_copy (imap4_t)

UID Copy

Function: int imap4_uid_copy (imap4_t)

Delete

Function: int imap4_delete (imap4_t)

Fetch

Function: int imap4_fetch (imap4_t)

UID Fetch

Function: int imap4_uid_fetch (imap4_t)

Examine

Function: int imap4_examine (imap4_t)

Expunge

Function: int imap4_expunge (imap4_t)

List

Function: int imap4_list (imap4_t)

Lsub

Function: int imap4_lsub (imap4_t)

Namespace

Function: int imap4_namespace (imap4_t)

Rename

Function: int imap4_rename (imap4_t)

Search

Function: int imap4_search (imap4_t)

UID Search

Function: int imap4_uid_search (imap4_t)

Select

Function: int imap4_select (imap4_t)

Status

Function: int imap4_status (imap4_t)

Store

Function: int imap4_store (imap4_t)

UID Store

Function: int imap4_uid_store (imap4_t)

Function: int imap4_subscribe (imap4_t)

Unsubscribe

Function: int imap4_unsubscribe (imap4_t)

Mbox

/* Prefix mbox_ is reserved */
#include <mailutils/mbox.h>

The most common mailbox format on UNIX platform is mbox. Mbox file is messages separated by the special format string.

   From SP envelope-sender SP date [SP moreinfo]

"From ": is sometimes call the From_.
envelope-sender: is a word with no space.
date: has the same format as asctime ()
moreinfo: are optional values that are seldom used.

A mbox_t is created, initialized and destroyed by mbox_create () and mbox_destroy (). When opening, mbox_open () will do a quick check to see if the format is a valid format or an empty file. The scanning of the mailbox is done by mbox_scan (). The function, mbox_scan (), takes callback functions called during the scanning to provide information. The scanning will cache some of the headers fields for speed. Closing the mailbox, mbox_close () will free any resources like, headers cache, locks etc ... All the messages with attributes marked deleted will only be removed on mbox_expunge (). If only the attributes need to be save but the messages not removed, this can be done by mbox_save_attributes (). New messages are added with mbox_append (). Attributes are saved in the Status: header field, Read is 'R', Seen is 'O', Deleted is 'd' and Reply is 'r'.

Initialization

Function: int mbox_create (mbox_t *mbox)

Allocate and initialize a mbox handle.

MU_ERROR_NO_MEMORY
MU_ERROR_INVALID_PARAMETER

Function: void mbox_destroy (mbox_t mbox)

When a POP3 session is finished, the structure must be free ()'ed to reclaim memory.

Carrier

Function: int mbox_set_carrier (mbox_t, stream_t carrier);

Another type of stream can be provided to work on, the carrier is set in the mbox_t handle. Any previous carrier stream in the handle, will be close and release. Since the parsing code maintain only the offsets off the message the carrier stream must be seekable.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_get_carrier (mbox_t, stream_t *carrier);

Return the mbox_t carrier. If none was set, a new file stream will be created.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_NO_MEMORY

Function: int mbox_open (mbox_t, const char *filename, int flags)

Open carrier stream with filename and flags. The stream will be quickly examine to see if it is a mbox format.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_NO_MEMORY
MU_ERROR_NO_ENTRY
MU_ERROR_NO_ACCESS
MU_ERROR_NOT_SUPPORTED

Function: int mbox_close (mbox_t)

Close the carrier stream and resources particular to the mailbox.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_NO_MEMORY

Function: int mbox_uidnext (mbox_t, unsigned long *uidnext)

Return the uidnext, if the mbox_t was not scan mbox_scan () is called first.

MU_ERROR_INVALID_PARAMETER
same as mbox_scan ()

Function: int mbox_uidvalidity (mbox_t, unsigned long *uidvalidity)

Return the uidvalidity, if the mbox_t was not scan mbox_scan () is called first.

MU_ERROR_INVALID_PARAMETER
same as mbox_scan ()

Function: int mbox_get_attribute (mbox_t, unsigned int msgno, attribute_t *attribute)

Return an attribute to indicate the status of message number msgno.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_NO_MEMORY

Function: int mbox_get_separator (mbox_t, unsigned int msgno, char **sep)

Return an allocated string in sep containing the value "From " separating each message in Unix mbox format. The string should be free ()ed by the caller.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_NO_MEMORY

Function: int mbox_set_separator (mbox_t, unsigned int msgno, const char *sep)

The variable sep should contain a valid "From " separator that will be use when the expunging.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_NO_MEMORY

Function: int mbox_get_hstream (mbox_t, unsigned int msgno, stream_t *stream)

Return a stream to read the header of message msgno. The stream should be destroy after usage.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_NO_MEMORY

Function: int mbox_set_hstream (mbox_t, unsigned int msgno, stream_t stream)

Use stream when expunging for message msgno.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_set_hsize (mbox_t, unsigned int msgno, unsigned int *size)

Return the size of message msgno.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_set_hlines (mbox_t, unsigned int msgno, unsigned int *size)

Return the number of lines of message msgno.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_get_bstream (mbox_t, unsigned int msgno, stream_t *stream)

Return a stream to read the body of message msgno. The stream should be destroy after usage.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_NO_MEMORY

Function: int mbox_set_bstream (mbox_t, unsigned int msgno, stream_t stream)

Use stream when expunging for message msgno.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_set_bsize (mbox_t, unsigned int msgno, unsigned int *size)

Return the size of message msgno.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_set_blines (mbox_t, unsigned int msgno, unsigned int *size)

Return the number of lines of message msgno.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_get_size (mbox_t, unsigned int *size)

Return the size of mailbox.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_save (mbox_t)

Save the changes to the messages back to the mailbox, but do not remove messages mark for deletion in the process.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_mak_deleted (mbox_t, unsigned int msgno)

Mark msgno for deletion.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_unmak_deleted (mbox_t, unsigned int msgno)

Unmark msgno if it was marked for deletion.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_expunge (mbox_t)

Save the changes to the mailbox and in the process remove all messages marked for deletion.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_append (mbox_t, const char *sep, stream_t stream)

Append to the mailbox an rfc822 message represented by stream. The variable sep should contain a valid "From " separator or NULL to get the default.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_append_hb (mbox_t, const char *sep, stream_t hstream, stream_t bstream)

Append to the mailbox an rfc822 message represented by a header, hstream, and a body, bstream. The variable sep should contain a valid "From " separator or NULL to get the default.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_scan (mbox_t, unsigned int start, unsigned int *count)

Start scanning the mailbox for new messages. The variable start can be a message number starting point. The result of the scanning will be in count. The scanning will trigger the mbox_newmsg_cb() callback for each new message and mbox_progress_cb () at different interval to notify progression. The return values of the those callback should be 0 is different then 0 the scanning will be stop an the function returns MU_ERROR_INTERRUPTED.

MU_ERROR_INVALID_PARAMETER
MU_ERROR_INTERRUPTED
MU_ERROR_NO_MEMORY

Function: int mbox_set_progress_cb (mbox_t, int (*callback) (int, void *)), void *arg)

Set the callback function for progress. The variable arg will be pass back in the callback as the second argument.

MU_ERROR_INVALID_PARAMETER

Function: int mbox_set_newmsg_cb (mbox_t, int (*callback) (int, void *)), void *arg)

Set the callback function for new messages. The variable arg will be pass back in the callback as the second argument.

MU_ERROR_INVALID_PARAMETER

Mh

/* Prefix mh_ is reserved */
#include <mailutils/mh.h>

Mail Handler mailbox format. Not implemented.

Maildir

/* Prefix maildir_ is reserved */
#include <mailutils/maildir.h>

QMail mailbox format. Not implemented.

SMTP

/* Prefix smtp_ is reserved */
#include <mailutils/smtp.h>

Simple Mail Transfer Protocol. Not implemented.

Commands

Initialization

Function: int smtp_create (smtp_t *)

Function: void smtp_destroy (smtp_t *)

Function: int smtp_open (smtp_t, const char *host, unsigned int port, int flags)

Data

Function: int smtp_data (smtp_t, stream_t stream)

Helo

Function: int smtp_helo (smtp_t, const char *domain)

Function: int smtp_ehlo (smtp_t, const char *domain)

Expn

Function: int smtp_expn (smtp_t, const char *list, iterator_t *)

Help

Function: int smtp_help (smtp_t, const char *help, iterator_t *)

Mail From

Function: int smtp_mail_from (smtp_t, const char *address, const char *param)

Noop

Function: int smtp_noop (smtp_t)

Quit

Function: int smtp_quit (smtp_t)

Recpt To

Function: int smtp_rcpt_to (smtp_t, const char *address, const char *param)

Reset

Function: int smtp_reset (smtp_t)

Verify

Function: int smtp_verify (smtp_t, const char *user)

Help functions

Function: extern int smtp_readline (smtp_t, char *buffer, size_t len, size_t *len)

Function: extern int smtp_response (smtp_t, char *buffer, size_t len, size_t *len)

Function: extern int smtp_writeline (smtp_t, const char *format, ...)

Function: extern int smtp_sendline (smtp_t, const char *line)

Function: extern int smtp_send (smtp_t

Sendmail

/* Prefix sendmail_ is reserved */
#include <mailutils/sendmail.h>

Spawning Sendmail daemon to deliver mail. Not implemented.

NNTP

/* Prefix nntp_ is reserved */
#include <mailutils/nntp.h>

Network News Transfer Protocol. Not implemented.

Commands

Initialization

Function: int nntp_create (nnpt_t *)

Function: int nntp_destroy (nnpt_t *)

Function: int nntp_open (nnpt_t)

Article

Function: int nntp_article (nnpt_t)

Body

Function: int nntp_body (nntp_t)

Group

Function: int nntp_group (nntp_t)

Head

Function: int nntp_head (nntp_t)

Help

Function: int nntp_help (nntp_t)

IHave

Function: int nntp_ihave (nntp_t)

Last

Function: int nntp_last (nntp_t)

List

Function: int nntp_list (nntp_t)

NewGroups

Function: int nntp_newgroups (nntp_t)

NewNews

Function: int nntp_newnews (nntp_t)

Function: int nntp_next (nntp_t)

Post

Function: int nntp_post (nntp_t)

Quit

Function: int nntp_quit (nntp_t)

Slave

Function: int nntp_slave (nntp_t)

Stat

Function: int nntp_stat (nntp_t)

Parse822

/* Prefix parse822_ is reserved */
#include <mailutils/parse822.h>

Internet Message Format, see Address node for the discussion.

Function: int parse822_address_list (address_t* a, const char* s)

Function: int parse822_mail_box (const char** p, const char* e, address_t* a)

Function: int parse822_group (const char** p, const char* e, address_t* a)

Function: int parse822_address (const char** p, const char* e, address_t* a)

Function: int parse822_route_addr (const char** p, const char* e, address_t* a)

Function: int parse822_route (const char** p, const char* e, char** route)

Function: int parse822_addr_spec (const char** p, const char* e, address_t* a)

Function: int parse822_unix_mbox (const char** p, const char* e, address_t* a)

Function: int parse822_local_part (const char** p, const char* e, char** local_part)

Function: int parse822_domain (const char** p, const char* e, char** domain)

Function: int parse822_sub_domain (const char** p, const char* e, char** sub_domain)

Function: int parse822_domain_ref (const char** p, const char* e, char** domain_ref)

Function: int parse822_domain_literal (const char** p, const char* e, char** domain_literal)

Function: int parse822_quote_string (char** quoted, const char* raw)

Function: int parse822_quote_local_part (char** quoted, const char* raw)

Function: int parse822_field_body (const char** p, const char *e, char** fieldbody)

Function: int parse822_field_name (const char** p, const char *e, char** fieldname)

Go to the first, previous, next, last section, table of contents.