NAME

rename − rename a file

SYNTAX

integer function rename (from, to)
character*(*) from, to

DESCRIPTION

The rename subroutine renames a file. The from argument must be the pathname of an existing file, and to will become the new pathname for the file.  If to exists, then both from and to must be the same type of file, and must reside on the same filesystem.  If to exists, it will be removed first. 

RETURN VALUE

The returned value will be 0 if successful and a system error code otherwise. 

RESTRICTIONS

Pathnames can be no longer than MAXPATHLEN as defined in <sys/param.h>. 

FILES

/usr/lib/libU77.a

SEE ALSO

rename(2), perror(3f)