PJLIB

PJLIB is an Open Source, small footprint framework library written in C for making scalable applications. It can be used in wide range of applications, from embedded systems, mobile applications, to high performance systems.

Key Features

Extreme Portability

From 16-bit, 32-bit, to 64-bit, big or little endian, single or multi-processors, wide range of operating systems, Unicode support. With or without floating point support. Multi-threading or not. With/without ANSI LIBC. Currently known to run on these platforms:

• Mac OS X (Intel and M1)

• Windows (32 and 64bit)

• Linux/uClinux

• Smartphones:

  • iOS

  • Android

  • Windows Phone 10/Universal Windows Platform (UWP)

• Community supported:

  • MinGW-w64

  • Embox RTOS

  • OpenBSD

  • FreeBSD

  • Solaris

  • RTEMS

• Deprecated platforms:

  • Windows Mobile/Windows CE

  • Symbian S60 3rd Edition and 5th Edition

  • BlackBerry (BB10)

Small Footprint

PJLIB size is around 150 KB. See Footprint Optimization for more information.

Big in Performance

PJLIB has been designed to achieve highest performance, with design decisions such as own memory management, string, and network event proactor.

See Performance Optimization for more information.

No Dynamic Memory Allocations

• alloc() is a O(1) operation.

• no mutex is used inside alloc().

• no free(). All chunks will be deleted when the pool is destroyed.

Rich Features

• Operating system abstraction

• Low and high level network I/O

• Timer management

• Rich data structures

• Exception construct

• Logging facility

• Random and GUID generation

API Reference

Basic Types and Functions

• Configs & Macros

• Basic Types and Init/Shutdown Functions

• DLL Build Target

Infrastructure

• Error Number Management

  • Errno Framework

  • Standard Error Constants

• Ctype

• Logging

• Assertion

• Math

• Exception Handling

Data structure

• Array

• Hash Table

• Linked List

• RB Tree

Network

• Address Resolution

  • IP Helper

  • Address Resolution

• Network I/O

  • Socket

  • select() Abstraction

  • Active Socket

  • IOQueue (Event Proactor pattern)

• NAT64

SSL/Secure Socket

SSL socket implementation on top of OpenSSL, BoringSSL, GNUTLS, and Apple’s Network framework. See:

• SSL Socket API

• Guide on guide_ssl

File

• File Access

• File I/O

Memory Management

• Introduction to Memory Pool

• Pool

• Pool on Fixed Buffer

• Caching Pool

  • Pool Factory Concept

String & Unicode

String in PJLIB is non-zero terminated, and represented with pj_str_t. A full set of API is provided to manipulate such strings.

• String Manipulations

• Unicode Helper

Multithreading and Concurrency

• Thread

• Concurrency

  • Atomic Operation

  • Critical Section

  • Mutex

  • RW Mutex

  • Semaphore

  • Lock

  • Group Lock

  • Event

• Thread Local Storage

OS Abstraction

• OS Abstraction

  • Symbian OS Specific

• System Information

Time and Timer

• Time

• High Resolution Timestamp

• Timer API

Random and GUID

• Random

• Native GUID generator

Application Microframework

• main()