Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
EMIL(1)			    General Commands Manual		       EMIL(1)

       emil - conversion filter	for Internet messages

       emil  [ -s  Sender ]  [ -r  Recipient ] [ -x Recipient_host ] [ -l Sys-
       log_level ] [ -h	 Headerlog_level ]  [ -f  Syslog_facility ]  [ -i  In-
       put_file	]  [ -o	 Output_file ] [ -m Mailer ] [ -e Configuration_file ]
       [ -c Charsets_file ] [ -A Recipient_applefile_encoding ]	 [ -B  Recipi-
       ent_bin_encoding	]  [ -C	 Recipient_charset ]  [	-F  Recipient_format ]
       [ -H Recipient_header_encoding ]	 [ -S  Sender_charset ]	 [ -T  Recipi-
       ent_text_encoding ]  [ -G  Target_Group ]  [ -n ]  [ -p ] [ -g ]	[ -d ]
       [ -u ] [	-v ]

       The message conversion filter emil is used to convert the  encoding  of
       enclosures  and	character set of an Internet message aswell as between
       the three message formats  MIME,	 SUN  Mailtool	and  plain  old	 style
       RFC822.	Emil loads the message and applies the changes in encoding and
       formatting in core. There is no spooling.

       Emil can	be applied by sendmail,	if specified as	a delivery agent,  and
       can  also invoke	sendmail or other programs for it's output.  When used
       like this, emil does not	close the connection with the calling sendmail
       until it	returns	an EX_OK from the called program, as a safety measure.

       Emil  can also be used by a mail	client program or as a prefix to a de-
       livery agent like binmail when acting like a regular filter.  Usage  is
       mainly limited by your imagination.

       Conversion is controlled	either by the combination of Sender, Recipient
       and Recipient_host as specified	in  the	 configuration	file  /usr/lo-
       cal/lib/	,  by  the Target_Group	or as specified	by the command
       line options.

       Options may appear in any order.

	      -s Sender
		     Sender's mail address.

	      -r Recipient
		     Recipient's mail address.

	      -x Recipient_host
		     Name of the recipient host	or relay.

	      -f Syslog_facility
		     Pick one of: m - LOG_MAIL,	d -  LOG_DAEMON,  0-7  LOG_LO-

	      -l Syslog_level
		     Log  level	 is  set by specifying a number	1-4. Log level
		     becomes: 1	- LOG_ERR, 2 - LOG_NOTICE, 3 - LOG_INFO, 4 and
		     more - LOG_DEBUG.

	      -m Mailer
		     Send  output to the specified Mailer, where Mailer	corre-
		     sponds to a mailer	definition in the  configuration  file

	      -i Input_file
		     Path  to  file for	use as input. Defaults to standard in-

	      -o Output_file
		     Path to file for use as output. Defaults to standard out-

	      -e Configuration_file
		     Path  to  file for	use as configuration file. Defaults to

	      -c Charsets_file
		     Path to file  for	use  as	 charsets  file.  Defaults  to

       Beware, when applying any of the	next five options, there is no recipi-
       ent look	up in the configuration	file.

	      -A Recipient_applefile_encoding
		     Recipient	applefile  encoding.  One  of  B(inhex),  (ap-
		     ple)d(ouble)  or (apple)s(ingle).	This defaults to noth-
		     ing, thus no applefile conversion if omitted unless  got-
		     ten from the configuration	file.

	      -B Recipient_binary_encoding
		     Recipient binary encoding.	One of BAse64, BInhex or Uuen-
		     code.  This defaults to nothing, thus no binary  encoding
		     conversion	 if  omitted unless gotten from	the configura-
		     tion file.

	      -C Recipient_charset
		     Recipient charset according to RFC1345.

	      -F Recipient_format
		     Recipient format. One of MIME, MAILTOOL, RFC822 or	TRANS-
		     PARENT. Defaults to RFC822.

	      -H Recipient_header_encoding
		     Recipient	header encoding. One of	Se, 7bit, 8bit,	BAse64
		     or	Quoted-printable.  See also

	      -T Recipient_text_encoding
		     Recipient text encoding. One of Se, 7bit,	8bit,  BAse64,
		     BInhex,	Quoted-printable   or	Uuencode.   See	  also

	      -G Target_Group
		     Use Target_Group to specify use of	a conversion group, as
		     declared  in  If	Target_Group is	specified Emil
		     will not try to resolve conversion	group using recipient,
		     sender  and  recipient  host,  instead it performs	a case
		     sensitive match on	the conversion groups as  declared  in See also

       Beware,	when  applying	the  Sender_charset option, there is no	sender
       look up in the configuration file.

	      -S Sender_charset
		     Sender charset according to RFC1345.

	      -h Headerlog_level
		     Log in message header. This is for	testing, not for  pro-
		     duction use.  Log level is	specified by a number 1-4. Log
		     level becomes: 1 -	LOG_ERR, 2 - LOG_NOTICE, 3 - LOG_INFO,
		     4 and more	- LOG_DEBUG.

	      -p     Adds a pseudo route to sendmail when using	the -f option.
		     Instead of	calling	sendmail with the recipient's address,
		     call  with	 @EMIL:"recipient address". Used when sendmail
		     is	used to	call emil, to catch the	visit to emil  of  the

	      -u     Prepends  a unix from line	first in the message/keeps the
		     unix from line if provided	in the	incoming  message.  If
		     not  specified  the  unix	from  line will	be removed/not

	      -g     Test configuration	file. Returns the matching group  name
		     based  on	the  provided  recipient, sender and recipient

	      -v     Just prints version, then exits.

	      -d     Enables debugging on stderr. Using	this will create volu-
		     minous output.

	      -n     Set  up  an  SMTP connection to the host, as specified by
		     the Recipient_host, and send output on  that  connection.
		     This makes	Emil act as an SMTP-client, and	can be used as
		     a replacement for the tcp mailer of sendmail.


	      To use emil as a simple filter:

	      %cat |	emil [OPTIONS] > message.out


	      %emil [OPTIONS] -i -o	message.out

       See the other documentation for further information.

			   configuration file.

			   file	containing the character  set  conversion  ta-

       Martin  Wendel  (  and Torbjorn Wictorin	(Torb-



			       19 December 1994			       EMIL(1)


Want to link to this manual page? Use this URL:

home | help