/usr/sbin/adduser

adduser, addgroup - システムにユーザまたはグループを追加する

SYNOPSIS

adduser [options] [--home DIR] [--shell SHELL] [--no-create-home] [--uid ID] [--firstuid ID] [--lastuid ID] [--ingroup GROUP | --gid ID] [--disabled-password] [--disabled-login] [--gecos GECOS] [--add_extra_groups] user

adduser --system [options] [--home DIR] [--shell SHELL] [--no-create-home] [--uid ID] [--group | --ingroup GROUP | --gid ID] [--disabled-password] [--disabled-login] [--gecos GECOS] user

addgroup [options] [--gid ID] group

addgroup --system [options] [--gid ID] group

adduser [options] user group

COMMON OPTIONS

[--quiet] [--debug] [--force-badname] [--help|-h] [--version] [--conf FILE]

DESCRIPTION

adduser と addgroup は、コマンドラインオプションと /etc/adduser.conf の設定情報に従って、システムにユーザとグループを追加する。これらは useradd, groupadd, usermod プログラムのような低レベルツールの友好的なフロントエンドで、デフォルトで Debian ポリシーに準拠した UID と GID 値を選択し、骨格構成でホームディレクトリを作成し、カスタムスクリプトを実行し、 その他の機能を備えている。adduser と addgroup は 5 つのモードのいずれかで実行することができる:

Add a normal user

オプション以外の引数を 1 つ指定し、--system および --group オプションを指定せずに呼び出すと、 adduser は通常のユーザーを追加する。

adduser は、設定ファイルで通常ユーザー用に指定された範囲から、最初に利用可能な UID を選択する。 UID は、--uid オプションで上書きすることができる。

設定ファイルで指定された範囲は --firstuid と --lastuid オプションで上書きすることができる。

デフォルトでは、Debian GNU/Linuxの各ユーザーは、同じ名前の対応するグループを与えられる。 ユーザグループは、適切なユーザを新しいグループに入れ、ディレクトリに set-group-ID ビットを設定し、すべてのユーザが 002 の umask を使うようにすることで、グループ書き込み可能なディレクトリを簡単に保守できるようにする。 USERGROUPSをnoに設定してこのオプションをオフにした場合、すべてのユーザーのGIDはUSERS_GIDに設定される。ユーザーのプライマリーグループは、コマンドラインから--gidまたは--ingroupオプションを使用して、それぞれidまたはnameでグループを設定することによっても上書きすることができる。 また、adduser.conf で ADD_EXTRA_GROUPS を 1 に設定するか、コマンドラインで --add_extra_groups を渡せば、adduser.conf で定義された 1 つまたは複数のグループにユーザーを追加することができる。

adduserは、DHOME、GROUPHOMES、LETTERHOMESに従ったホームディレクトリを作成する。 ホームディレクトリはコマンドラインから--homeオプションで、シェルはコマンドラインから--shellオプションで上書きすることができる。USERGROUPS が yes の場合、ホームディレクトリの set-group-ID ビットが設定され、 ユーザーのホームディレクトリに作成されるファイルが正しいグループを持つようになる。

adduser は、SKEL からホームディレクトリにファイルをコピーし、 finger (gecos) 情報とパスワードの入力を促す。 gecosは、--gecosオプションで設定することもできる。 --disabled-loginオプションを付けると、アカウントは作成されるが、 パスワードが設定されるまで無効化される。--disabled-passwordオプションでは、パスワードは設定されないが、ログインは可能である（SSHのRSA鍵など）。

ファイル /usr/local/sbin/adduser.local が存在する場合、ユーザーアカウントが設定された後に実行され、ローカル設定が行われる。 adduser.localに渡される引数は以下の通りである:

username uid gid home-directory

環境変数VERBOSEは、以下のルールに従って設定される:

0 --quiet が指定されている場合

1 --quietと--debugのどちらも指定されていない場合

2 --debugが指定されている場合

(変数DEBUGも同様であるが、DEBUGは非推奨で、adduserの後のバージョンで削除される予定である)

Add a system user

1 つの非オプション引数と --system オプションを付けて呼ばれた場合、 adduser はシステムユーザを追加する。 同名のユーザーがすでにシステムの uid 範囲に存在する場合 (uid が指定された場合、その uid を持つユーザーがすでに存在する場合)、 adduser は警告を発して終了する。この警告は、--quiet を追加することで抑制することができる。

adduser は設定ファイルでシステムユーザー用に指定された範囲 (FIRST_SYSTEM_UID と LAST_SYSTEM_UID) から、最初に利用できる UID を選択する。特定のUIDを持ちたい場合は、--uidオプションで指定することができる。

デフォルトでは、システム・ユーザーは nogroup グループに配置される。 新しいシステム・ユーザーを既に存在するグループに配置するには、 --gid または --ingroup オプションを使用する。 新しいシステム・ユーザーを同じIDの新しいグループに入れるには、 --groupオプションを使用する。

ホームディレクトリは，通常のユーザーと同じ規則で作成される． 新しいシステム・ユーザーは、シェル /usr/sbin/nologin を持ち (--shell オプションで上書きされない限り)、ログインが無効になる。 スケルトン設定ファイルはコピーされない。

