chmod() - Unix，Linux 系統呼叫

名稱

chmod, fchmod - 更改檔案許可權

概要

#include <sys/types.h>
#include <sys/stat.h> 
int chmod(const char *path, mode_t mode);
int fchmod(int fildes, mode_t mode);

描述

更改由path給定或由fildes引用的檔案的模式。

模式透過或以下方式指定

標籤	描述
S_ISUID	04000 設定使用者 ID 以執行
S_ISGID	02000 設定組 ID 以執行
S_ISVTX	01000 粘滯位
S_IRUSR	00400 所有者可讀
S_IWUSR	00200 所有者可寫
S_IXUSR	00100 所有者可執行/搜尋
S_IRGRP	00040 組可讀
S_IWGRP	00020 組可寫
S_IXGRP	00010 組可執行/搜尋
S_IROTH	00004 其他使用者可讀
S_IWOTH	00002 其他使用者可寫
S_IXOTH	00001 其他使用者可執行/搜尋

呼叫程序的有效 UID 必須與檔案的擁有者匹配，或者程序必須具有特權（Linux：它必須具有CAP_FOWNER功能）。

如果呼叫程序沒有特權（Linux：沒有CAP_FSETID功能），並且檔案的組與程序的有效組 ID 或其任何補充組 ID 不匹配，則 S_ISGID 位將被關閉，但這不會導致返回錯誤。

作為安全措施，根據檔案系統，如果寫入檔案，則可能會關閉 set-user-ID 和 set-group-ID 執行位。（在 Linux 上，如果寫入程序沒有CAP_FSETID功能，則會發生這種情況。）在某些檔案系統上，只有超級使用者才能設定粘滯位，這可能具有特殊含義。對於粘滯位，以及目錄上的 set-user-ID 和 set-group-ID 位，請參見stat(2)。

在 NFS 檔案系統上，限制許可權會立即影響已開啟的檔案，因為訪問控制是在伺服器上完成的，但檔案由客戶端維護。如果在客戶端啟用了屬性快取，則擴充套件許可權可能會延遲到其他客戶端。

返回值

成功時，返回零。發生錯誤時，返回 -1，並且errno被適當地設定。

錯誤

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

錯誤程式碼	描述
EACCES	路徑字首的元件上拒絕搜尋許可權。（另見path_resolution(2)。）
EFAULT	path 指向您可訪問的地址空間之外。
EIO	發生 I/O 錯誤。
ELOOP	在解析path時遇到太多符號連結。
ENAMETOOLONG	path 太長。
ENOENT	檔案不存在。
ENOMEM	核心可用記憶體不足。
ENOTDIR	路徑字首的元件不是目錄。
EPERM	有效 UID 與檔案的擁有者不匹配，並且程序沒有特權（Linux：它沒有CAP_FOWNER功能）。
EROFS	命名檔案位於只讀檔案系統上。
fchmod() 的常見錯誤列在下面
EBADF	檔案描述符fildes無效。
EIO	見上文。
EPERM	見上文。
EROFS	見上文。

符合標準

4.4BSD、SVr4、POSIX.1-2001。

參見

列印頁面