.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH LCMAPS_DUMMY_GOOD.MOD 8 "March 22, 2011"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.\" Don't use HP, PD and DT -- DvD
.SH NAME
lcmaps_dummy_good.mod \- dummy LCMAPS plugin that always returns success
.SH SYNOPSIS
.ad l
.B lcmaps_dummy_good.mod 
.RB [{ \-\-dummy\-uid 
.IR uid |\c
.B \-\-dummy\-username
.IR user }] 
.RB [{ \-\-dummy\-gid
.IR gid |\c
.B \-\-dummy\-group
.IR group }] 
.RB [{ \-\-dummy\-sec\-gid 
.IR gid |\c
.B \-\-dummy\-sec\-group
.IR group }]
.ad b
.SH DESCRIPTION
LCMAPS plug-in that always returns successfully, optionally with a user and group mapping.
.SH OPTIONS
This plugin is configured in the
.BR lcmaps.db (5)
file, following the specific syntax as described in the documentation.
.TP
.BI "\-\-dummy\-uid " uid
.TQ
.BI "\-\-dummy\-username " user
The user id or user name to return as part of a successful mapping. The 
user must exist on the system. The default is to return no user information.
Use either of these options, not both.
.TP
.BI "\-\-dummy\-gid " gid
.TQ
.BI "\-\-dummy\-group " group
The group id or group name to return as part of a successful mapping. The group
must exist on the system; the default is to return no group mapping. Use either
of these options, not both.
.TP
.BI "\-\-dummy\-sec\-gid " gid
.TQ
.BI "\-\-dummy\-sec\-group " group
The secondary group mapping to return as part of a successful mapping.  The
group must exist on the system. Only one secondary group can be mapped by this
plug-in. The default is to return no secondary group mapping. Use either
of these options, not both.
.SH RETURN VALUE
This plugin always returns LCMAPS_MOD_SUCCESS, but if the given user or group was not
found on the system, the plugin returns LCMAPS_MOD_FAIL.
.SH BUGS
Please report any errors to the Nikhef Grid Middleware Security Team
<grid-mw-security-support@nikhef.nl>.
.SH SEE ALSO
.BR lcmaps (3),
.BR lcmaps.db (5).
.br
More information can be found on-line at 
.UR https://wiki.nikhef.nl/grid/Site_Access_Control
the Nikhef Wiki on Site Access Control
.UE .
.SH AUTHOR
LCMAPS and the LCMAPS plug-ins were written by the Grid Middleware Security Team 
<grid-mw-security@nikhef.nl>.