---

4.12.1 Predefined Variables

Several variables are predefined. In mailfromd version 9.2 these are:

Predefined Variable: number milter_state ¶

Identifies the current milter state (see milter state). The module milter.mfl defines the following symbolic names:

milter_state_none

milter_state_startup

milter_state_shutdown

milter_state_begin

milter_state_end

milter_state_connect

milter_state_helo

milter_state_envfrom

milter_state_envrcpt

milter_state_data

milter_state_header

milter_state_eoh

milter_state_body

milter_state_eom

milter_action

Use the milter_state_name function to obtain the corresponding textual string (see milter_state_name).

Predefined Variable: string milter_server_id ¶

Identifier of the milter server which executes the code. This is the string passed to the id statement in the server section of the configuration file (see Server Configuration),

Predefined Variable: string milter_server_address ¶

Address of the socket the milter server is listening to. This is defined by the listen statement in the server section of the configuration file (see Server Configuration),

Predefined Variable: number milter_server_family ¶

Address family of the milter server address, as defined by the listen statement in the server section of the configuration file (see Server Configuration). See the FAMILY_ constants in Table 4.3.

Predefined Variable: string milter_client_address ¶

Address of the milter client which initiated the connection.

Predefined Variable: number milter_client_family ¶

Address family of milter_client_address. See the FAMILY_ constants in Table 4.3.

Predefined Variable: number cache_used ¶

This variable is set by stdpoll and strictpoll built-ins (and, consequently, by the on poll statement). Its value is ‘1’ if the function used the cached data instead of directly polling the host, and ‘0’ if the polling took place. See SMTP Callout Functions.

You can use this variable to make your reject message more informative for the remote party. The common paradigm is to define a function, returning empty string if the result was obtained from polling, or some notice if cached data were used, and to use the function in the reject text, for example:

func cachestr() returns string
do
  if cache_used
    return "[CACHED] "
  else
    return ""
  fi
done

Then, in prog envfrom one can use:

on poll $f
do
when not_found or failure:
  reject 550 5.1.0 cachestr() . "Sender validity not confirmed"
done

Predefined Variable: number clamav_stream_max_length ¶

Maximum size of a message chunk, used when sending message to ClamAV daemon. Must be less than or equal to the value of StreamMaxLength parameter in clamd.conf.

Default value is 4096.

See ClamAV.

Predefined Variable: string clamav_virus_name ¶

Name of virus identified by ClamAV. Set by clamav function (see ClamAV).

Predefined Variable: number greylist_seconds_left ¶

Number of seconds left to the end of greylisting period. Set by greylist and is_greylisted functions (see Special Test Functions).

Predefined Variable: string ehlo_domain ¶

Name of the domain used by polling functions in SMTP EHLO or HELO command. Default value is the fully qualified domain name of the host where mailfromd is run. See Sender Verification Tests.

Predefined Variable: string last_poll_greeting ¶

Callout functions (see SMTP Callout Functions) set this variable before returning. It contains the initial SMTP reply from the last polled host.

Predefined Variable: string last_poll_helo ¶

Callout functions (see SMTP Callout Functions) set this variable before returning. It contains the reply to the HELO (EHLO) command, received from the last polled host.

Predefined Variable: string last_poll_host ¶

Callout functions (see SMTP Callout Functions) set this variable before returning. It contains the host name or IP address of the last polled host.

Predefined Variable: string last_poll_recv ¶

Callout functions (see SMTP Callout Functions) set this variable before returning. It contains the last SMTP reply received from the remote host. In case of multi-line replies, only the first line is stored. If nothing was received the variable contains the string ‘nothing’.

Predefined Variable: string last_poll_sent ¶

Callout functions (see SMTP Callout Functions) set this variable before returning. It contains the last SMTP command sent to the polled host. If nothing was sent, last_poll_sent contains the string ‘nothing’.

Predefined Variable: string mailfrom_address ¶

Email address used by polling functions in SMTP MAIL FROM command (see Sender Verification Tests.). Default is ‘<>’. Here is an example of how to change it:

set mailfrom_address "postmaster@my.domain.com"

You can set this value to a comma-separated list of email addresses, in which case the probing will try each address until either the remote party accepts it or the list of addresses is exhausted, whichever happens first.

It is not necessary to enclose emails in angle brackets, as they will be added automatically where appropriate. The only exception is null return address, when used in a list of addresses. In this case, it should always be written as ‘<>’. For example:

set mailfrom_address "postmaster@my.domain.com, <>"

Predefined Variable: number sa_code ¶

Spam score for the message, set by sa function (see sa).

Predefined Variable: number rcpt_count ¶

The variable rcpt_count keeps the number of recipients given so far by RCPT TO commands. It is defined only in ‘envrcpt’ handlers.

Predefined Variable: number sa_threshold ¶

Spam threshold, set by sa function (see sa).

Predefined Variable: string sa_keywords ¶

Spam keywords for the message, set by sa function (see sa).

Predefined Variable: number safedb_verbose ¶

This variable controls the verbosity of the exception-safe database functions. See safedb_verbose.