fchownat() - Unix，Linux系統呼叫

名稱

fchownat - 更改相對於目錄檔案描述符的檔案所有權

#include <unistd.h> 

int fchownat(int dirfd, const char *path, 
             uid_t owner, gid_t group, int flags);

fchownat() 系統呼叫與 chown(2) 的工作方式完全相同，除了本手冊頁中描述的差異。

如果path中給定的路徑名是相對路徑，則它將相對於檔案描述符dirfd引用的目錄進行解釋（而不是相對於呼叫程序的當前工作目錄，chown(2) 對相對路徑名就是這樣做的）。

如果path中給定的路徑名是相對路徑，並且dirfd是特殊值AT_FDCWD，則path將相對於呼叫程序的當前工作目錄進行解釋（與chown(2)相同）。

如果path中給定的路徑名是絕對路徑，則忽略dirfd。

flags可以為0，也可以包含以下標誌：

標籤	描述
AT_SYMLINK_NOFOLLOW	如果path是符號連結，則不要取消引用它：而是像lchown(2)一樣對連結本身進行操作。（預設情況下，fchownat() 像chown(2)一樣取消引用符號連結）。

成功時，fchownat() 返回 0。出錯時，返回 -1，並設定errno以指示錯誤。

chown(2) 中發生的相同錯誤也可能發生在 fchownat() 中。fchownat() 可能會發生以下附加錯誤：

標籤	描述
EBADF	dirfd不是有效的檔案描述符。
EINVAL	在flags中指定了無效標誌。
ENOTDIR	path是相對路徑，並且dirfd是引用非目錄檔案的描述符。

有關fchownat()的需求說明，請參見openat(2)。

此係統呼叫是非標準的，但建議將其包含在POSIX.1的未來修訂版中。Solaris上存在類似的系統呼叫。

fchownat() 在 Linux 核心 2.6.16 中新增。

列印頁面