Add raw1394_get_local_id, _irm_id, _nodecount refentry.

git-svn-id: svn://svn.linux1394.org/libraw1394/trunk@73 53a565d1-3bb7-0310-b661-cf11e63c67ab
This commit is contained in:
aeb 2001-08-01 12:30:48 +00:00
parent 17167ea970
commit 4c165f62db
6 changed files with 107 additions and 114 deletions

7
debian/changelog vendored
View File

@ -1,3 +1,10 @@
libraw1394 (0.9.0-3) unstable; urgency=low
* Move to debhelper V3.
* Add debconf support.
-- Andreas Bombe <aeb@debian.org> Thu, 28 Jun 2001 14:01:37 +0200
libraw1394 (0.9.0-2) unstable; urgency=low libraw1394 (0.9.0-2) unstable; urgency=low
* Fix postinst of shared library package so that it does not fail over * Fix postinst of shared library package so that it does not fail over

6
debian/control vendored
View File

@ -2,8 +2,8 @@ Source: libraw1394
Section: libs Section: libs
Priority: optional Priority: optional
Maintainer: Andreas Bombe <aeb@debian.org> Maintainer: Andreas Bombe <aeb@debian.org>
Standards-Version: 3.5.4.0 Standards-Version: 3.5.6.0
Build-Depends: debhelper Build-Depends: debhelper (>= 3.0.0)
Package: libraw1394-dev Package: libraw1394-dev
Architecture: any Architecture: any
@ -23,7 +23,7 @@ Description: library for direct access to IEEE 1394 bus - development files
Package: libraw1394-5 Package: libraw1394-5
Architecture: any Architecture: any
Section: libs Section: libs
Depends: ${shlibs:Depends}${makedev-depend} Depends: debconf, makedev (>= 2.3.1-49), ${shlibs:Depends}
Description: library for direct access to IEEE 1394 bus (aka FireWire) Description: library for direct access to IEEE 1394 bus (aka FireWire)
libraw1394 is the only supported interface to the kernel side raw1394 libraw1394 is the only supported interface to the kernel side raw1394
of the Linux IEEE-1394 subsystem, which provides direct access to the of the Linux IEEE-1394 subsystem, which provides direct access to the

View File

@ -1,46 +0,0 @@
#!/bin/sh -e
if [ "$1" = "configure" ]; then
ldconfig
if [ ! -c /dev/raw1394 ]; then
cat <<EOF
Required /dev/raw1394 device file not found. Without it, libraw1394
is quite useless as it can not talk to the kernel driver.
EOF
read -p "Should I create it for you? [Y/n] " REPLY || REPLY=no
case "$REPLY" in
y|yes|"")
mknod -m600 /dev/raw1394 c 171 0
chown root.root /dev/raw1394
cat <<EOF
/dev/raw1394 created.
It is owned by root with read/write permissions for root. You may
want to fix the group/permission to something appropriate for you.
Note however that anyone who can open raw1394 can access all devices
on all connected 1394 buses unrestricted, including harddisks and
other probably sensitive devices.
EOF
;;
*)
cat <<EOF
/dev/raw1394 not created. You can create it at a later time using
/dev/MAKEDEV if you have a version that already knows raw1394 or you
can create it manually with the command:
mknod -m600 /dev/raw1394 c 171 0
EOF
;;
esac
fi
fi
#DEBHELPER#

View File

@ -1,44 +1,16 @@
#!/bin/sh -e #!/bin/sh -e
. /usr/share/debconf/confmodule
db_version 2.0
if [ "$1" = "configure" ]; then if [ "$1" = "configure" ]; then
ldconfig db_get libraw1394/dev/create_node
if [ ! -c /dev/raw1394 ]; then if [ "$RET" = "true" ]; then
cat <<EOF echo -n "Creating device node /dev/raw1394... "
cd /dev && ./MAKEDEV raw1394
Required /dev/raw1394 device file not found. Without it, libraw1394 echo "done."
is quite useless as it can not talk to the kernel driver.
EOF
read -p "Should I create it for you? [Y/n] " REPLY || REPLY=no
case "$REPLY" in
y|yes|"")
if (cd /dev && ./MAKEDEV raw1394); then
cat <<EOF
Device file created. You may want to fix the group/permission to
something appropriate for you. Note however that anyone who can open
raw1394 can access all devices on all connected 1394 buses
unrestricted, including harddisks and other probably sensitive
devices.
EOF
fi
;;
*)
cat <<EOF
/dev/raw1394 not created. You can create it at a later time manually
with the commands:
cd /dev; ./MAKEDEV raw1394
EOF
;;
esac
fi fi
fi fi
#DEBHELPER# #DEBHELPER#

49
debian/rules vendored
View File

