Initial commit for Tizen
[profile/extras/shadow-utils.git] / man / id / useradd.8
1 .\" Copyright 1991 \- 1994, Julianne Frances Haugh
2 .\" All rights reserved.
3 .\"
4 .\" Pendistribusian dan penggunaan dalam bentuk source dan binary, dengan
5 .\" atau tanpa modifikasi, diperbolehkan asal syarat\-syarat ini dipenuhi :
6 .\" 1. Pendistribusian source code harus mempertahankan tulisan copyright
7 .\"    di atas, persyaratan ini, dan disclaimer berikut.
8 .\" 2. Pendistribusian dalam bentuk binary harus menampilkan copyright di atas,
9 .\"    persyaratan ini, dan disclaimer yang tercantum pada dokumentasi dan/
10 .\"    atau keterangan lainnya yang terdapat pada distribusi ini.
11 .\" 3. Nama Julianne F. Haugh atau nama\-nama kontributor lainnya tidak boleh
12 .\"    digunakan sebagai jaminan atau untuk mempromosikan produk yang berasal
13 .\"    dari software ini tanpa izin khusus tertulis.
14 .\"
15 .\" SOFTWARE INI DISEDIAKAN OLEH JULIE HAUGH DAN PARA KONTRIBUTOR DALAM BENTUK
16 .\" "APA ADANYA" DAN SEGALA PERNYATAAN ATAU JAMINAN, TERMASUK, TAPI TIDAK
17 .\" TERBATAS PADA, JAMINAN DALAM PENJUALAN DAN PENYESUAIAN UNTUK MAKSUD
18 .\" TERTENTU DILUAR TANGGUNG JAWABNYA.  JULIE HAUGH DAN PARA KONTRIBUTOR TIDAK
19 .\" BERTANGGUNG JAWAB PADA KERUSAKAN SECARA LANGSUNG, TIDAK LANGSUNG, KEBETULAN,
20 .\" TERTENTU, SESUAI CONTOH ATAU KERUSAKAN BERUNTUN (TERMASUK, TAPI TIDAK
21 .\" TERBATAS PADA MENDAPATKAN PRODUK DENGAN CARA PERTUKARAN ATAU JASA;
22 .\" KEHILANGAN DATA, ATAU PROFIT; ATAU TERHENTINYA BISNIS) YANG MENGAKIBATKAN
23 .\" DAN SECARA TEORI BERTANGGUNG JAWAB, MESKIPUN DALAM PERJANJIAN, BERTANGGUNG
24 .\" JAWAB PENUH, ATAU TORT (TERMASUK KECEROBOHAN ATAU SEBALIKNYA) YANG TIMBUL
25 .\" KARENA KESALAHAN DALAM MENGGUNAKAN SOFTWARE INI, BAHKAN JIKA TELAH
26 .\" DIPERINGATKAN SEBELUMNYA TENTANG KEMUNGKINAN AKAN KERUSAKAN TERSEBUT.
27 .\"
28 .\"     $Id: useradd.8 1342 2007-11-10 23:46:11Z nekral-guest $
29 .\"
30 .TH USERADD 8
31 .SH NAME
32 useradd \- Membuat user baru atau memperbarui informasi tentang user baru
33 .SH SYNOPSIS
34 .TP 8
35 .B useradd
36 .\" .RB [ \-A
37 .\" .RI { method | \fBDEFAULT\fR "},... ]"
38 .RB [ \-c
39 .IR comment ]
40 .RB [ \-d
41 .IR home_dir ]
42 .br
43 .RB [ \-e
44 .IR expire_date ]
45 .RB [ \-f
46 .IR inactive_time ]
47 .br
48 .RB [ \-g
49 .IR initial_group ]
50 .RB [ \-G
51 .IR group [,...]]
52 .br
53 .RB [ \-m " [" \-k
54 .IR skeleton_dir ] " |" " " \-M ]
55 .RB [ \-s
56 .IR shell ]
57 .br
58 .RB [ \-u
59 .IR uid " ["
60 .BR \-o ]]
61 .RB [ \-n ]
62 .RB [ \-r ]
63 .I login
64 .TP 8
65 .B useradd
66 \fB\-D\fR
67 [\fB\-g\fI default_group\fR]
68 [\fB\-b\fI default_home\fR]
69 .br
70 [\fB\-f\fI default_inactive\fR]
71 [\fB\-e\fI default_expire_date\fR]
72 .br
73 [\fB\-s\fI default_shell\fR]
74 .SH PENJELASAN
75 .SS Membuat User Baru
76 Jika digunakan tanpa option \fB\-D\fR, perintah \fBuseradd\fR menciptakan
77 sebuah  user account baru dengan menggunakan nilai yang terdapat pada
78 baris perintah dan nilai default dari system.
79 User account yang baru tersebut akan dimasukkan ke system files seperlunya,
80 home directory akan dibuatkan, dan initial files di\-copy\-kan, tergantung
81 option yang terdapat pada baris perintah.
82 Versi yang terdapat pada Red Hat Linux akan membuat sebuah group untuk
83 setiap user yang didaftarkan pada system, jika \fB\-b\fR tidak diberikan.
84 Option yang dapat digunakan pada perintah \fBuseradd\fR adalah
85 .\" .IP "\fB\-A {\fImethod\fR|\fBDEFAULT\fR},..."
86 .\" Nilai milik user dalam metode autentikasi/pengecekan.
87 .\" Metode autentikasi/pengecekan adalah nama sebuah program yang bertanggung 
88 .\" jawab untuk memeriksa identitas user.
89 .\" String \fBDEFAULT\fR dapat digunakan untuk mengubah metode autentikasi
90 .\" menjadi metode password system yang standar.
91 .\" Daftar tersebut berisi nama\-nama program, yang dipisahkan oleh koma.
92 .\" \fBDEFAULT\fR hanya dapat dicantumkan sekali saja.
93 .\" 
94 .\" 
95 .\" 
96 .IP "\fB\-c \fIcomment\fR"
97 Komentar pada file password milik user baru.
98 .IP "\fB\-d \fIhome_dir\fR"
99 User baru akan diciptakan dengan \fIhome_dir\fR sebagai lokasi directory 
100 login\-nya.
101 Default\-nya adalah menambahkan nama \fIlogin\fR pada \fIdefault_home\fR
102 dan menggunakannya sebagai nama directory login.
103 .IP "\fB\-e \fIexpire_date\fR"
104 Tanggal ketika user account dimatikan.
105 Tanggal ditulis dalam format \fIMM/DD/YY\fR.
106 .IP "\fB\-f \fIinactive_days\fR"
107 Jumlah hari setelah sebuah password kadaluarsa hingga account 
108 tersebut dimatikan secara permanen.
109 Nilai 0 mematikan account segera setelah password kadaluarsa,
110 dan nilai \-1 mematikan fungsi ini.
111 Nilai default\-nya adalah \-1.
112 .IP "\fB\-g \fIinitial_group\fR"
113 Nama group atau angka initial login group.
114 Nama group harus sudah ada.  Seorang anggota group harus merujuk
115 pada group yang sudah ada.
116 Nilai group default\-nya adalah 1.
117 .IP "\fB\-G \fIgroup,[...]\fR"
118 Daftar group tambahan yang juga merupakan group\-nya user.
119 Setiap group dipisahkan oleh koma, tanpa diikuti spasi.
120 Group juga mengikuti aturan yang diberikan dengan option \fB\-g\fR.
121 Default\-nya hanyalah untuk user yang terdaftar pada group awal.
122 .IP \fB\-m\fR
123 Home directory milik user akan dibuatkan jika belum ada.
124 File yang terdapat pada \fIskeleton_dir\fR atau \fI/etc/skel\fR
125 akan dibuatkan pada home directory milik user.
126 Option \fB\-k\fR hanya valid jika bertemu option \fB\-m\fR.
127 Dafault\-nya adalah tidak membuat directory dan tidak meng\-copy
128 segala file.
129 .IP \fB\-M\fR
130 Home directory milik user tidak akan dibuatkan, bahkan jika setting
131 system pada \fI/etc/login.defs\fR ditujukan untuk membuat home 
132 directory.
133 .IP \fB\-n\fR
134 Sebuah group yang namanya sama dengan user akan ditambahkan ke dalam
135 system secara default.  Option ini akan mematikan kebiasaan tersebut
136 yang terdapat pada Red Hat Linux.
137 .IP \fB\-r\fR
138 Flag ini digunakan untuk membuat sebuah system account.  Yaitu, user
139 dengan UID yang lebih kecil dari UID_MIN yang tercantum pada 
140 \fI/etc/login.defs\fR.  Harap diingat bahwa \fBuseradd\fR tidak akan
141 membuat home directory untuk user semacam ini, menghiraukan setting
142 default yang terdapat di \fI/etc/login.defs\fR.
143 Anda harus menyebutkan option \fB\-m\fR jika ingin membuat home directory
144 untuk sebuah system account yang akan dibuat.
145 Ini adalah option yang ditambahkan oleh Red Hat.
146 .IP "\fB\-s \fIshell\fR"
147 Nama login shell milik user.
148 Default\-nya adalah membiarkan field ini kosong, yang menyebabkan
149 system untuk memilih login shell yang default.
150 .IP "\fB\-u \fIuid\fR"
151 Nilai user ID secara numerik.
152 Nilai ini harus unique, kecuali jika option \fI\-o\fR digunakan.
153 Nilai tersebut tidak boleh negatif.
154 Default\-nya adalah menggunakan nilai ID yang lebih besar dari 999
155 dan lebih besar dari semua user lain.
156 Nilai di antara 0 dan 999 biasanya disiapkan untuk system aacount.
157 .SS Mengubah nilai\-nilai default.
158 Ketika digunakan dengan option \fB\-D\fR, \fBuseradd\fR akan
159 menampilkan nilai default, atau memperbarui nilai default baru
160 yang terdapat pada baris perintah.
161 Option yang dapat digunakan adalah
162 .IP "\fB\-b \fIdefault_home\fR"
163 Awalan path untuk home directory milik user baru.
164 Nama user akan ditambahkan setelah akhir \fIdefault_home\fR
165 ketika membuat nama directory baru jika option \fB\-d\fI tidak
166 disebutkan dalam membuat account baru.
167 .IP "\fB\-e \fIdefault_expire_date\fR"
168 Tanggal ketika user account dimatikan.
169 .IP "\fB\-f \fIdefault_inactive\fR"
170 Jumlah hari setelah password kadaluarsa sebelum account
171 dimatikan.
172 .IP "\fB\-g \fIdefault_group\fR"
173 Nama group atau ID sebagai group awal user baru.
174 Nama group yang disebut harus sudah ada dan nomor group ID
175 harus mempunyai entry.
176 .IP "\fB\-s \fIdefault_shell\fR"
177 Nama untuk login shell milik user baru.
178 Nama program yang disebutkan akan digunakan untuk semua user
179 account baru mendatang.
180 .PP
181 Jika tidak ada option yang disebutkan, \fBuseradd\fR menampilkan
182 nilai default yang ada saat ini.
183 .SH NOTES
184 The system administrator is responsible for placing the default
185 user files in the \fI/etc/skel\fR directory.
186 .br
187 Versi useradd ini dimodifikasi oleh Red Hat agar cocok dengan
188 ketentuan mengenai user/group.
189 .SH CAVEATS
190 Anda tidak dapat menambahkan user pada grou NIS.
191 Ini harus dilakukan pada server NIS.
192 .SH FILES
193 \fB/etc/passwd\fR \- informasi tentang user account
194 .br
195 \fB/etc/shadow\fR \- informasi user account yang terlindung
196 .br
197 \fB/etc/group\fR \- informasi tentang group
198 .br
199 \fB/etc/default/useradd\fR \- informasi tentang nilai default
200 .br
201 \fB/etc/login.defs\fR \- system\-wide settings
202 .br
203 \fB/etc/skel\fR \- directory yang mengandung default files
204 .SH LIHAT JUGA
205 .BR chfn (1),
206 .BR chsh (1),
207 .BR groupadd (8),
208 .BR groupdel (8),
209 .BR groupmod (8),
210 .BR passwd (1),
211 .BR userdel (8),
212 .BR usermod (8)
213 .SH AUTHOR
214 Julianne Frances Haugh (jfh@tab.com)