rtf_destroy(3)

rtf_destroy3

Remove a real-time fifo created with rtf_create(3)

Usage

#include <rtl_fifo.h>

int rtf_destroy(unsigned int fifo);

Overview

rtf_destroy removes a real-time fifo (RT-FIFO) previously created with rtf_create(3). fifo is then available for reuse by another call to rtf_create(3).

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, -1 is returned, and errno is set as described below.

Errors

-ENODEV

fifo is greater than or equal to RTF_NO.

-EINVAL

fifo is not a valid RT-FIFO identifier.

Notes

This function can only be called in the Linux kernel mode.

From rtlinux 2.0rel-1 in Debian 2.2 (Potato). Parsed by carta from the page's man source.