p4 user
Helixサーバのユーザ仕様とプリファレンスを作成、編集、または削除します。
構文規則
p4 [g-opts] user [-f] [username]p4 [g-opts] user -d [-f | -F] usernamep4 [g-opts] user -D [-f | -y] usernamep4 [g-opts] user -o [username]p4 [g-opts] user -i [-f]
説明
p4 userコマンドを使用して、ユーザの仕様や設定を編集したり、
新しいユーザレコードを作成したりすることができます。
デフォルト設定の場合、不明なユーザがリポジトリ(またはリポジトリのメタデータ)を更新するコマンドを起動するたびに、Helixサーバによって新しいユーザが作成されます。 Helixサーバのスーパーユーザがdm.user.noautocreate構成可能変数を使用して、この動作を禁止することをお勧めします。 『Helix Coreサーバ管理者ガイド』の「セキュリティを確保するための構成可能変数の推奨設定」を参照してください。
プロテクションテーブルにエントリが登録されていない状態でも、ユーザやグループを作成できますが、プロテクションテーブル内にユーザやグループに適用されるエントリが追加されるまで、そのユーザやグループはコマンドを実行することはできません。ファイル、ディレクトリ、コマンドに対するアクセスを制御する権限は、p4 protectの権限レベル(list、read、write、admin、superなど)が設定されているuserまたはgroupに割り当てられます。
グラフディポ
HelixサーバにGitリポを保存するために使用されるグラフタイプのディポ。「Helix4Git」と「クラシックディポ」も参照してください。の場合、p4 grant-permission (グラフ)コマンドにより、アクセスの制御権限がユーザやグループに割り当てられます。
usernameオプションを指定せずにp4
userコマンドを実行すると、現在のユーザの仕様(Reviews:フィールドなど)を編集することができます。
usernameを指定して実行した場合は、
ユーザ仕様は表示されますが変更はできません。
P4EDITOR環境変数で定義したエディタに
フォームが表示されます。
Helixサーバスーパーユーザは、
新規のユーザを作成したり、-f(強制)オプションを使用して既存のユーザの仕様を編集したりすることができます。
その場合の構文はp4 user -f
usernameです。-fオプションと-Fオプションは、どちらもユーザを削除する場合に指定できますが、
-Fオプションは、プロテクションとグループに影響することに注意してください。
以下のオプションを参照してください。
Helixサーバコマンドを発行するユーザと、 コマンド実行の名義者となるユーザとは、必ずしも同じではありません。 特定のコマンドを実行するユーザは、次のように決定されます。
- コマンドを実行するユーザが
Helixサーバスーパーユーザであり、
かつ構文
p4 user -f usernameを使用する場合は、 ユーザusernameが編集されます。 -
コマンドラインで
-u usernameオプションが使用される場合(例えば、p4 -u joe submit)、 コマンドは「joe」というユーザ名で実行されます(パスワードが必要になる場合もあります)。 - このオプションを指定しなくても、
環境変数
P4CONFIGで指定したファイルにP4USERの設定が含まれている場合、 コマンドは該当ユーザ名で実行されます。 - -u usernameオプションも使用されず、ファイルも指定されていない場合でも、
環境変数
P4USERが設定されていれば、コマンドは該当ユーザ名で実行されます。 - 上記のいずれにも当てはまらない場合、OSレベルの環境変数である
USERまたはUSERNAMEからユーザ名が取得されます。
ユーザが組織を退職しているような場合、管理者は-Dオプションを使用すると便利です。このオプションは指定したユーザを削除するのみでなく、そのユーザに関連付けられているすべてのクライアントワークスペースを削除します。
ユーザのタイプ
ユーザタイプは一度設定すると、変更できません。
| 標準ユーザ |
デフォルト設定の場合、
存在しないユーザがコマンドを発行するたびに、
Helixサーバによって新しいユーザレコードが作成されます。
Helixサーバのスーパーユーザは、以下のように
$ p4 user -f username
フォームフィールドに作成するユーザに関する情報を入力します。
標準ユーザの権限プロテクションテーブルにエントリが登録されていない状態でも、ユーザやグループを作成できますが、プロテクションテーブル内にユーザやグループに適用されるエントリが追加されるまで、そのユーザやグループはコマンドを実行することはできません。詳細については、「 |
|||||||||
| オペレータユーザ |
|
|||||||||
| サービスユーザ |
注意
サービスユーザは、コマンドラインで直接p4 pullコマンドやp4 journalcopyコマンドを実行することはできませんが、レプリカサーバ上のサービスユーザは、自動的にこれらのコマンドを実行して、マスターサーバからメタデータとアーカイブコンテンツ(バージョンファイル)を取得することができます。 サービスユーザを作成するには、次のコマンドを実行します。
$ p4 user -f service1
標準のユーザフォームが表示されます。新しい行を入力して新しいユーザの User: service1 Email: services@example.com FullName: Service User for remote depots Type: service デフォルト設定の場合、p4 usersコマンドを実行しても、サービスユーザは表示されません。
サービスユーザを含めるには、 ヒント
グループ内にサービスユーザを含めることをお勧めします。詳しくは「p4 group」トピックを参照してください。 サービスユーザの権限サービスユーザに 注意
サービスユーザが必要になる環境について詳しくは、『Helix Coreサーバ管理者ガイド』の「展開アーキテクチャ」と「リモートディポとマルチサーバ展開」を参照してください。 |
フォームフィールド
| フィールド名 | タイプ | 説明 |
|---|---|---|
|
|
読み取り専用 |
ファイル名とエンティティに関する文字の制限に 注意してください。 |
|
|
読み取り専用 |
ユーザのタイプ: 重要
ユーザの作成後に、そのユーザのタイプを変更することはできません。 |
|
|
書き込み可能 |
次のいずれか1つになります。
|
|
|
書き込み可能 |
ユーザの電子メールアドレス。
デフォルトは |
|
|
読み取り専用 |
この仕様が最後に更新された日時。 |
|
|
読み取り専用 |
このユーザが最後に Helixサーバコマンドを実行した日時。 |
|
|
書き込み可能 |
ユーザの氏名。 |
|
|
書き込み可能 |
すべての新しいチェンジリストに自動的に表示されるジョブの説明 (「使用上の注意点」を参照してください)。 |
|
|
書き込み可能 |
ユーザのパスワード(「使用上の注意点」を参照してください)。 |
|
|
読み取り専用 |
ユーザが最後にパスワードを変更した日時。 ユーザにパスワードがない場合、このフィールドは空白です。 |
|
|
書き込み可能リスト |
ユーザが参照するファイルのリスト(「使用上の注意点」を参照してください)。 このフィールドには、除外マッピングを指定できます。 |
フィールドの下に行がある場合は、その行をインデントしてください。以下に例を示します。
Reviews://depot/path/to/directory1/... //maria/depot/path/to/directory1/... //depot/path/to/directory2/... //maria/depot/path/to/directory2/...
オプション
|
|
指定されたユーザを削除します。このオプションを指定できるのは、以下のユーザです。
|
-D username
|
このオプションを使用して以下の操作を実行できるのは、 Helixサーバのスーパーユーザだけです。
このオプションを使用する場合は、以下の点に注意する必要があります。
注意
他のユーザによって作業状態にされたファイルが存在するワークスペースクライアントは削除されません。 他のユーザによって作業状態にされたファイルが存在するワークスペースクライアントを強制的に削除するには、-Dオプションと-fオプションをプレビューモードで組み合わせて指定します。 操作を実行するには、-yオプションを追加します。 例を参照してください。 |
-y
|
-Dを指定して実行すると、削除操作が実際に行われます。-y、p4 user -D、p4 user -D -f、p4 user -D -Fを指定しなかった場合、-yを指定してコマンドを実行した場合の処理内容のみが表示されます。 注意
p4 user -D -y、p4 user -D -f -y、p4 user -D -F -yを指定してコマンドを実行した場合、実行結果を元の状態に戻すことはできません。 |
|
|
スーパーユーザ用の強制オプションです。指定したユーザの作成、変更、削除や、 最終更新日の変更を行うことができます(-yオプションを指定しなかった場合は、プレビューモードになります) |
|
|
|
|
|
標準入力からユーザ仕様を読み取ります。
入力は |
|
|
標準出力にユーザ仕様が書き込まれます。 |
|
|
詳しくは、「グローバルオプション」を参照してください。 |
使用上の注意点
| ファイル引数でリビジョン指定子を使用できるか？ | ファイル引数でリビジョン範囲を使用できるか？ | 最低限必要なアクセスレベル |
|---|---|---|
|
適用外 |
適用外 |
- スーパーユーザ以外のユーザは、
-dオプションを使用して、p4 userコマンドを起動したユーザの仕様のみを削除することができます。 Helixサーバスーパーユーザは、 どのHelixサーバユーザでも 削除できます。 - 指定したユーザがファイルを作業状態にしている場合、そのユーザの削除は失敗します。 作業状態にあるファイルをサブミットしてから、または元に戻してから、ユーザを削除してください。
-
デフォルトでは、ユーザ記録はパスワードなしで作成されるので、 どのHelixサーバユーザも
P4USERを設定するか、グローバルオプション-uを使用することにより、 ほかのユーザとして操作を行うことができます。自分の名前をほかのユーザが使用するのを防ぐために、p4 passwdコマンドを使用してパスワードを設定します。パスワードの作成、編集、および変更は、
p4 userフォームで行うことも、p4 passwdコマンドを使用して行うこともできます。p4 userコマンドでパスワードを設定できるのは、セキュリティレベルが「0」または「1」の場合だけです。p4 passwdでは任意のサーバセキュリティレベルでパスワードを設定することができます。 より高いセキュリティレベルでパスワードを設定するには、p4 passwdを使用する必要があります。 各種のセキュリティレベルの詳細については、 『Helix Coreサーバ管理者ガイド』を参照してください。ヒントp4 userのフォームでPassword:フィールドを編集する場合、 パスワード内にコメント文字#を使用しないでください。 Helixサーバは、同じ行にある、この文字に続くすべてをコメントとみなし、 パスワードの一部としては保存しません。構成可能変数
dm.user.resetpasswordが設定されている場合、 パスワードを作成しているすべてのユーザは、 パスワードをリセットしてからコマンドを実行する必要があります。 - パスワードは、その長さに関係なく、
p4 userフォームに6つのアスタリスクとして表示されます。 - チケットベースの認証(詳細については「
p4 login」を参照)を使用している場合は、 ユーザがパスワードを変更すると、そのユーザに対して発行されているすべての未処理のチケットが 自動的に無効になります。 - 各ユーザの[
Email:]フィールドの値はp4 usersコマンドで一覧表示でき、あらゆる目的に使用できます。 -
Helixサーバチェンジレビューデーモンで使用される
p4 reviewsコマンドは、Reviews:フィールドの値を使用します。 このデーモンは、 ユーザがReviews:フィールドで指定したファイルが変更されるたびに、 該当ユーザに電子メールを送ります。 このフィールドに一覧表示されるファイルは、ディポシンタックスで指定する必要があります。
例えば、ユーザjoeの[Reviews:]フィールドの値が 次のようになっているとします。//depot/main/... //depot/.../README
チェンジレビューデーモンは、
READMEファイルがサブミットされるか、//depot/main配下のファイルがサブミットされるたびに、joeに電子メールを送ります。[
Reviews:]フィールドの別の例を次に示します。//depot/*/relnotes.txt
ディポ内のすべてのブランチに関するrelnotes.txtファイルの変更について通知を送信します。
-
Helixサーバチェンジレビューデーモンで使用される、 ジョブレビューの特別な設定があります。値
//depot/jobs
が[
Reviews:]フィールドに含まれる場合、 ジョブが変更されるたびに、該当ユーザに電子メールを送ります。 -
[
Jobview:]フィールドに有効なジョブビューを設定すると、 該当ユーザが作成するどのチェンジリストにも、そのジョブビューに適合するジョブが表示されます。 そのチェンジリストで修正されるジョブは、p4 submitでチェンジリストがサブミットされるときにチェンジリストに残っている必要があり、 ほかのジョブはサブミット前にフォームから削除されている必要があります。例えば、サイトのジョブに[
Owned-By:]というフィールドがあるとします。 この場合、ユーザはp4 userフォームの[Jobview:]フィールドをOwned-By=と設定します。 これで、該当ユーザが所有しているすべての作業中ジョブが、 ユーザが作成するすべてのチェンジリストに表示されるようになります ジョブビューの使用方法や構文の詳細については、yourname&status=openp4 jobsを参照してください。 - ユーザ
sammy sammyのすべてのワークスペースクライアント(sammy以外のユーザが作業状態にしたファイルが存在するワークスペースクライアントは除外されます)- ユーザsammy
sammyのすべてのワークスペースクライアント(sammy以外のユーザが作業状態にしたファイルが存在するワークスペースクライアントは除外されます)- ユーザsammy
sammyのすべてのワークスペースクライアント(sammy以外のユーザが作業状態にしたファイルが存在するワークスペースクライアントは含まれます)- ユーザsammy
sammyのすべてのワークスペースクライアント(sammy以外のユーザが作業状態にしたファイルが存在するワークスペースクライアントは含まれます)- ユーザsammy
sammyのすべてのワークスペースクライアント(sammy以外のユーザが作業状態にしたファイルが存在するワークスペースクライアントは含まれます)-
プロテクションテーブルとグループに存在するsammy
例
|
|
Helixサーバユーザ |
|
|
現在のHelixサーバユーザのユーザ仕様を編集します。 |
|
|
Helixサーバユーザ |
|
|
次の削除をプレビューします。 |
|
|
次の削除を実行します。 注意
元に戻すことはできなくなります。 |
|
|
次の削除をプレビューします。 |
|
|
次の削除を実行します。 注意
元に戻すことはできなくなります。 |
|
|
次の削除を実行します。 注意
元に戻すことはできなくなります。 |
|
|
このコマンドは、高いセキュリティレベルでは機能しません。 |
|
|
呼び出し元がHelixサーバスーパーユーザであり、
|
関連コマンド
|
すべてのHelixサーバユーザの リストを参照する |
|
|
ユーザのパスワードを変更する |
|
|
特定ファイルのレビューを予約しているユーザのリストを参照する |
|
|
構成可能変数 |
