Provided by: oggfwd_0.2-6_i386 bug

NAME

     oggfwd -- pipe an Ogg stream from stdin to an Icecast server

SYNOPSIS

     oggfwd [-hp] [-d description] [-g genre] [-n name] [-u URL] address port
            password mountpoint

DESCRIPTION

     The oggfwd utility acts as a minimal source client for Icecast servers.
     It reads an Ogg stream from stdin and forwards it to a server specified
     on the command line.

     The address, port, password and mountpoint arguments are mandatory and
     have to be given in that order.

   Optional command line parameters
     -d description
             Set the stream description.

     -g genre
             Set the stream genre.

     -h      Print a short usage summay.

     -n name
             Set the stream (i.e. radio) name.

     -p      Allow the stream to be made public in stream directories.

     -u URL  Set the stream URL.

     oggfwd reacts to the hangup signal, SIGHUP, by printing the amount of
     bytes read from stdin to stdout at the next given opportunity.  How fast
     it reacts depends on the stream's current bitrate.

EXAMPLES

     To forward a public Ogg stream with the name ``Test radio'' to an Icecast
     server, one would pipe that stream to an oggfwd command line such as

         oggfwd -p -n "Test radio" radio.example.com 8000 password /stream.ogg

     Encode an Ogg Vorbis stream, dump it to disk and stream it at the same
     time:

         oggenc - < input.wav | tee streamdump.ogg \
             | oggfwd radio.example.com 8000 password /stream.ogg

AUTHORS

     Programming by
           J^ <j@v2v.cc>
           rafael2k <rafael@riseup.net>
           Moritz Grimm <gtgbr@gmx.net>

     This manual was contributed by Moritz Grimm.

CAVEATS

     Since the password to the Icecast server is given in clear text on the
     command line, other (local) users will probably be able to see it very
     easily.