Beyond Linux From Scratch - Version 6.1

Chapter 16. Networking Libraries

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

WvStreams Dependencies

Required

OpenSSL-0.9.7g

Optional

pkg-config-0.19, FAM-2.7.0, Berkeley DB-4.3.28, Linux-PAM-0.80, Tcl-8.4.11, Qt-3.3.4, Speex-1.0.5, libvorbis-1.1.1, Doxygen-1.4.3, 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.

Contents

Installed Programs: uni and uniconfd
Installed Libraries: libuniconf.[so,a], libwvbase.[so,a], libwvfft.[so,a], libwvoggspeex.[so,a], libwvoggvorbis.[so,a], libwvqt.[so,a], libwvstreams.[so,a], libwvtelephony.[so,a], libwvutils.[so,a] and libxplc-cxx.a
Installed Directories: /usr/include/wvstreams, /usr/share/doc/wvstreams-4.0.1 and /var/lib/uniconf

Short Descriptions

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.

Last updated on 2005-08-01 13:29:19 -0600