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

FreeBSD Manual Pages

  
 
  

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

NAME
       emil - conversion filter	for Internet messages

SYNOPSIS
       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 ]

DESCRIPTION
       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/emil.cf	,  by  the Target_Group	or as specified	by the command
       line options.

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-
		     CAL[0-7].

	      -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
		     emil.cf.

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

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

	      -e Configuration_file
		     Path  to  file for	use as configuration file. Defaults to
		     /usr/local/lib/emil.cf

	      -c Charsets_file
		     Path to file  for	use  as	 charsets  file.  Defaults  to
		     /usr/local/lib/charsets.cpl

       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 emil.cf(1).

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

	      -G Target_Group
		     Use Target_Group to specify use of	a conversion group, as
		     declared  in  emil.cf.  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
		     emil.cf. See also emil.cf(1).

       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
		     message.

	      -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
		     prepended.

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

	      -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.

       EXAMPLES

	      To use emil as a simple filter:

	      %cat message.in |	emil [OPTIONS] > message.out

	      or

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

       See the other documentation for further information.

FILES
       /usr/local/lib/emil.cf
			   configuration file.

       /usr/local/lib/charsets.cpl
			   file	 containing  the  character set	conversion ta-
			   bles.

AUTHOR
       Martin Wendel (Martin.Wendel@its.uu.se) and  Torbjorn  Wictorin	(Torb-
       jorn.Wictorin@its.uu.se)

SEE ALSO
       emil.cf(1)

BUGS
       None?

			       19 December 1994			       EMIL(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=emil&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help