Poster of Linux kernelThe best gift for a Linux geek
GFS_CHMOD

GFS_CHMOD

Section: (3) Updated: 13 November 2006
Local index Up

 

NAME

gfs_chmod - change permissions of a file  

SYNOPSIS

#include <gfarm/gfarm.h>

char *gfs_chmod (char * gfarm_url, mode_t mode);  

DESCRIPTION

gfs_chmod() changes the mode of the file given by gfarm_url. Permission bit masks of mode are similar to ones of mode parameter to chmod(2), though only the least 9 bit are effective.

An executable file cannot be changed to a non-executable file and vice versa, unless the number of fragment of the file is only one. In detail, a file has multiple fragments with any execution bit should not be changed to that with no execution bit. It is necessary to have at least one execution bit. Similarly, a file has multiple fragments with no execution bit should not be changed to that with any execution bit.  

RETURN VALUES

NULL
The function terminated successfully.
GFARM_ERR_NO_MEMORY
Insufficient memory was available.
GFARM_ERR_AUTHENTICATION
User authentication failed when connecting to gfmd(8) or gfsd(8).
GFARM_ERR_PERMISSION_DENIED
The parent directory of gfarm_url did not allow write permission.
GFARM_ERR_OPERATION_NOT_PERMITTED
The effective UID does not match the owner of the file, and is not zero. Or an attempt was made to change an executable file with more than one fragment to a non-executable file, or vice versa.
GFARM_ERR_NO_SUCH_OBJECT
The file does not exist.
GFARM_ERR_NOT_A_DIRECTORY
A component of the path prefix is not a directory.
Others
An error except the above occurred. The reason is shown by its pointed strings.


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES

This document was created by man2html, using the manual pages.
Time: 21:46:48 GMT, April 16, 2011