NAME

lchown - change the owner and group of a symbolic link

 SYNOPSIS

#include <unistd.h>

int lchown(const char *path, uid_t owner, gid_t group);

 DESCRIPTION

The lchown() function has the same effect as chown() except in the case where the named file is a symbolic link. In this case lchown() changes the ownership of the symbolic link file itself, while chown() changes the ownership of the file or directory to which the symbolic link refers.

 RETURN VALUE

Upon successful completion, lchown() returns 0. Otherwise, it returns -1 and sets errno to indicate an error.

 ERRORS

The lchown() function will fail if:

[EACCES]

Search permission is denied on a component of the path prefix of path.

[EINVAL]

The owner or group id is not a value supported by the implementation.

[ENAMETOOLONG]

The length of a pathname exceeds {PATH_MAX}, or pathname component is longer than {NAME_MAX}.

[ENOENT]

A component of path does not name an existing file or path is an empty string.

[ENOTDIR]

A component of the path prefix of path is not a directory.

[EOPNOTSUPP]

The path argument names a symbolic link and the implementation does not support setting the owner or group of a symbolic link.

[ELOOP]

Too many symbolic links were encountered in resolving path.

[EPERM]

The effective user ID does not match the owner of the file and the process does not have appropriate privileges.

[EROFS]

The file resides on a read-only file system.

The lchown() function may fail if:

[EIO]

An I/O error occurred while reading or writing to the file system.

[EINTR]

A signal was caught during execution of the function.

[ENAMETOOLONG]

Pathname resolution of a symbolic link produced an intermediate result whose length exceeds {PATH_MAX}.

 EXAMPLES

None.

 APPLICATION USAGE

None.

 FUTURE DIRECTIONS

None.

 SEE ALSO

chown(), symlink(), <unistd.h>.