# 管理解説書

## uss add

目的

ユーザー・アカウントを作成します。

構文

    uss add -user <login name>  [-realname <full name in quotes>]
            [-pass <initial password>]
            [-pwexpires <password expires in [0..254] days (0 => never)>]
            [-server <FileServer for home volume>]
            [-partition <FileServer's disk partition for home volume>]
            [-mount <home directory mount point>]
            [-uid <uid to assign the user>]
            [-template <pathname of template file>]
            [-verbose]  [-var <auxiliary argument pairs (Num val)>+]
            [-cell <cell name>]  [-admin <administrator to authenticate>]
            [-dryrun]  [-skipauth]  [-overwrite]  [-help]

    uss ad -us <login name>  [-r <full name in quotes>]
           [-pas <initial password>]
           [-pw <password expires in [0..254] days (0 => never)>]
           [-se <FileServer for home volume>]
           [-par <FileServer's disk partition for home volume>]
           [-m <home directory mount point>]  [-ui <uid to assign the user>]
           [-t <pathname of template file>]  [-ve]
           [-va <auxiliary argument pairs (Num val)>+]  [-c <cell name>]
           [-a <administrator to authenticate>]  [-d]  [-sk]  [-o]  [-h]

構文

uss add コマンドは、 -user 引き数で指定されたユーザー名を、保護データベースおよび認証データベースに作成します。デフォルトでは、保護サーバーは新規ユーザーに AFS ユーザー ID (UID) を自動的に割り振ります。代替 AFS UID を指定する場合には、-uid 引き数を使用してください。 -pass 引き数でパスワードが指定されると、暗号化キーとして使用するために適切な形式に変換され、認証データベースにユーザーのパスワードとして保管されます。パスワードを指定しない場合には、ユーザーの初期パスワードとして、 changeme という文字列が割り当てられます。

コマンドの他の結果は、命令および -template 引き数で指定されたテンプレート・ファイルにある命令および変数の定義済みセットによって異なります。多くのコマンドの引き数は、定義済みの変数の 1 つに値を渡します。対応する変数がテンプレート・ファイルにあるときに、引き数を渡すことができないと、コマンド・インタープリターがテンプレート・ファイルで最初に変数を検出する場所で、アカウント作成処理が停止します。

単一コマンドで複数のアカウントを作成する場合には、 uss bulk コマンドを使用してください。単一コマンドでアカウントを削除する場合には、 uss delete コマンドを使用してください。

オプション

-user
  ユーザーの認証データベースおよび保護データベース項目を指定します。名前は、8 文字までの英数字とすることができますが、以下の文字、: (コロン)、@ (アットマーク)、. (ピリオド)、スペース、または改行は含められません。これは、ユーザー名 (ユーザーがログインしたときの名前) になるので、シェル・メタキャラクターを含まず、多くのオペレーティング・システムがユーザー名に設けている制限事項に準拠することをお勧めします。(通常は、8 文字以内の英小文字にします)。

  テンプレート・ファイルの対応する変数は、$USER です。

-realname
  ユーザーの完全名を指定します。スペースまたは句読点を含む場合には、二重引用符で囲んでください。名前を指定しないと、-user 引き数に指定されたユーザー名がデフォルトで使用されます。

  テンプレート・ファイルの対応する変数は、$NAME です。多くのオペレーティング・システムでは、ローカル・パスワード・ファイル (/etc/passwd または同等のファイル) のユーザー項目に完全名を入力するフィールドが用意されています。この変数は、そのフィールドに値を渡すために使用することができます。

-pass
  ユーザーの初期パスワードを指定します。パスワードを処理する AFS コマンドは、実際には長さに制限のない文字列を受け入れますが、多くのアプリケーションおよびユーティリティーで使用できる 8 文字以内のパスワードを使用するようにしてください。値を指定しないと、文字列 changeme がデフォルトで使用されます。

  テンプレート・ファイルで対応する変数はありません。

-pwexpires
  ユーザーのパスワードが変更された場合に、変更後の有効期限を指定します。有効期限までの日数を指定する場合には、1 から 254 までの整数を指定してください。パスワードに有効期限を設定しない場合には、 0 (デフォルト) を指定してください。

  パスワードが無効 (有効期限切れ) になると、そのユーザーは認証されません。ただし、kpasswd コマンドを発行してパスワードを変更すると、そのパスワードは変更後 30 日までは保持されます。 (これは管理者のみが変更可能です。)

  テンプレート・ファイルで対応する変数は、$PWEXPIRES です。

-server
  新規ユーザーのボリュームを作成するファイル・サーバー・マシンを指定します。完全修飾されたホスト名 (たとえば、fs1.example.com) を指定するようにしてください。ボリューム作成時に名前を解決するときにセルのネーム・サービスが使用可能であれば、省略形を使用することができます。

  テンプレート・ファイルで対応する変数は、$SERVER です。

-partition
  ユーザーのボリュームを作成する区画を指定します。これは、 -server 引き数で指定されたファイル・サーバー・マシン上にある必要があります。完全な区画名 (たとえば、/vicepa)、または以下の省略フォームの 1 つを指定します。

         /vicepa     =     vicepa      =      a      =      0
         /vicepb     =     vicepb      =      b      =      1

  /vicepz (これのインデックスは 25 です) の後には、以下が続きます。

         /vicepaa    =     vicepaa     =      aa     =      26
         /vicepab    =     vicepab     =      ab     =      27

  次の値まで、以下同様となります。

         /vicepiv    =     vicepiv     =      iv     =      255

  テンプレート・ファイルに対応する変数は、$PART です。

-mount
  ユーザーのホーム・ディレクトリーのパス名を指定します。部分的なパス名を指定すると、現行作業ディレクトリーとの相対位置で解釈されます。

  読み取り / 書き込みパスをディレクトリーに指定すると、読み取り専用ボリュームに新規マウント・ポイントを作成しようとする際の失敗を避けることができます。規則では、読み取り / 書き込みパスは、パス名の第 2 レベルのセル名の前にピリオドを入れて示します (たとえば、/afs/.example.com)。ファイル・スペースによる読み取り / 書き込みパスまたは読み取り専用パスの概念について、詳しくは、 fs mkmount 解説ページを参照してください。

  テンプレート・ファイルの V 命令にある $MTPT のみがテンプレートで対応する変数になります。V 命令の後にあるテンプレート命令に $MTPT 変数があると、V 命令の mount_point フィールドから値を取得します。したがって、このコマンド行引き数の値は、V の mount_point フィールドに $MTPT という文字列がある場合にだけ、V 命令の後の命令の $MTPT 変数の値になります。

-uid
  ユーザーの AFS UID として割り当てる場合には、0 (ゼロ) 以外の正の整数値を指定してください。この引き数を省略すると場合、保護サーバーは、`max` `user` `id` カウンターの現在値より大きな値の AFS UID を割り当てます。(カウンターを表示する場合には、pts listmax コマンドを使用してください。) この引き数を組み込んでいる場合は、最初に pts examine コマンドを使用して、必要な AFS UID を既に持っている既存のアカウントがないことを確認するのが最適です。あれば、アカウント作成プロセスは、エラーで終了します。

  テンプレート・ファイルに対応する変数は、$UID です。

-template
  テンプレート・ファイルのパス名を指定します。この引き数が省略された場合、コマンド・インタープリターは、 uss.template と呼ばれるファイルで指示された順序で次のディレクトリーを検索します。

  1. 現行作業ディレクトリー
  2. /afs/cellname/common/uss。cellname はローカル・セルに名前を付加します。
  3. /etc

  発行側が、uss.template 以外のファイル名をパス名なしで与えた場合、コマンド・インタープリターは、指示されたディレクトリーでこれを検索します。発行側が、すべてまたは一部のパス名を与えた場合、コマンド・インタープリターは指定されたファイルのみを調べます。これは、一部のパス名が現行作業ディレクトリーと対応すると解釈するからです。

  指定されたテンプレート・ファイルが空 (ゼロ長) の場合、コマンドは保護および認証データベース項目のみを作成します。

  ファイル形式の詳細については、"uss テンプレート・ファイル" の解説ページを参照してください。

-verbose
  標準出力ストリームに、コマンド実行の詳細なトレースを出力します。この引き数を省略すると、警告およびエラー・メッセージだけが表示されます。

-var
  テンプレート・ファイルにある $1 から $9 までの各番号変数に値を指定します。標準セットの一部ではない uss テンプレート・ファイルにある変数に値を割り当てる場合には、番号変数を使用してください。

  テンプレート・ファイルの対応する変数は、$1 から $9 です。

  この引き数の各インスタンスの場合、指示された順序で 2 つの部分を指定してください。

  - テンプレート・ファイルにある変数と一致する 1 から 9 までの整数値です。先頭にドル記号は付けません。
  - 変数の値として割り当てる英数字の文字列。

  詳細については、AFS 管理の手引き の uss の章を参照してください。

-cell
  コマンドを実行するセルを指定します。詳細については、uss の解説ページを参照してください。

-admin
  ユーザー・アカウントのさまざまなコンポーネントを保守する AFS サーバー・プロセスとの認証接続で使用する AFS ユーザー名を指定します。詳細については、uss の解説ページを参照してください。

-dryrun
  コマンド・インタープリターが、コマンドの実行中に、実際には実行していなくても実行する必要があるアクションを報告します。詳細については、uss の解説ページを参照してください。

-skipauth
  Kerberos を使用するサイトにその認証フォームの置換を許可し、AFS 認証サーバーでの認証を不可にします。

-overwrite
  -template 引き数で指定されたテンプレート・ファイルにある D 、E、 F、L、または S 命令の定義に従って、ファイル・システムにあるディレクトリー、ファイルおよびリンクを上書きします。このフラグを省略すると、コマンド・インタープリターは、プロンプトを 1 回出して、すべての要素を上書きするかどうかを確認します。

-help
  このコマンドのオンライン・ヘルプを出力します。これ以外の有効なオプションはすべて無視されます。

例

次の例では、uss.tpl と呼ばれるテンプレート・ファイルにある uss add コマンドおよび V 命令の組み合わせで、 smith という名前の保護および認証データベース項目、およびパス名 /afs/example.com/usr/smith でマウントされた 2500 KB ブロックの割り当て量がある `user.smith` というボリュームを作成しています。マウント・ポイントのアクセス制御リスト (ACL) は、 smith にすべての権限を許可しています。

uss add コマンドの発行側は、完全パス名ではなく、テンプレート・ファイル名のみを指定します。完全パス名が現在の作業ディレクトリーに存在しているためです。読みやすくするために、ここではコマンドおよび V 命令を 2 行に分けていますが、実際の命令およびコマンドは、1 行で入力してください。

       V user.$USER $SERVER.example.com /vice$PART $1   \
            /afs/example.com/usr/$USER $UID $USER all

       % uss add  -user smith -realname "John Smith" -pass js_pswd -server fs2   \
                  -partition b -template uss.tpl -var 1 2500

必要となる特権

発行側 (または -admin 引き数で指定されたユーザー) は、保護データベースの system:administrators グループに所属して、発行側の認証データベース項目で `ADMIN` フラグをオンにする必要があります。

テンプレートに V 命令が含まれている場合、発行者が /usr/afs/etc/UserList ファイルにリストされていて、少なくとも a (administer) および i (insert) 許可が、新規マウント・ポイントを含むディレクトリーの ACL になければなりません。テンプレート・ファイルに、他のタイプのオブジェクト (ディレクトリー、ファイル、またはリンク) を作成する命令がある場合、発行者には、それらの命令を作成するのに必要なそれぞれの特権がなければなりません。

関連情報

UserList

uss テンプレート・ファイル

fs mkmount

uss

uss bulk

uss delete

[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]

(C) IBM Corporation 2000. All Rights Reserved