Skip to content

st31ny/smux

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

77 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SMUX Stream MUltiplexer library

The purpose of this library is to multiplex multiple virtual communication channels over a single "physical" channel. See file include/smux.h for detailed interface documentation. For convenience, a c++ wrapper is available at include/smux.hpp.

Dependencies and Compiling

The library itself has no dependencies beyond standard c/c++ lib. For compiling, go into directory lib and type make.

However, in order to run the unit tests, Boost.Test is required (lib boost_unit_test_framework). To build and run the tests, go into directory lib and type make test.

SMUX Host Application

The host application is intended to be run on a Unix-like system and provides means to connect various applications to the individual channels. In order to allow the largest possible flexibility, it integrates with the great socat tool that offers all the tool you need to connect to whatever type of sink or source you like to connect to.

Compiling

The host application can be built from the root directory by running make. The application will be compiled as bin/main/smux/smux.

Usage

Run smux -h for a brief explanation of the usage of the program.

Examples

Connect the master side to a console at /dev/pts/16 and open terminals for the channels 0 and 42:

smux -m file:/dev/pts/16 -c 0=socat:pty,rawer -c 42=socat:pty,rawer

Read master side from stdin, write master to a file/pipe called "out" and connect channel 12 to stdin/stdout of a "program".

smux -m stdio%file:out 12=exec:program

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published