3 # Copyright (c) The Exim Maintainers 2023
4 # Copyright (c) University of Cambridge, 1995 - 2007
5 # See the file NOTICE for conditions of use and distribution.
7 # Except when they appear in comments, the following placeholders in this
8 # source are replaced when it is turned into a runnable script:
10 # CONFIGURE_FILE_USE_NODE
16 # A shell+perl script to fish out the next retry time for a given domain;
17 # it first calls exim to find out which hosts are set up for that domain and
18 # then fishes out the retry data for each one.
20 # For testing the selection and formatting logic, and perhaps for use in
21 # special cases, the script can have an argument -C <filename> to specify
22 # the use of an alternate Exim configuration file. It may also have any number
23 # of -D options to set macros that are passed to exim.
29 if [ "x$1" = x--version -o "x$1" = x-v ]
31 echo "`basename $0`: $0"
32 echo "build: EXIM_RELEASE_VERSIONEXIM_VARIANT_VERSION"
36 if expr -- $1 : '\-' >/dev/null ; then
37 while expr -- $1 : '\-' >/dev/null ; do
38 if [ "$1" = "-C" ]; then
42 elif expr -- $1 : '\-D' >/dev/null ; then
43 eximmacdef="$eximmacdef $1"
44 if expr -- $1 : '\-DEXIM_PATH=' >/dev/null ; then
45 exim_path=`expr -- $1 : '\-DEXIM_PATH=\(.*\)'`
54 # We need to save the script's argument because in the absence of -C we need to
55 # use shell arguments for sorting out the configuration file name.
59 # This is the normal case when no config file or macros are specified
61 if [ "$config" = "" ]; then
62 # See if this installation is using the esoteric "USE_NODE" feature of Exim,
63 # in which it uses the host's name as a suffix for the configuration file name.
65 if [ "CONFIGURE_FILE_USE_NODE" = "yes" ]; then
66 hostsuffix=.`uname -n`
69 # Now find the configuration file name. This has got complicated because
70 # CONFIGURE_FILE may now be a list of files. The one that is used is the first
71 # one that exists. Mimic the code in readconf.c by testing first for the
72 # suffixed file in each case.
74 set `awk -F: '{ for (i = 1; i <= NF; i++) print $i }' <<End
78 while [ "$config" = "" -a $# -gt 0 ] ; do
79 if [ -f "$1$hostsuffix" ] ; then
80 config="$1$hostsuffix"
81 elif [ -f "$1" ] ; then
88 # Determine where the spool directory is. Search for an exim_path setting
89 # in the configure file; otherwise use the bin directory. Call that version of
90 # Exim to find the spool directory and the qualify domain. BEWARE: a tab
91 # character is needed in the command below. It has had a nasty tendency to get
92 # lost in the past. Use a variable to hold a space and a tab to keep the tab in
97 if [ "$exim_path" = "" ]; then
98 exim_path=`grep "^[$st]*exim_path" $config | sed "s/.*=[$st]*//"`
101 if test "$exim_path" = ""; then exim_path=BIN_DIRECTORY/exim; fi
102 spool_directory=`$exim_path $eximmacdef -C $config -bP spool_directory | sed 's/.*=[ ]*//'`
103 qualify_domain=`$exim_path $eximmacdef -C $config -bP qualify_domain | sed 's/.*=[ ]*//'`
105 # Now do the job. Perl uses $ so frequently that we don't want to have to
106 # escape them all from the shell, so pass in shell variable values as
109 # 16-May-1996 Fixed it to do better if routing fails to complete.
110 # Improved the format of the output.
111 # 10-Jun-1996 Complain if no argument given.
112 # 02-Aug-1996 Lower case the domain.
113 # 14-Jan-1999 Add subject to want list even if remote host found, so as to
114 # pick up routing delays after temporary recipient errors.
115 # Also add unqualified subject if it looks like a message id.
116 # 01-Apr-2004 Add the -C feature for testing
117 # 22-Dec-2005 Complete the -C feature (!)
119 if [ "$argone" = "" ]; then
120 echo "Usage: exinext <address>|<domain>|<local-part>"
124 perl - $exim_path "$eximmacdef" $argone $spool_directory $qualify_domain $config <<'End'
126 # We don't import anything, but guard against future changes which do
127 BEGIN { pop @INC if $INC[-1] eq '.' };
132 $eximmacdef = $ARGV[1];
138 # If the subject doesn't contain an @ then construct an address
139 # for the domain, and ensure that in both cases the domain is
142 $address = ($subject =~ /^([^\@]*)\@([^\@]*)$/)?
143 "$1\@\L$2\E" : "User\@\L$subject\E";
145 # Run Exim to get a list of hosts for the given domain; for
146 # each one construct the appropriate retry key.
148 open(LIST, "$exim -C $config -v -bt $address |") ||
149 die "can't run exim to route $address";
154 push(@list, $_) if s/\s*host (\S+)\s+\[(.+)\].*/$1:$2/;
155 print "$_\n" if /cannot be resolved/;
159 # If there were no hosts, assume that what was given was a local
160 # username, unless it contains an @, and construct a suitable retry
161 # key for that. Also, if it looks like a message id, search for that
162 # as well, so as to pick up message-specific retry data.
164 if (scalar(@list) == 0)
166 push(@list, $subject) if $subject =~ /^\w{6}-\w{11}-\w{4}$/;
167 push(@list, $subject) if $subject =~ /^\w{6}-\w{6}-\w{2}$/;
169 if ($subject !~ /\@/ && $subject !~ /\./)
171 push(@list, "$subject\@$qualify");
175 print "No remote hosts found for $subject\n";
179 # Always search for the full address, even if hosts are found, in case
180 # there is a routing delay caused by a temporary recipient error.
182 push(@list, $subject);
184 # Run exim_dumpdb to get out the retry data and pick off what we want
186 open(DATA, "${exim}_dumpdb $spool retry |") ||
187 die "can't run exim_dumpdb";
191 for ($i = 0; $i <= $#list; $i++)
196 if (/^\s*T:[^:\s]*:/)
198 ($key,$error,$error2,$text) = /^\s*T:(\S+)\s+(\S+)\s+(\S+)\s*(.*)$/;
200 # Parsing the keys is a nightmare because of IPv6. The design of the
201 # format for the keys is a complete shambles. All my fault (PH). But
202 # I don't want to change it just for this purpose. If they key
203 # contains more than 3 colons, we have an IPv6 address, because
204 # an IPv6 address must contain at least two colons.
206 # Deal with IPv4 addresses (3 colons or fewer)
208 if ($key !~ /:([^:]*?:){3}/)
210 ($host,$ip,$port,$msgid) = $key =~
211 /^([^:]*):([^:]*)(?::([^:]*)(?::(\S*)|)|)/;
214 # Deal with IPv6 addresses; sorting out the colons is a complete
215 # mess. We should be able to find the host name and IP address from
216 # further in the message. That seems the easiest escape plan here. We
217 # can use those to match the rest of the key.
221 ($host,$ip) = $text =~ /host\s(\S+)\s\[([^]]+)\]/;
224 ($port,$msgid) = $key =~
225 /^$host:$ip(?::([^:]*)(?::(\S*)|)|)/;
228 # This will probably be wrong...
232 ($host,$ip) = $key =~ /([^:]*):(.*)/;
236 printf("Transport: %s [%s]", $host, $ip);
237 print ":$port" if defined $port;
238 print " $msgid" if defined $msgid;
239 print " error $error: $text\n";
244 ($type,$domain,$error,$error2,$text) =
245 /^\s*(\S):(\S+)\s+(\S+)\s+(\S+)\s*(.*)$/;
246 $type = ($type eq 'R')? "Route: " :
247 ($type eq 'T')? "Transport: " : "";
248 print "$type$domain error $error: $text\n";
251 ($first,$last,$next,$expired) =
252 /^(\S+\s+\S+)\s+(\S+\s+\S+)\s+(\S+\s+\S+)\s*(\*?)/;
253 print " first failed: $first\n";
254 print " last tried: $last\n";
255 print " next try at: $next\n";
256 print " past final cutoff time\n" if $expired eq "*";
262 print "No retry data found for $subject\n" if !$printed;