doc/runtime.in/platforms.html

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   3                       "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   4 <html  xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   5 <head>
   6 <meta http-equiv="Content-Style-Type" content="text/css" />
   7 <meta http-equiv="Content-type" content="text/html; charset=ISO-8859-1" />
   8 <link rel="stylesheet" href="./runtime.css" type="text/css" />
   9 <title>SILC Runtime Toolkit</title>
  10 </head>
  11 <body>
  12
  13 <div id="logo">
  14 <table border="0" cellspacing="0" cellpadding="6" width="100%">
  15  <tr valign="top">
  16   <td>Copyright &copy; 2001 - 2008 SILC Project<br />
  17     <a href="http://silcnet.org">SILC Project Website</a></td>
  18   <td align="right">
  19    <a href="index.html">SILC Runtime Toolkit Manual</a><br />
  20    <a href="masterindex.html">Index</a></small></td>
  21   </td>
  22  </tr>
  23 </table>
  24 </div>
  25
  26 <div id="contentwrapper">
  27 <div id="navigation">
  28 </div> <!-- navigation -->
  29 <div id="content">
  30
  31 <big><b>Platform Implementations</b></big>
  32
  33 <br />&nbsp;<br />
  34 This document describes the implementation issues with different platforms
  35 that the SILC Runtime Toolkit support.  Some of the supported platforms
  36 does not support all the features delivered with the Toolkit or they may
  37 behave differently from other platforms.
  38 <br />
  39
  40 <ul class="toc_entries">
  41 <li><a href="#unix">Unix & Linux Implementation</a><br />
  42 <li><a href="#windows">Windows Implementation</a><br />
  43 <li><a href="#macosx">Mac OS X Implementation</a>
  44 <li><a href="#symbian">Symbian OS Implementation</a>
  45 </ul>
  46
  47 <b>Supported Platforms</b>
  48
  49 <br />&nbsp;<br />
  50 The Toolkit supports by default all Unix and Linux platforms, Windows
  51 platforms from Windows 2000 and newer, Mac OS X and Symbian OS.
  52
  53 <br />&nbsp;<br />&nbsp;<br />
  54 <b><a name="unix"></a>Unix Implementation</b>
  55
  56 <br />&nbsp;<br />
  57 All features and components delivered with the Toolkit work on all
  58 Unix and Linux platforms.  There are no special Unix platform related
  59 implementation issues with current version of Toolkit.
  60
  61
  62 <br />&nbsp;<br />&nbsp;<br />
  63 <b><a name="windows"></a>Windows Implementation</b>
  64
  65 <br />&nbsp;<br />
  66 By default all features and components delivered with Toolkit are
  67 supported on Windows.  However, there are some certain issues with the
  68 Windows version of the Toolkit.
  69
  70 <br />&nbsp;<br />
  71 <ul>
  72 <li>Some of the network routines do not support IPv6.
  73 </ul>
  74
  75 <br />&nbsp;<br />&nbsp;<br />
  76 <b><a name="macosx"></a>Mac OS X Implementation</b>
  77
  78 <br />&nbsp;<br />
  79 All features and components delivered with the Toolkit work on Mac
  80 OS X platform.  There are no special Mac OS X platform related
  81 implementation issues with current version of Toolkit.
  82
  83
  84 <br />&nbsp;<br />&nbsp;<br />
  85 <b><a name="symbian"></a>Symbian OS Implementation</b>
  86
  87 <br />&nbsp;<br />
  88 Symbian OS support in Toolkit is still experimental.  By default all
  89 features and components delivered with the Toolkit are supported and
  90 should work on Symbian.  However, there are some issues with the Symbian
  91 version of the Toolkit of what Symbian developers need to be aware.
  92
  93 <ul>
  94 <li>The function <tt>silc_schedule</tt> on Symbian will allocate new Active
  95 Scheduler Waiter and will block the calling thread.  The caller should
  96 allocate Active Scheduler before calling <tt>silc_schedule</tt>.
  97
  98 <li>When adding timeout tasks to SILC Scheduler the SILC Scheduler is woken
  99 up after the timeout task has been added.  This allows adding of the
 100 timeout tasks from Symbian active objects outside the SILC Scheduler loop.
 101 On other platforms this wakeup operation is not performed.
 102
 103 <li>Adding fd task to SILC Scheduler will not schedule the fd for any
 104 operation.  Instead, programmer should use SILC Socket Stream API and SILC
 105 Fd Stream API on Symbian when dealing with file descriptors and sockets.
 106 These APIs provide asynchronous notification when data is available and can
 107 be written.
 108
 109 <li>The function <tt>silc_thread_create</tt> on Symbian will install Active
 110 Scheduler and allocate Cleanup Stack for the new thread.  The created
 111 thread always shares heap with the parent thread.
 112 </ul>
 113
 114 <br />&nbsp;<br />
 115 </div> <!-- content -->
 116
 117 </div> <!-- contentwrapper -->
 118 <div id="footer">
 119 <table border="0" cellspacing="0" cellpadding="6" width="100%">
 120  <tr valign="top">
 121   <td>Copyright &copy; 2001 - 2008 SILC Project<br />
 122     <a href="http://silcnet.org">SILC Project Website</a></td>
 123   <td align="right">
 124    <a href="index.html">SILC Runtime Toolkit Manual</a><br />
 125    <a href="masterindex.html">Index</a></small></td>
 126   </td>
 127  </tr>
 128 </table>
 129 </div>
 130
 131 </body>
 132 </html>
 133