man rtf_destroy () - remove a realtime fifo created with rtf_create(3)

NAME

rtf_destroy - remove a realtime fifo created with rtf_create(3)

SYNOPSIS

#include <asm/rtl_fifo.h> 
 
int rtf_destroy(unsigned int fifo); 

DESCRIPTION

rtf_destroy removes a realtime fifo (RT-FIFO) previously created with rtf_create(3). fifo is then available for re-use by another call to rtf_create(3). All handlers for the FIFO are uninstalled.

The RT-FIFO is a mechanism, implemented as a character device, to communicate between realtime tasks and ordinary Linux processes. The rtf_* functions are used by the realtime tasks; Linux processes use standard character device accesed by functions such as read(3), write(3) and select(3).

RETURN VALUE

On success, count is returned. On failure, a negative value is returned 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 should only be used in the Linux cleanup_module() context or in user space via PSC library (please see below).

rtf_create is a system call made available by PSC, the user-level real-time signal library. It can be called from user space, but not from PSC handlers.

SEE ALSO

rtf_create(3) (link to URL rtf_create.3.html) , rtf_create_handler(3) (link to URL rtf_create_handler.3.html) , rtf_get(3) (link to URL rtf_get.3.html) , rtf_put(3) (link to URL rtf_put.3.html)

©1997 Jerry Epplin.

Modifications for RTLinux 2.x and 3.x by Michael Barabanov. ©2001 FSMLabs Inc.

All rights reserved.