uchmod(PCI)                    6 January 1993                    uchmod(PCI)


 Name

    uchmod - change UNIX operating system file attributes

 Syntax


    #include <pcilib.h>


    #include <memmdl.h>

    int uchmod( dpath, mode )
    char *dpath;
    int mode;


 Description

    uchmod is a DOS function used to change the file attribute or mode of a
    file on a UNIX operating system.

    mode is the target UNIX operating system file mode.  See chmod(S) or
    chmod(C) for a description of the various bits in the mode parameter.

    dpath is a DOS style path name for a file residing on the virtual drive
    whose mode is to be changed.  The path may include a drive designation to
    indicate on which host the operation is to be performed.  If no drive is
    specified, the current drive is used.

 Return value

    On successful completion, a value of 0 returns.  If the call fails for
    any reason, a value of -1 returns and a DOS error code is returned in
    errno.

 Example


               :
               :
       char *dPath = "D:\\EXISTING\\FILENAME";
       int  mode   = 0755;       /* rwxr-xr-x permission in octal */
       int  retVal;
               :
               :
       /* Change the mode of the DOS file name on virtual drive D: */
       if ( (retVal = uchmod(dPath, mode)) == -1 )
               errorHandler();
               :
               :


 See also

    getuattr(PCI), isvirtual(PCI)