.TH LCMAPS_BAN_FQAN.MOD 8 "June 5, 2012"
.SH NAME
lcmaps_ban_fqan.mod \- LCMAPS plugin to ban a user based on any of its FQANs
.SH SYNOPSIS
.B lcmaps_ban_fqan.mod
.RB [ -banmapfile
.IR banning\ file ]
.RB [ -disablewildcard ]
.SH  DESCRIPTION
This plugin is an Banning Plugin and will provide the LCMAPS system a credential
banning feature based on VOMS FQANs.
A Gridmapfile will be read, if the FQAN is listed, this means the FQAN is banned
and the plug-in will register a negative result, this means an 
.BR LCMAPS_MOD_FAIL.
The plugin will finish its run with a
.BR LCMAPS_MOD_SUCCESS 
when the FQAN is not banned.
When there are no FQANs (including in the case when the VOMS credentials have
expired), the plugin also finishes with an LCMAPS_MOD_SUCCESS (versions before
1.6.2 would incorrectly fail in those cases).
This result will be reported to the Plugin Manager which started this plugin and
it will forward this result to the Evaluation Manager, which will take
appropriate actions for the next plugin to run. 

.SH OPTIONS
.TP
.BI -banmapfile\ "banmapfile"
When this option is set the plug-in will use the path to the banning gridmapfile
as a ban file.
It is advised to use an absolute path to the gridmapfile to avoid usage of the
wrong file(path).
.TP
.BI -disablewildcard
When this option is set the plug-in will only match exact FQANs, i.e. /dteam*
will not match.

.SH RETURN VALUES
.TP
.B LCMAPS_MOD_SUCCESS
Success.
.TP
.B LCMAPS_MOD_FAIL
Failure or banned.
.SH BUGS
Please report any errors to the Nikhef Grid Middleware Security Team
<grid-mw-security-support@nikhef.nl>.
.SH "SEE ALSO"
.BR lcmaps.db (5), 
.BR lcmaps (3).
.SH AUTHORS
LCMAPS and the LCMAPS plug-ins were written by the Grid Middleware Security Team 
<grid-mw-security@nikhef.nl>.