Commit 74f0a362 authored by Howard Chu's avatar Howard Chu Committed by Quanah Gibson-Mount
Browse files

ITS#7177 make manpages more consistent

parent aabec0dc
......@@ -7,6 +7,10 @@ ldapcompare \- LDAP compare tool
.SH SYNOPSIS
.B ldapcompare
[\c
.BR \-V [ V ]]
[\c
.BI \-d \ debuglevel\fR]
[\c
.BR \-n ]
[\c
.BR \-v ]
......@@ -15,7 +19,7 @@ ldapcompare \- LDAP compare tool
[\c
.BR \-M [ M ]]
[\c
.BI \-d \ debuglevel\fR]
.BR \-x ]
[\c
.BI \-D \ binddn\fR]
[\c
......@@ -37,7 +41,7 @@ ldapcompare \- LDAP compare tool
[\c
.BR \-E \ [ ! ] \fIext\fP [ =\fIextparam\fP ]]
[\c
.BR \-o \ \fIopt\fP [ =\fIoptparam\fP ]]
.BI \-o \ opt \fR[= optparam \fR]]
[\c
.BI \-O \ security-properties\fR]
[\c
......@@ -45,12 +49,12 @@ ldapcompare \- LDAP compare tool
[\c
.BR \-Q ]
[\c
.BR \-N ]
[\c
.BI \-U \ authcid\fR]
[\c
.BI \-R \ realm\fR]
[\c
.BR \-x ]
[\c
.BI \-X \ authzid\fR]
[\c
.BI \-Y \ mech\fR]
......@@ -79,6 +83,15 @@ TRUE, FALSE, or UNDEFINED on standard output.
.LP
.SH OPTIONS
.TP
.BR \-V [ V ]
Print version info.
If \fB\-VV\fP is given, only the version information is printed.
.TP
.BI \-d \ debuglevel
Set the LDAP debugging level to \fIdebuglevel\fP.
.B ldapcompare
must be compiled with LDAP_DEBUG defined for this option to have any effect.
.TP
.B \-n
Show what would be done, but don't actually perform the compare. Useful for
debugging in conjunction with \fB\-v\fP.
......@@ -95,11 +108,6 @@ Enable manage DSA IT control.
.B \-MM
makes control critical.
.TP
.BI \-d \ debuglevel
Set the LDAP debugging level to \fIdebuglevel\fP.
.B ldapcompare
must be compiled with LDAP_DEBUG defined for this option to have any effect.
.TP
.B \-x
Use simple authentication instead of SASL.
.TP
......@@ -176,7 +184,7 @@ Compare extensions:
!dontUseCopy
.fi
.TP
.BR \-o \ \fIopt\fP [ =\fIoptparam\fP ]
.BI \-o \ opt \fR[= optparam \fR]
Specify general options.
......@@ -196,6 +204,9 @@ only as needed.
.B \-Q
Enable SASL Quiet mode. Never prompt.
.TP
.B \-N
Do not use reverse DNS to canonicalize SASL host name.
.TP
.BI \-U \ authcid
Specify the authentication ID for SASL bind. The form of the ID
depends on the actual SASL mechanism used.
......
......@@ -7,17 +7,25 @@ ldapdelete \- LDAP delete entry tool
.SH SYNOPSIS
.B ldapdelete
[\c
.BR \-V [ V ]]
[\c
.BI \-d \ debuglevel\fR]
[\c
.BR \-n ]
[\c
.BR \-v ]
[\c
.BR \-c ]
[\c
.BR \-M [ M ]]
.BI \-f \ file\fR]
[\c
.BI \-d \ debuglevel\fR]
.BR \-r ]
[\c
.BI \-f \ file\fR]
.BI \-z \ sizelimit\fR]
[\c
.BR \-M [ M ]]
[\c
.BR \-x ]
[\c
.BI \-D \ binddn\fR]
[\c
......@@ -31,36 +39,32 @@ ldapdelete \- LDAP delete entry tool
[\c
.BI \-h \ ldaphost\fR]
[\c
.BI \-p \ ldapport\fR]
[\c
.BR \-P \ { 2 \||\| 3 }]
[\c
.BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ]]
[\c
.BR \-E \ [ ! ] \fIext\fP [ =\fIextparam\fP ]]
[\c
.BR \-o \ \fIopt\fP [ =\fIoptparam\fP ]]
[\c
.BI \-p \ ldapport\fR]
.BI \-o \ opt \fR[= optparam \fR]]
[\c
.BI \-O \ security-properties\fR]
[\c
.BI \-U \ authcid\fR]
[\c
.BI \-R \ realm\fR]
.BR \-I ]
[\c
.BR \-r ]
.BR \-Q ]
[\c
.BR \-x ]
.BR \-N ]
[\c
.BR \-I ]
.BI \-U \ authcid\fR]
[\c
.BR \-Q ]
.BI \-R \ realm\fR]
[\c
.BI \-X \ authzid\fR]
[\c
.BI \-Y \ mech\fR]
[\c
.BI \-z \ sizelimit\fR]
[\c
.BR \-Z [ Z ]]
[\c
.IR DN \ [ ... ]]
......@@ -80,6 +84,15 @@ are provided, a list of DNs is read from standard input (or from
\fIfile\fP if the \fB\-f\fP flag is used).
.SH OPTIONS
.TP
.BR \-V [ V ]
Print version info.
If \fB\-VV\fP is given, only the version information is printed.
.TP
.BI \-d \ debuglevel
Set the LDAP debugging level to \fIdebuglevel\fP.
.B ldapdelete
must be compiled with LDAP_DEBUG defined for this option to have any effect.
.TP
.B \-n
Show what would be done, but don't actually delete entries. Useful for
debugging in conjunction with \fB\-v\fP.
......@@ -93,20 +106,26 @@ Continuous operation mode. Errors are reported, but
will continue with deletions. The default is to exit after
reporting an error.
.TP
.BI \-f \ file
Read a series of DNs from \fIfile\fP, one per line, performing an
LDAP delete for each.
.TP
.B \-r
Do a recursive delete. If the DN specified isn't a leaf, its
children, and all their children are deleted down the tree. No
verification is done, so if you add this switch, ldapdelete will
happily delete large portions of your tree. Use with care.
.TP
.BI \-z \ sizelimit
Use \fIsizelimit\fP when searching for children DN to delete,
to circumvent any server-side size limit. Only useful in conjunction
with \fB\-r\fP.
.TP
.BR \-M [ M ]
Enable manage DSA IT control.
.B \-MM
makes control critical.
.TP
.BI \-d \ debuglevel
Set the LDAP debugging level to \fIdebuglevel\fP.
.B ldapdelete
must be compiled with LDAP_DEBUG defined for this option to have any effect.
.TP
.BI \-f \ file
Read a series of DNs from \fIfile\fP, one per line, performing an
LDAP delete for each.
.TP
.B \-x
Use simple authentication instead of SASL.
.TP
......@@ -171,7 +190,7 @@ Delete extensions:
(none)
.fi
.TP
.BR \-o \ \fIopt\fP [ =\fIoptparam\fP ]
.BI \-o \ opt \fR[= optparam \fR]
Specify general options.
......@@ -181,17 +200,6 @@ General options:
ldif-wrap=<width> (in columns, or "no" for no wrapping)
.fi
.TP
.B \-r
Do a recursive delete. If the DN specified isn't a leaf, its
children, and all their children are deleted down the tree. No
verification is done, so if you add this switch, ldapdelete will
happily delete large portions of your tree. Use with care.
.TP
.BI \-z \ sizelimit
Use \fIsizelimit\fP when searching for children DN to delete,
to circumvent any server-side size limit. Only useful in conjunction
with \fB\-r\fP.
.TP
.BI \-O \ security-properties
Specify SASL security properties.
.TP
......@@ -202,6 +210,9 @@ only as needed.
.B \-Q
Enable SASL Quiet mode. Never prompt.
.TP
.B \-N
Do not use reverse DNS to canonicalize SASL host name.
.TP
.BI \-U \ authcid
Specify the authentication ID for SASL bind. The form of the identity depends on the
actual SASL mechanism used.
......
......@@ -20,52 +20,50 @@ ldapexop \- issue LDAP extended operations
.SH SYNOPSIS
ldapexop
[\c
.BI \-d \ level\fR]
.BR \-V [ V ]]
[\c
.BI \-D \ binddn\fR]
.BI \-d \ debuglevel\fR]
[\c
.BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ]]
.BR \-n ]
[\c
.BR \-o \ \fIopt\fP [ =\fIoptparam\fP ]]
.BR \-v ]
[\c
.BI \-f \ file\fR]
[\c
.BI \-h \ host\fR]
.BR \-x ]
[\c
.BI \-H \ URI\fR]
.BI \-D \ binddn\fR]
[\c
.BR \-I ]
.BR \-W ]
[\c
.BR \-n ]
.BI \-w \ passwd\fR]
[\c
.BR \-N ]
.BI \-y \ passwdfile\fR]
[\c
.BI \-O \ security-properties\fR]
.BI \-H \ URI\fR]
[\c
.BI \-o \ opt\fR[\fP = optparam\fR]]
.BI \-h \ ldaphost\fR]
[\c
.BI \-p \ port\fR]
.BI \-p \ ldapport\fR]
[\c
.BR \-Q ]
.BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ]]
[\c
.BI \-R \ realm\fR]
.BI \-o \ opt \fR[= optparam \fR]]
[\c
.BI \-U \ authcid\fR]
.BI \-O \ security-properties\fR]
[\c
.BR \-v ]
.BR \-I ]
[\c
.BR \-V ]
.BR \-Q ]
[\c
.BI \-w \ passwd\fR]
.BR \-N ]
[\c
.BR \-W ]
.BI \-U \ authcid\fR]
[\c
.BR \-x ]
.BI \-R \ realm\fR]
[\c
.BI \-X \ authzid\fR]
[\c
.BI \-y \ file\fR]
[\c
.BI \-Y \ mech\fR]
[\c
.BR \-Z [ Z ]]
......@@ -123,12 +121,53 @@ results in
.SH OPTIONS
.TP
.BI \-d \ level
Set the LDAP debugging level to \fIlevel\fP.
.BI \-V [ V ]
Print version info.
If\fB\-VV\fP is given, only the version information is printed.
.TP
.BI \-d \ debuglevel
Set the LDAP debugging level to \fIdebuglevel\fP.
.TP
.BI \-n
Show what would be done but don't actually do it.
Useful for debugging in conjunction with \fB\-v\fP.
.TP
.BI \-v
Run in verbose mode, with many diagnostics written to standard output.
.TP
.BI \-f \ file
Read operations from \fIfile\fP.
.TP
.BI \-x
Use simple authentication instead of SASL.
.TP
.BI \-D \ binddn
Use the Distinguished Name \fIbinddn\fP to bind to the LDAP directory.
.TP
.BI \-W
Prompt for simple authentication.
This is used instead of specifying the password on the command line.
.TP
.BI \-w \ passwd
Use \fIpasswd\fP as the password for simple authentication.
.TP
.BI \-y \ passwdfile
Use complete contents of \fIpasswdfile\fP as the password for
simple authentication.
.TP
.BI \-H \ URI
Specify URI(s) referring to the ldap server(s); only the protocol/host/port
fields are allowed; a list of URI, separated by whitespace or commas
is expected.
.TP
.BI \-h \ ldaphost
Specify the host on which the ldap server is running.
Deprecated in favor of \fB\-H\fP.
.TP
.BI \-p \ ldapport
Specify the TCP port where the ldap server is listening.
Deprecated in favor of \fB\-H\fP.
.TP
.BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ]
Specify general extensions. \'!\' indicates criticality.
.nf
......@@ -148,7 +187,7 @@ Specify general extensions. \'!\' indicates criticality.
not really controls)
.fi
.TP
.BR \-o \ \fIopt\fP [ =\fIoptparam\fP ]
.BI \-o \ opt \fR[= optparam \fR]
Specify general options.
......@@ -158,69 +197,26 @@ General options:
ldif-wrap=<width> (in columns, or "no" for no wrapping)
.fi
.TP
.BI \-f \ file
Read operations from \fIfile\fP.
.TP
.BI \-h \ host
Specify the host on which the ldap server is running.
Deprecated in favor of \fB\-H\fP.
.TP
.BI \-H \ URI
Specify URI(s) referring to the ldap server(s); only the protocol/host/port
fields are allowed; a list of URI, separated by whitespace or commas
is expected.
.BI \-O \ security-properties
Specify SASL security properties.
.TP
.BI \-I
Enable SASL Interactive mode. Always prompt. Default is to prompt
only as needed.
.TP
.BI \-n
Show what would be done but don't actually do it.
Useful for debugging in conjunction with \fB\-v\fP.
.TP
.BI \-N
Do not use reverse DNS to canonicalize SASL host name.
.TP
.BI \-O \ security-properties
Specify SASL security properties.
.TP
.BI \-o \ opt\fR[\fP = optparam\fR]
Specify general options:
.nf
nettimeout=<timeout> (in seconds, or "none" or "max")
.fi
.TP
.BI \-p \ port
Specify the TCP port where the ldap server is listening.
Deprecated in favor of \fB\-H\fP.
.TP
.BI \-Q
Enable SASL Quiet mode. Never prompt.
.TP
.BI \-R \ realm
Specify the realm of authentication ID for SASL bind. The form of the realm
depends on the actual SASL mechanism used.
.B \-N
Do not use reverse DNS to canonicalize SASL host name.
.TP
.BI \-U \ authcid
Specify the authentication ID for SASL bind. The form of the ID
depends on the actual SASL mechanism used.
.TP
.BI \-v
Run in verbose mode, with many diagnostics written to standard output.
.TP
.BI \-V
Print version info and usage message.
If\fB\-VV\fP is given, only the version information is printed.
.TP
.BI \-w \ passwd
Use \fIpasswd\fP as the password for simple authentication.
.TP
.BI \-W
Prompt for simple authentication.
This is used instead of specifying the password on the command line.
.TP
.BI \-x
Use simple authentication instead of SASL.
.BI \-R \ realm
Specify the realm of authentication ID for SASL bind. The form of the realm
depends on the actual SASL mechanism used.
.TP
.BI \-X \ authzid
Specify the requested authorization ID for SASL bind.
......@@ -230,10 +226,6 @@ must be one of the following formats:
or
.BI u: <username>
.TP
.BI \-y \ file
Use complete contents of \fIfile\fP as the password for
simple authentication.
.TP
.BI \-Y \ mech
Specify the SASL mechanism to be used for authentication.
Without this option, the program will choose the best mechanism the server knows.
......
......@@ -7,19 +7,25 @@ ldapmodify, ldapadd \- LDAP modify entry and LDAP add entry tools
.SH SYNOPSIS
.B ldapmodify
[\c
.BR \-a ]
[\c
.BR \-c ]
.BR \-V [ V ]]
[\c
.BI \-S \ file\fR]
.BI \-d \ debuglevel\fR]
[\c
.BR \-n ]
[\c
.BR \-v ]
[\c
.BR \-a ]
[\c
.BR \-c ]
[\c
.BI \-f \ file\fR]
[\c
.BI \-S \ file\fR]
[\c
.BR \-M [ M ]]
[\c
.BI \-d \ debuglevel\fR]
.BR \-x ]
[\c
.BI \-D \ binddn\fR]
[\c
......@@ -41,7 +47,7 @@ ldapmodify, ldapadd \- LDAP modify entry and LDAP add entry tools
[\c
.BR \-E \ [ ! ] \fIext\fP [ =\fIextparam\fP ]]
[\c
.BR \-o \ \fIopt\fP [ =\fIoptparam\fP ]]
.BI \-o \ opt \fR[= optparam \fR]]
[\c
.BI \-O \ security-properties\fR]
[\c
......@@ -49,33 +55,37 @@ ldapmodify, ldapadd \- LDAP modify entry and LDAP add entry tools
[\c
.BR \-Q ]
[\c
.BR \-N ]
[\c
.BI \-U \ authcid\fR]
[\c
.BI \-R \ realm\fR]
[\c
.BR \-x ]
[\c
.BI \-X \ authzid\fR]
[\c
.BI \-Y \ mech\fR]
[\c
.BR \-Z [ Z ]]
[\c
.BI \-f \ file\fR]
.LP
.B ldapadd
[\c
.BR \-c ]
.BR \-V [ V ]]
[\c
.BI \-S \ file\fR]
.BI \-d \ debuglevel\fR]
[\c
.BR \-n ]
[\c
.BR \-v ]
[\c
.BR \-c ]
[\c
.BI \-f \ file\fR]
[\c
.BI \-S \ file\fR]
[\c
.BR \-M [ M ]]
[\c
.BI \-d \ debuglevel\fR]
.BR \-x ]
[\c
.BI \-D \ binddn\fR]
[\c
......@@ -93,25 +103,29 @@ ldapmodify, ldapadd \- LDAP modify entry and LDAP add entry tools
[\c
.BR \-P \ { 2 \||\| 3 }]
[\c
.BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ]]
[\c
.BR \-E \ [ ! ] \fIext\fP [ =\fIextparam\fP ]]
[\c
.BI \-o \ opt \fR[= optparam \fR]]
[\c
.BI \-O \ security-properties\fR]
[\c
.BR \-I ]
[\c
.BR \-Q ]
[\c
.BR \-N ]
[\c
.BI \-U \ authcid\fR]
[\c
.BI \-R \ realm\fR]
[\c
.BR \-x ]
[\c
.BI \-X \ authzid\fR]
[\c
.BI \-Y \ mech\fR]
[\c
.BR \-Z [ Z ]]
[\c
.BI \-f \ file\fR]
.SH DESCRIPTION
.B ldapmodify
is a shell-accessible interface to the
......@@ -132,6 +146,22 @@ The entry information is read from standard input or from \fIfile\fP through
the use of the \fB\-f\fP option.
.SH OPTIONS
.TP
.BR \-V [ V ]
Print version info.
If \fB\-VV\fP is given, only the version information is printed.
.TP
.BI \-d \ debuglevel
Set the LDAP debugging level to \fIdebuglevel\fP.
.B ldapmodify
must be compiled with LDAP_DEBUG defined for this option to have any effect.
.TP
.B \-n
Show what would be done, but don't actually modify entries. Useful for
debugging in conjunction with \fB\-v\fP.
.TP
.B \-v
Use verbose mode, with many diagnostics written to standard output.
.TP
.B \-a
Add new entries. The default for
.B ldapmodify
......@@ -145,32 +175,20 @@ Continuous operation mode. Errors are reported, but
will continue with modifications. The default is to exit after
reporting an error.
.TP
.BI \-f \ file
Read the entry modification information from \fIfile\fP instead of from
standard input.
.TP
.BI \-S \ file
Add or change records which were skipped due to an error are written to \fIfile\fP
and the error message returned by the server is added as a comment. Most useful in
conjunction with \fB\-c\fP.
.TP
.B \-n
Show what would be done, but don't actually modify entries. Useful for
debugging in conjunction with \fB\-v\fP.
.TP
.B \-v
Use verbose mode, with many diagnostics written to standard output.
.TP
.BR \-M [ M ]
Enable manage DSA IT control.
.B \-MM
makes control critical.
.TP
.BI \-d \ debuglevel
Set the LDAP debugging level to \fIdebuglevel\fP.
.B ldapmodify
must be compiled with LDAP_DEBUG defined for this option to have any effect.
.TP
.BI \-f \ file
Read the entry modification information from \fIfile\fP instead of from
standard input.
.TP
.B \-x
Use simple authentication instead of SASL.
.TP
......@@ -205,9 +223,6 @@ Deprecated in favor of \fB\-H\fP.
.BR \-P \ { 2 \||\| 3 }
Specify the LDAP protocol version to use.
.TP
.BI \-O \ security-properties
Specify SASL security properties.
.TP
.BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ]
.TP
.BR \-E \ [ ! ] \fIext\fP [ =\fIextparam\fP ]
......@@ -238,7 +253,7 @@ Modify extensions:
[!]txn[=abort|commit]
.fi
.TP
.BR \-o \ \fIopt\fP [ =\fIoptparam\fP ]
.B