163 lines
4.7 KiB
Groff
163 lines
4.7 KiB
Groff
.\" Copyright (c) 1990, 1991, 1993, 1994
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
.\" may be used to endorse or promote products derived from this software
|
|
.\" without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" @(#)chown.8 8.3 (Berkeley) 3/31/94
|
|
.\" %FreeBSD: src/usr.sbin/chown/chown.8,v 1.23 2004/08/07 04:19:37 imp Exp %
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd April 25, 2003
|
|
.Dt CHOWN 8
|
|
.Os
|
|
.Sh 名称
|
|
.Nm chown
|
|
.Nd 指定したファイルの所有者およびグループを変更する
|
|
.Sh 書式
|
|
.Nm
|
|
.Op Fl fhv
|
|
.Oo
|
|
.Fl R
|
|
.Op Fl H | Fl L | Fl P
|
|
.Oc
|
|
.Ar owner Ns Op : Ns Ar group
|
|
.Ar
|
|
.Nm
|
|
.Op Fl fhv
|
|
.Oo
|
|
.Fl R
|
|
.Op Fl H | Fl L | Fl P
|
|
.Oc
|
|
.No : Ns Ar group
|
|
.Ar
|
|
.Sh 解説
|
|
.Nm
|
|
ユーティリティは、指定したファイルのユーザ ID やグループ ID を変更します。
|
|
引数で指定されるシンボリックリンクは、
|
|
.Fl h
|
|
が指定されない限りは、何も表示せずに無変更のままとなります。
|
|
.Pp
|
|
オプションは以下のものがあります:
|
|
.Bl -tag -width Ds
|
|
.It Fl H
|
|
.Fl R
|
|
オプションが指定されている場合に、コマンドライン上の
|
|
シンボリックリンクをたどるようになります。
|
|
( ツリー内をたどっている際中に見つけたシンボリックリンクの先は
|
|
調べません。)
|
|
.It Fl L
|
|
.Fl R
|
|
オプションが指定された場合に、全てのシンボリックリンクを
|
|
たどるようになります。
|
|
.It Fl P
|
|
.Fl R
|
|
オプションが指定された場合に、シンボリックリンクの先を
|
|
たどらないようになります。
|
|
これがデフォルトです。
|
|
.It Fl R
|
|
指定したディレクトリツリーのファイルのユーザ ID やグループ ID を
|
|
(再帰的に、ディレクトリ内のものを含め)
|
|
変更します。
|
|
.Dq Li ".*"
|
|
のようなワイルドカードを使用するときには、
|
|
親ディレクトリへのハードリンク
|
|
.Dq Pa ".."
|
|
が意図に反してマッチしないように注意してください。
|
|
.It Fl f
|
|
所有者やグループの変更が失敗しても報告を行ないません。
|
|
変更の失敗は戻り値にも影響しません。
|
|
.It Fl h
|
|
ファイルがシンボリックリンクの場合、
|
|
リンク自身のユーザ ID および/またはグループ ID
|
|
を変更します。
|
|
.It Fl v
|
|
.Nm
|
|
を冗長にし、所有者が修正されるファイルを表示させます。
|
|
.Fl v
|
|
フラグが複数回指定されると、
|
|
.Nm
|
|
は、ファイル名に続けて、
|
|
古い数値ユーザ/グループ ID と新しい数値ユーザ/グループ ID を
|
|
表示します。
|
|
.El
|
|
.Pp
|
|
.Fl H ,
|
|
.Fl L ,
|
|
.Fl P
|
|
のオプションは
|
|
.Fl R
|
|
が指定されない限り無視されます。
|
|
加えて、これらのオプションはお互いの効果を上書きするため、
|
|
コマンドの動作は最後に指定されたもので決まります。
|
|
.Pp
|
|
.Ar owner
|
|
と
|
|
.Ar group
|
|
のオペランドはどちらも無くてもよいもの (optional) ですが、
|
|
少なくともどちらかを指定しなければなりません。
|
|
.Ar group
|
|
オペランドを指定した場合は
|
|
先頭にコロン (``:'') をつけて下さい。
|
|
.Pp
|
|
.Ar owner
|
|
は ユーザ ID の数値かユーザ名のどちらかです。ユーザ名がユーザ ID
|
|
の数値でもある場合、このオペランドはユーザ名とみなされます。
|
|
.Ar group
|
|
は
|
|
グループ ID の数値かグループ名のどちらかです。グループ名がグループ ID
|
|
の数値でもある場合、このオペランドはグループ名とみなされます。
|
|
.Pp
|
|
セキュリティの関係上明らかなことですが、ファイルの所有者の変更はスーパユーザ
|
|
にしか行なうことができません。
|
|
.Sh 診断
|
|
.Ex -std
|
|
.Sh 互換性
|
|
.Nm
|
|
の以前のバージョンは、グループ名を指定するのにドット (``.'') を
|
|
用いていました。
|
|
この文字はコロン (``:'') に変更されたため、
|
|
ユーザ名やグループ名にドットを含んでも構いません。
|
|
.Pp
|
|
以前のバージョンのシステムでは、シンボリックリンクは所有者がありませんでした。
|
|
.Pp
|
|
.Fl v
|
|
オプションは非標準ですので、スクリプト中での使用は勧められません。
|
|
.Sh 関連項目
|
|
.Xr chgrp 1 ,
|
|
.Xr find 1 ,
|
|
.Xr chown 2 ,
|
|
.Xr fts 3 ,
|
|
.Xr symlink 7
|
|
.Sh 規格
|
|
.Nm
|
|
ユーティリティは
|
|
.St -p1003.2
|
|
互換であると考えられています。
|
|
.Sh 歴史
|
|
.Nm
|
|
ユーティリティは
|
|
.At v1
|
|
から導入されました。
|