version 1.6, 2018/06/26 09:47:20 |
version 1.7, 2018/07/03 10:10:09 |
|
|
.Nd simple LDAP client |
.Nd simple LDAP client |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm ldap |
.Nm ldap |
.Ar command |
.Cm search |
.Op Fl LvWxZ |
.Op Fl LvWxZ |
.Op Fl b Ar basedn |
.Op Fl b Ar basedn |
.Op Fl c Ar CAfile |
.Op Fl c Ar CAfile |
|
|
.Op Fl w Ar secret |
.Op Fl w Ar secret |
.Op Fl y Ar secretfile |
.Op Fl y Ar secretfile |
.Op Fl z Ar sizelimit |
.Op Fl z Ar sizelimit |
.Op Ar arguments ... |
.Op Ar filter |
|
.Op Ar attributes ... |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm |
.Nm |
program is a simple LDAP client program. |
program is a simple LDAP client program. |
It queries an LDAP server to perform a command and outputs the results |
It queries an LDAP server to perform a command and outputs the results |
in the LDAP Data Interchange Format (LDIF). |
in the LDAP Data Interchange Format (LDIF). |
.Pp |
|
The command is as follows: |
|
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Cm search Ar options Oo Ar filter Oc Op Ar attribute ... |
.It Cm search Ar options Oo Ar filter Oc Op Ar attributes ... |
Perform a directory search request. |
Perform a directory search request. |
The optional |
The optional |
.Ar filter |
.Ar filter |
|
|
.Sm off |
.Sm off |
.Op Ar protocol No :// |
.Op Ar protocol No :// |
.Ar host Op : Ar port |
.Ar host Op : Ar port |
.Oo / basedn |
.Oo |
.Oo ? Op Ar attribute , ... |
.Li / Ar basedn |
.Oo ? Op Ar scope |
.Li ?\& Ar attribute , ... |
.Op ? Op Ar filter |
.Li ?\& Ar scope |
|
.Li ?\& Ar filter |
.Oc |
.Oc |
.Oc |
|
.Oc |
|
.Sm on |
.Sm on |
.Pp |
.Pp |
|
The default is |
|
.Ar ldap://localhost:389/ . |
|
Each of |
|
.Ar basedn , attribute , scope |
|
and |
|
.Ar filter |
|
may be omitted, |
|
but the preceding |
|
.Sq / |
|
or |
|
.Sq ?\& |
|
is required if a subsequent field is non-empty. |
|
.Pp |
The following protocols are supported: |
The following protocols are supported: |
.Pp |
.Pp |
.Bl -tag -width "ldap+tls" -compact |
.Bl -tag -width "ldap+tls" -compact |
|
|
for |
for |
.Pa /var/run/ldapi . |
.Pa /var/run/ldapi . |
.El |
.El |
.Pp |
|
The default is |
|
.Ar ldap://localhost:389/ . |
|
.It Fl L |
.It Fl L |
Output the directory search result in a standards-compliant version of |
Output the directory search result in a standards-compliant version of |
the LDAP Data Interchange Format (LDIF). |
the LDAP Data Interchange Format (LDIF). |