/lacewing

Cross-platform network I/O library for C/C++

Primary LanguageC++OtherNOASSERTION

liblacewing is a library for writing cross-platform, networked applications in C/C++.

http://lacewing-project.org/

http://github.com/udp/lacewing/

Build Status

Installing

Linux/BSD/OS X:

./configure
make
make install

Windows/MSVC: Use the solution in the msvc directory to build a DLL/LIB.

Windows/MinGW:

./configure --disable-spdy
make
make install

For other platforms (such as the Android NDK) see the documentation.

Documentation

The API documentation for liblacewing can be found here.

Issues with the documentation can be reported in the gh-pages branch of the liblacewing GitHub repository.

Changes in 0.4.3 (2012-Oct-28)

  • Various issues with the Windows implementation of FDStream resolved

  • Visual Studio projects added for examples

  • Issues with building under MinGW resolved

  • Server::Client::NPN stub added for Windows

  • New parameter to Stream::Close to allow cancellation of pending writes

  • Public header file renamed from Lacewing.h to lacewing.h (lowercase)

  • C webserver examples updated for the current C API

  • Updated to the latest version of multipart-parser-c

0.4.3 Release Notes

Changes in 0.4.2 (2012-Aug-23)

  • Fix issue with POST data truncation (0.4.1 regression)

  • Cookies were not correctly parsed

  • StreamGraph did not read beyond any filters present in a graph

0.4.2 Release Notes

Changes in 0.4.1 (2012-Aug-22)

  • Fix issue with HTTP data not always being completely processed

  • Fix error with URL decoding function which lead to trailing garbage in decoded strings

0.4.1 Release Notes

Changes in 0.4.0 (2012-Aug-21)

  • Webserver now supports the SPDY protocol, and much of the HTTP code has been improved

  • Resolve various issues with the stream system

  • New option in FDStream::SetFD to close the FD on destruction, which is now used by File

  • If Stream::WriteFile failed to open a file, the stream would be permanently blocked

  • Server now supports TLS NPN where available

  • The code for multipart POST data handling has been replaced with multipart-parser-c

  • Fixed IPv4 support in Client

  • File::OpenTemp used incorrect filenames on Windows

0.4.0 Release Notes

Changes in 0.3.1 (2012-Jun-29)

  • New Stream::WritePartial function to opt out of automatic buffering

  • Fix bad length param in GetSockAddr function (causing problems with ::Port etc)

Changes in 0.3.0 (2012-Jun-20)

  • I/O is now separated into classes such as Stream and FDStream instead of being provided separately by each class.

  • The Relay* classes have been removed (they may become a separate library later)

  • HTTP parser switched out for joyent/http-parser

  • IPv6 is now supported

  • Lots of miscellaneous fixes/refactoring

Changes in 0.2.6 (2011-Dec-18)

  • Webserver::Request::Cookie now has a parameter allowing you to set attributes for each cookie. By default, both the Secure and HttpOnly attributes are set.

  • You can now iterate through the headers, cookies, GET/POST parameters and session data stored in a Webserver::Request

  • Bug when parsing fragmented HTTP requests fixed. This made Webserver incompatible with recent fixes for the SSL BEAST attack.

  • The library now builds as liblacewing.dylib on OS X instead of liblacewing.so

  • The source should now build using MinGW (although the included makefile will not work on Windows)

Changes in 0.2.5 (2011-Oct-11)

  • Resolve various issues with the build system

Changes in 0.2.4 (2011-Oct-01)

  • Some functions were missing LacewingFunction in Lacewing.h, and thus were not correctly exported from the shared object/DLL :-

    • RelayServer::Channel::Next
    • RelayServer::Client::Next
    • RelayServer::ChannelCount
    • RelayServer::SetChannelListing

  • The name of a client was set before calling the onNameSet handler in RelayServer

  • Client disconnect issues on BSD/OS X fixed in Server

  • MSG_NOSIGNAL or SO_NOSIGPIPE are now used everywhere, to prevent the generation of unwanted SIGPIPE signals on Unix

  • Possible EventPump deadlock fixed (Unix)

  • New functions introduced:

    • Client::CheapBuffering
    • UDP::Hosting

  • FlashPlayerPolicy class renamed to FlashPolicy

  • Miscellaneous fixes in the C API

Changes in 0.2.3 (2011-Sep-07)

  • Fixed an issue with Lacewing::EventPump on Windows, which would cause functions queued with Post() not to execute in some cases. This lead to to a significant issue with client disconnects not being detected properly in Lacewing::Server.

  • Miscellaneous relay protocol fixes

Changes in 0.2.2 (2011-Aug-31)

  • Lacewing::Timer now ends the timer thread properly in the destructor. In previous versions it was necessary to call Stop() explicitly to avoid a crash.

  • Two issues with the EventPump class fixed:

    • StartEventLoop() could return prematurely in some cases (Unix only)
    • Possible segmentation fault when a null WriteCallback was specified

  • Added the RelayClient and RelayServer source files to the Makefile and Android.mk

  • SHA1_Hex no longer cuts off the last four bytes

  • Updated relay protocol specification and implementation classes (now revision 3)

  • Fixed issue with the GuessMimeType function returning application/octet-stream even for known file extensions

  • Refactored the internals of Lacewing::Webserver for future SPDY support. The HTTP specific code is now separate from the webserver itself.

Changes in 0.2.1 (2011-Jul-15)

  • Fixed crash in the List utility class introduced by 0.2.0

Changes in 0.2.0 (2011-Jul-14)

  • New Javascript liblacewing API for MozJS (SpiderMonkey/TraceMonkey) and V8. Currently only supports the webserver and utility classes. It is also now possible to build liblacewing as a Node.JS module - a wscript for node-waf is provided.

  • Added support for building for Android (Android.mk is in the 'jni' folder)

  • The build system has been changed from automake to autoconf with a simple Makefile. This should solve the headaches with building on different platforms (Windows users should still use the MSVC project as normal.)

  • Removed the dependency on STL, resulting in a much faster build and smaller binaries (particularly on Android.) This also makes it easier to link liblacewing into static Linux binaries.

  • New global hash functions, implemented via OpenSSL or the Win32 crypt32 API:

    • Lacewing::MD5
    • Lacewing::MD5_Hex
    • Lacewing::SHA1
    • Lacewing::SHA1_Hex

  • PostEventLoopExit() function added to the EventPump, to cause StartEventLoop() to return (once any pending events have been processed.)

  • In the Webserver, Request objects are now freed immediately after the connection is closed, after calling the disconnect handler. Previously, the Request object would remain in a disconnected state until Finish() was called.

  • In Unix, the EventPump class is is now just a default implementation of the Pump class, which can be derived from to use custom methods of watching FDs. A custom pump using libev is provided in the 'ev' folder.

  • Fixed some issues with Lacewing::Server on Unix:

    • SendFile didn't always complete in SSL mode
    • SendFile didn't send the file if open() returned 0
    • The Disconnect handler didn't always trigger