pub/scm/libs/ieee1394/libraw1394.git  about / heads / tags
libraw1394 - user space library to Linux FireWire
$ git log --pretty=format:'%h %s (%cs)%d'
410e6dc configure.ac, Changelog, NEWS: update to version 2.1.2 (2016-04-03)
	(HEAD -> master, tag: v2.1.2, testing)
0ef8fab testlibraw: build the CLOCK_MONOTONIC_RAW test conditionally (2016-03-20)
6373598 Use <stdint.h> types instead of non-standard types (2016-03-20)
a8b9a1b configure.ac, Changelog, NEWS: update to version 2.1.1 (2015-04-28)
	(tag: v2.1.1)
042ddc6 Align fw_handle buffer for 64-bit access (2015-04-28)
c756fb8 Prevent requests for previously provided iso tx packets (2015-04-28)
242ed44 Fix memory leak in response handler (2015-04-28)
d80678d Save and restore errno in raw1394_new_handle{,_on_port} for legacy applications (2013-08-24)
ba8d211 tools: Fix startup of dumpiso and sendiso on juju (2013-08-24)
77dd78e Documentation improvement: return code of raw1394_read_cycle_timer{,_and_clock} (2012-07-31)
...

$ git cat-file blob HEAD: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 dependency 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).

	Since version 2, libraw1394 also works with the kernel driver
firewire-core.  libraw1394's role has thus become that of a raw1394
compatibility layer for existing applications when running on firewire-core.


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.


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. Pkg-config

	The library comes with a pkg-config .pc file, so you can check for
libraw1394 and its version in your configure script.  For example, here is how 
to use the autoconf macro:

PKG_CHECK_MODULES(LIBRAW1394, libraw1394 >= 1.1.0)

	This macro sets the variables LIBRAW1394_CFLAGS and LIBRAW1394_LIBS.  You 
have to include those into your build variables so that the build process 
correctly links with libraw1394.


6. Contact

	Send questions, suggestions, bug reports and patches to the mailing
list linux1394-devel@lists.sourceforge.net.  This list is open for posting
without prior subscription, and replies will usually be Cc'd to you.  Visit
http://ieee1394.wiki.kernel.org/ for links to list subscription interfaces and
list archives.

	Maintainer of libraw1394 is currently Stefan Richter.  See the file
AUTHORS for a complete list of contributors to libraw1394.

	Source repository:
git://git.kernel.org/pub/scm/libs/ieee1394/libraw1394.git
http://git.kernel.org/pub/scm/libs/ieee1394/libraw1394.git
https://git.kernel.org/pub/scm/libs/ieee1394/libraw1394.git

	Gitweb:
http://git.kernel.org/?p=libs/ieee1394/libraw1394.git

	Release tarballs:
https://www.kernel.org/pub/linux/libs/ieee1394/
ftp://ftp.kernel.org/pub/linux/libs/ieee1394/

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
* master       configure.ac, Changelog, NEWS: update to version 2.1.2 (2016-04-03)
  testing      configure.ac, Changelog, NEWS: update to version 2.1.2 (2016-04-03)

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
v2.1.2       libraw1394 v2.1.2 release (2016-04-03) tar.gz
v2.1.1       libraw1394 v2.1.1 release (2015-04-28) tar.gz
v2.1.0       libraw1394 v2.1.0 release (2012-07-29) tar.gz
v2.0.9       libraw1394 v2.0.9 release (2012-06-02) tar.gz
v2.0.8       Tag v2.0.8 release. (2012-02-19) tar.gz
v2.0.7       Tag v2.0.7 release. (2011-03-08) tar.gz
v2.0.6       Tag v2.0.6 release. (2010-11-01) tar.gz
v2.0.5       Tag v2.0.5 release. (2010-01-08) tar.gz
v2.0.4       Tag v2.0.4 release. (2010-01-08) tar.gz
v2.0.3       Tag v2.0.3 release. (2009-06-29) tar.gz
...

