chown、fchown、lchown、chownx、fchownx、chownxat、または fchownat サブルーチン

目的

ファイル所有権を変更します。

ライブラリー

標準 C ライブラリー (libc.a)

構文

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

int chown ( Path, Owner, Group ) const char *Path; uid_t Owner; gid_t Group;

int fchown ( FileDescriptor, Owner, Group )

int FileDescriptor; uid_t Owner; gid_t Group；

int lchown ( パス、 所有者、 グループ )

const char * fname uid_t uid gid_tgid

#include <sys/types.h>

#include <sys/chownx.h>

int chownx ( Path, Owner, Group, Flags )

char *パス; uid_t 所有者; gid_t Group; int Flags;

int fchownx ( FileDescriptor, Owner, Group, Flags )

int FileDescriptor; uid_t Owner; gid_t Group; int Flags；

int chownxat ( DirFileDescriptor, Path, Owner, Group, Flags)

int DirFileDescriptor；

char * パス;

uid_t 所有者;

gid_t グループ;

int フラグ;

int fchownat (DirFileDescriptor, Path, Owner, Group, Flag)

int DirFileDescriptor；

char *パス;

uid_t 所有者;

gid_t グループ;

int フラグ;

説明

chown、 chownx、 fchown、 fchownx、 chownxat、 fchownat、および lchown サブルーチンは、指定されたファイル・システム・オブジェクトのファイル所有者とグループ ID を設定します。 ファイルの所有者を変更するには、root ユーザー権限が必要です。

関数 lchown 関数は、指定されたファイルの所有者 ID とグループ ID を chown 関数に設定します。ただし、指定されたファイルがシンボリック・リンクである場合を除きます。 この場合、 lchown 関数はシンボリック・リンク・ファイル自体の所有権を変更し、 chown 関数はシンボリック・リンクが参照するファイルまたはディレクトリーの所有権を変更します。

chownxatサブルーチンはchownxサブルーチンと等価であり、fchownatサブルーチンは、Pathパラメーターが絶対パスを指定している場合、またはDirFileDescriptorパラメーターがAT_FDCWDに設定されている場合、chownまたはlchownサブルーチンと等価である。 変更されるファイルは、現在の作業ディレクトリではなく、DirFileDescriptorパラメータに関連付けられたディレクトリへの相対パスによって決定される。 ディレクトリーが O_SEARCH オープン・フラグなしでオープンされた場合、サブルーチンは、ディレクトリーの現行許可を使用してディレクトリー検索が許可されているかどうかを判別します。 ディレクトリーが O_SEARCH オープン・フラグでオープンされている場合、サブルーチンは検査を実行しません。

パラメーター

戻り値

正常終了すると、 chown、 chownx、 fchown、 fchownx、 chownxat、 fchownat、および lchown サブルーチンは、値 0 を戻します。 chown、chownx、fchown、fchownx、chownxat、fchownat、またはlchownサブルーチンが失敗した場合、値-1が返され、エラーを示すerrnoグローバル変数が設定される。

エラー・コード

以下のいずれかに該当する場合、 chown、 fchownat、 chownx、 chownxat、または lchown サブルーチンは失敗し、ファイルの所有者とグループは変更されません。

以下のいずれかが該当する場合、 fchown または fchownx サブルーチンは失敗し、ファイル所有者およびグループは変更されません。

以下のいずれかが該当する場合、 chownxat または fchownat サブルーチンは失敗し、ファイル所有者およびグループは変更されません。

セキュリティー

アクセス制御: 呼び出し側は、 Path パラメーターのすべてのコンポーネントに対する検索許可を持っている必要があります。