RENAME(DOS)              XENIX System V               RENAME(DOS)



     Name
          rename - renames a file or directory.

     Syntax
          #include <io.h>

          int rename (newname, oldname);
          char *newname;
          char *oldname;

     Description
          The rename function renames the file or directory specified
          by oldname to the name given by newname. oldname must
          specify the pathname of an existing file or directory.
          Newname must not specify the name of an existing file or
          directory.

          The rename function can be used to move a file from one
          directory to another by giving a different pathname in the
          newname argument.  However, files cannot be moved from one
          device to another (for example, from Drive A to Drive B).
          Directories can only be renamed, not moved.

     Return Value
          rename returns 0 if it is successful.

     See Also
          creat(S), fopen(DOS), open(S)

     Example
          #include <io.h>

          int result;

          /* The following statement changes the file "data" to **
          have the name "input".  */ result = rename ("input",
          "data"):

     Notes
          This call must be compiled with the -dos flag.















     Page 1                                           (printed 8/7/87)