svn commit: r202962 - head/share/man/man4

[Joerg Wunsch]

Author: joerg
Date: Mon Jan 25 06:37:44 2010
New Revision: 202962
URL: http://svn.freebsd.org/changeset/base/202962

Log:
  Add an example, derived from the basic demo phk once sent me.

Modified:
  head/share/man/man4/gpib.4

Modified: head/share/man/man4/gpib.4
==============================================================================
--- head/share/man/man4/gpib.4	Mon Jan 25 06:18:31 2010	(r202961)
+++ head/share/man/man4/gpib.4	Mon Jan 25 06:37:44 2010	(r202962)
@@ -44,6 +44,39 @@ IEC-625 (or just "IEC bus"), or HP-IB (H
 Bus), or GPIB (General Purpose Instrument Bus).
 The device can become either a listener, talker, controller, and
 in particular a master controller on the bus.
+.Ss Example
+The following example code queries the device provided as
+.Va argv[1]
+for its identification response.
+.Bd -literal
+/* compile with:  cc -O -o ibtest ibtest.c -lgpib */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <err.h>
+#include <vis.h>
+
+#include <gpib/gpib.h>
+
+int
+main(int argc, char **argv)
+{
+	int dmm;
+        unsigned char buf[100];
+        char vbuf[sizeof buf * 4];
+
+        /* DVM */
+        dmm = ibdev(0, (argc > 1? atoi(argv[1]): 7), 0,
+		    T10s, 1, 0);
+        if (dmm < 0)
+                errx(1, "ibdev = %d\\n", dmm);
+        ibwrt(dmm, "*IDN?\\r\\n", 7);
+        ibrd(dmm, buf, sizeof buf - 1);
+        strvisx(vbuf, buf, ibcnt, VIS_WHITE | VIS_CSTYLE);
+        printf("%s\\n", vbuf);
+        return (0);
+}
+.Ed
 .Sh FILES
 .Bl -tag -width /dev/gpibNNib
 .It Pa /dev/gpib Ns Em N Ns "ib"