From 0c639a12ac0b10193f587ca5c15a526c7f1a9b28 Mon Sep 17 00:00:00 2001 From: Jacob Bachmeyer Date: Wed, 16 Nov 2022 21:38:58 -0600 Subject: [PATCH] Explain intended use of ftp_abort --- gatekeeper.pl | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/gatekeeper.pl b/gatekeeper.pl index 139fbd9..e1509e9 100755 --- a/gatekeeper.pl +++ b/gatekeeper.pl @@ -441,6 +441,12 @@ to exit with the current value of the C<$AbortExitCode> global variable. If the C<$AbortPipe> global variable is defined and an open file, sends MESSAGE there; otherwise MESSAGE is sent to syslog with 'err' severity. +Most errors should be handled with die or throw, both of which throw +exceptions that can be caught, allowing processing to continue with the +next packet uploaded. This sub should be used only for system errors or +other situations that suggest that further processing will be futile. This +sub should B be called as a direct result of invalid remote input. + =cut sub ftp_abort($) { -- 2.25.1