~ttx/openldap/lucid-gssapi-495418

« back to all changes in this revision

Viewing changes to doc/man/man1/ldapwhoami.1

  • Committer: Bazaar Package Importer
  • Author(s): Steve Langasek, Updated debconf translations
  • Date: 2009-07-28 10:17:15 UTC
  • mfrom: (1.1.4 upstream) (0.2.2 sid)
  • mto: (0.2.4 sid)
  • mto: This revision was merged to the branch mainline in revision 16.
  • Revision ID: james.westby@ubuntu.com-20090728101715-epwmqmsk0d3h22k3
* New upstream version.
  - Fixes FTBFS on ia64 with -fPIE. Closes: #524770.
  - Fixes some TLS issues with GnuTLS.  Closes: #505191.
* Update priority of libldap-2.4-2 to match the archive override.
* Add the missing ldapexop and ldapurl tools to ldap-utils, as well as the
  ldapurl(1) manpage.  Thanks to Peter Marschall for the patch.
  Closes: #496749.
* Bump build-dependency on debhelper to 6 instead of 5, since that's
  what we're using.  Closes: #498116.
* Set the default SLAPD_SERVICES to ldap:/// ldapi:///, instead of using
  the built-in default of ldap:/// only.
* Build-depend on libltdl-dev | libltdl3-dev (>= 1.4.3), for the package
  name change.  Closes: #522965.

[ Updated debconf translations ]
* Spanish, thanks to Francisco Javier Cuadrado <fcocuadrado@gmail.com>.
  Closes: #521804.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.TH LDAPWHOAMI 1 "RELEASEDATE" "OpenLDAP LDVERSION"
2
 
.\" $OpenLDAP: pkg/ldap/doc/man/man1/ldapwhoami.1,v 1.10.2.4 2008/02/11 23:26:39 kurt Exp $
3
 
.\" Copyright 1998-2008 The OpenLDAP Foundation All Rights Reserved.
 
2
.\" $OpenLDAP: pkg/ldap/doc/man/man1/ldapwhoami.1,v 1.10.2.8 2009/06/08 18:23:33 quanah Exp $
 
3
.\" Copyright 1998-2009 The OpenLDAP Foundation All Rights Reserved.
4
4
.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
5
5
.SH NAME
6
6
ldapwhoami \- LDAP who am i? tool
29
29
[\c
30
30
.BI \-p \ ldapport\fR]
31
31
[\c
 
32
.BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ]]
 
33
[\c
 
34
.BR \-E \ [ ! ] \fIext\fP [ =\fIextparam\fP ]]
 
35
[\c
32
36
.BI \-O \ security-properties\fR]
33
37
[\c
34
38
.BR \-I ]
45
49
[\c
46
50
.BI \-Y \ mech\fR]
47
51
[\c
48
 
.BR \-Z[Z] ]
 
52
.BR \-Z [ Z ]]
49
53
.SH DESCRIPTION
50
54
.I ldapwhoami
51
55
implements the LDAP "Who Am I?" extended operation.
58
62
.B \-n
59
63
Show what would be done, but don't actually perform the whoami operation.
60
64
Useful for
61
 
debugging in conjunction with -v.
 
65
debugging in conjunction with \fB\-v\fP.
62
66
.TP
63
67
.B \-v
64
68
Run in verbose mode, with many diagnostics written to standard output.
73
77
.TP
74
78
.BI \-D \ binddn
75
79
Use the Distinguished Name \fIbinddn\fP to bind to the LDAP directory.
 
80
For SASL binds, the server is expected to ignore this value.
76
81
.TP
77
82
.B \-W
78
83
Prompt for simple authentication.
92
97
.TP
93
98
.BI \-h \ ldaphost
94
99
Specify an alternate host on which the ldap server is running.
95
 
Deprecated in favor of -H.
 
100
Deprecated in favor of \fB\-H\fP.
96
101
.TP
97
102
.BI \-p \ ldapport
98
103
Specify an alternate TCP port where the ldap server is listening.
99
 
Deprecated in favor of -H.
100
 
.TP
101
 
.BI \-P \ 2\fR\||\|\fI3
102
 
Specify the LDAP protocol version to use.
 
104
Deprecated in favor of \fB\-H\fP.
103
105
.TP
104
106
.BI \-O \ security-properties
105
107
Specify SASL security properties.
106
108
.TP
 
109
.BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ]
 
110
.TP
 
111
.BR \-E \ [ ! ] \fIext\fP [ =\fIextparam\fP ]
 
112
 
 
113
Specify general extensions with \fB\-e\fP and search extensions with \fB\-E\fP.
 
114
\'\fB!\fP\' indicates criticality.
 
115
 
 
116
General extensions:
 
117
.nf
 
118
  [!]assert=<filter>   (an RFC 4515 Filter)
 
119
  [!]authzid=<authzid> ("dn:<dn>" or "u:<user>")
 
120
  [!]manageDSAit
 
121
  [!]noop
 
122
  ppolicy
 
123
  [!]postread[=<attrs>]        (a comma-separated attribute list)
 
124
  [!]preread[=<attrs>] (a comma-separated attribute list)
 
125
  abandon, cancel (SIGINT sends abandon/cancel; not really controls)
 
126
.fi
 
127
 
 
128
Search extensions:
 
129
.nf
 
130
  [!]domainScope                               (domain scope)
 
131
  [!]mv=<filter>                               (matched values filter)
 
132
  [!]pr=<size>[/prompt|noprompt]       (paged results/prompt)
 
133
  [!]sss=[\-]<attr[:OID]>[/[\-]<attr[:OID]>...]  (server side sorting)
 
134
  [!]subentries[=true|false]           (subentries)
 
135
  [!]sync=ro[/<cookie>]                        (LDAP Sync refreshOnly)
 
136
          rp[/<cookie>][/<slimit>]     (LDAP Sync refreshAndPersist)
 
137
.fi
 
138
.TP
107
139
.B \-I
108
140
Enable SASL Interactive mode.  Always prompt.  Default is to prompt
109
141
only as needed.
123
155
Specify the requested authorization ID for SASL bind.
124
156
.I authzid
125
157
must be one of the following formats:
126
 
.B dn:\c
127
 
.I <distinguished name>
 
158
.BI dn: "<distinguished name>"
128
159
or
129
 
.B u:\c
130
 
.I <username>
 
160
.BI u: <username>
131
161
.TP
132
162
.BI \-Y \ mech
133
163
Specify the SASL mechanism to be used for authentication. If it's not
134
164
specified, the program will choose the best mechanism the server knows.
135
165
.TP
136
 
.B \-Z[Z]
 
166
.BR \-Z [ Z ]
137
167
Issue StartTLS (Transport Layer Security) extended operation. If you use
138
 
.B \-ZZ\c
139
 
, the command will require the operation to be successful.
 
168
\fB\-ZZ\fP, the command will require the operation to be successful.
140
169
.SH EXAMPLE
141
170
.nf
142
 
    ldapwhoami -x -D "cn=Manager,dc=example,dc=com" -W
 
171
    ldapwhoami \-x \-D "cn=Manager,dc=example,dc=com" \-W
143
172
.fi
144
173
.SH "SEE ALSO"
145
174
.BR ldap.conf (5),