rtf_create(2)

NAME

rtf_create - create a real-time fifo

SYNOPSIS

#define MODULE
#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/version.h>
#include <linux/errno.h>
#include <linux/rtf.h>

int rtf_create(unsigned int fifo, int size);

DESCRIPTION

rtf_create creates a real-time fifo (RT-FIFO) of size size and assigns it the identifier fifo. fifo is a value unique within the system, and must be less than RTF_NO.

The RT-FIFO is a mechanism, implemented as a character device, to communicate between real-time tasks and ordinary 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

-ENODEV

fifo is greater than or equal to RTF_NO.

-EBUSY

fifo is already in use. Choose a different ID.

-ENOMEM

size bytes could not be allocated for the RT-FIFO.

SEE ALSO

rtf_create_handler(2), rtf_destroy(2), rtf_get(2), rtf_put(2), rtf_resize(2),

AUTHOR

This manual page was written by Jerry Epplin.

Copyright (C) 1997 Jerry Epplin, placed under the GNU General Public License, see the file copyright for details.