WvStreams-4.0.1

Introduction to WvStreams

WvStreams is a library suite containing platform-independent C++ networking and utilities libraries for rapid application development.

Package information

Download (HTTP): http://open.nit.ca/download/wvstreams-4.0.1.tar.gz
Download (FTP):
Download MD5 sum: 89cdc4f979d1f6d745e173bc7485f325
Download size: 1.0 MB
Estimated disk space required: 57 MB (additional 43 MB to install documentation)
Estimated build time: 0.77 SBU (additional 0.45 SBU to build documentation)

Additional downloads

Required Patch for Tcl: http://www.linuxfromscratch.org/blfs/downloads/6.0/wvstreams-4.0.1-tcl84-1.patch

WvStreams dependencies

Required

OpenSSL-0.9.7e

Optional

pkgconfig-0.15.0, FAM-2.7.0, Berkeley DB-4.3.27, Linux-PAM-0.78, Tcl-8.4.9, Qt-3.3.3, Speex-1.0.4, libvorbis-1.1.0, Doxygen-1.4.1, FFTW-2.X, SWIG, QDBM, OpenSLP, XPLC, Valgrind and Electric Fence

Installation of WvStreams

If you have Tcl and SWIG installed and wish to utilize them, apply the following patch and run the autoreconf program:

patch -Np1 -i ../wvstreams-4.0.1-tcl84-1.patch &&
autoreconf -f

Install WvStreams by running the following commands:

./configure --prefix=/usr \
    --sysconfdir=/etc --localstatedir=/var &&
make

If Doxygen is installed and you wish to build the API documentation, issue the following command:

make doxygen

Now, as the root user:

make install

If you built the API documentation, install it using the following commands:

install -v -d -m755 /usr/share/doc/wvstreams-4.0.1/doxy-html && 
install -v -m644 Docs/doxy-html/* \
    /usr/share/doc/wvstreams-4.0.1/doxy-html

Command explanations

--sysconfdir=/etc: This parameter places configuration files in /etc instead of /usr/etc.

--localstatedir=/var: This parameter places uniconfd run-time files in /var/lib instead of /usr/var/lib.

Configuring WvStreams

Config files

/etc/uniconf.conf

Configuration information

As with most libraries, there is no configuration to do, save that the library directory i.e., /opt/lib or /usr/local/lib should appear in /etc/ld.so.conf so that ldd can find the shared libraries. After checking that this is the case, /sbin/ldconfig should be run while logged in as root.

uni: is a program to interface with the UniConf configuration system.
uniconfd: is a daemon program for the UniConf configuration system.
libuniconf.[so,a]: contains functions that define a hierarchical registry abstraction in the UniConf configuration system.
libwvbase.[so,a]: contains the Base64 encoder and decoder implementations functions.
libwvfft.[so,a]: enables WvStreams programs to easily handle Fast-Fourier transforms, instead of forcing the programmer to use the much harder to use libfftw interface.
libwvoggspeex.[so,a]: enables quick and painless creation of audio streams using the Speex Voice over IP CODEC.
libwvoggvorbis.[so,a]: enables quick and painless creation of audio streams using the OggVorbis CODEC.
libwvqt.[so,a]: enables WvStreams to act as the I/O and configuration back end for Qt and KDE.
libwvstreams.[so,a]: provides functions for basic streaming I/O support.
libtelephony.[so,a]: contains telephony function routines such as echo cancellation, dc offset removal, automatic gain control, etc.
libwvutils.[so,a]: contains functions required by the WvStreams libraries and utility programs.
libxplc-cxx.a: contains helper functions for the C++ WvStreams bindings.

Beyond Linux From Scratch - Version 6.0

Chapter 16. Networking Libraries