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つの制限値のどれかに影響を受けるコマンドのリストを取得することができます。