Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/c/chown.html on line 1
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/c/chown.html on line 1
Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/c/chown.html on line 8
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/c/chown.html on line 8
Change the user ID and group ID of a file
#include <sys/types.h>
#include <unistd.h>
int chown( const char * path,
uid_t owner,
gid_t group );
- path
- The name of the file whose ownership you want to change.
- owner
- The user ID of the new owner.
- group
- The group ID of the new owner.
libc
Use the -l c option to
qcc
to link against this library.
This library is usually included automatically.
The chown() function changes the user ID and group ID of the
file specified by path to be the numeric values contained in
owner and group, respectively.
If the named file is a symbolic link,
chown() changes the ownership of the file or directory
to which the symbolic link refers;
lchown()
changes the ownership of the symbolic link file itself.
Only processes with an effective user ID equal to the user ID of the file
or with appropriate privileges (for example, the superuser) may change
the ownership of a file.
In QNX Neutrino, the _POSIX_CHOWN_RESTRICTED flag
(tested via the _PC_CHOWN_RESTRICTED flag in pathconf()),
is enforced for path.
This means that only the superuser may change the ownership or the group of a file to anyone.
Normal users can't give a file away to another user by changing the file ownership,
nor to another group by changing the group ownership.
If the path argument refers to a regular file, the
set-user-ID (S_ISUID) and set-group-ID
(S_ISGID)
bits of the file mode are cleared, if the function is successful.
If chown() succeeds, the st_ctime field of the file is marked for update.
- 0
- Success.
- -1 (no changes were made in the user ID and group ID of the file).
- An error occurred (errno is set).
- EACCES
- Search permission is denied on a component of the path prefix.
- ELOOP
- Too many levels of symbolic links or prefixes.
- ENAMETOOLONG
- The length of the path string exceeds
PATH_MAX, or a pathname component is longer than
NAME_MAX.
- ENOENT
- A component of the path prefix doesn't exist, or the path
arguments points to an empty string.
- ENOSYS
- The chown() function isn't implemented for the filesystem specified in path.
- ENOTDIR
- A component of the path prefix isn't a directory.
- EPERM
- The effective user ID doesn't match the owner of the file, or the
calling process doesn't have appropriate privileges.
- EROFS
- The named file resides on a read-only filesystem.
/*
* Change the ownership of a list of files
* to the current user/group
*/
#include <stdio.h>
#include <stdlib.h>
#include <sys/types.h>
#include <unistd.h>
int main( int argc, char** argv )
{
int i;
int ecode = 0;
for( i = 1; i < argc; i++ ) {
if( chown( argv[i], getuid(), getgid() ) == -1 ) {
perror( argv[i] );
ecode++;
}
}
exit( ecode );
}
POSIX 1003.1
Safety: | |
Cancellation point |
No |
Interrupt handler |
No |
Signal handler |
Yes |
Thread |
Yes |
chmod(),
errno,
fchown(),
fstat(),
lchown(),
open(),
stat()
Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/c/chown.html on line 245
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/c/chown.html on line 245