dua - Directory User Agent
dua [ options ] [ entry ]
dua is an interactive tool used to query an LDAP Directory
If dua is invoked with a command line argument, an LDAP
search is performed, the results returned and dua exits.
In the interactive mode dua understands the concept of a
'current entry.' A current entry may be an individual entry
or a list which is produced as a result of a dua search. In
interactive mode there are a number of commands that can be
search [ entry ]
allows you to search for an entry in the LDAP
directory. If more than one possible match is
found, dua will produce a numerical list of the
result, you can then search for a particular entry
from the list by specifying it's number ie search
15. The default entry is the current entry.
bind [ entry ]
bind (authenticates) you to the LDAP directory. If
entry is specified, bind uses it to authenticate
to the directory. Default is the login name of the
owner of the current process.
unbind from the LDAP directory.
modify [ entry ]
allows you to modify the entry, however you must
be appropriately bound to the LDAP directory in
order to make modifications to a particular entry.
dua will list the entry with each attribute
labelled numerically, or alpha-numerically if an
attribute has more than one value. You will then
be asked what you would like to modify, you must
enter the number or alphnumeric number of the
attribute you want to modify. The default entry is
the current entry; if this is a list dua will ask
adds an entry to the LDAP directory, however you
must be appropriately bound to the directory to
perform this operation.
delete [ entry ]
deletes the entry from the LDAP directory, however
you must be appropriately bound to the directory
to perform this operation. The default entry is
the current entry. If this is a list dua will ask
action [ number ]
once an entry is displayed, and if it has any
actions associated with it, they will be numeri-
cally listed e.g.
1 Show Membership
2 Show Ownership
These actions may be invoked simply by entering
the command 'action' followed by the numerical
value, i.e. 'action 1'. The default is the first
help [ command ]
displays help information for the command speci-
fied. Default displays a list of dua commands.
shows information on the session.
terminates the program.
dua commands may be used in an abbreviated fashion:
search [ entry ] s [ entry ]
modify [ entry ] m [ entry ]
delete [ entry ] d [ entry ]
-h host specifies the name of the LDAP directory
-p port specifies the port used when connecting
to the LDAP directory server.
-f filter-file sets the filter file to the name speci-
fied, else the default file is used.
-t template-file sets the template file to the name
specified, else the default file is
-D bind-entry bind to the LDAP directory using the
See environ(5) for a description of environment variables.
BINDDN This variable, if set, is used to bind
to the LDAP directory only if the com-
mand line option to bind has not been
ldap(3), ldaptemplates.conf(5), ldapfilter.conf(5).
Man(1) output converted with