imported>Fire: /* Changing the default values */

2022-11-07T11:11:27Z

Changing the default values

New page

新規ユーザーの作成またはデフォルトの新規ユーザー情報の更新

== How to use ==

'''useradd [オプション] ユーザ名''' でユーザが作れるが、オプションをいっぱい指定しないといけないので、対話形式で初期設定もすべてできる、'''[[/usr/sbin/adduser|adduser]]'''を利用した方が楽

== Setting ==
/etc/default/useradd を編集しデフォルト値を設定

{| class="wikitable"
|+ Variable List
|-
! Variable !! Description
|-
| SHELL || Login Shell
|-
| GROUP || Group ID
|-
| HOME || Home directory
|-
| INACTIVE || Password 無効化までの日数。-1だとexpire無し
|-
| EXPIRE || Userの有効化日数
|-
| SKEL || [[/etc/skel|スケルトン(雛形)]] directory の指定
|-
| CREATE_MAIL_SPOOL || yes: メールボックス作成, no: メールボックス作成しない
|}

== SYNOPSIS ==
:'''useradd''' [options] LOGIN

:'''useradd''' -D

:'''useradd''' -D [options]

== DESCRIPTION ==
'''useradd''' は、ユーザを追加するための低レベルのユーティリティである。Debian では、管理者は通常'''[[/usr/sbin/adduser|adduser]]''' を代わりに使うべきである。

D オプションを付けずに起動すると、'''useradd''' コマンドはコマンドラインで指定された値とシステムのデフォルト値を使用して新しいユーザーアカウントを作成する。

コマンドラインで指定された値とシステムのデフォルト値を使用して新しいユーザーアカウントを作成する。
コマンドライン・オプションによっては、'''useradd''' コマンドはシステム・ファイルを更新し、新しいユーザのホーム・ディレクトリを作成し、初期ファイルをコピーすることができる。

デフォルトでは、新しいユーザー用にグループも作成される ('''-g'''、'''-N'''、'''-U'''、および '''USERGROUPS_ENAB''' を参照)。

== OPTIONS ==
{{hidden begin|toggle=left|title=option list|titlestyle = background:lightgrey;}}

