Add raw1394_get_local_id, _irm_id, _nodecount refentry.

git-svn-id: svn://svn.linux1394.org/libraw1394/trunk@73 53a565d1-3bb7-0310-b661-cf11e63c67ab

debian/changelog

@@ -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
 
   * Fix postinst of shared library package so that it does not fail over

debian/control

@@ -2,8 +2,8 @@ Source: libraw1394
 Section: libs
 Priority: optional
 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
 Architecture: any
@@ -23,7 +23,7 @@ Description: library for direct access to IEEE 1394 bus - development files
 Package: libraw1394-5
 Architecture: any
 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)
  libraw1394 is the only supported interface to the kernel side raw1394
  of the Linux IEEE-1394 subsystem, which provides direct access to the

debian/libraw1394-potato.postinst.in

@@ -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#

debian/libraw1394.postinst.in

@@ -1,44 +1,16 @@
 #!/bin/sh -e
 
+. /usr/share/debconf/confmodule
+db_version 2.0
+
 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.
+    fi
-
-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
 
-
 #DEBHELPER#

debian/rules

@@ -1,37 +1,34 @@
 #!/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)
 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)
-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-stamp:
 	dh_testdir
 
-	./configure --prefix=/usr --mandir=\$${prefix}/share/man --infodir=\$${prefix}/share/info
+	./configure --prefix=/usr --mandir=\$${prefix}/share/man
 	$(MAKE)
 
 	touch build-stamp
 
-clean: autoclean-files
+clean:
 	dh_testdir
 	dh_testroot
-	rm -f build-stamp
+	rm -f build-stamp $(somaint:%=debian/$(libraw).%)
 
 	-$(MAKE) distclean
 
 	dh_clean
-	xargs <autoclean-files rm -f
 
 install: build
 	dh_testdir
@@ -44,38 +41,34 @@ install: build
 binary-indep: build install
 # Nothing to do here
 
-binary-arch: build install autoclean-files
+binary-arch: build install
 	dh_testdir
 	dh_testroot
 
+	for i in $(somaint); do					\
+		ln -sf libraw1394.$$i.in debian/$(libraw).$$i;	\
+	done
+
 	dh_movefiles -p$(libraw)		\
 		usr/lib/$(majorname)		\
 		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_installchangelogs
+	dh_installdebconf
 	dh_strip
 	dh_compress
 	dh_fixperms
 	dh_makeshlibs -V
 	dh_installdeb
-	dh_shlibdeps -ldebian/$(libraw)/usr/lib
+	LD_PRELOAD='' dh_shlibdeps -v -ldebian/$(libraw)/usr/lib
 	dh_gencontrol
 	dh_md5sums
 	dh_builddeb

doc/libraw1394.sgml

@@ -893,6 +893,73 @@ struct <structname>raw1394_portinfo</structname> {
 	</para>
       </refsect1>
     </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>
 
 </book>