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