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
  39 <br />&nbsp;<br />
  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
  45 <br />&nbsp;<br />&nbsp;<br />
  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 <li>Some of the network routines do not support IPv6.
  71
  72
  73 <br />&nbsp;<br />&nbsp;<br />
  74 <b><a name="macosx"></a>Mac OS X Implementation</b>
  75
  76 <br />&nbsp;<br />
  77 All features and components delivered with the Toolkit work on Mac
  78 OS X platform.  There are no special Mac OS X platform related
  79 implementation issues with current version of Toolkit.
  80
  81
  82 <br />&nbsp;<br />&nbsp;<br />
  83 <b><a name="symbian"></a>Symbian OS Implementation</b>
  84
  85 <br />&nbsp;<br />
  86 Symbian OS support in Toolkit is still experimental.  By default all
  87 features and components delivered with the Toolkit are supported and
  88 should work on Symbian.  However, there are some issues with the Symbian
  89 version of the Toolkit of what Symbian developers need to be aware.
  90
  91 <br />&nbsp;<br />
  92 <li>The function <tt>silc_schedule</tt> on Symbian will allocate new Active
  93 Scheduler Waiter and will block the calling thread.  The caller should
  94 allocate Active Scheduler before calling <tt>silc_schedule</tt>.
  95
  96 <li>When adding timeout tasks to SILC Scheduler the SILC Scheduler is woken
  97 up after the timeout task has been added.  This allows adding of the
  98 timeout tasks from Symbian active objects outside the SILC Scheduler loop.
  99 On other platforms this wakeup operation is not performed.
 100
 101 <li>Adding fd task to SILC Scheduler will not schedule the fd for any
 102 operation.  Instead, programmer should use SILC Socket Stream API and SILC
 103 Fd Stream API on Symbian when dealing with file descriptors and sockets.
 104 These APIs provide asynchronous notification when data is available and can
 105 be written.
 106
 107 <li>The function <tt>silc_thread_create</tt> on Symbian will install Active
 108 Scheduler and allocate Cleanup Stack for the new thread.  The created
 109 thread always shares heap with the parent thread.
 110
 111 </div> <!-- content -->
 112
 113 </div> <!-- contentwrapper -->
 114 <div id="footer">
 115 <table border="0" cellspacing="0" cellpadding="6" width="100%">
 116  <tr valign="top">
 117   <td>Copyright &copy; 2001 - 2008 SILC Project<br />
 118     <a href="http://silcnet.org">SILC Project Website</a></td>
 119   <td align="right">
 120    <a href="index.html">SILC Runtime Toolkit Manual</a><br />
 121    <a href="masterindex.html">Index</a></small></td>
 122   </td>
 123  </tr>
 124 </table>
 125 </div>
 126
 127 </body>
 128 </html>
 129