-SILC - Secure Internet Live Conferencing
-========================================
+SILC Runtime Toolkit
+====================
-SILC (Secure Internet Live Conferencing) is a protocol which provides
-secure conferencing services on the Internet over insecure channel.
-SILC is IRC-like software although internally they are very different.
-The biggest similarity between SILC and IRC is that they both provide
-conferencing services and that SILC has almost the same commands as IRC.
-Other than that they are nothing alike. Major differences are that SILC
-is secure what IRC is not in any way. The network model is also entirely
-different compared to IRC.
+SILC Runtime Toolkit (SRT) provides useful utility functions for application
+programmers. The SRT can be used as the sole and main runtime in any
+application. It provides application main loop, hash table, lists, atomic
+operations, threads, locks, queues, file descriptor stream, socket stream,
+network routines, a finite state machine, memory pool, random number
+generator, buffers, regular expressions, and many many other features.
+The SRT natively supports multiple platforms; Unix/Linux, Windows, Mac OS
+X and Symbian OS, and all APIs work identically or nearly identically on
+all support platforms. The SRT and all of its APIs are entirely reentrant
+and some APIs are completely thread safe.
-Running SILC
-============
-
-After installing the SILC to the system the SILC client is started by
-giving command:
-
- silc
-
-If you want to run with specific configuration file give -f option.
-
-To run the server you should configure the server first. To run the
-server give the command:
-
- silcd
-
-This will launch the server on to the background.
-
-
-Features
-========
-
-Features to be included into the final release of SILC. [Note that the
-current Developer's Version does not include all of these features, read
-TODO file for more information.]
-
- o Normal conferencing services such as private messages, channels,
- channel messages, etc. All traffic is secured and authenticated.
-
- o No unique nicknames. There can same nicknames in SILC without
- collisions. SILC has unique Client ID's, Server ID's and Channel ID's
- to assure that there are no collisions.
-
- o Secure key exchange and authentication protocol. SILC Key Exchange
- protocol provides key material used in the SILC sessions in secure
- manner. The protocol is immune for example to man-in-the-middle
- attacks. The SILC Authentication protocol provides strong
- authentication. Authentication may be based on passphrase or public
- key (RSA) authentication. For clients there is an option not to
- use authentication when connecting to servers.
-
- o All traffic is encrypted and authenticated using the best cryptographic
- algorithms out there. Command messages, private messages and channel
- messages are all protected by encryption. User can set private keys
- for both private message and for channels so that even SILC servers do
- not know the keys. Cipher keys are, by default, 128 bits in length and
- public keys, by default, 1024 bits in length.
-
- o Supports data compression with GZIP to improve performance.
-
- o Supports SOCKS4 and SOCKS5 firewall traversal protocols.
-
- o SIM (SILC Module) support. Support for loading of shared objects at
- run-time that provides new and extended features to both SILC client
- and server. These can provide extra ciphers and extra features to
- the software.
-
- o SILC client can be installed and used without root privileges.
-
- o SILC client can be configured by system wide configuration files but
- with user specific configuration files as well.
-
+The SRT is free software and is dual-licensed with GNU GPL and BSD
+licenses.
History
=======
-SILC was released in the summer 2000 to the public, but the idea and the
-protocol itself is quite old. The SILC was designed by Pekka Riikonen in
-the year 1996 and first lines of codes were written in the early 1997. The
-SILC has been rewritten three times since its very first version in 1997.
-The first version included SILC client, very preliminary SILC server, RSA
-implementation and 3DES implementation. The server actually was not usable
-but the client looked pretty much the same as the first client released in
-the summer 2000. The first version had also random number generator which
-were based on the SSH's random number generator. The current RNG is based
-on the first RNG but has been rewritten twice since the first version.
-
-The development of SILC was suspended in 1997 when Pekka got busy at
-school and in work. The pause laster several months. The development
-resumed in 1998 when Juha Räsänen and Pekka implemented the ElGamal
-algorithm. However, for the same reasons as previously the development
-stopped again, and was resumed again later in 1998 by doing rewrite of
-ther SILC in C++. This was obviously a mistake but at that time it seemed
-like a good idea. Again, in the winter 1999 the development suspended when
-Pekka got busy writing his thesis and was forced to stop the development.
-
-Later, in 1999, it was decided that this time SILC will be rewritten from
-scratch in the right way. C++ was obviously a bad choice so plain C
-language was selected again. The protocol itself faced some rework by
-redesigning some core parts of the protocol. The protocol was also fully
-documented and the protocol specifications were submitted to the IETF. The
-result of this development effort is the release now in public. Since the
-release in the summer 2000 several other people have contributed to the
-project as well. And, the development continues.
-
-
-Contact
-=======
-
-Feedback and comments are welcome. Bug reports should be sent to the
-development mailing list.
-
-Official SILC project web site : http://silcnet.org/
-FTP archive for SILC project : ftp://ftp.silcnet.org/
-Development mailing list address : silc-devel@lists.silcnet.org
-SILC Server : /server silc.silcnet.org
-
+The SRT used to be part of the SILC Toolkit; a software development kit for
+Secure Internet Life Conferencing application programmers. The SRT was
+split off from the SILC Toolkit into its own package due to its generic and
+useful nature. Many APIs still present in SRT have been in use in the SILC
+Toolkit since the year 2000.
-Compiling SILC Toolkit on MAC OS X
+Compiling SILC Runtime on MAC OS X
==================================
-SILC Toolkit works on MAC OS X as well, as that is Unix based operating
+SILC Runtime works on MAC OS X as well, as that is Unix based operating
system. Some compilation issues however must be taken into consideration.
To compile the Toolkit on MAC OS X give the following commands:
make
-This will compile the libraries and applications. If you do not want to
-compile the applications, before giving make command go to the lib/
+This will compile the libraries and applications. If you do not want to
+compile the applications, before giving make command go to the lib/
directory, and give make there:
cd lib
-Compiling SILC Toolkit for Symbian OS
-=====================================
+Compiling SILC Runtime Toolkit for Symbian OS
+=============================================
-The SILC Toolkit works on Symbian OS. This document is intended for those
-that want to compile the SILC Toolkit by themselves for Symbian OS, or for
-Symbian OS emulator. The building environment expects Carbide.c++ and
-WINSCW compiler for emulator target and GCCE (variant of GCC) for device
-target. The SILC Toolkit has not been tested with other compilers or
-build systems. The build environment expects MS Windows.
+The SRT works on Symbian OS. This document is intended for those that
+want to compile the SRT by themselves for Symbian OS, or for Symbian OS
+emulator. The building environment expects Carbide.c++ and WINSCW compiler
+for emulator target and GCCE (variant of GCC) for device target. The SRT
+has not been tested with other compilers or build systems. The build
+environment expects MS Windows.
Requirements
Installing Build Environment
============================
-If you do not have a working Carbide.c++ and Symbian OS SDK environment
+If you do not have a working Carbide.c++ and Symbian OS SDK environment
installed in your MS Windows system it needs to be done first.
1) Download the freely available Carbide.c++ from Nokia at
- http://forum.nokia.com. The exact hyperlink location changes often, so
+ http://forum.nokia.com. The exact hyperlink location changes often, so
it is not referenced here. It is usually under "Tools and SDKs" link.
-2) After installation a web browser is opened automatically by the
- Carbide.c++ installer. Follow its instructions by installing the Perl,
- CTags and the SDK. Perl and the SDK are required, but CTags is
+2) After installation a web browser is opened automatically by the
+ Carbide.c++ installer. Follow its instructions by installing the Perl,
+ CTags and the SDK. Perl and the SDK are required, but CTags is
optional and if necessary can be omitted.
-3) The SILC Toolkit is generic C and C++ code and should work with any
- SDK. If you don't have SDK already installed, install the latest
- version you can find. The links to SDKs are found in the Carbide.c++
- instructions after installation. If you already have SDK in your
+3) The SILC Runtime is generic C and C++ code and should work with any
+ SDK. If you don't have SDK already installed, install the latest
+ version you can find. The links to SDKs are found in the Carbide.c++
+ instructions after installation. If you already have SDK in your
system, you should use that.
-4) After installation the environment should be ready for SILC Toolkit
- building.
+4) After installation the environment should be ready for SRT building.
Building with Carbide.c++
=========================
-After starting the Carbide.c++ you will need to import the SILC Toolkit
-project. Go to File -> Import -> Symbian OS -> Symbian OS Bld.inf file,
-and go to the extracted SILC Toolkit source tree and find symbian\bld.inf
-file and import it. When Carbide.c++ asks for the Root Directory, select
-the root of the extracted SILC Toolkit source tree, if not already
-selected.
+After starting the Carbide.c++ you will need to import the SRT project.
+Go to File -> Import -> Symbian OS -> Symbian OS Bld.inf file, and go
+to the extracted SRT source tree and find symbian\bld.inf file and import
+it. When Carbide.c++ asks for the Root Directory, select the root of the
+extracted SRT source tree, if not already selected.
-After importing the project it is immediately ready for building. By
+After importing the project it is immediately ready for building. By
default, it will build the following libraries:
silc.dll - SILC Core DLL
targets are Emulator or Phone with Debug or Release.
-Using SILC Toolkit in Your Project
+Using SILC Runtime in Your Project
==================================
-When linking with SILC libraries your application will need to also link
+When linking with SRT libraries your application will need to also link
the following Symbian libraries:
estlib
insock
esock
-You will also need to include the \epoc32\include\libc into your system
+You will also need to include the \epoc32\include\libc into your system
include path in your project, if not already included.
-Compiling SILC Toolkit on WIN32
-===============================
+Compiling SILC Runtime Toolkit on WIN32
+=======================================
-SILC Toolkit works on native WIN32 systems as well. This document is
+SILC Runtime works on native WIN32 systems as well. This document is
intended for those who needs to compile the Toolkit for native WIN32
systems. The Toolkit can be compiled for native WIN32 systems using
generally any compiler. However, the compilation environment is designed
cygwin).
-Compiling SILC Toolkit with MSVC++
-==================================
+Compiling SILC Runtime Toolkit with MSVC++
+===========================================
The MSVC++ workspace and project files resides in the win32/ subdirectory
of the Toolkit package. The `silc.dsw' file is the workspace file that
application by setting the global variable silc_debug to TRUE or FALSE.
-Compiling SILC Toolkit with MinGW
-=================================
+Compiling SILC Runtime Toolkit with MinGW
+=========================================
+
+Note that this method is not officially supported and may not work at all.
To compile the Toolkit with MinGW you first need to install the cygwin and
the MinGW into your system. After that you can just normally give the
files for linking against a client application.
-Compiling SILC Toolkit with Cygwin
-==================================
+Compiling SILC Runtime Toolkit with Cygwin
+==========================================
+
+Note that this method is not officially supported and may not work at all.
Compiling the Toolkit with Cygwin is equivalent to compiling with MinGW
except that the ./configure does not take the --with-win32 option. In this
<big><b>Building the Toolkit</b></big>
<br /> <br />
-SILC Runtime Toolkit works on various platforms, such as on several Unix
-systems and on Windows. Building of the Toolkit on some platform may
-differ from the other. This document describes how to build the Toolkit
-from the sources, to create linkable libraries and binaries, on all
+SILC Runtime Toolkit works on various platforms, such as on several Unix
+systems and on Windows. Building of the Toolkit on some platform may
+differ from the other. This document describes how to build the Toolkit
+from the sources, to create linkable libraries and binaries, on all
platforms the Toolkit support.
<br /> <br />
The building instructions for all platforms are also included in the Toolkit
package. Please refer to the INSTALL file for general building instructions
-for Unix systems, README.WIN32 for building on Windows systems, and
-README.MACOSX for building on Mac OS X.
+for Unix systems, README.WIN32 for building on Windows systems,
+README.MACOSX for building on Mac OS X, and README_SYMBIAN for building on
+Symbian OS.
+<br />
-<br /> <br />
+<ul class="toc_entries">
<li><a href="#unix">Building on Unix & Linux</a><br />
<li><a href="#windows">Building on Windows</a><br />
<li><a href="#macosx">Building on Mac OS X</a>
<li><a href="#symbian">Building on Symbian OS</a>
+</ul>
-<br /> <br /> <br />
<b><a name="unix"></a>Building on Unix & Linux</b>
<br /> <br />
-On Unix systems both statically and dynamically linkable libraries are
+On Unix systems both statically and dynamically linkable libraries are
built by default.
<br /> <br />
<tt>--disable-cpu-optimizations</tt>
<br /> <br />
-By default the configure script will attempt to detect the type of your
-CPU and enable any features specific to your CPU that could optimize the
-performance of the Toolkit. If you are creating binary package that
-should work on any CPU (and not only your CPU) you should diable these
-optimizations. If you compile it for yourself only, keeping the
+By default the configure script will attempt to detect the type of your
+CPU and enable any features specific to your CPU that could optimize the
+performance of the Toolkit. If you are creating binary package that
+should work on any CPU (and not only your CPU) you should diable these
+optimizations. If you compile it for yourself only, keeping the
optimizations enabled is recommended.
<br /> <br />
automatically compile the Toolkit. The MSVC++ workspace and project files
resides in the win32/ subdirectory of the Toolkit package. The `srt.dsw'
file is the workspace file that automatically supports compiling the Toolkit
-and to generate the SILC Runtime DLL (libsrt.dll). You may also compile
+and to generate the SILC Runtime DLL (libsrt.dll). You may also compile
debug version by selecteing the Debug compilation method.
<br /> <br /> <br />
symbian/ subdirectory in the Toolkit package.
<br /> <br />
-Please read the README.SYMBIAN from the SILC Runtime Toolkit package for
+Please read the README.SYMBIAN from the SILC Runtime Toolkit package for
complete building instructions.
+<br /> <br />
</div> <!-- content -->
</div> <!-- contentwrapper -->
</body>
</html>
-
<table border="0" cellspacing="0" cellpadding="6" width="100%">
<tr valign="top">
<td>Copyright © 2001 - 2008 SILC Project<br />
- <a href="http://silcnet.org">SILC Project Website</a></td>
+ <a href="http://silc.fi">SILC Project Website</a></td>
<td align="right">
<a href="index.html">SILC Runtime Toolkit Manual</a><br />
<a href="masterindex.html">Index</a></small></td>
<table border="0" cellspacing="0" cellpadding="6" width="100%">
<tr valign="top">
<td>Copyright © 2001 - 2008 SILC Project<br />
- <a href="http://silcnet.org">SILC Project Website</a></td>
+ <a href="http://silc.fi">SILC Project Website</a></td>
<td align="right">
<a href="index.html">SILC Runtime Toolkit Manual</a><br />
<a href="masterindex.html">Index</a></small></td>
<table border="0" cellspacing="0" cellpadding="6" width="100%">
<tr valign="top">
<td>Copyright © 2001 - 2008 SILC Project<br />
- <a href="http://silcnet.org">SILC Project Website</a></td>
- <td align="right">
- <a href="index.html">SILC Runtime Toolkit Manual</a><br />
- <a href="masterindex.html">Index</a></small></td>
+ <a href="http://silc.fi">SILC Project Website</a></td>
</td>
</tr>
</table>
<div id="navigation">
</div> <!-- navigation -->
<div id="content">
-<h2>SILC Runtime Toolkit Reference Manual</h2>
+<h2>SILC Runtime Toolkit @VERSION@</h2>
<p>
-Version: @VERSION@<br />
-Copyright © 1997 - 2008 The SILC Project<br />
-Updated: @DATE@
+SILC Runtime Toolkit (SRT) provides useful utility functions for
+application programmers. SRT can be used as the sole and main runtime
+in any application. It provides application main loop, hash table, lists,
+atomic operations, threads, locks, queues, file descriptor stream, socket
+stream, network routines, a finite state machine, memory pool, random
+number generator, buffers, regular expressions, and many many other
+features.
</p>
<p>
-Welcome to the SILC Runtime Toolkit Reference Manual. The manual is a
-complete developer guide and reference for the application programmer.
-The manual is intended for programmers who would like to use the SILC
-Runtime Toolkit as their primary runtime in their application.</p>
+SRT natively supports multiple platforms; Unix/Linux, Windows, Mac OS X
+and Symbian OS, and all APIs work identically or nearly identically on all
+support platforms. SRT and all of its APIs are entirely reentrant and some
+APIs are completely thread safe.
+</p>
<p>
-The application programming interfaces are automatically generated from the
-Toolkit sources, and the documentation is constantly evolving. New versions
-of the Toolkit always delivers the latest version of this reference manual.
+SRT is free software and is dual-licensed with GNU GPL and BSD licenses.
</p>
-<p class="item_name">GUIDES</p>
+<p class="item_name">DOWNLOAD</p>
<ul class="toc_entries">
-
-<li class="toc_entries"><a href="intro_reference.html">Introduction to the Manual</a><br />
-<li class="toc_entries"><a href="platforms.html">Supported Platforms</a>
-<li class="toc_entries"><a href="building.html">Building the Toolkit</a>
+<li class="toc_entries"><a href="http://silcnet.org/download/srt/sources/">Download SRT sources</a>
+<li class="toc_entries"><a href="http://silcnet.org/download/srt/rpm/">Download SRT RPM binaries</a>
+<li class="toc_entries"><a href="http://silcnet.org/download/srt/win32/">Download SRT Windows binaries</a>
+<li class="toc_entries"><a href="http://silcnet.org/download/srt/symbian/">Download SRT Symbian OS binaries</a>
+<li class="toc_entries"><a href="../../ChangeLog">Release Notes</a>
</ul>
-<p class="item_name">TOOLKIT REFERENCE</p>
+<p class="item_name">DOCUMENTATION</p>
<ul class="toc_entries">
+<li class="toc_entries"><a href="manual.html">Toolkit Reference Manual</a>
+</ul>
-<li class="toc_entries"><a href="./silcruntime_hsilcutil2FRuntime20Toolkit20Interface.html" >Runtime Toolkit Interface</a>
-<li class="toc_entries"><a href="./silcasync_hsilcutil2FAsync20Operation20Interface.html" >Async Operation Interface</a>
-<li class="toc_entries"><a href="./silcatomic_hsilcutil2FAtomic20Operations20Interface.html" >Atomic Operations Interface</a>
-<li class="toc_entries"><a href="./silcbase64_hsilcutil2FBase6420Interface.html" >Base64 Interface</a>
-<li class="toc_entries"><a href="./silcbitops_hsilcutil2FBit20Operations20Interface.html" >Bit Operations Interface</a>
-<li class="toc_entries"><a href="./silcbuffmt_hsilcutil2FBuffer20Format20Interface.html" >Buffer Format Interface</a>
-<li class="toc_entries"><a href="./silcbuffer_hsilcutil2FBuffer20Interface.html" >Buffer Interface</a>
-<li class="toc_entries"><a href="./silccond_hsilcutil2FCondition20Variable20Interface.html" >Condition Variable Interface</a>
-<li class="toc_entries"><a href="./silcconfig_hsilcutil2FConfig20File20Interface.html" >Config File Interface</a>
-<li class="toc_entries"><a href="./silcdir_hsilcutil2FDirectory20Interface.html" >Directory Interface</a>
-<li class="toc_entries"><a href="./silcdlist_hsilcutil2FDynamic20List20Interface.html" >Dynamic List Interface</a>
-<li class="toc_entries"><a href="./silcenv_hsilcutil2FEnvironment20Interface.html" >Environment Interface</a>
-<li class="toc_entries"><a href="./silcerrno_hsilcutil2FErrno20Interface.html" >Errno Interface</a>
-<li class="toc_entries"><a href="./silcfdstream_hsilcutil2FFd20Stream20Interface.html" >Fd Stream Interface</a>
-<li class="toc_entries"><a href="./silcfileutil_hsilcutil2FFile20Util20Interface.html" >File Util Interface</a>
-<li class="toc_entries"><a href="./silcfsm_hsilcutil2FFinite20State20Machine.html" >Finite State Machine</a>
-<li class="toc_entries"><a href="./silcgetopt_hsilcutil2FGetOpt20Interface.html" >GetOpt Interface</a>
-<li class="toc_entries"><a href="./silcglobal_hsilcutil2FGlobal20Variable20Interface.html" >Global Variable Interface</a>
-<li class="toc_entries"><a href="./silchashtable_hsilcutil2FHash20Table20Interface.html" >Hash Table Interface</a>
-<li class="toc_entries"><a href="./silclist_hsilcutil2FList20Interface.html" >List Interface</a>
-<li class="toc_entries"><a href="./silclog_hsilcutil2FLogging20Interface.html" >Logging Interface</a>
-<li class="toc_entries"><a href="./silcmemory_hsilcutil2FMemory20Interface.html" >Memory Interface</a>
-<li class="toc_entries"><a href="./silcstack_hsilcutil2FMemory20Pool20Interface.html" >Memory Pool Interface</a>
-<li class="toc_entries"><a href="./silcmime_hsilcutil2FMIME20Interface.html" >MIME Interface</a>
-<li class="toc_entries"><a href="./silcutil_hsilcutil2FMisc20Utilities.html" >Misc Utilities</a>
-<li class="toc_entries"><a href="./silcmutex_hsilcutil2FMutex20Interface.html" >Mutex Interface</a>
-<li class="toc_entries"><a href="./silcnet_hsilcutil2FNetwork20Interface.html" >Network Interface</a>
-<li class="toc_entries"><a href="./silcrand_hsilcutil2FRandom20Number20Interface.html" >Random Number Interface</a>
-<li class="toc_entries"><a href="./silcregex_hsilcutil2FRegex20Interface.html" >Regex Interface</a>
-<li class="toc_entries"><a href="./silcschedule_hsilcutil2FScheduler20Interface.html" >Scheduler Interface</a>
-<li class="toc_entries"><a href="./silcdll_hsilcutil2FShared20Object20Interface.html" >Shared Object Interface</a>
-<li class="toc_entries"><a href="./silcsnprintf_hsilcutil2FSnprintf20Interface.html" >Snprintf Interface</a>
-<li class="toc_entries"><a href="./silcsocketstream_hsilcutil2FSocket20Stream20Interface.html" >Socket Stream Interface</a>
-<li class="toc_entries"><a href="./silcstream_hsilcutil2FStream20Interface.html" >Stream Interface</a>
-<li class="toc_entries"><a href="./silcstrutil_hsilcutil2FString20Utilities.html" >String Utilities</a>
-<li class="toc_entries"><a href="./silcstringprep_hsilcutil2FStringprep20Interface.html" >Stringprep Interface</a>
-<li class="toc_entries"><a href="./silcthread_hsilcutil2FThread20Interface.html" >Thread Interface</a>
-<li class="toc_entries"><a href="./silcthreadqueue_hsilcutil2FThread20Queue20Interface.html" >Thread Queue Interface</a>
-<li class="toc_entries"><a href="./silctime_hsilcutil2FTime20Interface.html" >Time Interface</a>
-<li class="toc_entries"><a href="./silctimer_hsilcutil2FTimer20Interface.html" >Timer Interface</a>
-<li class="toc_entries"><a href="./silctypes_hsilcutil2FTypes20and20Definitions.html" >Types and Definitions</a>
-<li class="toc_entries"><a href="./silcutf8_hsilcutil2FUTF2D820Interface.html" >UTF-8 Interface</a>
+<p class="item_name">DEVELOPMENT</p>
+<ul class="toc_entries">
+<li class="toc_entries"><a href="https://lists.silcnet.org/mailman/listinfo/silc-devel">Mailing List</a>
+<li class="toc_entries"><a href="http://git.silc.fi/gitweb/?p=runtime.git">SRT GIT Version Control</a> </ul>
-<li class="toc_entries"><a href="masterindex.html">Toolkit Index</a><br />
-</ul>
+<p>
+To clone SRT repository give one of the following commands:
+<pre>
+ git clone git://git.silc.fi/runtime
+ git clone http://git.silc.fi/runtime
+</pre>
+</p>
</div> <!-- content -->
<table border="0" cellspacing="0" cellpadding="6" width="100%">
<tr valign="top">
<td>Copyright © 2001 - 2008 SILC Project<br />
- <a href="http://silcnet.org">SILC Project Website</a></td>
- <td align="right">
- <a href="index.html">SILC Runtime Toolkit Manual</a><br />
- <a href="masterindex.html">Index</a></small></td>
+ <a href="http://silc.fi">SILC Project Website</a></td>
</td>
</tr>
</table>
--- /dev/null
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-type" content="text/html; charset=ISO-8859-1" />
+<link rel="stylesheet" href="./runtime.css" type="text/css" />
+<title>SILC Runtime Toolkit</title>
+</head>
+<body>
+
+<div id="logo">
+<table border="0" cellspacing="0" cellpadding="6" width="100%">
+ <tr valign="top">
+ <td>Copyright © 2001 - 2008 SILC Project<br />
+ <a href="http://silc.fi">SILC Project Website</a></td>
+ <td align="right">
+ <a href="index.html">SILC Runtime Toolkit Manual</a><br />
+ <a href="masterindex.html">Index</a></small></td>
+ </td>
+ </tr>
+</table>
+</div>
+
+<div id="contentwrapper">
+<div id="navigation">
+</div> <!-- navigation -->
+<div id="content">
+<h2>SILC Runtime Toolkit Reference Manual</h2>
+<p>
+Version: @VERSION@<br />
+Copyright © 1997 - 2008 The SILC Project<br />
+Updated: @DATE@
+</p>
+<p>
+Welcome to the SILC Runtime Toolkit Reference Manual. The manual is a
+complete developer guide and reference for the application programmer.
+The manual is intended for programmers who would like to use the SILC
+Runtime Toolkit as their primary runtime in their application.</p>
+<p>
+The application programming interfaces are automatically generated from the
+Toolkit sources, and the documentation is constantly evolving. New versions
+of the Toolkit always delivers the latest version of this reference manual.
+</p>
+
+<p class="item_name">GUIDES</p>
+<ul class="toc_entries">
+
+<li class="toc_entries"><a href="intro.html">Introduction</a><br />
+<li class="toc_entries"><a href="platforms.html">Supported Platforms</a>
+<li class="toc_entries"><a href="building.html">Building the Toolkit</a>
+</ul>
+
+<p class="item_name">TOOLKIT REFERENCE</p>
+<ul class="toc_entries">
+
+<li class="toc_entries"><a href="./silcruntime_hsilcutil2FRuntime20Toolkit20Interface.html" >Runtime Toolkit Interface</a>
+<li class="toc_entries"><a href="./silcasync_hsilcutil2FAsync20Operation20Interface.html" >Async Operation Interface</a>
+<li class="toc_entries"><a href="./silcatomic_hsilcutil2FAtomic20Operations20Interface.html" >Atomic Operations Interface</a>
+<li class="toc_entries"><a href="./silcbase64_hsilcutil2FBase6420Interface.html" >Base64 Interface</a>
+<li class="toc_entries"><a href="./silcbitops_hsilcutil2FBit20Operations20Interface.html" >Bit Operations Interface</a>
+<li class="toc_entries"><a href="./silcbuffmt_hsilcutil2FBuffer20Format20Interface.html" >Buffer Format Interface</a>
+<li class="toc_entries"><a href="./silcbuffer_hsilcutil2FBuffer20Interface.html" >Buffer Interface</a>
+<li class="toc_entries"><a href="./silccond_hsilcutil2FCondition20Variable20Interface.html" >Condition Variable Interface</a>
+<li class="toc_entries"><a href="./silcconfig_hsilcutil2FConfig20File20Interface.html" >Config File Interface</a>
+<li class="toc_entries"><a href="./silcdir_hsilcutil2FDirectory20Interface.html" >Directory Interface</a>
+<li class="toc_entries"><a href="./silcdlist_hsilcutil2FDynamic20List20Interface.html" >Dynamic List Interface</a>
+<li class="toc_entries"><a href="./silcenv_hsilcutil2FEnvironment20Interface.html" >Environment Interface</a>
+<li class="toc_entries"><a href="./silcerrno_hsilcutil2FErrno20Interface.html" >Errno Interface</a>
+<li class="toc_entries"><a href="./silcfdstream_hsilcutil2FFd20Stream20Interface.html" >Fd Stream Interface</a>
+<li class="toc_entries"><a href="./silcfileutil_hsilcutil2FFile20Util20Interface.html" >File Util Interface</a>
+<li class="toc_entries"><a href="./silcfsm_hsilcutil2FFinite20State20Machine.html" >Finite State Machine</a>
+<li class="toc_entries"><a href="./silcgetopt_hsilcutil2FGetOpt20Interface.html" >GetOpt Interface</a>
+<li class="toc_entries"><a href="./silcglobal_hsilcutil2FGlobal20Variable20Interface.html" >Global Variable Interface</a>
+<li class="toc_entries"><a href="./silchashtable_hsilcutil2FHash20Table20Interface.html" >Hash Table Interface</a>
+<li class="toc_entries"><a href="./silclist_hsilcutil2FList20Interface.html" >List Interface</a>
+<li class="toc_entries"><a href="./silclog_hsilcutil2FLogging20Interface.html" >Logging Interface</a>
+<li class="toc_entries"><a href="./silcmemory_hsilcutil2FMemory20Interface.html" >Memory Interface</a>
+<li class="toc_entries"><a href="./silcstack_hsilcutil2FMemory20Pool20Interface.html" >Memory Pool Interface</a>
+<li class="toc_entries"><a href="./silcmime_hsilcutil2FMIME20Interface.html" >MIME Interface</a>
+<li class="toc_entries"><a href="./silcutil_hsilcutil2FMisc20Utilities.html" >Misc Utilities</a>
+<li class="toc_entries"><a href="./silcmutex_hsilcutil2FMutex20Interface.html" >Mutex Interface</a>
+<li class="toc_entries"><a href="./silcnet_hsilcutil2FNetwork20Interface.html" >Network Interface</a>
+<li class="toc_entries"><a href="./silcrand_hsilcutil2FRandom20Number20Interface.html" >Random Number Interface</a>
+<li class="toc_entries"><a href="./silcregex_hsilcutil2FRegex20Interface.html" >Regex Interface</a>
+<li class="toc_entries"><a href="./silcschedule_hsilcutil2FScheduler20Interface.html" >Scheduler Interface</a>
+<li class="toc_entries"><a href="./silcdll_hsilcutil2FShared20Object20Interface.html" >Shared Object Interface</a>
+<li class="toc_entries"><a href="./silcsnprintf_hsilcutil2FSnprintf20Interface.html" >Snprintf Interface</a>
+<li class="toc_entries"><a href="./silcsocketstream_hsilcutil2FSocket20Stream20Interface.html" >Socket Stream Interface</a>
+<li class="toc_entries"><a href="./silcstream_hsilcutil2FStream20Interface.html" >Stream Interface</a>
+<li class="toc_entries"><a href="./silcstrutil_hsilcutil2FString20Utilities.html" >String Utilities</a>
+<li class="toc_entries"><a href="./silcstringprep_hsilcutil2FStringprep20Interface.html" >Stringprep Interface</a>
+<li class="toc_entries"><a href="./silcthread_hsilcutil2FThread20Interface.html" >Thread Interface</a>
+<li class="toc_entries"><a href="./silcthreadqueue_hsilcutil2FThread20Queue20Interface.html" >Thread Queue Interface</a>
+<li class="toc_entries"><a href="./silctime_hsilcutil2FTime20Interface.html" >Time Interface</a>
+<li class="toc_entries"><a href="./silctimer_hsilcutil2FTimer20Interface.html" >Timer Interface</a>
+<li class="toc_entries"><a href="./silctypes_hsilcutil2FTypes20and20Definitions.html" >Types and Definitions</a>
+<li class="toc_entries"><a href="./silcutf8_hsilcutil2FUTF2D820Interface.html" >UTF-8 Interface</a>
+
+<li class="toc_entries"><a href="masterindex.html">Toolkit Index</a><br />
+</ul>
+
+</div> <!-- content -->
+
+</div> <!-- contentwrapper -->
+<div id="footer">
+<table border="0" cellspacing="0" cellpadding="6" width="100%">
+ <tr valign="top">
+ <td>Copyright © 2001 - 2008 SILC Project<br />
+ <a href="http://silc.fi">SILC Project Website</a></td>
+ <td align="right">
+ <a href="index.html">SILC Runtime Toolkit Manual</a><br />
+ <a href="masterindex.html">Index</a></small></td>
+ </td>
+ </tr>
+</table>
+</div>
+
+</body>
+</html>
that the SILC Runtime Toolkit support. Some of the supported platforms
does not support all the features delivered with the Toolkit or they may
behave differently from other platforms.
+<br />
-<br /> <br />
+<ul class="toc_entries">
<li><a href="#unix">Unix & Linux Implementation</a><br />
<li><a href="#windows">Windows Implementation</a><br />
<li><a href="#macosx">Mac OS X Implementation</a>
<li><a href="#symbian">Symbian OS Implementation</a>
+</ul>
-<br /> <br /> <br />
<b>Supported Platforms</b>
<br /> <br />
Windows version of the Toolkit.
<br /> <br />
+<ul>
<li>Some of the network routines do not support IPv6.
-
+</ul>
<br /> <br /> <br />
<b><a name="macosx"></a>Mac OS X Implementation</b>
should work on Symbian. However, there are some issues with the Symbian
version of the Toolkit of what Symbian developers need to be aware.
-<br /> <br />
+<ul>
<li>The function <tt>silc_schedule</tt> on Symbian will allocate new Active
Scheduler Waiter and will block the calling thread. The caller should
allocate Active Scheduler before calling <tt>silc_schedule</tt>.
<li>The function <tt>silc_thread_create</tt> on Symbian will install Active
Scheduler and allocate Cleanup Stack for the new thread. The created
thread always shares heap with the parent thread.
+</ul>
+<br /> <br />
</div> <!-- content -->
</div> <!-- contentwrapper -->
projects / runtime.git / commitdiff