<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>comedi_do_insnlist</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE=" Comedi
"
HREF="index.html"><LINK
REL="UP"
TITLE=" Comedi Function Reference
"
HREF="x4629.html#FUNCTIONREFERENCE"><LINK
REL="PREVIOUS"
TITLE="comedi_trigger"
HREF="r5503.html"><LINK
REL="NEXT"
TITLE="comedi_do_insn"
HREF="r5553.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Comedi: The <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Control and Measurement Device Interface</I
></SPAN
>
handbook
</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="r5503.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="r5553.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="FUNC-REF-COMEDI-DO-INSNLIST"
></A
>comedi_do_insnlist</H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN5531"
></A
><H2
>Name</H2
>comedi_do_insnlist -- perform multiple instructions</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN5534"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><P
></P
><A
NAME="AEN5535"
></A
><PRE
CLASS="FUNCSYNOPSISINFO"
>#include <comedilib.h></PRE
><P
><CODE
><CODE
CLASS="FUNCDEF"
>int comedi_do_insnlist</CODE
>(comedi_t * device, comedi_insnlist * list);</CODE
></P
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN5544"
></A
><H2
> Description
</H2
><P
>The function comedi_do_insnlist() performs multiple Comedi
instructions as part of one system call. In addition, Comedi
attempts to perform the instructions atomically, that is, on
standard Linux kernels, no process preemption should occur
during the instructions. However, the process may be preempted
before or after the group of instructions.</P
><P
>This function can be used to avoid the overhead of multiple
system calls, or to ensure that multiple instructions occur
without significant delay between them.</P
><P
>Preemption may occur if any of the instructions or the data
arrays of any of the instructions exist in non-resident or
copy-on-write pages.
</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN5549"
></A
><H2
> Return value
</H2
><P
>The function comedi_do_insnlist() returns the number of
sucessfully completed instructions. Error information for
the unsucessful instruction is not available. If there is
an error before the first instruction can be executed, -1
is returned.</P
><P
> </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="r5503.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="r5553.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>comedi_trigger</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="x4629.html#FUNCTIONREFERENCE"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>comedi_do_insn</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