Add a user group

adduser を --group オプション付きで --system オプションなしで、または addgroup をそれぞれ呼び出すと、ユーザグループが追加される。

GIDは設定ファイルのシステムGIDに指定された範囲(FIRST_GID, LAST_GID)から選択される。この機構を無効にするには、--gid オプションを使用して GID を指定することができる。

グループはユーザー無しで作成される。

Add a system group

addgroup が --system オプション付きで呼び出された場合、システムグループが追加される。

GID は設定ファイルのシステム GID に指定された範囲 (FIRST_SYSTEM_GID, LAST_SYSTEM_GID) から選択される。このメカニズムを無効にするには、--gid オプションを使用して GID を指定する。

グループはユーザーを持たずに作成される。

Add an existing user to an existing group

2つの非オプション引数で呼び出された場合、adduserは既存のユーザーを既存のグループに追加する。

OPTIONS

--conf FILE

/etc/adduser.confの代わりにFILEを使用する

--disabled-login

パスワードを設定するためにpasswdを実行しない。 パスワードが設定されるまで、ユーザーは自分のアカウントを使用することができない。

--disabled-password

--disabled-login と同様であるが、ログインは可能である (たとえば SSH RSA 鍵を使用)、パスワード認証は使用しない。

--force-badname

デフォルトでは、ユーザ名とグループ名は設定ファイルで指定された設定可能な正規表現NAME_REGEXと照合される。このオプションは、adduserとaddgroupに名前の妥当性についての弱いチェックのみを適用させる。NAME_REGEX は adduser.conf に記載されている。

--gecos GECOS

このオプションが与えられると、adduser はfingerの情報を要求しない。

--gid ID

グループを作成するとき、このオプションは、新しいグループIDを与えられた番号にすることを強制する。 ユーザーを作成する場合、このオプションはそのユーザーをそのグループに入れる。

--group

systemと組み合わせた場合、システムユーザーと同じ名前とIDを持つグループを作成する。systemと組み合わせない場合は、指定された名前のグループが作成される。 これは、このプログラムがaddgroupとして起動された場合のデフォルトの動作である。

--help

簡単な説明を表示する

--home DIR

設定ファイルで指定されたデフォルトではなく、DIRをユーザのホームディレクトリとして使用する。 このディレクトリが存在しない場合は作成され、スケルトンファイルがコピーされる。

--shell SHELL

ユーザーのログインシェルとして、設定ファイルで指定されたデフォルトではなく、SHELLを使用する。

--ingroup GROUP

新しいユーザーを、設定ファイルのUSERS_GIDで定義されたユーザーグループまたはデフォルトグループではなく、GROUPに追加する。 これは、ユーザーのプライマリ・グループに影響する。 追加のグループを追加するには、add_extra_groups オプションを参照すること。

--no-create-home

ホームディレクトリが存在しない場合でも作成しない。

--quiet

警告とエラーだけを表示し、情報的なメッセージを表示しない。

--debug

詳細な情報を表示する。adduserの問題点を突き止めたい場合に有効である。

--system

Create a system user or group.

--uid ID

新しいユーザIDを強制的に指定する。ユーザIDが既に使われている場合、adduserは失敗する。

-firstuid ID

uidが選択される範囲の最初のuidを上書きする(設定ファイルで指定されたFIRST_UIDを上書きする)。

--lastuid ID

uid が選択される範囲の最後の uid を上書きする ( LAST_UID )。

--add_extra_groups

設定ファイルで定義された追加グループに新しいユーザーを追加する。

--version

バージョンと著作権情報を表示する。

EXIT VALUES

0

指定されたユーザーが存在する。これには2つの原因がある。adduserによってユーザーが作成されたか、またはadduserが起動される前にユーザーがすでにシステム上に存在していた。adduser が 0 を返している場合、以前と同じパラメータで 2 回目の adduser を起動しても 0 が返される。

1

ユーザーまたはグループが指定されたものとは別のUID/GIDですでに存在したため、作成に失敗した。ユーザー名またはグループ名が、設定された正規表現と不一致のため拒否された。adduser.conf を参照すること。adduser はシグナルによって中断される。あるいは、コンソールに表示される、まだ文書化されていない他の多くの理由。この場合、adduser をより詳細にするために、--quiet を削除することを考慮してもよい。

FILES

/etc/adduser.conf

adduserとaddgroupのデフォルト configuration file

/usr/local/sbin/adduser.local

オプションカスタムアドオン

SEE ALSO

adduser.conf, deluser, groupadd, useradd, usermod, Debian Policy 9.2.2.

COPYRIGHT

      Copyright (C) 1997, 1998, 1999 Guy Maor. Modifications by Roland Bauerschmidt  and  Marc  Haber.  Additional patches by Joerg Hoh and Stephen Gran.
      Copyright (C) 1995 Ted Hajek, with a great deal borrowed from the original Debian adduser
      Copyright (C) 1994 Ian Murdock.  adduser is free software; see the GNU General Public Licence version 2 or later for copying conditions.  There is no warranty.