;'''--badname'''
:規格外の名称を許可する
;'''-b''', '''--base-dir''' BASE_DIR
:'''-d''' HOME_DIR が指定されない場合のシステムのデフォルトのベースディレクトリ。 BASE_DIR は、アカウント名と結合してホーム・ディレクトリを定義する。'''-m''' オプションが使用されない場合、BASE_DIR は存在しなければならない。
:このオプションが指定されない場合、'''useradd'''は[[/etc/default/useradd]] の'''HOME'''変数で指定されたベースディレクトリを使用しする。つまり、デフォルトでの /home を使用する。
;'''-c''', '''--comment''' COMMENT
:任意のテキスト文字列。これは一般的にログインの短い説明であり、現在はユーザーのフルネームのフィールドとして使用されている。
;'''-d''', '''--home-dir''' HOME_DIR
:新しいユーザーは、ユーザーのログインディレクトリの値としてHOME_DIRを使用して作成される。デフォルトでは、BASE_DIR に LOGIN 名を付加し、それをログイン・ディレクトリ名として使用する。このとき、ディレクトリHOME_DIRは存在する必要はないが、存在しない場合は作成されない。
;'''-D''', '''--defaults'''
:以下のサブセクション「[[#Changing the default values]]」を参照してください。
;'''-e''', '''--expiredate''' EXPIRE_DATE
:ユーザーアカウントが無効になる日付。日付は、YYYY-MM-DDの形式で指定する。
:指定されない場合、'''useradd'''は、[[/etc/default/useradd]]の'''EXPIRE'''変数で指定されたデフォルトの有効期限を使用する。つまり、デフォルトの-1(有効期限なし)を使用する
;'''-g''', '''--gid''' GROUP
:ユーザーの初期ログイン時のグループ名または番号。グループ名は必ず存在する必要がある。グループ番号は、すでに存在するグループを参照しなければならない。
:指定されない場合、useraddの動作は、[[/etc/login.defs]]の'''USERGROUPS_ENAB'''変数に依存する。この変数がyesに設定されている場合（またはコマンドラインで'''-U/--user-group'''が指定されている場合）、そのユーザーの loginname と同じ名前のグループが作成される。この変数が no に設定されている場合 (または、コマンドラインで '''-N/--no-user-group''' が指定されている場合)、 '''useradd''' は、[[/etc/default/useradd]] の '''GROUP''' 変数で指定された値、つまりデフォルトの 100 に設定する。
;'''-G''', '''--groups''' GROUP1[,GROUP2,...[,GROUPN]]]
:ユーザーが所属している補助グループのリストである。各グループはカンマで区切られ、空白は含まない。グループには、'''-g'''オプションで指定したグループと同じ制限が適用される。デフォルトでは、ユーザは最初のグループにのみ所属する。
;'''-h''', '''--help'''
:ヘルプメッセージを表示し、終了する
;'''-k''', '''--skel''' SKEL_DIR
:'''useradd'''でホームディレクトリを作成したときに、ユーザのホームディレクトリにコピーするファイルやディレクトリを含むスケルトンディレクトリである。
:このオプションは、'''-m''' (または '''--create-home''') オプションが指定されたときのみ有効である。
:このオプションが設定されていない場合、スケルトンディレクトリは、[[/etc/default/useradd]]の'''SKEL'''変数で定義される。つまり /etc/skel が設定される。
:可能であれば、'''ACL''と拡張属性がコピーされる。
;'''-K''', '''--key''' KEY=VALUE
:[[/etc/login.defs]] のデフォルト ('''UID_MIN''', '''UID_MAX''', '''UMASK''', '''PASS_MAX_DAYS''', その他) を上書きする。
:例: '''-K''' PASS_MAX_DAYS=-1 は、システムアカウントを作るときに使い、パスワードが設定されてない時であってもパスワードの停止を止めることができる。'''-K''' オプションは複数指定可能である。例:'''-K''' UID_MIN=100 '''-K''' UID_MAX=499
;'''-l''', '''--no-log-init'''
:ユーザーをlastlogおよびfaillogデータベースに追加しない。
:デフォルトでは、以前削除されたユーザのエントリを再利用しないように、 [[/usr/bin/lastlog|lastlog]] および [[/usr/bin/faillog|faillog]] データベース内のユーザのエントリはリセットされる。
:以前のDebianの'''useradd'''との互換性を保つために，'''-o'''オプションもサポートされている．
;'''-m''', '''--create-home'''
:ユーザーのホームディレクトリが存在しない場合は、作成する。スケルトン・ディレクトリ（'''-k'''オプションで定義可能）に含まれるファイルとディレクトリは、ホーム・ディレクトリにコピーされる。
:デフォルトでは、このオプションが指定されず、'''CREATE_HOME'''が有効になっていない場合、ホーム・ディレクトリは作成されない。
;'''-M''', '''--no-create-home'''
:[[/etc/login.defs]]('''CREATE_HOME''')が、yesに設定されている場合でもホームディレクトリを作成しない。
；'''-N''', '''--no-user-group'''
:ユーザと同じ名前のグループを作成しないが、'''-g'''オプションあるいは、[[/etc/default/useradd]]の'''GROUP'''変数で指定されるグループを付与する。
:'''-g''', '''-N''', '''-U'''オプションが指定されない場合のデフォルトの動作は、[[/etc/login.defs]]の'''USERGROUPS_ENAB'''で定義される。
;'''-o''', '''--non-unique'''
:重複(non-unique) UIDを持つユーザアカウントの作成を許容する。
:このオプションは、'''-u'''オプションとの組み合わせでのみ有効。
;'''-p''', '''--password''' PASSWORD
:[https://manpages.org/crypt/3 crypt(3)] が返すような、暗号化されたパスワード。デフォルトでは、パスワードは無効になっている。
:'''注意:''' パスワード (または暗号化されたパスワード) はプロセスを一覧表示するユーザから見えるため、このオプションは推奨されない。
:パスワードがシステムのパスワードポリシーを尊重することを確認する必要がある。
;'''-r''', '''--system'''
:システムアカウントを作成する。
:システムユーザーは [[/etc/shadow]] にエイジング情報がない状態で作成され、その数値識別子は [[/etc/login.defs]] で定義されている '''SYS_UID_MIN-SYS_UID_MAX''' の範囲から選ばれるが、その代わりに '''UID_MIN-UID_MAX'''（およびグループ作成時の'''GID'''対応）ではなく、[[/etc/login.defs]]で定義された'''SYS_UID_MIN-SYS_UID_MAX'''の範囲で選ばれる。
:'''useradd''' は、[[/etc/login.defs]] ('''CREATE_HOME''')のデフォルト設定にかかわらず、そのユーザーのホームディレクトリを作成しないことに注意すること。システム・アカウントのホーム・ディレクトリを作成したい場合は、'''-m''' オプションを指定する必要がある。
;'''-R''', '''--root''' CHROOT_DIR
:CHROOT_DIRディレクトリの変更を適用し、CHROOT_DIRディレクトリの設定ファイルを使用する。
;'''-P''', '''--prefix''' PREFIX_DIR
:PREFIX_DIR ディレクトリの変更を適用し、PREFIX_DIR ディレクトリの設定ファイルを使用します。このオプションは chroot しないので、クロスコンパイルターゲットを準備するためのものである。いくつかの制限事項がある。NIS および LDAP のユーザー/グループは検証されない。PAMの認証はhost ファイルを使用する。SELINUXのサポートはない。
;'''-s''', '''--shell''' SHELL
:ユーザのログインshellを変更します。デフォルトでは、このフィールドを空白になり、システムは [[/etc/default/useradd]] の '''SHELL''' 変数で指定されたデフォルトのログインシェルを選択する。
;'''-u''', '''--uid''' UID
:ユーザーIDの数値。この値は、'''-o'''オプションが使用されていない限り、一意でなければならない。このは負であってはならない。デフォルトは、'''UID_MIN'''以上かつ他のユーザーより大きい最小のID値を使用する。
:'''-r'''オプションと'''UID_MAX'''の説明も参照すること。
;'''-U''', '''--user-group'''
:ユーザの名前を持つグループを作成し、ユーザをこのグループに加える。
:'''-g''', '''-N''', '''-U'''オプションが指定されない場合のデフォルトの動作は、[[/etc/login.defs]]の'''USERGROUPS_ENAB'''変数で定義される。
;'''-Z''', '''--selinux-user''' SEUSER
:ユーザログインに使用するSELinux user。このフィールドを空白にしておくと、システムはデフォルトのSELinuxユーザーを選択する。
{{hidden end}}

== Changing the default values ==
'''-D'''オプションのみを指定して起動した場合、'''useradd'''は現在のデフォルト値を表示する。'''-D'''オプションと他のオプションを指定して起動すると、'''useradd'''は指定されたオプションの既定値を更新する。有効なデフォルト値を変更する有効なオプションは次のとおり:

;'''-b''', '''--base-dir''' BASE_DIR
:新しいユーザのホームディレクトリのpath prefix。新規アカウント作成時に '''-d''' オプションを使用しなかった場合、ユーザ名が '''BASE_DIR''' の末尾につけられ、新規ユーザのホームディレクトリ名となる。
:このオプションは、[[/etc/default/useradd]]の'''HOME'''変数にセットされる。
;'''-e''', '''--expiredate''' EXPIRE_DATE
:ユーザアカウントが無効となる日付
:このオプションは、[[/etc/default/useradd]]の'''EXPIRE'''変数にセットされる。
;'''-f''', '''--inactive''' INACTIVE
:アカウントが無効になる前にパスワードが期限切れになる日数。
:このオプションは、[[/etc/default/useradd]]の'''INACTIVE'''変数にセットされる。
;'''-g''', '''--gid''' GROUP
:新しいユーザーの最初のグループのグループ名またはID ('''-N/--no-user-group''' が使われている場合、または [[/etc/login.defs]] で '''USERGROUPS_ENAB''' 変数が no に設定されている場合)。指定されたグループは存在しなければならず、また数値のグループIDは、既存のエントリを持つ必要がある。
:このオプションは、[[/etc/default/useradd]]の'''GROUP'''変数にセットされる。
;'''-s''', '''--shell''' SHELL
:新しいユーザのログインshell名称
:このオプションは、[[/etc/default/useradd]]の'''SHELL'''変数にセットされる。

== NOTES ==
システム管理者は、デフォルトのユーザーファイルを [[/etc/skel]] ディレクトリ(または [[/etc/default/useradd]] やコマンドラインで指定された他のスケルトンディレクトリ) に配置する責任がある。

== CAVEATS ==
NISやLDAPのグループにユーザーを追加することはできない。これは、対応するサーバー上で実行する必要がある。

同様に、ユーザ名が NIS や LDAP などの外部ユーザ・データベースに既に存在する場合、'''useradd''' はユーザーアカウント作成要求を拒否する。

通常、小文字またはアンダースコアで始まり、その後に小文字、数字、アンダースコア、ダッシュを続けたユーザー名のみを使用することが推奨される。また、ドル記号で終わることも可能である。正規表現では [a-z_][a-z0-9_-]*[$]?

Debian では、ユーザ名がダッシュ ('-') やプラス ('+') で始まってはいけないという制約があるだけである。チルダ ('~')、コロン (':')、カンマ (',')、空白 (スペース: ', 行末:') を含んではいけない。また、コロン(':')、カンマ(',')、空白(スペース： ' '、行末： '\n'、タブ： '\t'、など)も含まれない。スラッシュ('/')を使用すると、ユーザーのホームディレクトリを定義するためのデフォルトのアルゴリズムが壊れることがある。

ユーザー名の長さは最大32文字までである。

== CONFIGURATION ==
[[/etc/login.defs]]にある以下の設定変数で、このツールの動作が変わる:

{{hidden begin||toggle = left|title=configuration items||titlestyle = background:lightgrey;}}
;'''CREATE_HOME''' (boolean)
:新規ユーザーのために、ホームディレクトリをデフォルトで作成するかどうかを指定する。
:この設定はシステム・ユーザーには適用されず、コマンドラインで上書きすることができる。
;'''GID_MAX''' (number), '''GID_MIN''' (number)
:'''useradd''', '''[[/usr/sbin/groupadd|groupadd]]''', '''[[/usr/sbin/newusers|newusers]]'''で通常のグループを作成する際に使用するグループIDの範囲である。
:GID_MIN (resp. GID_MAX) のデフォルト値は1000 (resp. 60000)である。
;'''HOME_MODE''' (number)
:新しいホームディレクトリのためのモード。指定されない場合、'''UMASK''' がモードを作成するために使用される。
:'''useradd''' と '''[[/usr/sbin/newusers|newusers]]''' は、作成するホームディレクトリのモードを設定するためにこれを使用する。
;'''LASTLOG_UID_MAX''' (number)
:[[/usr/bin/lastlog|lastlog]]エントリーを更新すべき最も高いユーザーID番号。より高いユーザーIDは、通常、リモート・ユーザー・アイデンティティおよび認証サービスによって追跡されるため、そのための巨大な無駄な lastlog ファイルを作成する必要はない。
:'''LASTLOG_UID_MAX''' オプションが設定にない場合は、 lastlog エントリの書き込みにユーザ ID の制限がないことを意味する。
;'''MAIL_DIR''' (string)
:メールスプールディレクトリである。これは、対応するユーザーアカウントが変更または削除されたときに、メールボックスを操作するために必要である。　指定されない場合、コンパイル時のデフォルトが使用される。
;'''MAIL_FILE''' (string)
:ユーザのメールスプールファイルの場所をホームディレクトリと相対的に定義する。
:'''MAIL_DIR''' と '''MAIL_FILE''' 変数は '''useradd''', '''[[/usr/sbin/usermod|usermod]]''', '''[[/usr/sbin/userdel|userdel]]''' によって、ユーザのメール・スプールを作成、移動、削除するために使われる。
;'''MAX_MEMBERS_PER_GROUP''' (number)
:グループエントリあたりの最大メンバー数。最大値に達すると、[[/etc/group]]に新しいグループエントリ（行）が開始される（同じ名前、同じパスワード、同じ'''GID'''で）。
:デフォルト値は0である。つまり、グループ内のメンバー数に制限はない。
:この機能(split group)は、グループ・ファイルの行の長さを制限することを許可する。これは、NISグループの行が1024文字より大きくないことを確認するのに便利である。
:このような制限を強制する必要がある場合は、25 を使用できる。
:注意：分割グループは、すべてのツールでサポートされていない場合がある（Shadow toolsuite でも）。本当に必要でない限り、この変数を使用するべきではない。
;'''PASS_MAX_DAYS''' (number)
:パスワードが使用できる最大日数である。これより古いパスワードの場合、パスワードの変更が強制される。指定しない場合は、-1が想定される（制限を解除する）。
;'''PASS_WARN_AGE''' (number)
:パスワードの有効期限が切れるまでの警告日数。0は、有効期限切れ当日にのみ警告が出されることを意味し、負の値は警告が出されないことを意味する。指定しない場合は、警告は行われない。
;'''SUB_GID_MIN''' (number), '''SUB_GID_MAX''' (number), '''SUB_GID_COUNT''' (number)
:[[/etc/subuid]] が存在する場合、'''useradd''' と '''[[/usr/sbin/newusers|newusers]]''' コマンドは (すでに下位のグループ ID を持っていない限り) 各新規ユーザに対して '''SUB_GID_MIN''' から '''SUB_GID_MAX''' の範囲から未使用のグループ ID を割り当てる。
:'''SUB_GID_MIN''', '''SUB_GID_MAX''', '''SUB_GID_COUNT'''のデフォルト値はそれぞれ100000, 600100000, 65536である。
;'''SUB_UID_MIN''' (number), '''SUB_UID_MAX''' (number), '''SUB_UID_COUNT''' (number)
:[[/etc/subuid]] が存在する場合、'''useradd''' と '''[[/usr/sbin/newusers|newusers]]''' コマンドは (すでに下位のユーザ ID を持っていない限り) 各新規ユーザに対して '''SUB_UID_MIN''' から '''SUB_UID_MAX''' までの範囲から未使用のユーザ ID '''SUB_UID_COUNT''' を割り当てる。
:'''SUB_UID_MIN''', '''SUB_UID_MAX''', '''SUB_UID_COUNT'''のデフォルト値はそれぞれ100000, 600100000, 65536である。
;'''SYS_GID_MAX''' (number), '''SYS_GID_MIN''' (number)
:'''useradd''', '''[[/usr/sbin/groupadd|groupadd]]''', '''[[/usr/sbin/newusers|newusers]]'''によるシステムグループの作成に使用されるグループIDの範囲。
:'''SYS_GID_MIN''' (resp. '''SYS_GID_MAX''') のデフォルト値は 101 (resp. '''GID_MIN'''-1) である。
;'''SYS_UID_MAX''' (number), '''SYS_UID_MIN''' (number)
:'''useradd''','''[[/usr/sbin/newusers|newusers]]'''によるシステムユーザの作成に使用されるユーザIDの範囲。
:'''SYS_UID_MIN''' (resp. '''SYS_UID_MAX''') のデフォルト値は 101 (resp. '''UID_MIN'''-1) である。
;'''UID_MAX''' (number), '''UID_MIN''' (number)
:'''useradd''', '''[[/usr/sbin/newusers|newusers]]'''による一般ユーザの作成に使用されるユーザIDの範囲。
:'''UID_MIN''' (resp. '''UID_MAX''') のデフォルト値は 1000 (resp. 60000) である。
;'''UMASK''' (number)
:ファイルモード作成マスクはこの値で初期化される。指定されない場合、マスクは 022 に初期化される。
:'''useradd''' と '''[[/usr/sbin/newusers|newusers]]''' は、'''HOME_MODE''' が設定されていない場合、作成するホームディレクトリのモードを設定するためにこのマスクを使用する。
:また、'''pam_umask'''によって、デフォルトのumask値として使用される。
;'''USERGROUPS_ENAB''' (boolean)
:yesを設定すると、'''[[/usr/sbin/userdel|userdel]]'''は、そのユーザーのグループにメンバーがいなくなった場合に削除し、'''useradd'''はデフォルトでそのユーザーの名前のグループを作成する。
{{hidden end}}

== EXIT VALUES ==
'''useradd'''コマンドは、以下の値で終了する:

;0
:正常
;1
:パスワードファイルを更新できない
;2
:無効なコマンドシンタックス
;3
:無効なオプション引数
;4
:UIDはすでに使われている (そして'''-o'''ではない)
;6
:指定されたグループは存在しない
;9
:ユーザネームはすでに使われている
;10
:グループファイルを更新できない
;12
:ホームディレクトリを作成できない
;14
:SELinuxユーザマッピングを更新できない

== SEE ALSO ==
'''[[/usr/bin/chfn|chfn]]''',
'''[[/usr/bin/chsh|chsh]]''',
'''[[/usr/bin/passwd|passwd]]''',
'''[https://manpages.org/crypt/3 crypt(3)]''',
'''[[/usr/sbin/groupadd|groupadd]]''',
'''[[/usr/sbin/groupdel|groupdel]]''',
'''[[/usr/sbin/groupmod|groupmod]]''',
'''[[/etc/login.defs|login.defs]]''',
'''[[/usr/sbin/newusers|newusers]]''',
'''[[/etc/subgid|subgid]]''',
'''[[/etc/subuid|subuid]]''',
'''[[/usr/sbin/userdel|userdel]]''',
'''[[/usr/sbin/usermod|usermod]]'''

== External link ==

{{Linux}}

{{Debian|https://manpages.debian.org/bullseye/passwd/useradd.8.en.html}}
[[Category:/usr/sbin|useradd]]
[[Category:ユーザ管理|useradd]]
[[Category:passwd|useradd]]

/usr/sbin/useradd - Revision history

imported>Fire: /* Changing the default values */