libraw1394 fork
This repository has been archived on 2022-09-20. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
bencollins c412fe45d2 Update for new version, 0.10.1.
git-svn-id: svn://svn.linux1394.org/libraw1394/trunk@133 53a565d1-3bb7-0310-b661-cf11e63c67ab
2003-09-26 13:55:47 +00:00
debian Update for new version, 0.10.1. 2003-09-26 13:55:47 +00:00
doc added Dan Maas' rawiso docs 2003-04-21 17:01:41 +00:00
src Fixup async_stream to use same local req variable for reentrancy. 2003-09-26 13:51:31 +00:00
tools Fix compiler warnings. 2003-07-13 00:49:54 +00:00
AUTHORS Updates from 0.10.0 release. 2003-07-13 00:26:14 +00:00
COPYING.LIB Ensure this ends up in distributions. 2000-03-12 04:08:48 +00:00
INSTALL Initial revision 1999-12-02 23:07:38 +00:00
Makefile.am pkg-config support from Kristian Hogsberg. 2003-07-17 17:28:56 +00:00
NEWS Updates from 0.10.0 release. 2003-07-13 00:26:14 +00:00
README Handle generation number is not automatically advanced with bus reset. 2001-05-14 01:05:58 +00:00
autogen.sh Ooops...libtool works a bit different than I thought, but atleast it works 2003-07-13 01:27:13 +00:00
configure.ac Increase so maj/age so account for new recv-flush call. 2003-07-22 15:02:12 +00:00
libraw1394.m4 Fix macros so that they actually work. 2001-05-14 00:57:05 +00:00
libraw1394.pc.in pkg-config support from Kristian Hogsberg. 2003-07-17 17:28:56 +00:00

README

				   libraw1394
				   ==========

1. About libraw1394

	libraw1394 is the only supported interface to the kernel side raw1394 of
the Linux IEEE-1394 subsystem, which provides direct access to the connected
1394 buses to user space.  Through libraw1394/raw1394, applications can directly
send to and receive from other nodes without requiring a kernel driver for the
protocol in question.

	The reason for making a library the interface to the kernel is to avoid
a program dependancy on the kernel version, which would hinder development and
optimization of raw1394.  If development changed the protocol and made it
incompatible with previous versions only the libraw1394 has to be upgraded to
match the kernel version (instead of all applications).


2. Copyleft

	libraw1394 itself is licensed under the Lesser General Public License
(short LGPL, see file COPYING.LIB in the source distribution).  Other files in
the source archives not belonging to but being part of the build procedure of
libraw1394 are under their own licenses, as stated at the top of the individual
files.


3. API documentation

	Finally there is something, in the doc subdirectory.  The file is
libraw1394.sgml (it's Docbook format), and there are preformatted PostScript and
HTML available.  This documentation is not complete yet!  I hopefully will have
a libraw1394 0.9.1 out soon with finished documentation.


4. Multithreading

	This library should be multithreadable with the restriction that one
raw1394handle_t may be used only within a single thread.  Multiple threads
operating on the same handle would royally mess up the kernel-user protocol.
Simply use separate handles for each thread in which you need to use libraw1394.


5. Autoconf macro

	Along with the library an autoconf macro gets installed (in
$prefix/share/aclocal).  It is called the following way:

AC_LIB_RAW1394(MINIMUMVERSION[,ACTION_IF_FOUND[,ACTION_IF_NOT_FOUND]])

	Versions prior to 0.9 can not be checked and appear as "not found".
This macro sets the variables LIBRAW1394_CPPFLAGS, LIBRAW1394_CFLAGS and
LIBRAW1394_LIBS.  You have to include those into your build variables so that
the build process correctly links with libraw1394.


6. Maintainer

	Maintainer of libraw1394 is currently Andreas Bombe.  Send suggestions,
bug reports and fixes to andreas.bombe@munich.netsurf.de.  See the file AUTHORS
for a complete list of contributors to libraw1394.

	You can get updates through this project's homepage on SourceForge, see
http://sourceforge.net/project/?group_id=2514 for more information.  You can
also submit bugs through this page.


2001-05-14  Andreas Bombe