uren(PCI)                      6 January 1993                      uren(PCI)


 Name

    uren - rename a UNIX operating system file

 Syntax


    #include <pcilib.h>


    #include <memmdl.h>

    int uren( oldupath, newupath )
    char *oldupath, *newupath;


 Description

    uren is a DOS function used to rename UNIX operating system files.  The
    file to be renamed must exist, and the DOS user must have access to it.

    oldupath is the UNIX operating system name of the file to be renamed.
    The name may include a drive designation to select the host.  If no drive
    is specified, the current drive is used.

    newupath is the path name to be given to the file.

 Return value

    If any error occurs, a value of -1 returns.

 Example


               :
               :
       char *oldUpath = "D:/unixpath/file1";
       char *newUpath = "D:/unixpath/file2";
       int  retVal;
               :
               :
       /*
       ** Rename the UNIX file on
       ** virtual drive D:
       */
       if ( (retVal = uren(oldUpath, newUpath)) == -1 )
               errorHandler();

               :
               :


 See also

    isvirtual(PCI), mapd2u(PCI)