> Linux Reviews > man >

chown

chown

  1. chown.1.man
  2. chown.2.man

1. chown.1.man

Manpage of CHOWN

CHOWN

Section: User Commands (1)
Updated: 18 June 2002
Index Return to Main Contents
 

名前

chown - ファイルの所有者とグループを変更する  

書式

chown [オプション] user[:group] file...

POSIX オプション: [-R]

GNU オプション (簡略形式): [-cfhvR] [--dereference] [--from=owner:group] [--reference=file] [--help] [--version] [--]  

説明

chown コマンドは指定されたそれぞれの file のユーザーおよびグループ、もしくはいずれかの所有権を、 オプションではない最初の引き数により以下のように変更する: ユーザー名 (もしくは数値の user ID) のみを指定した場合、 それぞれのファイルの所有者は指定したユーザーになり、 グループは変わらない。 ユーザー名に続けてコロンとグループ名 (もしくは数値の group ID) を 間にスペースを入れずに指定した場合、 同じようにそれらファイルのグループ所有権も指定したグループに変わる。  

GNU 詳細

GNU 版ではコロンの代わりにドットが使える (BSD に従っている)。 [POSIX ではユーザー名にドットが使えるため、これは許されていなかった。]

ユーザー名に続いてコロンもしくはドットがあるのにグループ名が無い場合、 ファイルの所有権はそのユーザーになり、 ファイルのグループはそのユーザーのログイングループに変更される。 コロンもしくはドットとグループは指定されているがユーザー名が無い場合、 ファイルのグループのみが変更される; この場合、 chown コマンドは chgrp コマンドと同じ働きをする。  

POSIX オプション

-R
ディレクトリやそこに含まれるものの所有権を再帰的に変更する。
 

GNU オプション

-c, --changes
実際に所有権の変更があった file それぞれについての動作を詳細に表示する。
--dereference
シンボリックリンクそれ自身ではなく、指している先を変更する。
-f, --silent, --quiet
所有権を変更できなかったファイルについてのエラーメッセージを出力しない。
--from=owner:group
owner と group にマッチするファイルのみを変更する。 どちらかを省略することもできる。
-h, --no-dereference
指している先ではなく、シンボリックリンクそれ自身を変更する。 これがデフォルトである。 lchown(2) が提供されていない場合、chown は失敗する。 再帰的に処理している時にシンボリックリンクを見付けても、 --verbose が指定されていない場合、 エラーメッセージは出力されない。
-v, --verbose
全ての file について変更した (もしくはしなかった) という動作を詳細に表示する。
-R, --recursive
ディレクトリやそこに含まれるものの所有権を再帰的に変更する。
--reference=file
明示的に user-group 値を指示する代わりに、 参照用に指定した file のユーザー、グループを使う。

 

GNU 標準オプション

--help
標準出力に使用方法のメッセージを出力して正常終了する。
--version
標準出力にバージョン情報を出力して正常終了する。
--
オプションリストを終了する。
 

環境変数

変数 LANG, LC_ALL, LC_CTYPE, LC_MESSAGES が通常の意味を持つ。  

準拠

POSIX 1003.2 ではユーザー名とグループ名の間の区切り文字として ドットの使用を認めていない。  

注意

chown(2) で set-uid ビットや set-gid ビットがリセットできるシステムでも、 set-uid や set-gid は保護される。

このページでは fileutils-4.1 パッケージでの chown コマンドについて説明している。 その他のバージョンでは少し違いがあるかもしれない。 修正や追加は aeb@cwi.nl, aw@mail1.bet1.puv.fi, ragnar@ragnar-hojland.com 宛てにメールで連絡してほしい。 プログラムのバグについては bug-fileutils@gnu.org へ報告してほしい。

 

Index

名前
書式
説明
GNU 詳細
POSIX オプション
GNU オプション
GNU 標準オプション
環境変数
準拠
注意
This document was created by man2html using the manual pages.
Time: 17:13:21 GMT, January 19, 2012

2. chown.2.man

Manpage of CHOWN

CHOWN

Section: Linux Programmer's Manual (2)
Updated: 2010-09-26
Index Return to Main Contents
 

名前

chown, fchown, lchown - ファイルの所有者を変更する  

書式

#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);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

fchown(), lchown():

_BSD_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
|| /* glibc 2.12 以降: */ _POSIX_C_SOURCE >= 200809L
 

説明

これらのシステムコールは、ファイルの所有者 (owner) とグループを変更する。 システムコール間の違いは、ファイルの指定の仕方だけである。
*
chown() は path で指定されたファイルの所有権を変更する。 path がシンボリック・リンクの場合は、リンクの展開が行われる。
*
fchown() はオープンされたファイルディスクリプタ fd により参照されるファイルの所有権を変更する。
*
lchown() は chown() と同じだが、シンボリック・リンクを展開しない点が異なる。

特権を持つプロセス (Linux では CAP_CHOWN ケーパビリティ (capability) を持つプロセス) だけが ファイルの所有者を変更できる。 ファイルの所有者は、その所有者が属しているグループのいずれかに ファイルのグループを変更することができる。 特権 (Linux では CAP_CHOWN) を持つプロセスは、任意のグループに変更できる。

owner または group に -1 が指定された場合、それらの ID は変更されない。

非特権ユーザーにより実行ファイルの所有者またはグループが 変更された場合は S_ISUID と ISGID モードビットはクリアされる。 POSIX はこの動作やルートが chown() を行なった場合については特に指定されていない。 Linux における動作はカーネルのバージョンに依存する。 非グループ実行ファイル (S_IXGRP ビットが設定されていないファイル) の場合には S_ISGID ビットは強制ロック (mandatory locking) を意味している。 そしてそれは chown() ではクリアできない。  

