'\" te
.\" Copyright (c) 2007, 2011, Oracle and/or its affiliates. All rights reserved.
.\" Copyright 1989 AT&T
.\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures
.\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
.\"  Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at http://www.opengroup.org/bookstore/.
.\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. This notice shall appear on any product containing this material.
.TH newgrp 1 "2011 年 7 月 12 日" "SunOS 5.11" "ユーザーコマンド"
.SH 名前
newgrp \- 新たなグループへのログイン
.SH 形式
.SS "コマンド"
.LP
.nf
\fB/usr/bin/newgrp\fR [\fB-|\fR \fB-l\fR] [\fIgroup\fR]
.fi

.SS "sh 組み込み"
.LP
.nf
\fBnewgrp\fR [\fIargument\fR]
.fi

.SS "ksh88 組み込み"
.LP
.nf
\fB*newgrp\fR [\fIargument\fR]
.fi

.SS "ksh 組み込み"
.LP
.nf
\fB+newgrp\fR [\fIargument\fR]
.fi

.SH 機能説明
.SS "コマンド"
.sp
.LP
\fBnewgrp\fR コマンドは、ユーザーの実および実効グループ ID を変更してユーザーを新たなグループへログインさせます。ユーザーはログイン状態を保ち、またカレントディレクトリも変わりません。\fBnewgrp\fR を実行すると、常にシェルは新たなものに入れ替えられます。これはコマンドが、グループ名不明のためにエラーで終了した場合でも同様です。
.sp
.LP
エクスポートされない変数は、NULL またはデフォルト値にリセットされます。エクスポートされた変数は、その値を保持します。\fBPS1\fR、 \fBPS2\fR、 \fBPATH\fR、 \fBMAIL\fR、 \fBHOME\fR のようなシステム変数は、システムやユーザーによりエクスポートされないかぎり、デフォルト値にリセットされます。たとえば、ユーザーが主プロンプト文字列として、デフォルトの \fB$\fR の代わりに \fBPS1\fR を使っていて、\fBPS1\fR をエクスポートしなかった場合、ユーザーの \fBPS1\fR はデフォルト文字列の \fB$\fR に設定されます。これは \fBnewgrp\fR がエラーで終了したとしても同様です。なおシェルコマンドの \fBexport\fR (\fBsh\fR(1) と \fBset\fR(1) を参照) は、変数をエクスポートするための方法で、これを使うと、新たなシェルを呼び出す際に割り当て済みの変数値を保持できます。
.sp
.LP
オペランドとオプションをすべて省略した場合、\fBnewgrp\fR は、ユーザーのグループ ID (実 ID と実効 ID) を、ユーザーのパスワードファイルエントリに指定されているグループに戻します。この方法を使うと、いったん \fBnewgrp\fR コマンド実行により変更した状態を、元に戻すことができます。
.sp
.LP
グループがパスワードを持っていて、ユーザーがそのグループのメンバーである旨が \fB/etc/group\fR ファイルに定義されていない場合、パスワードの入力が要求されます。グループ用にパスワードを生成する唯一の方法は、まず \fBpasswd\fR(1) を実行し、さらに \fB/etc/shadow\fR から \fB/etc/group\fR へパスワードを「カット & ペースト」することです。グループ用パスワードは、今日ではあまり使われません。
.SS "sh 組み込み"
.sp
.LP
\fBexec\fR \fBnewgrp\fR \fI argument\fR を実行した場合と同等です。\fIargument\fR は \fBnewgrp\fR コマンドのオプションまたはオペランド、もしくはその両方を表します。
.SS "ksh88 組み込み"
.sp
.LP
\fBexec\fR \fB/bin/newgrp\fR \fI argument\fR を実行した場合と同等です。\fIargument\fR は \fBnewgrp\fR コマンドのオプションまたはオペランド、もしくはその両方を表します。
.sp
.LP
このマニュアルページでは、1 つまたは 2 つの \fB*\fR (アスタリスク) が先頭に付加されている  \fBksh88\fR(1) コマンドは、次のような特殊な扱いを受けます。
.RS +4
.TP
1.
コマンドが完了しても、コマンドの直前の変数代入リストは依然として有効です。
.RE
.RS +4
.TP
2.
入出力のリダイレクトは変数代入後に行われます。
.RE
.RS +4
.TP
3.
エラーが発生すると、それを含むスクリプトは中止されます。
.RE
.RS +4
.TP
4.
変数代入形式で、\fB**\fR を先頭に持つコマンドに続くワードは、変数代入と同一の規則で展開されます。つまり、チルド置換は \fB=\fR 符号のあとに実行され、ワード分割とファイル名生成は実行されません。
.RE
.SS "ksh 組み込み"
.sp
.LP
\fBexec\fR \fB/bin/newgrp\fR \fI argument\fR を実行した場合と同等です。\fIargument\fR は \fBnewgrp\fR コマンドのオプションまたはオペランド、もしくはその両方を表します。
.sp
.LP
このマニュアルページでは、1 つまたは 2 つの \fB+\fR (プラス符号) が先頭に付加されている \fBksh\fR(1) コマンドは、次のような特殊な処理を受けます。
.RS +4
.TP
1.
コマンドが完了しても、コマンドの直前の変数代入リストは依然として有効です。
.RE
.RS +4
.TP
2.
入出力のリダイレクトは変数代入後に行われます。
.RE
.RS +4
.TP
3.
エラーが発生すると、それを含むスクリプトは中止されます。
.RE
.RS +4
.TP
4.
これらは有効な関数名ではありません。
.RE
.RS +4
.TP
5.
変数代入形式で、\fB++\fR を先頭に持つコマンドに続くワードは、変数代入と同一の規則で展開されます。つまり、チルド置換は \fB=\fR 符号のあとに実行され、フィールド分割とファイル名生成は実行されません。
.RE
.SH オプション
.sp
.LP
次のオプションがサポートされています。
.sp
.ne 2
.mk
.na
\fB\fB-l\fR | \fB-\fR\fR
.ad
.RS 10n
.rt  
環境を、ユーザーが実際に新グループのメンバーとしてログインした場合に得られるものに変更します。
.RE