# associated public inboxes:
# (number on the left is used for dev purposes)
         12 lkml
          5 linux-arm-kernel
          4 linux-bluetooth
          3 linux-samsung-soc
          3 linux-mtd
          3 qemu-devel
          3 linux-fsdevel
          3 linux-mm
          3 netdev
          3 linux-media
          3 xen-devel
          3 stable
          3 alsa-devel
          3 dpdk-dev
          3 linuxppc-dev
          3 kvm
          3 dri-devel
          3 intel-gfx
          3 linux-api
          3 virtualization
          3 linux-arch
          3 linux-can
          3 u-boot
          3 ltp
          2 linux-wireless
          2 linux-riscv
          2 linux-nvme
          2 linux-xfs
          2 bpf
          2 linux-nfs
          2 linux-mediatek
          2 linux-crypto
          2 linux-acpi
          2 netfilter-devel
          2 linux-cifs
          2 linux-devicetree
          2 linux-amlogic
          2 linux-erofs
          2 linux-iommu
          2 linux-mips
          2 fstests
          2 linux-pm
          2 linux-rtc
          2 linux-input
          2 linux-scsi
          2 linux-btrfs
          2 kvmarm
          2 driverdev-devel
          2 linux-usb
          2 linux-kselftest
          2 selinux
          2 linux-clk
          2 linux-iio
          2 linux-gpio
          2 linux-rdma
          2 linux-ext4
          2 linux-security-module
          2 linux-pci
          2 linux-f2fs-devel
          2 linux-modules
          2 linux-rt-users
          2 linux-ide
          2 linux-serial
          2 linux-watchdog
          2 linux-trace-devel
          2 util-linux
          2 backports
          2 linux-doc
          2 git
          2 linux-man
          2 linux-mmc
          2 amd-gfx
          2 linux-omap
          2 linux-spi
          2 linux-i2c
          2 linux-sparse
          2 linux-tegra
          2 lttng-dev
          2 linux-kbuild
          2 containers
          2 linux-rockchip
          2 linux-raid
          2 openbmc
          2 dm-devel
          2 linux-fbdev
          2 linux-cxl
          2 linux-perf-users
          2 linux-sh
          2 nouveau
          2 linux-s390
          2 linux-coco
          2 buildroot
          2 iwd
          2 yocto
          2 yocto-meta-freescale
          2 openembedded-core
          2 yocto-toaster
          2 yocto-meta-arm
          2 openembedded-devel
          2 bitbake-devel
          2 yocto-meta-virtualization
          2 yocto-meta-ti
          2 yocto-meta-arago
          2 outreachy
          2 openrisc
          2 intel-wired-lan
          2 kexec
          2 intel-xe
          2 linux-um
          2 virtio-comment
          2 poky
          2 qemu-riscv
          2 cluster-devel
          2 grub-devel
          2 kvm-ppc
          2 linux-hexagon
          2 linux-hotplug
          2 reiserfs-devel
          2 lvm-devel
          2 virtio-fs
          2 ../../../../../fuego
          2 ../../../../../igt-dev
          1 linux-fscrypt
          1 cocci
          1 linux-block
          1 live-patching
          1 linux-efi
          1 linux-integrity
          1 linux-edac
          1 linux-arm-msm
          1 linux-nvdimm
          1 linux-snps-arc
          1 linux-hwmon
          1 linux-renesas-soc
          1 kernel-hardening
          1 dmaengine
          1 linux-next
          1 linux-parisc
          1 linux-leds
          1 kernelnewbies
          1 linux-sgx
          1 linux-hyperv
          1 workflows
          1 rcu
          1 selinux-refpolicy
          1 linux-m68k
          1 linux-i3c
          1 linux-spdx
          1 linux-wpan
          1 ksummit-discuss
          1 wireguard
          1 io-uring
          1 linux-kernel-mentees
          1 linux-csky
          1 tpmdd-devel
          1 linux-unionfs
          1 linux-firmware
          1 cip-dev
          1 linux-audit
          1 linux-remoteproc
          1 linux-dash
          1 linux-bcache
          1 mm-commits
          1 linux-pwm
          1 linux-fpga
          1 ceph-devel
          1 xdp-newbies
          1 platform-driver-x86
          1 phone-devel
          1 linux-hardening
          1 dash
          1 keyrings
          1 linux-sctp
          1 target-devel
          1 lustre-devel
          1 soc
          1 ocfs2-devel
          1 rust-for-linux
          1 ath10k
          1 ath11k
          1 linux-phy
          1 kernel-janitors
          1 sparclinux
          1 linux-staging
          1 linux-sunxi
          1 mptcp
          1 regressions
          1 ksummit
          1 b43-dev
          1 nvdimm
          1 linux-nfc
          1 linux-bcachefs
          1 ath9k-devel
          1 ntfs3
          1 llvm
          1 fio
          1 ell
          1 ofono
          1 yocto-docs
          1 linux-patches
          1 chrome-platform
          1 ntb
          1 xenomai
          1 damon
          1 asahi
          1 loongarch
          1 imx
          1 ath12k
          1 b4-sent
          1 linux-trace-kernel
          1 oe-linux-nfc
          1 oe-kbuild-all
          1 oe-chipsec
          1 batman
          1 virtio-dev
          1 v9fs
          1 ecryptfs
          1 linux-ia64
          1 kbd
          1 autofs
          1 cpufreq
          1 dccp
          1 cgroups
          1 devicetree-spec
          1 devicetree-compiler
          1 initramfs
          1 hail-devel
          1 kvm-ia64
          1 linux-8086
          1 kernel-testers
          1 linux-alpha
          1 linux-btrace
          1 linux-embedded
          1 linux-hams
          1 linux-laptop
          1 linux-sound
          1 trinity
          1 linux-metag
          1 linux-x25
          1 linux-nilfs
          1 lvs-devel
          1 netfilter
          1 linux-oxnas
          1 u-boot-amlogic
          1 lm-sensors
          1 acpica-devel
          1 perfbook
          1 smatch
          1 ../../../../../wireless-regdb
          1 ../../../../../powertop

git clone https://80x24.org/lore/pub/scm/libs/ieee1394/libraw1394.git