p4 group
概要
ユーザをグループに追加、またはグループから削除します。または、グループのメンバーに対するmaxresults
、maxscanrows
、maxlocktime
およびtimeout
の各制限を設定します。
構文
p4 [g-opts
] group [-a | -A] groupname
p4 [g-opts
] group -d [-a] groupname
p4 [g-opts
] group -o groupname
p4 [g-opts
] group -i [-a | -A]
解説
グループは、Perforceユーザのリストです。グループを使用して、p4 protectフォームでのアクセスレベルの設定、特定のユーザが1つのコマンドでPerforceから取得できるデータの最大件数の制限、p4 loginチケットのタイムアウト期間の設定、ならびにp4 ldapsyncコマンドに対する情報の付与を行います。
グループを削除するには、p4 group -d
groupname
を実行するか、p4 group groupname
を起動して、表示されたフォームからユーザ全員を消去します。
フォームフィールド
フィールド名 |
タイプ |
解説 |
---|---|---|
|
読み取り専用 |
コマンドライン上で入力されたグループ名です。 |
|
書き込み可能 |
グループのメンバーが1つのコマンドでサービスからアクセスできるデータの最大件数です。デフォルト値は |
|
書き込み可能 |
グループのメンバーがサービスから、1つのコマンドでスキャンできる最大の列数です。デフォルト値は |
|
書き込み可能 |
データスキャンの際、ある1つの操作で任意のデータベーステーブルをロックすることのできる最長時間(ミリ秒単位)。デフォルト値は |
|
書き込み可能 |
p4
loginによって作成されるセッションチケットが有効である期間(秒単位)です。デフォルト値は43,200秒(12時間)です。有効期限が無期限のチケットを作成するには、 |
|
書き込み可能 |
このグループに属するユーザのパスワードが有効である期間(秒単位)。パスワードの有効期限設定を無効にするには、値に |
|
書き込み可能 |
LDAPクエリからグループのユーザのリストを作成するときに使用するLDAPコンフィギュレーション。 詳細については、p4 ldapsyncを参照してください。 |
|
書き込み可能 |
グループのメンバーの識別に使用するLDAPクエリ。 詳細については、p4 ldapsyncを参照してください。 |
|
書き込み可能 |
ユーザのユーザ名を表すLDAP属性。 詳細については、p4 ldapsyncを参照してください。 |
|
書き込み可能、複数行 |
他のPerforceグループの名前です。
あらかじめ定義されているグループのユーザ全員を現在自分が属しているグループに追加するには、p4
groupのフォームの
|
|
書き込み可能、複数行 |
他のPerforceユーザの名前です。
グループの所有者は必ずしもグループのメンバーでなくても構いません。グループ所有者をグループのメンバーにするには、そのユーザIDも 指定する所有者は、Perforceユーザである必要はありません。ユーザがまだ存在していないため任意の名前を使用する場合や、ユーザを削除してから仕様を新しいユーザに割り当てるまでのプレースホルダーが必要となる場合があります。 |
|
書き込み可能、複数行 |
グループのメンバーのPerforceユーザ名ですユーザー名は各自1行ずつ記述され、インデントされていなければなりません。 |
オプション
|
(スーパーユーザではない)グループ所有者によるグループの管理を可能にします。そのユーザは、グループの |
|
|
|
グループ |
|
ユーザのエディタを立ち上げずに標準入力からフォームを読み込みます。新しいグループ仕様がそれまでの仕様に置き換わります。 |
|
ユーザのエディタを立ち上げずに標準出力へフォームを書き出します。 |
|
「“グローバルオプション”」を参照してください。 |
使用上の留意点
ファイル引数にリビジョン指定子を使えるか? |
ファイル引数にリビジョン範囲を使えるか? |
最低限必要なアクセスレベル |
---|---|---|
適用外 |
適用外 |
|
-
グループ定義の中で(存在しない)ユーザを記述しても、ユーザは作成されず、ライセンスも消費されません。ユーザの作成にはp4 userを使用してください。
-
複数のグループに属するユーザのチケットの
Timeout
とPasswordTimeout
の値は、maxresults
値と同様の方法で計算されます。つまり、そのユーザが属するすべてのグループのtimeout
値のうち(unlimited
は含めるがunset
は無視して)最大の値が設定されます。どのグループにも属さないユーザには、デフォルトのチケットのTimeout
値に43200
が設定され、PasswordTimeout
にunset
が設定されます。無期限のチケットを作成するには、Timeout
をunlimited
に設定します。 -
PasswordTimeout:
フィールドを使用してパスワード有効期限を設定する場合、30日間でのタイムアウトは2,592,000秒です。 -
ディポに保存されているファイルの数が増えてくると、ある種のコマンドをパラメータなしで、あるいは制限のない引数を付けて実行したときに、サービスの動作が大幅に遅くなることがあります。例えば、p4 print //depot/...は、ディポに保存されているあらゆるファイルの内容をユーザの画面上に表示し、p4 filelog //depot/...は、ディポに保存されているあらゆるファイルのあらゆるリビジョンにおいて、データを取り込もうとします。
Perforceスーパーユーザは、ユーザのグループについて
MaxResults
値を設定することにより、Perforceがユーザに返すデータの量を制限することができます。同様に、MaxScanRows
値を設定することにより、スキャンされるデータの量(ユーザに返されるか返されないかにかかわらず)を制限することができます。また、MaxLockTime
値により、ある1つの操作で任意のデータベーステーブルをロックすることができる時間の長さを設定することができます。この
MaxResults
値、MaxScanRows
値またはMaxLockTime
値を超えた場合、サーバへの要求は拒否され、ユーザは問合せを制限するように求められます。ユーザが複数のグループに属している場合、サーバは、ユーザが属しているすべてのグループに対する
MaxResults
値の最大値をそのユーザのMaxResults
値として計算します(設定値unlimited
に遭遇すると制限は削除されますが、デフォルト値unset
のままである設定は無視されます)。どのグループにも属さないユーザがいれば、そのMaxResults
値はunset
になります。(ユーザのMaxScanRows
値およびMaxLockTime
値の制限も同様の方法で計算されます。)通常のハードウェアの処理速度では、
MaxResults
を10,000以下に設定したり、MaxScanRows
を50,000以下に設定したり、MaxLockTime
を1000以下に設定したりする必要はありません。 -
ワークスペースまたはラベルのアンロードを行うには、ユーザがワークスペースのhaveリストにあるすべてのファイルおよび/またはラベルによってタグ付けされているファイルをスキャンすることが可能でなければなりません。管理者は
MaxScanRows
およびMaxResults
を十分な大きさの値に設定して、ユーザがp4 unloadまたはp4 reloadの操作にサポートを要求せずに済むようにするべきです。 -
あるグループについて
maxresults
、maxscanrows
、maxlocktime
、およびtimeout
の制限を表示するには、p4 groups -vgroupname
を使用します。 -
p4 help maxresultsを使用すると、3つの制限値のどれかに影響を受けるコマンドのリストを取得することができます。