smfi_getsymval

#include <libmilter/mfapi.h>
char* smfi_getsymval(
	     SMFICTX *ctx,
	     char *symname
);

smfi_getsymval description

Get the value of a sendmail macro. smfi_getsymval can be called from within any of the xxfi_* callbacks. Which macros are defined depends on when smfi_getsymval is called.

smfi_getsymval parameters

ctx: The opaque context structure.
symname: The name of a sendmail macro, optionally enclosed in braces ({ and }). See below for default macros.

smfi_getsymval result

smfi_getsymval returns the value of the given macro as a null-terminated string, or returns NULL if the macro is not defined.

Notes:

By default, the following macros are valid in the given contexts:

Sent With	Macros
xxfi_connect	daemon_name, if_name, if_addr, j, _
xxfi_helo	tls_version, cipher, cipher_bits, cert_subject, cert_issuer
xxfi_envfrom	i, auth_type, auth_authen, auth_ssf, auth_author, mail_mailer, mail_host, mail_addr
xxfi_envrcpt	rcpt_mailer, rcpt_host, rcpt_addr

All macros remain in effect from the point they are received until the end of the connection for the first two sets, the end of the message for the third set (xxfi_envfrom), and for each recipient for the final set (xxfi_envrcpt).
The macro list can be changed using the confMILTER_MACROS_* options in sendmail.mc. The scopes of such macros are determined by when they are set by sendmail. For descriptions of macro values, see Sendmail Installation and Operation Guide provided with the sendmail distribution.