NAME

     dua - Directory User Agent

SYNOPSIS

     dua [ options ] [ entry ]

DESCRIPTION

     dua is an interactive tool used to query an  LDAP  Directory
     Server.

     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
     issued:


     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
               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
               accordingly.

     add entry
               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
               accordingly.


     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
               action.


     help [ command ]
               displays help information for the  command  speci-
               fied. Default displays a list of dua commands.


     info
               shows information on the session.


     quit
               terminates the program.

     dua commands may be used in an abbreviated fashion:


     search [ entry ]   s [ entry ]


     modify [ entry ]   m [ entry ]


     delete [ entry ]   d [ entry ]


     info               i

OPTIONS

     -h host             specifies the name of the LDAP directory
                         server.

     -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
                         used.

     -D bind-entry       bind to the  LDAP  directory  using  the
                         name specified.

ENVIRONMENT

     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
                         specified.

SEE ALSO

     ldap(3), ldaptemplates.conf(5), ldapfilter.conf(5).