share
The Share Library Project.
The share library introduces a new model of handling IPC and Internet communications. Supplies documented API with POSIX and convienence calls for networking applications.
API: Share Library Documentation
Quick Instructions
Share Library Build Instructions
On linux, a build can be performed by running the following:
git clone https://github.com/neonatura/share cd share mkdir build cd build ../configure make make install
Note: Use --libdir=/usr/lib64 on Cent OS platforms.
Build Dependencies
You must install the 'gcc-java' package in order to provide the "jni.h" gcc header file for the java API to compile correctly. To install on linux run 'yum install gcc-java' or 'apt-get install gcc-java'.
SWIG is optional. Pre-built source code has been generated as part of the distritution. To install on linux run 'yum install swig' or 'apt-get install swig'.
The "libusb-1.0" library is required for compiling the libshare library suite unless the configure flag "--disable-usb" is specified.
On CentOS you can run the following: yum install libusb1 libusb1-devel
On Ubuntu you can run the following: apt-get install libusb-1.0.0-dev
You can compile and install the included "libusb-1.0.XX.zip" on any platform. Download Url: https://sourceforge.net/projects/libusb/files/libusb-1.0/libusb-1.0.21/libusb-1.0.21.zip/download
"libusb-1.0" compile instructions: unzip libusb-1.0.XX.zip cd libusb-1.0.XX ./autogen.sh ./configure make make install
Library Specifications
Internet
Network communications can be performed in a traditional manner in order to replace the TCP protocol with the share library's built-in Encoded Stream Protocol.
The Encoded Stream Protocol introduces several enhancement over the original 1981 TCP model. TCP was designed for a much different virtual-verse than what is available in the 21st century.
The Encoded Stream Protocol provides extra security, built-in stream compression, backwards compatibility, packet route probing, optimized route detection, and increases the maximum limitations on the amount of data that can be sent in a single interval of time.
Large stream buffer support (over 64k per r/w) which minimizes critical program termination due to socket errors.
The Share Library also implements maximum operating system thresholds and the ability to accept more than 1024 sockets by a single process,
Inter-Process Communication (IPC)
The share library supports POSIX style share memory mapping, message queues, and memory mapped files. The mapped files may preside on a local file system or a shared file.
The share library provides simulated block devices in order to stream file data between multiple endpoints. Permissions allow control of whether the stream is readable, writeable, or executable.
- Shared Filesystem
The share library introduces a flexible approach to inter-process communication by combining a shared memory map with a versioned file system.
The sharefs file system utilitizes the operating system's file cache in order to simulate a shared memory segment.
File data is saved persistently with access rights based on the peer reading or writing the file. Several version of the same file may exist, and based on the trust level with another sharefs peer multiple copies of the same file may exist.
The structure of the file system is designed in order to allow for multiple hierarchies simutaneously. The file system contains "meta file" definitions which allow for a program dynamically interpret how to handle file data.
Share Daemons
The share library provides the ability to easily establish several standard daemons such as web or email server. The daemon uses a combination of specific content, meta file definitions, and shared file data.
Portability
Support share library API calls are accessible from php, java, and android platforms.
Revision History
June 30 2014release of v2.1.4 Local shfs partition support. The usded daemon with embedded stratum capability.
April 10 2013release of v2.1 (releases/libshare_2.1.tar.xz) Current functionality provides preliminary support for sharefs filesystem, socket wrappers, hashmaps, memory buffers/pools, tiny encryption, and locks. See the 'doc/html' directory for a API reference manual. Includes gnulib support for base fs/socket operations, java bindings, and self-test routines.
Future Release Versions
share library version 2.3.0 Distributed file-system support.