.SH オペランド
.sp
.LP
次のオペランドがサポートされています。
.sp
.ne 2
.mk
.na
\fB\fIgroup\fR \fR
.ad
.RS 12n
.rt  
グループデータベースから得られるグループ名、または負でない数値のグループ ID。実グループ ID と実効グループ ID として新たに用いるグループ ID を指定します。\fIgroup\fR が負でない数値で、グループ名としてグループデータベースに存在している (\fBgetgrnam\fR(3C) を参照) 場合、そのグループ名に対応した数値グループ ID が新たなグループ ID として用いられます。
.RE

.sp
.ne 2
.mk
.na
\fB\fIargument\fR\fR
.ad
.RS 12n
.rt  
\fBsh\fR と \fBksh88\fR でのみ使用。\fBnewgrp\fR コマンドのオプションまたはオペランド、もしくはその両方。
.RE

.SH 環境
.sp
.LP
\fBnewgrp\fR の実行に影響を与える次の環境変数についての詳細は、\fBenviron\fR(5) を参照してください。\fBLANG\fR、\fBLC_ALL\fR、\fBLC_CTYPE\fR、\fBLC_MESSAGES\fR、および \fBNLSPATH\fR。
.SH 終了ステータス
.sp
.LP
\fBnewgrp\fR が新たなシェル実行環境を生成できた場合、グループ ID の変更が正常終了したかどうかにかかわらず、終了ステータスはシェルの終了ステータスと同じになります。環境が生成できなかったとき、次の終了値が返されます。
.sp
.ne 2
.mk
.na
\fB>\fB0\fR\fR
.ad
.RS 6n
.rt  
エラーが発生した。
.RE

.SH ファイル
.sp
.ne 2
.mk
.na
\fB\fB/etc/group\fR\fR
.ad
.RS 15n
.rt  
システムグループファイル
.RE

.sp
.ne 2
.mk
.na
\fB\fB/etc/passwd\fR\fR
.ad
.RS 15n
.rt  
システムパスワードファイル
.RE

.SH 属性
.sp
.LP
属性についての詳細は、マニュアルページの \fBattributes\fR(5) を参照してください。
.SS "/usr/bin/newgrp、ksh88、sh"
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
属性タイプ属性値
_
使用条件system/core-os
_
インタフェースの安定性確実
_
標準T{
\fBstandards\fR(5) を参照してください。
T}
.TE

.SS "ksh"
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
属性タイプ属性値
_
使用条件system/core-os
_
インタフェースの安定性不確実
.TE

.SH 関連項目
.sp
.LP
\fBlogin\fR(1), \fBksh\fR(1), \fBksh88\fR(1), \fBset\fR(1), \fBsh\fR(1), \fBIntro\fR(3), \fBgetgrnam\fR(3C), \fBgroup\fR(4), \fBpasswd\fR(4), \fBattributes\fR(5), \fBenviron\fR(5), \fBstandards\fR(5)