Content-type: text/html Man page of remove

remove

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

remove - Removes a file  

LIBRARY

Standard C Library (libc.so, libc.a)  

SYNOPSIS

#include <stdio.h>

int remove(        const char *path );
 

STANDARDS

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

Points to the file to be removed.  

DESCRIPTION

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

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

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

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

RELATED INFORMATION

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

Standards: standards(5) delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
NOTES
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:34 GMT, October 02, 2010