Class Netpop.client

class client : Netchannels.in_obj_channel -> Netchannels.out_obj_channel -> object .. end

The class client implements the POP3 protocol. Client objects are created by

 new client in_ch out_ch

where in_ch is an input channel representing the input direction of the TCP stream, and where out_ch is an output channel representing the output direction of the TCP stream.

method state : state

Current state of this session.

method quit : unit -> unit

Requests the server to end this session. If the session is currently in the `Transaction state, the server will attempt to remove all messages marked as deleted before closing its side of the connection.

method close : unit -> unit

Closes the file descriptors

method user : user:string -> unit

Specifies the name of the mailbox the client would like to open using plain-text authentication. Normal completion of this function should be followed by the pass command.

method pass : pass:string -> unit

Authenticates a user with the plain-text password pass.

method apop : user:string -> pass:string -> unit

Specifies the user and password using APOP authentication. APOP is a more secure method of authentication than what is provided by the user/pass command sequence.

method stat : unit -> int * int * string

Returns information about the current mailbox as tuple (count,size,ext) where count is the number of messages in the mailbox, size is the size of the mailbox in octets, and ext is any server extension data.

method list : ?msgno:int -> unit -> (int, int * string) Hashtbl.t

Returns the scan listing for an optional message number or for all messages in the current mailbox. The result is a hash table that maps a message number to a tuple (size,ext) where size is the size of the message in octets, and ext is any server extension data.

method retr : msgno:int -> Netchannels.in_obj_channel

Retrieves a message from the server.

method dele : msgno:int -> unit

Marks the message number of the current mailbox for deletion.

method noop : unit -> unit

Pings the server to keep the session alive.

method rset : unit -> unit

Unmarks any messages that have previously been marked as deleted.

method top : ?lines:int -> msgno:int -> unit -> Netchannels.in_obj_channel

Returns the message header plus a limited number of lines of the message body. The default body length is 0 lines.

method uidl : ?msgno:int -> unit -> (int, string) Hashtbl.t

Returns the unique identifier(s) for an optional message number or for all messages in the current mailbox. The result is a hash table that maps a message number to its unique id.

method stls : peer_name:string option -> Netsys_crypto_types.tls_config -> unit

Sends STLS (STARTTLS), and negotiates a secure connection. Raises Err_state if TLS is unavailable on the server.

STLS is specified in RFC 2595.

method tls_endpoint : Netsys_crypto_types.tls_endpoint option

Returns the TLS endpoint (after STARTTLS)

method tls_session_props : Nettls_support.tls_session_props option

Returns the TLS session properties (after STARTTLS)

This web site is published by Informatikbüro Gerd Stolpmann

Plasma	GitLab	Archive
Projects	Blog	Knowledge