Next Previous Contents

2. Installation

2.1 Getting vls

You can get tarballs and binary packages (Debian packages, RPMs and Windows) for the VideoLAN Server at the vls download page. If you can't find binaries for your operating system, you will have to download the source code (tarball) and build vls by hand (but don't worry, it is very easy ;-)

To install the Debian package, you can type something like:

# dpkg -i vls_0.3.3-1_i386.deb

Under Windows, just extract the zip archive (vls_0.3.3-win.zip for instance) in a directory.

If you have downloaded the source tarball, uncompress it with:

# tar xvzf vls-0.3.3.tar.gz

You can also get the source code through CVS, with the following commands:

# export CVSROOT=:pserver:anonymous@cvs.videolan.org:/cvs/videolan
# cvs login
 [there is no password, just press enter]
# cvs checkout vls
# cvs logout

2.2 Compiling vls (under Unix/Linux)

The VideoLAN Server uses the GNU configure and build system. It means that you will need the standard GNU utilities, such as make, gcc, ld, and so on...

Configuration

The first step is to create the Makefile thanks to the configure script. For a basic configuration, juste run:

# ./configure
You can supply several options to configure, to change the installation directories, for instance. Run ./configure --help to get a list of all options available. Here is an explanation of vls-specific options:
--with-words=(big|little)
Specify endianness when cross-compiling. Don't use this option if you don't know what it means !
--disable-debug
Disable debug mode (enabled by default).
--disable-syslog
Disable the logging to syslogd (enabled by default).
--disable-syslog
Disable the logging to syslogd (enabled by default).
--disable-daemon
Run as Unix/Linux daemon process, --enable-syslog is required (enabled by default). Start application vlsd (instead of vls) to run as daemon process.
--enable-profiling
Generate extra code to write profile information suitable for the analysis program gprof.
--disable-dvd
Disable DVD support (enabled by default). You must supply this option if you don't have libdvdread installed.
--enable-dvb
Enable DVB support (disabled by default).
--with-dvb=[PATH]
Enable DVB support and specify where to get the DVB driver header files.

Building

To compile and link vls, just type:

# make
Afterwards, there should be a binary called vls in the bin subdirectory. There sould be also a library called dvdreader.so, if you enabled DVD support.

2.3 Installing vls (under Unix/Linux)

To install vls files, run

# make install
If you haven't changed the install directories with configure options (--prefix=DIR for instance), these directories are:

2.4 Uninstalling vls (under Unix/Linux)

To uninstall vls binary and config files, just run:

# make uninstall


Next Previous Contents