Merge remote-tracking branch 'origin/mdb.master' into OPENLDAP_REL_ENG_2_4

[openldap] / doc / man / man8 / slapauth.8

diff --git a/doc/man/man8/slapauth.8 b/doc/man/man8/slapauth.8
index d4112af601f5a764a90f837dc823a860e49811c0..1f619668b1d0e4e01526e03dac255faf40dacc6a 100644 (file)
--- a/doc/man/man8/slapauth.8
+++ b/doc/man/man8/slapauth.8
@@ -1,20 +1,30 @@
 .TH SLAPAUTH 8C "RELEASEDATE" "OpenLDAP LDVERSION"
 .TH SLAPAUTH 8C "RELEASEDATE" "OpenLDAP LDVERSION"

-.\" Copyright 2004-2009 The OpenLDAP Foundation All Rights Reserved.
+.\" Copyright 2004-2013 The OpenLDAP Foundation All Rights Reserved.

 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.

+.\" $OpenLDAP$

 .SH NAME
 slapauth \- Check a list of string-represented IDs for LDAP authc/authz
 .SH SYNOPSIS
 .B SBINDIR/slapauth
 .SH NAME
 slapauth \- Check a list of string-represented IDs for LDAP authc/authz
 .SH SYNOPSIS
 .B SBINDIR/slapauth

-.B [\-d level]
-.B [\-f slapd.conf]
-.B [\-F confdir]
-.B [\-M mech]
-.B [\-o name[=value]]
-.B [\-R realm]
-.B [\-U authcID]
-.B [\-v]
-.B [\-X authzID]
-.B ID [...]
+[\c
+.BI \-d \ debug-level\fR]
+[\c
+.BI \-f \ slapd.conf\fR]
+[\c
+.BI \-F \ confdir\fR]
+[\c
+.BI \-M \ mech\fR]
+[\c
+.BI \-o \ option\fR[ = value\fR]]
+[\c
+.BI \-R \ realm\fR]
+[\c
+.BI \-U \ authcID\fR]
+[\c
+.BR \-v ]
+[\c
+.BI \-X \ authzID\fR]
+.IR ID \ [ ... ]

 .LP
 .SH DESCRIPTION
 .LP
 .LP
 .SH DESCRIPTION
 .LP


@@ -24,34 +34,36 @@ for authentication and authorization purposes, as specified in
 .BR slapd.conf (5).
 It opens the
 .BR slapd.conf (5)
 .BR slapd.conf (5).
 It opens the
 .BR slapd.conf (5)

-configuration file, reads in the 
-.B authz-policy
+configuration file or the 
+.BR slapd\-config (5) 
+backend, reads in the 
+.BR authz\-policy / olcAuthzPolicy

 and
 and

-.B authz-regexp
+.BR authz\-regexp / olcAuthzRegexp

 directives, and then parses the 
 directives, and then parses the 

-.B ID
+.I ID

 list given on the command-line.
 .LP
 .SH OPTIONS
 .TP
 list given on the command-line.
 .LP
 .SH OPTIONS
 .TP

-.BI \-d " level"
+.BI \-d \ debug-level

 enable debugging messages as defined by the specified
 enable debugging messages as defined by the specified

-.IR level ;
+.IR debug-level ;

 see
 .BR slapd (8)
 for details.
 .TP
 see
 .BR slapd (8)
 for details.
 .TP

-.BI \-f " slapd.conf"
+.BI \-f \ slapd.conf

 specify an alternative
 .BR slapd.conf (5)
 file.
 .TP
 specify an alternative
 .BR slapd.conf (5)
 file.
 .TP

-.BI \-F " confdir"
+.BI \-F \ confdir

 specify a config directory.
 If both
 specify a config directory.
 If both

-.B -f
+.B \-f

 and
 and

-.B -F
+.B \-F

 are specified, the config file will be read and converted to
 config directory format and written to the specified directory.
 If neither option is specified, an attempt to read the
 are specified, the config file will be read and converted to
 config directory format and written to the specified directory.
 If neither option is specified, an attempt to read the


@@ -59,43 +71,43 @@ default config directory will be made before trying to use the default
 config file. If a valid config directory exists then the
 default config file is ignored.
 .TP
 config file. If a valid config directory exists then the
 default config file is ignored.
 .TP

-.BI \-M " mech"
+.BI \-M \ mech

 specify a mechanism.
 .TP
 specify a mechanism.
 .TP

-.BI \-o " option[=value]"
+.BI \-o \ option\fR[ = value\fR]

 Specify an
 Specify an

-.BR option
+.I option

 with a(n optional)
 with a(n optional)

-.BR value .
+.IR value .

 Possible generic options/values are:
 .LP
 .nf
               syslog=<subsystems>  (see `\-s' in slapd(8))
 Possible generic options/values are:
 .LP
 .nf
               syslog=<subsystems>  (see `\-s' in slapd(8))

-              syslog-level=<level> (see `\-S' in slapd(8))
-              syslog-user=<user>   (see `\-l' in slapd(8))
+              syslog\-level=<level> (see `\-S' in slapd(8))
+              syslog\-user=<user>   (see `\-l' in slapd(8))

 
 .fi
 .TP
 
 .fi
 .TP

-.BI \-R " realm"
+.BI \-R \ realm

 specify a realm.
 .TP
 specify a realm.
 .TP

-.BI \-U " authcID"
+.BI \-U \ authcID

 specify an ID to be used as 
 .I authcID
 throughout the test session.
 If present, and if no
 specify an ID to be used as 
 .I authcID
 throughout the test session.
 If present, and if no

-.B authzID
+.I authzID

 is given, the IDs in the ID list are treated as 
 is given, the IDs in the ID list are treated as 

-.BR authzID .
+.IR authzID .

 .TP
 .TP

-.BI \-X " authzID"
+.BI \-X \ authzID

 specify an ID to be used as 
 .I authzID
 throughout the test session.
 If present, and if no
 specify an ID to be used as 
 .I authzID
 throughout the test session.
 If present, and if no

-.B authcID
+.I authcID

 is given, the IDs in the ID list are treated as 
 is given, the IDs in the ID list are treated as 

-.BR authcID .
+.IR authcID .

 If both
 .I authcID 
 and
 If both
 .I authcID 
 and


@@ -109,8 +121,8 @@ The command
 .LP
 .nf
 .ft tt
 .LP
 .nf
 .ft tt

-       SBINDIR/slapauth -f /ETCDIR/slapd.conf -v \\
-            -U bjorn -X u:bjensen
+       SBINDIR/slapauth \-f /ETCDIR/slapd.conf \-v \\
+            \-U bjorn \-X u:bjensen

 
 .ft
 .fi
 
 .ft
 .fi


@@ -122,8 +134,8 @@ provided the directives
 .LP
 .nf
 .ft tt
 .LP
 .nf
 .ft tt

-       authz-policy from
-       authz-regexp "^uid=([^,]+).*,cn=auth$"
+       authz\-policy from
+       authz\-regexp "^uid=([^,]+).*,cn=auth$"

                "ldap:///dc=example,dc=net??sub?uid=$1"
 
 .ft
                "ldap:///dc=example,dc=net??sub?uid=$1"
 
 .ft


@@ -132,7 +144,7 @@ are defined in
 .BR slapd.conf (5).
 .SH "SEE ALSO"
 .BR ldap (3),
 .BR slapd.conf (5).
 .SH "SEE ALSO"
 .BR ldap (3),

-.BR slapd (8)
+.BR slapd (8),

 .BR slaptest (8)
 .LP
 "OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)
 .BR slaptest (8)
 .LP
 "OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)