/**
* @fn int rt_pipe_delete(RT_PIPE *pipe)
* @brief Delete a message pipe.
*
* This routine deletes a pipe object previously created by a call to
* rt_pipe_create(). All resources attached to that pipe are
* automatically released, all pending data is flushed.
*
* @param pipe The pipe descriptor.
*
* @return Zero is returned upon success. Otherwise:
*
* - -EINVAL is returned if @a pipe is not a valid pipe descriptor.
*
* - -EIDRM is returned if @a pipe is a closed pipe descriptor.
*
* - -EPERM is returned if this service was called from an
* asynchronous context.
*
* @apitags{thread-unrestricted, switch-secondary}
*/
int rt_pipe_delete(RT_PIPE *pipe)
{
struct alchemy_pipe *pcb;
struct service svc;
int ret = 0;
if (threadobj_irq_p())
return -EPERM;
CANCEL_DEFER(svc);
pcb = find_alchemy_pipe(pipe, &ret);
if (pcb == NULL)
goto out;
ret = __RT(close(pcb->sock));
if (ret) {
ret = -errno;
if (ret == -EBADF)
ret = -EIDRM;
goto out;
}
syncluster_delobj(&alchemy_pipe_table, &pcb->cobj);
pcb->magic = ~pipe_magic;
out:
CANCEL_RESTORE(svc);
return ret;
}
/**
* @fn int rt_buffer_delete(RT_BUFFER *bf)
* @brief Delete an IPC buffer.
*
* This routine deletes a buffer object previously created by a call
* to rt_buffer_create().
*
* @param bf The descriptor address of the deleted buffer.
*
* @return Zero is returned upon success. Otherwise:
*
* - -EINVAL is returned if @a bf is not a valid buffer descriptor.
*
* - -EPERM is returned if this service was called from an
* asynchronous context.
*
* Valid calling context:
*
* - Regular POSIX threads
* - Xenomai threads
*/
int rt_buffer_delete(RT_BUFFER *bf)
{
struct alchemy_buffer *bcb;
struct syncstate syns;
struct service svc;
int ret = 0;
if (threadobj_irq_p())
return -EPERM;
CANCEL_DEFER(svc);
bcb = get_alchemy_buffer(bf, &syns, &ret);
if (bcb == NULL)
goto out;
syncluster_delobj(&alchemy_buffer_table, &bcb->cobj);
bcb->magic = ~buffer_magic;
syncobj_destroy(&bcb->sobj, &syns);
out:
CANCEL_RESTORE(svc);
return ret;
}
