1NS-ACCOUNTSTATUS.PL(8)      System Manager's Manual     NS-ACCOUNTSTATUS.PL(8)
2
3
4

NAME

6       ns-accountstatus.pl  -  Directory  Server  perl script for checking the
7       status of entries.
8

SYNOPSIS

10       ns-accountstatus.pl [-Z serverID] [-D rootdn] { -w password | -w - | -j
11       filename } [-p port] [-h host] [-P protocol] {-I DN |
12        -b basedn -f filter [-s scope]} [-i] [-g seconds]
13

DESCRIPTION

15       Provides  account  status  information to establish whether an entry or
16       group of entries is inactivated.
17

OPTIONS

19       A summary of options is included below:
20
21       -Z Server Identifier
22              The server ID of the Directory Server  instance.   If  there  is
23              only one instance on the system, this option can be skipped.
24
25       -D Root DN
26              The  Directory  Manager  DN,  or root DN.  If not specified, the
27              script will search the server  instance  configuration  for  the
28              value.
29
30       -w password
31              The rootdn password.
32
33       -w -
34              Prompt for the rootdn password.
35
36       -j password filename
37              The name of the file that contains the root DN password.
38
39       -P Protocol
40              The  connection  protocol  to  connect  to the Directory Server.
41              Protocols are STARTTLS, LDAPS, LDAPI, and LDAP.  If this  option
42              is  skipped, the most secure protocol that is available is used.
43              For LDAPI, AUTOBIND is also available for the root user.
44
45       -I DN  Specifies the entry DN or role DN whose status is required.
46
47       -h host
48              Host name of the Directory Server.
49
50       -p port
51              Port number of the Directory Server.
52
53       -b basedn
54              The suffix DN from which to search from.
55
56       -f filter
57              The search filter used to find user entries.
58
59       -s scope
60              The search scope.  "base", "one, "sub".  Default is "sub"
61
62       -i
63              Only list entries that are inactivated.
64
65       -g seconds
66              Only display entries that will become inactive within the  time‐
67              frame.
68
69

EXAMPLE

71       ns-accountstatus.pl  -Z instance3 -D 'cn=directory manager' -w password
72       -I 'uid=user,ou=people,dc=example,dc=com'
73
74       ns-accountstatus.pl -Z instance3 -D 'cn=directory manager' -w  password
75       -b 'dc=example,dc=com' -f "(uid=*)"
76
77       ns-accountstatus.pl  -Z instance3 -D 'cn=directory manager' -w password
78       -b 'dc=example,dc=com' -f "(uid=*)" -g 86400
79
80       ns-accountstatus.pl   -w   password   -I   'uid=user,ou=people,dc=exam‐
81       ple,dc=com' -P STARTTLS
82              Note:  security  must  be  enabled to use protocol STARTTLS.  If
83              STARTTLS is not  available  it  will  default  to  next  strong‐
84              est/available protocol automatically.
85

DIAGNOSTICS

87       Exit  status  is  zero if no errors occur.  Errors result in a non-zero
88       exit status and a diagnostic message being written to standard error.
89

AUTHOR

91       ns-accountstatus.pl was written by the 389 Project.
92

REPORTING BUGS

94       Report bugs to https://pagure.io/389-ds-base/new_issue
95

97       Copyright © 2017 Red Hat, Inc.
98
99
100
101                                March 31, 2017          NS-ACCOUNTSTATUS.PL(8)
Impressum