imported>Fire at 05:13, 5 November 2022

2022-11-05T05:13:50Z

New page

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''' と '''[[/usr/sbin/addgroup|addgroup]]''' は、コマンドラインオプションと [[/etc/adduser.conf]] の設定情報に従って、システムにユーザとグループを追加する。これらは '''[[/usr/sbin/useradd|useradd]]''', '''[[/usr/sbin/groupadd|groupadd]]''', '''[[/usr/sbin/usermod|usermod]]''' プログラムのような低レベルツールの友好的なフロントエンドで、デフォルトで Debian ポリシーに準拠した UID と GID 値を選択し、骨格構成でホームディレクトリを作成し、カスタムスクリプトを実行し、その他の機能を備えている。'''adduser''' と '''[[/usr/sbin/addgroup|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
:パスワードを設定するために'''[[/usr/sbin/passwd|passwd]]'''を実行しない。パスワードが設定されるまで、ユーザーは自分のアカウントを使用することができない。

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

;--force-badname
:デフォルトでは、ユーザ名とグループ名は設定ファイルで指定された設定可能な正規表現'''NAME_REGEX'''と照合される。このオプションは、'''adduser'''と'''addgroup'''に名前の妥当性についての弱いチェックのみを適用させる。'''NAME_REGEX''' は [[/etc/adduser.conf|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'''ですでに存在したため、作成に失敗した。ユーザー名またはグループ名が、設定された正規表現と不一致のため拒否された。[[/etc/adduser.conf|adduser.conf]] を参照すること。'''adduser''' はシグナルによって中断される。あるいは、コンソールに表示される、まだ文書化されていない他の多くの理由。この場合、'''adduser''' をより詳細にするために、'''--quiet''' を削除することを考慮してもよい。

== FILES ==
;[[/etc/adduser.conf]]
:'''adduser'''と'''addgroup'''のデフォルト configuration file

;[[/usr/local/sbin/adduser.local]]
:オプションカスタムアドオン

== SEE ALSO ==
'''[[/etc/adduser.conf|adduser.conf]]''',
'''[[/usr/sbin/deluser|deluser]]''',
'''[[/usr/sbin/groupadd|groupadd]]''',
'''[[/usr/sbin/useradd|useradd]]''',
'''[[/usr/sbin/usermod|usermod]]''',
[https://www.debian.or.jp/community/devel/debian-policy-ja/policy.ja.html/ 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.

{{Linux}}
{{Debian|https://manpages.debian.org/bullseye/adduser/adduser.8.en.html}}

[[category:/usr/sbin|adduser]]
[[Category:adduser|adduser]]
[[category:ユーザ管理|adduser.conf]]

/usr/sbin/adduser - Revision history

imported>Fire at 05:13, 5 November 2022