NAME    [Toc]    [Back]

       remove - Remove a file

SYNOPSIS    [Toc]    [Back]

       #include <stdio.h>

       int remove(
               const char *path );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       remove():  POSIX.1, XPG4, XPG4-UNIX

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Points to the file to be removed.

DESCRIPTION    [Toc]    [Back]

       The  remove() function causes a file named by the pathname
       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 it is created anew.

       If the path parameter names a directory,  remove(path)  is
       equivalent  to calling the rmdir() function on that directory.
 If path does not name a directory,  remove(path)  is
       equivalent to unlink(path).

NOTES    [Toc]    [Back]

       If  the  file  operated  upon by the remove() function has
       multiple hard links, the link count in the file is  decremented
 and only the specified file name is removed.

RETURN VALUES    [Toc]    [Back]

       Upon  successful completion, the remove() function returns
       0 (zero). Otherwise, a nonzero value is returned. Refer to
       the  unlink() function and the rmdir() function for information
 on return values.

ERRORS    [Toc]    [Back]

       Refer to the unlink() function and  the  rmdir()  function
       for information on error conditions.

SEE ALSO    [Toc]    [Back]

       Functions: link(2), rename(2), rmdir(2), unlink(2)


       Standards: standards(5)



                                                        remove(3)