getuattr(PCI)                  6 January 1993                  getuattr(PCI)


 Name

    getuattr - get UNIX operating system file attributes

 Syntax


    #include <pcilib.h>


    #include <memmdl.h>

    int getuattr( upath )
    char *upath;


 Description

    getuattr is a DOS function used to determine the UNIX operating system
    file attributes of the specified UNIX operating system path.

    upath is the UNIX operating system path name whose attributes are being
    requested.  The path may include a drive designation (for example, D:)
    indicating on which host the file is stored.  If no drive is specified,
    the current drive is used.

 Return value

    If the call succeeds, the UNIX operating system file mode is returned.
    (See stat(S) and stat(FP) for more information.)

    If the call fails for any reason, a value of -1 is returned.

 Example


               :
               :
       char *uPath = "D:/existing/\*(un/file";
       int  uAttrib;
               :
               :
       /*
       ** Get attributes of the UNIX System V file
       ** on virtual drive D:
       */
       if ( (uAttrib = getuattr(uPath)) == -1 )
               errorHandler();
       else
               printf("Attribute - in octal - is: %o", uAttrib);

               :
               :


 See also

    isvirtual(PCI), uchmod(PCI)