.\" Copyright (c) 1992, 1993, 1994
.\"	The Regents of the University of California.  All rights reserved.
.\" All rights reserved.
.\"
.\" This code is derived from software donated to Berkeley by
.\" Jan-Simon Pendry and from John Heidemann of the UCLA Ficus project.
.\"
.\" 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.
.\"
.\"	@(#)mount_umap.8	8.4 (Berkeley) 5/1/95
.\"	%Id: mount_umap.8,v 1.8 1998/07/15 06:12:31 charnier Exp %
.\" jpman %Id: mount_umap.8,v 1.2 1997/04/12 15:56:14 horikawa Stab %
.\"
.Dd May 1, 1995
.Dt MOUNT_UMAP 8
.Os BSD 4.4
.Sh 名称
.Nm mount_umap
.Nd ファイルシステム層のサンプルファイルシステム
.Pp
.Sh 書式
.Nm mount_umap
.Op Fl o Ar options
.Fl u Ar uid-mapfile
.Fl g Ar gid-mapfile
.Ar target
.Ar mount-point
.Sh 解説
.Nm
は、ローカルシステムとは異なる uid, gid を使用するファイルシステムの
サブトリーをマウントするために使用します。
そのようなファイルシステムには、別のサイトの NFS や
別のパスワードを使用する場所から持って来たリムーバブルメディア上の
ファイルシステムです。
.Pp
.Nm
はユーザが提供するファイルのセットを使用し、
サブトリーの元の環境とローカルの環境との uid, gid の対応を取ります。
元の環境では smith は uid 1000 を持ち、ローカル環境では
uid 2000 を持ちます。
.Nm
は、smith のオリジナルの環境で持っているファイルを次のようにマップさせます:
uid 1000 が所有するファイルを、実際には uid 2000 が所有者である
かのように見せます。
.Pp
以下のオプションを使用可能です:
.Bl -tag -width indent
.It Fl o
.Fl o
のあとに、コンマで区切ってオプション文字列を指定することができます。
可能なオプションとその意味は
.Xr mount 8
を参照してください。
.It Ar target 
ローカルシステムの名前空間において、サブツリーの現在位置。
.It Ar mount-point
マップされたサブツリーが置かれるディレクトリ。
.It Fl u Ar uid-mapfile 
.It Fl g Ar gid-mapfile 
識別子の対応が記述されます。
それぞれのファイルの1行目には、そのファイルがいくつの対応を持っている
かを記述します。
2行目からは、各行に対応を記述します。
最初の項目はローカル環境での id で、次の項目がオリジナル環境での idで、
項目は空白で区切ります。
.Ar uid-mapfile
にはすべての uid の対応を、
.Ar gid-mapfile
にはすべての gid の対応を記述するべきです。
.Ar uid-mapfile
に記載されない uid は NOBODY と、
.Ar gid-mapfile
に記載されない gid は NULLGROUP と扱われます。
uid の対応は64個まで、gid の対応は16個まで記述することができます。
.El
.Pp
マップファイルはファイル階層のどこにでも置くことができますが、
ファイルの所有者はrootで、rootのみが書き込めるようにしておかなければ
なりません。
.Nm
は、もしこれらのファイルの所有者や権限が
不適切な場合はサブトリーをマップしません。
もしマップファイルの1行目の対応数と実際の対応数が異なる場合も、
実行を停止します。
.Pp
.Nm
コマンドで作られるファイルシステム層は、簡単なファイルシステム層の
例となっています。商品としての利用は考えられていません。
そのため、あまり洗練された実装ではありません。
.Sh 関連項目
.Xr mount 8 ,
.Xr mount_null 8
.Sh バグ

本ファイルシステムタイプは、まだ完全にはサポートされていません
(注: 機能しないということです) し、
実際のところ使用するとシステム上のデータを破壊するかもしれません。
自己責任において使用してください。
猛犬注意。濡れていて滑ります。

危険性を減らすためには、このコードもまた所有者を必要としています -
真面目なハッカーの方はメールを hackers@freebsd.org に送って
引き継ぎの意思を宣言してください。

.Sh 歴史
.Nm
は
.Bx 4.4
から実装されました。