PW(8) FreeBSD システム管理者マニュアル PW(8)
名称
|
pw − システムユーザ、グループの作成、削除、変更、表示 |
書式
|
pw [−V etcdir] useradd [name|uid] [−C config] [−q] [−n name] [−u uid] [−c comment] [−d dir] [−e date] [−p date] [−g group] [−G grouplist] [−m] [−k dir] [−w method] [−s shell] [−o] [−L class] [−h fd | −H fd] [−N] [−P] [−Y] |
|
pw [−V etcdir] useradd [name|uid] −D [−C config] [−q] [−b dir] [−e days] [−p days] [−g group] [−G grouplist] [−k dir] [−u min,max] [−i min,max] [−w method] [−s shell] [−y path] |
|
pw [−V etcdir] userdel [name|uid] [−n name] [−u uid] [−r] [−Y] |
|
pw [−V etcdir] usermod [name|uid] [−C config] [−q] [−n name] [−u uid] [−c comment] [−d dir] [−e date] [−p date] [−g group] [−G grouplist] [−l name] [−m] [−k dir] [−w method] [−s shell] [−L class] [−h fd | −H fd] [−N] [−P] [−Y] |
|
pw [−V etcdir] usershow [name|uid] [−n name] [−u uid] [−F] [−P] [−7] [−a] |
|
pw [−V etcdir] usernext [−C config] [−q] |
|
pw [−V etcdir] groupadd [group|gid] [−C config] [−q] [−n group] [−g gid] [−M members] [−o] [−h fd | −H fd] [−N] [−P] [−Y] |
|
pw [−V etcdir] groupdel [group|gid] [−n name] [−g gid] [−Y] |
|
pw [−V etcdir] groupmod [group|gid] [−C config] [−q] [−n name] [−g gid] [−l name] [−M members] [−m newmembers] [−h fd | −H fd] [−N] [−P] [−Y] |
|
pw [−V etcdir] groupshow [group|gid] [−n name] [−g gid] [−F] [−P] [−a] |
|
pw [−V etcdir] groupnext [−C config] [−q] |
|
pw [−V etcdir] lock [name|uid] [−C config] [−q] |
|
pw [−V etcdir] unlock [name|uid] [−C config] [−q] |
|
解説 |
|
pw ユーティリティは、システムの user 、 group ファイルのユーザ、グループ を簡単に、標準的な方法で追加、変更、削除することができるようにするコマン ドライン版のエディタです。 pw は、ローカルな user ファイルと group ファイ ルを操作することができるだけだということに注意して下さい。 NIS のユーザ、 グループは NIS サーバ上で管理しなければなりません。 pw ユーティリティは passwd, master.passwd, group ファイルや、安全なまたは安全でないパスワード データベースファイルの更新作業を行いますので、 root で実行されなければな りません。 pw のコマンドラインにかかれている最初の一つか二つのキーワードは、引数の残 りを解釈する際の文脈を指定します。 user と group のキーワードはどちらも、 add, del, mod, show, next と組み合わせて用いることができ、どのような順序 (例えば showuser, usershow, show user, user show はすべて同じこととみなさ れます) で指定してもかまいません。この柔軟性は、ユーザ、グループデータ ベース操作のために pw を呼び出す対話的なスクリプトには便利です。 −n name, −u uid, −g gid オプションを使う代わりに、これらのキーワードに続けてユーザ 名、グループ名、数字の ID のうち一つを指定することができます。 以下のフラグは操作のほとんどまたは全てのモードで共通です。 |
−V etcdir
|
本フラグは、パスワードファイル・グループファイル・設定ファ イルを探すための、通常とは別の場所をセットします。また、通 常とは別の場所でユーザ/グループデータベースを管理するために 使用可能です。本スイッチを指定すると、システムの /etc/pw.conf をデフォルト設定データをしては使用せず、代り に、指定したディレクトリ中のファイル pw.conf を使用します ( 存在しない場合には使用しません)。 −C フラグは、この動作に優 先します。一般規則では、オプションは操作タイプに後続する必 要があるのですが、 −V フラグは例外であり、コマンドライン上 で操作キーワードの前で使用可能です。 −C config −q −N −Y ユーザオプション |
|
以下のオプションは useradd と usermod コマンドに付けます: |
−n name
|
ユーザ名/アカウント名を指定します。 −u uid アカウント名は uid を含み、逆も同様であるため、通常これらの オプションのどちらか片方しか必要ではありません。しかし、両 方を指定しなければならないこともしばしばあります。例えば、 すでに存在するユーザの uid を usermod で変えたり、新しいア カウントを作るときにデフォルトの uid を上書きしたりするとき です。 pw で useradd を使って新しいユーザに uid を自動的に 割り当てたい場合は、 −u オプションを使っては いけません。コ マンドライン上で useradd, userdel, usermod, usershow キー ワードの直後なら、アカウントとユーザIDのどちらかを −n や −u を使わずにそのまま続けて書くことができます。 −c comment −d dir −e date −p date −g group −G grouplist −L class −m ユーザのホームディレクトリが作成されるとき、デフォルトで は、 −b dir オプション (下記参照) で指定された basehome ディレクトリのサブディレクトリとして作られ、アカウント名と 同じ名前が付けられます。コマンドラインに −d dir オプション を付けると、上書きするようにすることもできます。 −k dir −s shell −h fd 引数 fd として ‘-’ が与えられると、パスワードとして ‘*’ が セットされ、そのアカウントにはパスワードを使ってログインす ることができないようになります。 −H fd useradd を使うことで、存在するユーザ ID と重複する新しいアカウントを作成 することができるようになります。これは普通エラーになって拒否されますが、 −o オプションにより、重複チェックを上書きしユーザ ID の重複を許すことにな ります。これは、同一のユーザが異なるコンテキスト(異なるグループ割り当てや 異なるホームディレクトリ、異なるシェル)でログインするのを許可する場合に、 各アカウントに基本的に同一のアクセス権を与える場合に使用できます。 useradd コマンドは −D オプションを使うことで新しいユーザとグループのデ フォルトも設定できます。新しいユーザを付け加える代わりに、 pw は設定ファ イル /etc/pw.conf に新しいデフォルトのセットを書き込みます。 −D オプショ ンを使う場合、 −n name や −u uid を使ってはいけません。そうでないとエラー になります。 −D を使うと、 useradd コマンドのいくつかのコマンドラインス イッチの意味が変わります。それは: −D −b dir −e days −p days −g group −G grouplist −L class −k dir −u min,max, −i
min,max −w method no ‘random’ や ‘no’ method は、最も安全です。前者の場合、 pw はパスワードを生成し、標準出力に出力します。このパスワード は、ユーザがそのアカウントにアクセスするパスワードとしてあ なたが発行しますが、ユーザ自身が自分のパスワードを指定 (多 分ひどい選択です) するものより適切です。 ‘no’ method にした 場合、パスワードでアクセスできるアカウントを与えるために スーパユーザが passwd(1) を使わなければなりません。 −y path userdel コマンドには指定可能なオプションは 3 つしかありません。 −n name と −u uid オプションは、既に説明したとおりです。追加のオプションは以下の ものです。 −r メールスプールファイルと crontab は、ユーザ名に無条件に付属しているものな ので、アカウントが削除されたとき常に削除されます。 at コマンドによって処 理待ちのキューに入っているジョブも、ユーザの uid がユニークであり、かつ、 そのシステムの別のアカウントに使われていない場合は削除されます。 usershow コマンドは、二種類のフォーマットでアカウントを閲覧できます。 フォーマットは、デフォルトで /etc/master.passwd で使われているものと同じ で、パスワードフィールドは ‘*’ に置き換えられています。 −P オプションが使 われると、 pw はより人間に読みやすい形でアカウントの詳細を出力します。 −7 オプションが使われると、アカウントの詳細が v7 フォーマットで表示されま す。 −a オプションは、現在ファイルにあるすべてのユーザをリストします。 −F を使用すると、存在しないアカウントであってもその詳細を表示するよう、 pw に強制します。 usernext コマンドは、利用可能な次のユーザ ID とグループ ID をコロン区切り で返します。これは、通常 pw を使う対話的なスクリプトやフロントエンド用で す。 グループオプション |
|
グループを操作するコマンドには、 − と −q オプション (前セクションの始めに 説明があります) が使えます。他のグループ関係のコマンド: |
−n name
|
グループ名を指定します。 −g gid グループ名は uid を意味し、逆も同様なので、アカウント名と ID フィールドとして、普通どちらか一つを付ければよいので す。両方を指定する必要があるのは、新しいグループに指定した グループ ID を設定するとき、または存在するグループの uid を変えたいときだけです。 −M memberlist −m newmembers groupadd にも、存在するグループ ID を新しいグループに割り当てる −o オプ ションがあります。デフォルトの動作は、グループ追加の試みを拒否することに なっており、このオプションはグループ ID の重複チェックを上書きします。グ ループ ID を重複させる必要は滅多にありません。 groupmod コマンドには、一つの追加オプションがあります: −l name groupshow へのオプションは −u uid の代わりにグループ ID を指定する −g gid を付けた usershow と同じです。 −7 オプションは、 groupshow コマンドには適 用されません。 groupnext コマンドは、次に使用できるグループ ID を標準出力に返します。 ユーザのロック |
|
pw ユーティリティは、ユーザに対する簡単なパスワードロック機構を持ちます。 これは、文字列 ‘*LOCKED*’ を master.passwd のパスワードフィールドに前置 し、認証を失敗させることにより機能します。 lock と unlock のコマンドはユーザ名または UID を取り、それぞれ当該アカウ ントをロック/アンロックします。これらのコマンドは、前述の −V, −C, −q オプ ションを受け付けます。 |
診断
|
pw ユーティリティは、操作に成功すると EXIT_SUCCESS を返し、そうでなければ sysexits(3) により定義された以下の戻り値のうちどれかひとつを返します: |
EX_USAGE
|
• コマンドラインのシンタックスエラー (不適切なキーワード、未定義 オプション)。 EX_NOPERM EX_OSERR EX_DATAERR EX_OSFILE EX_NOUSER EX_SOFTWARE EX_IOERR EX_CONFIG 注 |
|
各コマンドに使用可能なオプションの要約として、 |
|
pw [command] help |
|
が使えます。例えば、 |
|
pw useradd help |
|
は useradd 操作に使用できるすべてのオプションをリストします。 pw ユーティリティは、passwd ファイルの GECOS フィールド (ユーザの姓名、オ フィス、業務用電話番号、自宅電話番号のサブフィールドがあります) に 8 ビッ ト文字を使うことができます。しかし、8 ビット文字をユーザログイン名やグ ループ名に使うことはできません。8 ビット文字の使用に際して、以下の点に注 意してください。インターネットとの接続に際しては、メール配送プログラムが 8BITMIME をサポートしていることが要求されており、8 ビット文字を含むヘッダ は 7 ビットの quoted-printable フォーマットに変換されてしまいます。 sendmail(8) はこの機能をサポートしています。 GECOS フィールドに 8 ビット 文字を置く際は、ユーザのデフォルトロケールとデフォルト文字集合といっしょ に使用するべきで、これらを使用せずに実装してはいけません。 8 ビット文字の 使用は、 fingerd(8) のように、インターネット経由で GECOS フィールドの内容 をやりとりする他のプログラムにも影響を及ぼす可能性があります。 TCP/IP ク ライアントの中には、IRC のように、少数ながらもパスワードファイルに指定さ れたフルネームをデフォルトで使用するものもあります。 ユーザやグループの追加や削除のときに、 pw ユーティリティは、ログファイル を /var/log/userlog ファイルへ書きます。このログファイルの位置は pw.conf(5) で変更可能です。 |
関連ファイル
/etc/master.passwd
|
ユーザデータベース 関連項目 |
|
chpass(1), passwd(1), group(5), login.conf(5), passwd(5), pw.conf(5), pwd_mkdb(8), vipw(8) |
歴史
|
pw ユーティリティは、SYSV の shadow サポートで使われていた多くのオプショ ンを模倣して書かれましたが、 4.4BSD オペレーティングシステムに特有のパス ワードフィールド、グループフィールドに合わせて変更されています。また、ほ とんどの要素が一つのコマンドにまとめられています。 FreeBSD 10.0 January 11, 2004 FreeBSD 10.0 |