clarify what "return values are ignored or discarded" means

git-svn-id: https://svn.perl.org/qpsmtpd/trunk@925 958fd67b-6ff1-0310-b445-bb7760255be9
This commit is contained in:
Hanno Hecker 2008-06-03 16:09:59 +00:00 committed by Ask Bjørn Hansen
parent 6fc25099b0
commit 28f4cd51c1

View File

@ -410,6 +410,13 @@ are noted in the description of the hook. If you need examples how the
hook can be used, see the source of the plugins, which are given as hook can be used, see the source of the plugins, which are given as
example plugins. example plugins.
B<NOTE>: for some hooks (post-fork, post-connection, disconnect, deny, ok) the
return values are ignored. This does B<not> mean you can return anything you
want. It just means the return value is discarded and you can not disconnect
a client with I<DENY_DISCONNECT>. The rule to return I<DECLINED> to run the
next plugin for this hook (or return I<OK> / I<DONE> to stop processing)
still applies.
=head2 hook_pre_connection =head2 hook_pre_connection
Called by a controlling process (e.g. forkserver or prefork) after accepting Called by a controlling process (e.g. forkserver or prefork) after accepting