qpsmtpd Wiki

[[api:hook_return_values]]

You are here: start » api » hook_return_values

Login

You are currently not logged in! Enter your authentication credentials below to log in. You need to have cookies enabled to log in.

Login

You don't have an account yet? Just get one: Register

Forgotten your password? Get a new one: Set new password

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

api:hook_return_values [2007/01/09 00:53]
jamtur01
api:hook_return_values [2007/08/21 15:23] (current)
vetinari clarify what happens on NOT returning DECLINED
Line 7: Line 7:
 ====OK==== ====OK====
  
-The ''OK'' return value implies that the plugin has performed some sort of checking on this [[connection]] or [[transaction]], and that the remaining plugins should not be called for the current ''hook''. //This is not very clear//+The ''OK'' return value implies that the plugin has performed some sort of checking on this [[connection]] or [[transaction]], and that the remaining plugins should not be called for the current ''hook''. //This is not very clear// ((keep in mind that plugins are called in the order of the //plugins// config file, for most hooks: returning anything else than ''DECLINED'' will not run any later plugins))
  
 ====DONE==== ====DONE====
 +
  
 ====DENY==== ====DENY====
  
-The ''DENY'' return value tells qpsmtpd to end this [[transaction]] with a xx_error_code]].+The ''DENY'' return value tells qpsmtpd to end this [[transaction]] with a [[5xx_error_code]].
  
 ====DENY_DISCONNECT==== ====DENY_DISCONNECT====
  
-The ''DENY_DISCONNECT'' return value tells qpsmtpd to end this [[transaction]] with a xx_error_code]] and to end the [[connection]] by "hanging up" on the connecting client.+The ''DENY_DISCONNECT'' return value tells qpsmtpd to end this [[transaction]] with a [[5xx_error_code]] and to end the [[connection]] by "hanging up" on the connecting client.
  
 ====DENYSOFT==== ====DENYSOFT====
  
-The ''DENYSOFT'' return value tells qpsmtpd to end this [[transaction]] with a xx_error_code]], i.e. a temporary error.+The ''DENYSOFT'' return value tells qpsmtpd to end this [[transaction]] with a [[4xx_error_code]], i.e. a temporary error.
  
  
Line 27: Line 28:
  
  
-The ''DENYSOFT_DISCONNECT'' return value tells qpsmtpd to end this [[transaction]] with a xx_error_code]], i.e. a temporary error, and to end the [[connection]] by "hanging up" on the connecting client.+The ''DENYSOFT_DISCONNECT'' return value tells qpsmtpd to end this [[transaction]] with a [[4xx_error_code]], i.e. a temporary error, and to end the [[connection]] by "hanging up" on the connecting client.
  
 ====DECLINED==== ====DECLINED====
  
-The ''DECLINED'' return code is used to indicate that the plugin does not wish to affect reception of this message, or that the plugin has failed internally. It will imply that the next plugin is called, so many plugins will use ''DECLINED'' and not ''OK'' to signal that this plugin thinks the message is legitimate. //This is not very clear either//+The ''DECLINED'' return code is used to indicate that the plugin does not wish to affect reception of this message, or that the plugin has failed internally. It will imply that the next plugin is called, so many plugins will use ''DECLINED'' and not ''OK'' to signal that this plugin thinks the message is legitimate. //This is not very clear either// ((see other footnote))