.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 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.10.2.1 2000/12/08 15:27:59 ru Exp %
.\"
.\" jpman %Id: chown.8,v 1.3 1997/05/19 16:59:53 horikawa Stab %
.\"
.Dd March 31, 1994
.Dt CHOWN 8
.Os BSD 4
.Sh 名称
.Nm chown
.Nd 指定したファイルの所有者およびグループを変更する
.Sh 書式
.Nm
.Op Fl fhv
.Oo
.Fl R
.Op Fl H | Fl L | Fl P
.Oc
.Ar owner Ns Op Ar :group
.Ar
.Nm
.Op Fl fhv
.Oo
.Fl R
.Op Fl H | Fl L | Fl P
.Oc
.Ar :group
.Ar
.Sh 解説
.Nm
は指定したファイルのユーザ ID や グループ ID を設定します。
.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 を
変更します。
.It Fl f
所有者やグループの変更が失敗しても報告を行ないません。
変更の失敗は戻り値にも影響しません。
.It Fl h
ファイルがシンボリックリンクの場合、
リンクが指すファイルではなくリンク自身のユーザ ID および/またはグループ ID
を変更します。
.It Fl v
.Nm
を冗長にし、所有者が修正されるファイルを表示させます。
.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
セキュリティの関係上明らかなことですが、ファイルの所有者の変更はスーパユーザ
にしか行なうことができません。
.Pp
.Nm
は成功時に 0 を、エラーが起こった時に 0 より大きい値を戻り値とし
て返します。
.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 
から導入されました。