chown() - Unix，Linux系統呼叫

名稱

chown, fchown, lchown - 更改檔案所有者

概要

#include <sys/types.h>
#include <unistd.h>

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

描述

這些系統呼叫更改由path或fd指定的檔案的所有者和組。只有特權程序（Linux：具有CAP_CHOWN能力的程序）才能更改檔案的所有者。檔案的所有者可以將檔案的組更改為該所有者所屬的任何組。特權程序（Linux：具有CAP_CHOWN）可以任意更改組。

如果owner或group指定為-1，則該ID不會更改。

當非超級使用者更改可執行檔案的所有者或組時，S_ISUID和S_ISGID模式位將被清除。POSIX沒有指定root執行chown()時是否也應該發生這種情況；Linux的行為取決於核心版本。對於非組可執行檔案（S_IXGRP位清除），S_ISGID位表示強制鎖定，不會被chown()清除。

返回值

成功時，返回零。出錯時，返回-1，並適當地設定errno。

錯誤

根據檔案系統，可以返回其他錯誤。下面列出了chown() 的更常見錯誤。

標籤	描述
EACCES	路徑字首的元件被拒絕搜尋許可權。（另見path_resolution(2)。）
EFAULT	path指向您可訪問的地址空間之外。
ELOOP	在解析path時遇到太多符號連結。
ENAMETOOLONG
	path太長。
ENOENT	檔案不存在。
ENOMEM	核心可用記憶體不足。
ENOTDIR
	路徑字首的元件不是目錄。
EPERM	呼叫程序沒有更改所有者和/或組所需的許可權（見上文）。
EROFS	指定的檔案位於只讀檔案系統上。
下面列出了fchown() 的常見錯誤
EBADF	描述符無效。
EIO	修改inode時發生低階I/O錯誤。
ENOENT	見上文。
EPERM	見上文。
EROFS	見上文。

備註

在早於2.1.81（以及與2.1.46不同的）版本的Linux中，chown()不會跟蹤符號連結。從Linux 2.1.81開始，chown()跟蹤符號連結，並且有一個新的系統呼叫lchown()不跟蹤符號連結。從Linux 2.1.86開始，這個新的呼叫（與舊的chown()具有相同的語義）獲得了相同的系統呼叫號，而chown()獲得了新引入的號。

只有定義_BSD_SOURCE時，才可以使用fchown()的原型。

符合標準

4.4BSD，SVr4，POSIX.1-2001。

4.4BSD版本只能由超級使用者使用（即，普通使用者無法放棄檔案）。

限制

啟用了UID對映的NFS檔案系統故意違反了chown()的語義。此外，訪問檔案內容的所有系統呼叫的語義都被違反了，因為chown()可能會導致對已開啟檔案的立即訪問撤銷。客戶端快取可能會導致所有權更改以允許使用者訪問的時間與使用者實際上可以在其他客戶端訪問檔案的時間之間存在延遲。

參見

列印頁面