remove(3C)                     DG/UX R4.11MU05                    remove(3C)


NAME
       remove - remove file

SYNOPSIS
       #include <stdio.h>
       int remove(const char *path);

DESCRIPTION
       remove causes the file or empty directory whose name is the string
       pointed to by path to be no longer accessible by that name.  A
       subsequent attempt to open that file using that name will fail,
       unless the file is created anew.  If a file is removed while one or
       more processes have the file open, the removal is postponed until all
       references to the file are closed.

       For files, remove is identical to unlink. For directories, remove is
       identical to rmdir.

       See rmdir(2) and unlink(2) for a detailed list of failure conditions.


   Considerations for Threads Programming
                     +---------+-----------------------------+
                     |         |                      async- |
                     |function | reentrant   cancel   cancel |
                     |         |             point     safe  |
                     +---------+-----------------------------+
                     |remove   |     Y         Y        N    |
                     +---------+-----------------------------+

SEE ALSO
       rmdir(2), unlink(2), reentrant(3).

RETURN VALUE
       Upon successful completion, remove returns a value of 0; otherwise,
       it returns a value of -1 and sets errno to indicate an error.


Licensed material--property of copyright holder(s)