NAME

       rtf_create_handler  - install a handler for real-time fifo
       data


SYNOPSIS

       #include <rtl_fifo.h>

       int rtf_create_handler(unsigned  int  fifo,  int  (*  han­
       dler)(unsigned int fifo));


DESCRIPTION

       rtf_create_handler  installs  a  handler which is executed
       when data is written to or read from a real-time fifo (RT-
       FIFO).   fifo is an RT-FIFO that must have previously been
       created with a call to rtf_create_fifo.  handler  is  then
       called whenever a Linux process accesses that fifo.

       rtf_create_handler  is  often  used  in  conjunction  with
       rtf_get to process data  acquired  asynchronously  from  a
       Linux  process.   The installed handler calls rtf_get when
       data is present.  Because the  handler  is  only  executed
       when  there is activity on the fifo, polling is not neces­
       sary.

       The RT-FIFO is a mechanism,  implemented  as  a  character
       device,  to  communicate between real-time tasks and ordi­
       nary Linux processes.  The rtf_* functions are used by the
       real-time  tasks;  Linux  processes use standard character
       device access functions such  as  read(2),  write(2),  and
       select(2).


RETURN VALUE

       On  success,  0 is returned.  On failure, a negative value
       is returned as described below.


ERRORS

       -EINVAL
              fifo is greater than or equal to RTF_NO, or is  not
              a valid RT-FIFO identifier; or handler is NULL.


SEE ALSO

       rtf_create(3), rtf_destroy(3), rtf_get(3), rtf_put(3)













Man(1) output converted with man2html