rfio_chown man page

RFIO_CHOWN(3)               Rfio Library Functions               RFIO_CHOWN(3)

[1mNAME[0m
      rfio_chown - change owner and group of a directory/file

[1mSYNOPSIS[0m
      [1m#include <sys/types.h>[0m
      [1m#include "rfio_api.h"[0m

      [1mint rfio_chown (const char *[4m[22mpath[24m[1m, uid_t [4m[22mnew_uid[24m[1m, gid_t [4m[22mnew_gid[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mrfio_chown  [22msets  the  owner  and  the group of a directory/file to the
      numeric values in [4mowner[24m and [4mgroup[24m respectively.  If [4mowner[24m or  [4mgroup[24m  is
      specified  as  -1, [1mrfio_chown() [22mdoes not change the corresponding ID of
      the file.

      [4mpath[24m   specifies the logical pathname relative to the current directory
             or the full pathname.

      The  effective  user ID of the process must match the owner of the file
      or be super-user.

[1mRETURN VALUE[0m
      This routine returns 0 if the operation was successful  or  -1  if  the
      operation failed. In the latter case, [1mserrno [22mis set appropriately.

[1mERRORS[0m
      [1mEPERM        [22mThe effective user ID does not match the owner of the file
                   and is not super-user.

      [1mENOENT       [22mThe named file/directory does not exist or is a null path-
                   name.

      [1mEACCES       [22mSearch  permission  is  denied  on a component of the [4mpath[0m
                   prefix or write permission on the file itself is denied.

      [1mEFAULT       [4m[22mpath[24m is a NULL pointer.

      [1mENOTDIR      [22mA component of [4mpath[24m prefix is not a directory.

      [1mEINVAL       [4m[22mnew_uid[24m or [4mnew_gid[24m is invalid.

      [1mENAMETOOLONG [22mThe length of [4mpath[24m exceeds [1mCA_MAXPATHLEN [22mor the length  of
                   a [4mpath[24m component exceeds [1mCA_MAXNAMELEN[22m.

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSETIMEDOUT   [22mTimed out.

      [1mSECONNDROP   [22mConnection closed by remote end.

      [1mSECOMERR     [22mCommunication error.

[1mSEE ALSO[0m
      [1mCastor_limits(4)[0m

[1mAUTHOR[0m
      [1mLCG Grid Deployment [22mTeam

LCG                      $Date: 2005/03/31 13:13:02 $            RFIO_CHOWN(3)