Man Linux: Main Page and Category List

NAME

       comedi_do_insnlist - perform multiple instructions

SYNOPSIS

       #include <comedilib.h>

       int comedi_do_insnlist (comedi_t * device, comedi_insnlist * list);

DESCRIPTION

       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.

       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.

       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.

RETURN VALUE

       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.

                                28 October 2007