


      RENAME(3F)                  (bsd 4.2)                  RENAME(3F)



      NAME
           rename - rename a file

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

      DESCRIPTION
           From must be the pathname of an existing file.  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.

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

      FILES
           /usr/lib/libU77.a

      SEE ALSO
           rename(2), perror(3F)

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





























      Page 1                                          (73 A2 03MT REV1)



