X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=doc%2Fman%2Fman8%2Fslapauth.8;h=1f619668b1d0e4e01526e03dac255faf40dacc6a;hb=c216e1809971ac6c5b2b973501e0e8a766b77287;hp=dc22819af0e0ae9fdddf2d8de491b2c71d208c07;hpb=4efbb9960c8ed57f2e9c4f086d3468739cebd517;p=openldap diff --git a/doc/man/man8/slapauth.8 b/doc/man/man8/slapauth.8 index dc22819af0..1f619668b1 100644 --- a/doc/man/man8/slapauth.8 +++ b/doc/man/man8/slapauth.8 @@ -1,20 +1,30 @@ .TH SLAPAUTH 8C "RELEASEDATE" "OpenLDAP LDVERSION" -.\" Copyright 2004-2006 The OpenLDAP Foundation All Rights Reserved. +.\" Copyright 2004-2013 The OpenLDAP Foundation All Rights Reserved. .\" Copying restrictions apply. See COPYRIGHT/LICENSE. +.\" $OpenLDAP$ .SH NAME -slapauth \- Check a list of string-represented IDs for authc/authz. +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 @@ -24,34 +34,36 @@ for authentication and authorization purposes, as specified in .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 -.B authz-regexp +.BR authz\-regexp / olcAuthzRegexp directives, and then parses the -.B ID +.I ID 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 -.IR level ; +.IR debug-level ; see .BR slapd (8) for details. .TP -.BI \-f " slapd.conf" +.BI \-f \ slapd.conf specify an alternative .BR slapd.conf (5) file. .TP -.BI \-F " confdir" +.BI \-F \ confdir specify a config directory. If both -.B -f +.B \-f 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 @@ -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 -.BI \-M " mech" +.BI \-M \ mech specify a mechanism. .TP -.BI \-o " option[=value]" +.BI \-o \ option\fR[ = value\fR] Specify an -.BR option +.I option with a(n optional) -.BR value . +.IR value . Possible generic options/values are: .LP .nf syslog= (see `\-s' in slapd(8)) - syslog-level= (see `\-S' in slapd(8)) - syslog-user= (see `\-l' in slapd(8)) + syslog\-level= (see `\-S' in slapd(8)) + syslog\-user= (see `\-l' in slapd(8)) .fi .TP -.BI \-R " realm" +.BI \-R \ realm 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 -.B authzID +.I authzID is given, the IDs in the ID list are treated as -.BR authzID . +.IR authzID . .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 -.B authcID +.I authcID is given, the IDs in the ID list are treated as -.BR authcID . +.IR authcID . If both .I authcID and @@ -109,8 +121,8 @@ The command .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 @@ -122,8 +134,8 @@ provided the directives .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 @@ -132,7 +144,7 @@ are defined in .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/)