@ -1,37 +1,34 @@
#!/usr/bin/make -f #!/usr/bin/make -f
export DH_COMPAT=1 export DH_COMPAT=3
potato-build = no
majorname = $(shell grep library_names src/libraw1394.la | cut -d"'" -f 2 | cut -d" " -f 2) majorname = $(shell grep library_names src/libraw1394.la | cut -d"'" -f 2 | cut -d" " -f 2)
fullversionname = $(shell grep library_names src/libraw1394.la | cut -d"'" -f 2 | cut -d" " -f 1) fullversionname = $(shell grep library_names src/libraw1394.la | cut -d"'" -f 2 | cut -d" " -f 1)
major = $(shell echo $(majorname) | cut -d"." -f 3)
major = 5
libraw = libraw1394-$(major) libraw = libraw1394-$(major)
source-version = $(shell dpkg-parsechangelog | grep ^Version | cut -d" " -f 2)
autoclean-files: # maintainer files for the so package (of the name $(libraw))
echo $@ >$@ somaint = postinst config templates
build: build-stamp build: build-stamp
build-stamp: build-stamp:
dh_testdir dh_testdir
./configure --prefix=/usr --mandir=\$${prefix}/share/man --infodir=\$${prefix}/share/info ./configure --prefix=/usr --mandir=\$${prefix}/share/man
$(MAKE) $(MAKE)
touch build-stamp touch build-stamp
clean: autoclean-files clean:
dh_testdir dh_testdir
dh_testroot dh_testroot
rm -f build-stamp rm -f build-stamp $(somaint:%=debian/$(libraw).%)
-$(MAKE) distclean -$(MAKE) distclean
dh_clean dh_clean
xargs <autoclean-files rm -f
install: build install: build
dh_testdir dh_testdir
@ -44,38 +41,34 @@ install: build
binary-indep: build install binary-indep: build install
# Nothing to do here # Nothing to do here
binary-arch: build install autoclean-files binary-arch: build install
dh_testdir dh_testdir
dh_testroot dh_testroot
for i in $(somaint); do \
ln -sf libraw1394.$$i.in debian/$(libraw).$$i; \
done
dh_movefiles -p$(libraw) \ dh_movefiles -p$(libraw) \
usr/lib/$(majorname) \ usr/lib/$(majorname) \
usr/lib/$(fullversionname) usr/lib/$(fullversionname)
echo >>autoclean-files \ dh_movefiles -plibraw1394-dev \
debian/$(libraw).postinst \ usr/lib \
debian/$(libraw).substvars usr/bin \
usr/include/libraw1394 \
usr/share/aclocal/libraw1394.m4
if [ "$(potato-build)" = "yes" ]; then \ dh_installman
cp debian/libraw1394-potato.postinst.in \
debian/$(libraw).postinst; \
echo "makedev-depend=" >>debian/$(libraw).substvars; \
else \
cp debian/libraw1394.postinst.in \
debian/$(libraw).postinst; \
echo "makedev-depend=, makedev (>= 2.3.1-49)" \
>>debian/$(libraw).substvars; \
fi
dh_installmanpages -plibraw1394-dev
dh_installdocs dh_installdocs
dh_installchangelogs dh_installchangelogs
dh_installdebconf
dh_strip dh_strip
dh_compress dh_compress
dh_fixperms dh_fixperms
dh_makeshlibs -V dh_makeshlibs -V
dh_installdeb dh_installdeb
dh_shlibdeps -ldebian/$(libraw)/usr/lib LD_PRELOAD='' dh_shlibdeps -v -ldebian/$(libraw)/usr/lib
dh_gencontrol dh_gencontrol
dh_md5sums dh_md5sums
dh_builddeb dh_builddeb

View File

@ -893,6 +893,73 @@ struct <structname>raw1394_portinfo</structname> {
</para> </para>
</refsect1> </refsect1>
</refentry> </refentry>
<refentry>
<refmeta>
<refentrytitle>raw1394_get_(local_id|irm_id|nodecount)</refentrytitle>
<manvolnum>3</manvolnum>
</refmeta>
<refnamediv>
<refname>raw1394_get_local_id</refname>
<refname>raw1394_get_irm_id</refname>
<refname>raw1394_get_nodecount</refname>
<refpurpose>return basic information about the bus</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcprototype>
<funcdef>nodeid_t <function>raw1394_get_local_id</function></funcdef>
<paramdef>raw1394handle_t <parameter>handle</parameter></paramdef>
</funcprototype>
<funcprototype>
<funcdef>nodeid_t <function>raw1394_get_irm_id</function></funcdef>
<paramdef>raw1394handle_t <parameter>handle</parameter></paramdef>
</funcprototype>
<funcprototype>
<funcdef>int <function>raw1394_get_nodecount</function></funcdef>
<paramdef>raw1394handle_t <parameter>handle</parameter></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Arguments</title>
<variablelist>
<varlistentry>
<term><parameter>handle</parameter></term>
<listitem>
<para>handle associated with a 1394 bus</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>Description</title>
<para>
These functions return information about the 1394 bus the handle is
associated with. The values that can be queried through these
functions can change with every bus reset.
</para>
</refsect1>
<refsect1>
<title>Return Value</title>
<para>
<function>raw1394_get_local_id()</function> returns the node ID of the
local node (i.e. the hardware the driver is controlling directly).
<function>raw1394_get_irm_id()</function> returns the node ID of the
node that has become isochronous resource manager.
<function>raw1394_get_nodecount</function> returns the number of nodes
currently on the bus (including the local node).
</para>
</refsect1>
</refentry>
</chapter> </chapter>
</book> </book>