pSOSystem System Calls - Read

ename pREPC+ System Calls
rename Renames a file.
#include
#include
int rename(
const char *old, /* existing file name */
const char *new /* new file name */
)
Description
Arguments
Return Value
Error Codes
This function changes the name of a file from old to new. It applies only to pHILE+managed
files. If a file new already exists, it is deleted. Certain error conditions
specific to the volume type can result, as follows:
■ If a file called new exists and is open, the call fails (except on NFS volumes).
■ If old is open, the call fails (DOS volumes only).
■ If old is a directory file, the call fails (DOS volumes only).
old Points to the string that contains the old filename.
new Points to the string that contains the new filename.
This function returns zero if the file is successfully renamed. If an error occurs,
errno is set, and a nonzero value is returned.
Refer to Appendix B.
3-126 pSOSystem System Calls