Changes file access permissions.

    Format

      #include  <stat.h>

      int fchmod  (int fildes, mode_t mode);

1 - Arguments

 fildes

    An open file descriptor.

 mode

    The bit pattern that determines the access permissions.

2 - Description

    The fchmod function is equivalent to the chmod function, except
    that the file whose permissions are changed is specified by a
    file descriptor (fildes) rather than a filename.

3 - Return Values

    0                  Indicates that the mode is successfully
                       changed.
    -1                 Indicates that the change attempt has failed.