1dsidm(8) System Manager's Manual dsidm(8)
2
6 dsidm
7
9 dsidm [-h] [-b BASEDN] [-v] [-D BINDDN] [-w BINDPW] [-W] [-y PWDFILE]
10 [-Z] [-j] instance {account,group,initialise,organizationalunit,posix‐
11 group,user} ...
12
14 instance
15 The instance name OR the LDAP url to connect to, IE localhost,
16 ldap://mai.example.com:389
17 Sub-commands
20 dsidm account
21 Manage generic accounts IE account locking and unlocking.
22 dsidm group
24 Manage groups
25 dsidm initialise
27 Initialise a backend with domain information and sample entries
28 dsidm organizationalunit
30 Manage organizational units
31 dsidm posixgroup
33 Manage posix groups
34 dsidm user
36 Manage posix users
37
39 usage: dsidm instance account [-h]
40 {list,lock,status,unlock,reset_pass‐
41 word,change_password}
42 ...
43 Sub-commands
46 dsidm account list
47 list
48 dsidm account lock
50 lock
51 dsidm account status
53 status
54 dsidm account unlock
56 unlock
57 dsidm account reset_password
59 Reset the password of an account. This should be performed by a
60 directory admin.
61 dsidm account change_password
63 Change the password of an account. This can be performed by any
64 user (with correct rights)
65
67 usage: dsidm instance account list [-h]
68
73 usage: dsidm instance account lock [-h] [dn]
74 dn The dn to lock
77
81 usage: dsidm instance account status [-h] [dn]
82 dn The dn to check
85
89 usage: dsidm instance account unlock [-h] [dn]
90 dn The dn to unlock
93
97 usage: dsidm instance account reset_password [-h] [dn] [new_password]
98 dn The dn to reset the password for
101 new_password
104 The new password to set
105
109 usage: dsidm instance account change_password [-h]
110 [dn] [new_password]
111 [current_password]
112 dn The dn to change the password for
115 new_password
118 The new password to set
119 current_password
122 The accounts current password
123
128 usage: dsidm instance group [-h]
129 {list,get,get_dn,create,delete,mem‐
130 bers,add_member,remove_member}
131 ...
132 Sub-commands
135 dsidm group list
136 list
137 dsidm group get
139 get
140 dsidm group get_dn
142 get_dn
143 dsidm group create
145 create
146 dsidm group delete
148 deletes the object
149 dsidm group members
151 List member dns of a group
152 dsidm group add_member
154 Add a member to a group
155 dsidm group remove_member
157 Remove a member from a group
158
160 usage: dsidm instance group list [-h]
161
166 usage: dsidm instance group get [-h] [selector]
167 selector
170 The term to search for
171
175 usage: dsidm instance group get_dn [-h] [dn]
176 dn The dn to get
179
183 usage: dsidm instance group create [-h] [--cn [CN]]
184 --cn [CN]
188 Value of cn
189
192 usage: dsidm instance group delete [-h] [dn]
193 dn The dn to delete
196
200 usage: dsidm instance group members [-h] [cn]
201 cn cn of group to list members of
204
208 usage: dsidm instance group add_member [-h] [cn] [dn]
209 cn cn of group to add member to
212 dn dn of object to add to group as member
215
219 usage: dsidm instance group remove_member [-h] [cn] [dn]
220 cn cn of group to remove member from
223 dn dn of object to remove from group as member
226
231 usage: dsidm instance initialise [-h] [--version VERSION]
232 --version VERSION
236 The version of entries to create.
237
240 usage: dsidm instance organizationalunit [-h]
241 {list,get,get_dn,cre‐
242 ate,delete} ...
243 Sub-commands
246 dsidm organizationalunit list
247 list
248 dsidm organizationalunit get
250 get
251 dsidm organizationalunit get_dn
253 get_dn
254 dsidm organizationalunit create
256 create
257 dsidm organizationalunit delete
259 deletes the object
260
262 usage: dsidm instance organizationalunit list [-h]
263
268 usage: dsidm instance organizationalunit get [-h] [selector]
269 selector
272 The term to search for
273
277 usage: dsidm instance organizationalunit get_dn [-h] [dn]
278 dn The dn to get
281
285 usage: dsidm instance organizationalunit create [-h] [--ou [OU]]
286 --ou [OU]
290 Value of ou
291
294 usage: dsidm instance organizationalunit delete [-h] [dn]
295 dn The dn to delete
298
303 usage: dsidm instance posixgroup [-h] {list,get,get_dn,create,delete}
304 ...
305 Sub-commands
308 dsidm posixgroup list
309 list
310 dsidm posixgroup get
312 get
313 dsidm posixgroup get_dn
315 get_dn
316 dsidm posixgroup create
318 create
319 dsidm posixgroup delete
321 deletes the object
322
324 usage: dsidm instance posixgroup list [-h]
325
330 usage: dsidm instance posixgroup get [-h] [selector]
331 selector
334 The term to search for
335
339 usage: dsidm instance posixgroup get_dn [-h] [dn]
340 dn The dn to get
343
347 usage: dsidm instance posixgroup create [-h] [--cn [CN]]
348 [--gidNumber [GIDNUMBER]]
349 --cn [CN]
353 Value of cn
354 --gidNumber [GIDNUMBER]
357 Value of gidNumber
358
361 usage: dsidm instance posixgroup delete [-h] [dn]
362 dn The dn to delete
365
370 usage: dsidm instance user [-h]
371 {list,get,get_dn,create,mod‐
372 ify,delete,lock,status,unlock}
373 ...
374 Sub-commands
377 dsidm user list
378 list
379 dsidm user get
381 get
382 dsidm user get_dn
384 get_dn
385 dsidm user create
387 create
388 dsidm user modify
390 modify <add|delete|replace>:<attribute>:<value> ...
391 dsidm user delete
393 deletes the object
394 dsidm user lock
396 lock
397 dsidm user status
399 status
400 dsidm user unlock
402 unlock
403
405 usage: dsidm instance user list [-h]
406
411 usage: dsidm instance user get [-h] [selector]
412 selector
415 The term to search for
416
420 usage: dsidm instance user get_dn [-h] [dn]
421 dn The dn to get
424
428 usage: dsidm instance user create [-h] [--uid [UID]] [--cn [CN]]
429 [--displayName [DISPLAYNAME]]
430 [--uidNumber [UIDNUMBER]]
431 [--gidNumber [GIDNUMBER]]
432 [--homeDirectory [HOMEDIRECTORY]]
433 --uid [UID]
437 Value of uid
438 --cn [CN]
441 Value of cn
442 --displayName [DISPLAYNAME]
445 Value of displayName
446 --uidNumber [UIDNUMBER]
449 Value of uidNumber
450 --gidNumber [GIDNUMBER]
453 Value of gidNumber
454 --homeDirectory [HOMEDIRECTORY]
457 Value of homeDirectory
458
461 usage: dsidm instance user modify [-h] selector changes [changes ...]
462 selector
465 The uid to modify
466 changes
469 A list of changes to apply in format:
470 <add|delete|replace>:<attribute>:<value>
471
475 usage: dsidm instance user delete [-h] [dn]
476 dn The dn to delete
479
483 usage: dsidm instance user lock [-h] [uid]
484 uid The uid to lock
487
491 usage: dsidm instance user status [-h] [uid]
492 uid The uid to check
495
499 usage: dsidm instance user unlock [-h] [uid]
500 uid The uid to unlock
503 -b BASEDN, --basedn BASEDN
508 Basedn (root naming context) of the instance to manage
509 -v, --verbose
512 Display verbose operation tracing during command execution
513 -D BINDDN, --binddn BINDDN
516 The account to bind as for executing operations
517 -w BINDPW, --bindpw BINDPW
520 Password for binddn
521 -W, --prompt
524 Prompt for password for binddn
525 -y PWDFILE, --pwdfile PWDFILE
528 Specifies a file containing the password for the bind DN
529 -Z, --starttls
532 Connect with StartTLS
533 -j, --json
536 Return result in JSON object
537
540 lib389 was written by Red Hat Inc. <389-devel@lists.fedoraproject.org>.
541
543 The latest version of lib389 may be downloaded from
544 ⟨http://www.port389.org/docs/389ds/FAQ/upstream-test-framework.html⟩
545 Manual dsidm(8)