返り値

成功すると、0 を返す。 失敗すると、-1 を返し、 errno に適切な値を設定する。  

エラー

ファイルシステムによっては他のエラーが返される事がある。 chmod で一般的なエラーを以下に挙げる。
EACCES
path の構成要素に検索許可 (search permission) がない (path_resolution(7) も参照)。
EFAULT
path が割り当てられたアドレス空間外を指している。
ELOOP
path を解決する際に遭遇したシンボリック・リンクが多過ぎる。
ENAMETOOLONG
path が長過ぎる。
ENOENT
ファイルが存在しない。
ENOMEM
カーネルに十分なメモリがない。
ENOTDIR
path の構成要素がディレクトリでない。
EPERM
呼び出したプロセスに所有者またはグループ (もしくはその両方) を変更するために 要求される許可 (上記を参照) がない。
EROFS
指定したファイルが読み込み専用 (read-only) のファイル・システム上にある。

fchown() で一般的なエラーを以下に挙げる:

EBADF
ディスクリプターが有効でない。
EIO
i ノード (inode) を変更する際に低レベル I/O エラーが発生した。
ENOENT
上記を参照。
EPERM
上記を参照。
EROFS
上記を参照。
 

準拠

4.4BSD, SVr4, POSIX.1-2001.

4.4BSD 版ではスーパー・ユーザーのみが使用できる (つまり、普通のユーザーはファイルを手放すことはできない)。  

注意

(open(2) や mkdir(2) などにより) 新しいファイルが作成されるとき、 その所有者は呼び出したプロセスのファイルシステム・ユーザ ID と 同じに設定される。 そのファイルのグループはいくつかの要因により決定される。 その要因としては、 ファイルシステムの種類、そのファイルシステムのマウント時に 使用されたオプション、親ディレクトリで set-group-ID 許可ビットが 有効になっているどうか、がある。 ファイルシステムが mount(8) オプションの -o grpid (-o bsdgroups も同義語) と -o nogrpid (-o sysvgroups も同義語) に対応している場合、ルールは以下の通りとなる。
*
ファイルシステムが -o grpid 付きでマウントされている場合、新しいファイルのグループは 親ディレクトリのグループと同じになる。
*
ファイルシステムが -o nogrpid 付きでマウントされており、親ディレクトリでは set-group-ID ビットが 無効になっている場合、新しいファイルのグループは プロセスのファイルシステム GID と同じになる。
*
ファイルシステムが -o nogrpid 付きでマウントされており、親ディレクトリでは set-group-ID ビットが 有効になっている場合、新しいファイルのグループは 親ディレクトリのグループと同じになる。

Linux 2.6.25 では、マウントオプション -o grpid と -o nogrpid に対応しているファイルシステムは ext2, ext3, ext4, XFS である。 これらのマウントオプションに対応していないファイルシステムでは、 -o nogrpid に関するルールが適用される。

chown() 方式は UID マッピングを使用した NFS ファイル・システムを侵害する。 さらにファイルの内容にアクセスする全てのシステム・コールを侵害する。 これは chown() が既にオープンされたファイルに対する アクセスをただちに取り消すことによる。 クライアント側のキャッシュにより所有権が変更されて ユーザーのアクセスが許した時点と、実際に他のクライアントでユーザーによって ファイルにアクセスできる時点との間に時間差があるかもしれない。

Linux の 2.1.81 より前のバージョン (特に 2.1.46 以前) では、 chown() はシンボリック・リンクを追跡しない。 Linux 2.1.81 以降では chown() はシンボリック・リンクを追跡し、新たなシステム・コール lchown() はシンボリック・リンクを追跡しない。 Linux 2.1.86 以降ではこの新しいコール (古い chown() と全く同じ動作を行なう) は同じシステムコール番号を持ち chown() は新しく導入された番号を持つ。  

例

以下のプログラムは、 二つ目のコマンドライン引き数で指定された名前のファイルの所有者を、 一つ目のコマンドライン引き数で指定された値に変更する。 新しい所有者は、数字のユーザ ID かユーザ名のいずれかで指定できる (ユーザ名で指定した場合には、 getpwnam(3) を使ってシステムのパスワードファイルの検索が行われ、 ユーザ ID への変換が行われる)。 


#include <pwd.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

int
main(int argc, char *argv[])
{
    uid_t uid;
    struct passwd *pwd;
    char *endptr;

    if (argc != 3 || argv[1][0] == aq\0aq) {
        fprintf(stderr, "%s <owner> <file>
", argv[0]);
        exit(EXIT_FAILURE);
    }

    uid = strtol(argv[1], &endptr, 10);  /* Allow a numeric string */

    if (*endptr != aq\0aq) {         /* Was not pure numeric string */
        pwd = getpwnam(argv[1]);   /* Try getting UID for username */
        if (pwd == NULL) {
            perror("getpwnam");
            exit(EXIT_FAILURE);
        }

        uid = pwd->pw_uid;
    }

    if (chown(argv[2], uid, -1) == -1) {
        perror("chown");
        exit(EXIT_FAILURE);
    }

    exit(EXIT_SUCCESS);
}
 

関連項目

chmod(2), fchownat(2), flock(2), path_resolution(7), symlink(7)

 

Index

名前
書式
説明
返り値
エラー
準拠
注意
例
関連項目
This document was created by man2html using the manual pages.
Time: 17:13:21 GMT, January 19, 2012

SVENSKA - cs - da - SVENSKA - SVENSKA - SVENSKA - nl - pl - ro - SVENSKA