view libdha/README @ 17566:f580a7755ac5

Patch by Stefan Huehner / stefan % huehner ! org \ patch replaces '()' for the correct '(void)' in function declarations/prototypes which have no parameters. The '()' syntax tell thats there is a variable list of arguments, so that the compiler cannot check this. The extra CFLAG '-Wstrict-declarations' shows those cases. Comments about a similar patch applied to ffmpeg: That in C++ these mean the same, but in ANSI C the semantics are different; function() is an (obsolete) K&R C style forward declaration, it basically means that the function can have any number and any types of parameters, effectively completely preventing the compiler from doing any sort of type checking. -- Erik Slagter Defining functions with unspecified arguments is allowed but bad. With arguments unspecified the compiler can't report an error/warning if the function is called with incorrect arguments. -- M���\ns Rullg���\rd

lidbha - Direct Hardware Access library
=======================================

This library was designed for providing direct hardware access under different
OS'es and architectures, so it's platform- and os-independent.

The main project on the top of libdha is Vidix. It provides userspace
video drivers for Matrox, Ati, 3Dlabs, Trident (and it's still evolving).

For the full list of supported OS'es read the sources, anyway here's a 'reported
as working' list (these platforms are used daily):
 Linux/x86
 FreeBSD/x86
 NetBSD/x86
 Linux/PPC

There are different ways to access the hardware, normally only ROOT can do that.
With root privileges libdha will run fine, but there are some others ways
to use it as a normal user:
1, set the SUID bit on the binary (in this way it runs with root privileges)
2, use svgalib kernel helper
3, use dhahelper (not yet finished)

The library is based on XFree86 and gfxdump (a utility from the GATOS project)
sources.

Original import and design by Nick Kurshev and Alex Beregszaszi.
Current maintenance and dhahelper by Alex Beregszaszi.
Svgalib kernelhelper support by Matan Ziv-Av.
(for the e-mail addresses see the AUTHORS file in MPlayer)