/usr/share/doc/qmf/html/messageserver.html is in qmf-doc-html 1.0.7~2011w23.2-2.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 | <?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!-- messageserver.qdoc -->
<head>
<title>MessageServer Daemon</title>
<link href="classic.css" rel="stylesheet" type="text/css" />
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="left" valign="top" width="32"><img src="images/qtlogo.png" align="left" border="0" /></td>
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a></td>
<td align="right" valign="top" width="230"><img src="images/codeless.png" border="0" /></td></tr></table><h1 class="title">MessageServer Daemon<br /><span class="subtitle"></span>
</h1>
<ul><li><a href="#introduction">Introduction</a></li>
<li><a href="#features">Features</a></li>
<li><a href="#accounts">Accounts</a></li>
<li><a href="#interface">Interface</a></li>
<li><a href="#dependencies">Dependencies</a></li>
<li><a href="#logging">Logging</a></li>
</ul>
<a name="introduction"></a>
<h2>Introduction</h2>
<p>The <i>MessageServer</i> application provides message transport services to Messaging Framework client applications. It can send and retrieve messages of various types, to and from external message service providers such as POP and IMAP servers, or local resources such as a SIM card. Protocol implementations are loaded from plugin libraries, so that the system can be extended with new services, without modification to the MessageServer application.</p>
<p>The MessageServer application is a daemon process; it is designed to be always running and available to client applications. If the MessageServer experiences a fault and restarts, clients do not need to re-establish communication with the server process.</p>
<a name="features"></a>
<h2>Features</h2>
<p>Messages provides the following features:</p>
<p><table class="generic" align="center" cellpadding="2" cellspacing="1" border="0">
<thead><tr valign="top" class="qt-style"><th>Feature</th><th>Description</th></tr></thead>
<tr valign="top" class="odd"><td>Send messages</td><td>Send messages via the transport mechanism defined for the associated account.</td></tr>
<tr valign="top" class="even"><td>Retrieve folder and message lists</td><td>Report the list of folders and messages available at the server for an account.</td></tr>
<tr valign="top" class="odd"><td>Retrieve messages</td><td>Retrieve the content of specified messages from the originating server, either partially or completely.</td></tr>
<tr valign="top" class="even"><td>Search messages</td><td>Search for messages via arbitrary criteria, performed at the originating server.</td></tr>
<tr valign="top" class="odd"><td>Manage messages</td><td>Move, copy and delete messages on the originating server.</td></tr>
<tr valign="top" class="even"><td>Status reporting</td><td>Status and progress information is emitted during MessageServer operations, for the benefit of client applications.</td></tr>
</table></p>
<a name="accounts"></a>
<h2>Accounts</h2>
<p>MessageServer supports the following aspects of messaging accounts:</p>
<p><table class="generic" align="center" cellpadding="2" cellspacing="1" border="0">
<thead><tr valign="top" class="qt-style"><th>Feature</th><th>Description</th></tr></thead>
<tr valign="top" class="odd"><td>Unrestricted accounts</td><td>MessageServer supports any number of messaging accounts.</td></tr>
<tr valign="top" class="even"><td>Messaging types</td><td>MessageServer supports accounts using the following messaging types:<ul>
<li>SMS</li>
<li>MMS</li>
<li>Email</li>
<li>Instant Messaging servics</li>
</ul>
</td></tr>
<tr valign="top" class="odd"><td>Email protocols</td><td>The following email protocols are available:<ul>
<li>POP</li>
<li>SMTP</li>
<li>IMAP</li>
</ul>
<p>Other protocols can be supported by providing implementations as plugins.</p>
</td></tr>
<tr valign="top" class="even"><td>Instant Messaging protocols</td><td>The following Instant Messaging protocols are available:<ul>
<li>XMPP (Jabber)</li>
</ul>
<p>Other protocols can be supported by providing implementations as plugins.</p>
</td></tr>
</table></p>
<a name="interface"></a>
<h2>Interface</h2>
<p>MessageServer communicates with clients via QCop. The only supported method of passing messages over this channel is for each client to instantiate an object of the <a href="qmailmessageserver.html">QMailMessageServer</a> class, which converts between IPC messages and local signals and slots.</p>
<p>Some actions of the MessageServer process affect the Messaging Framework data store directly. A client can respond to these actions by connecting to the relevant signals of the <a href="qmailstore.html">QMailStore</a> class, such as <a href="qmailstore.html#messagesAdded">QMailStore::messagesAdded</a>(), and <a href="qmailstore.html#messagesRemoved">QMailStore::messagesRemoved</a>().</p>
<a name="dependencies"></a>
<h2>Dependencies</h2>
<p>MessageServer has the following dependencies:</p>
<ul>
<li>the <a href="qtextendedmail.html">Messaging Framework Client Library</a></li>
<li>the <a href="qtextendedmail-messageserver.html">Message Server Support Library</a></li>
</ul>
<a name="logging"></a>
<h2>Logging</h2>
<p>MessageServer supports runtime-enabled logging. The logging levels in use can be changed by updating the configuration file and sending a HUP signal to the messageserver process.</p>
<p>The config file for logging is located at ~/.config/Nokia/QMF.conf. The logging configuration is in the <tt>[Logging]</tt> section. <tt>qmaillog.h</tt> defines the categories that can be used.</p>
<p>An example config file follows:</p>
<pre> [Logging]
Messaging=0
IMAP=0
SMTP=0
POP=0</pre>
<p>To inform the messageserver process that the logging levels have been changed you must send it a HUP signal.</p>
<pre> killall -HUP messageserver</pre>
<p>Note that the default for a runtime-enabled logging category in release builds is off and in debug builds it is on. If a category is defined in the config file that definition will take precedence over the default.</p>
<p /><address><hr /><div align="center">
<table width="100%" cellspacing="0" border="0"><tr class="address">
<td align="left">Copyright © 2010 QtSoftware</td>
<td align="right"><div align="right">Messaging Framework</div></td>
</tr></table></div></address></body>
</html>
|