EMIL version 2 TUTORIAL

# TUTORIAL FOR EMIL VERSION 2.1

Written by Martin Wendel, ITS, Uppsala university. Martin.Wendel@its.uu.se

## COMMAND LINE ARGUMENTS

### Address specification arguments:

- -r <address> The address of the recipient.
- -s <address> The address of the sender.
- -x <hostname> The name of the recipient host.

The address specifications are used when you want to redirect output to a program such as /bin/mail or sendmail. The usage of these addresses is as arguments to the execv of the program. They are also used to lookup sender and recipient information such as format and encoding etc. Emil does not rewrite addresses, so beware the address format you use.

### Target Group specification

- -G <group> The target conversion group.

The target group specification is used when you want Emil to act according to a conversion profile specified in emil.cf. The conversion profile should be specified in emil.cf using the group command (see the documentation of emil.cf).

### Format, Encodings and Charsets

- -A <appletype> The target applefile encoding style.
- -B <encoding> The target binary encoding style.
- -C <charset> The target charset.
- -F <format> The target format.
- -H <encoding> The target header encoding style.
- -S <charset> The sender's charset.
- -T <encoding> The target text encoding style.

#### Legal values

- <appletype> One of:
  - (s) AppleSingle
  - (d) AppleDouble
  - (b) BinHex
- <format> One of:
  - (MIME) MIME - MIME message format.
  - (MAILTOOL) Mailtool - SUN Mailtool message format.
  - (RFC822) RFC822 - Plain old style RFC822 message format.
  - (TRANSPARENT) Pass through the message as it is, without conversion.
- <encoding> Choose between:
  - (7) 7bit - 7bit encoding (if text or header, converts to US-ASCII).
  - (8) 8bit - 8bit encoding.
  - (s) se - convert to national variant of ASCII (for type text and header only).
  - (bi) binhex - BinHex encoding.
  - (u) uuencode - UUencode encoding.
  - (ba) base64 - Base64 encoding.
  - (q) quoted-printable - Quoted-Printable.
- <charset> Any charset name as defined in rfc1345.

It is possible to explicitly specify the format, encoding or charset of the target message on the command line. If done, the lookup for this information in the configuration file is disabled. Therefore, make sure to apply a complete specification of the format and encoding features using these arguments, if one of them is omitted the value of that feature will be set to the default value.

The specification of the sender's charset will not override the charset specification of a MIME or Mailtool message. Therefore this is really only used when converting an old style RFC822 message.

### Logging and Debug

- -d Debug output on stderr.
- -f <facility> The log facility of syslog logging.
- -h <level> The log level of header logging.
- -l <level> The log level of syslog logging.

#### Legal values

- <facility> Choose between:
  - m - LOG_MAIL
  - d - LOG_DAEMON
  - 0 - LOG_LOCAL0
  - 1 - LOG_LOCAL1
  - 2 - LOG_LOCAL2
  - 3 - LOG_LOCAL3
  - 4 - LOG_LOCAL4
  - 5 - LOG_LOCAL5
  - 6 - LOG_LOCAL6
  - 7 - LOG_LOCAL7
- <level> Choose between:
  - 1 - LOG_ERR
  - 2 - LOG_NOTICE
  - 3 - LOG_INFO
  - 4 - LOG_DEBUG

Logging and debug is controlled using the above command line arguments.

#### Configuration files

- -c <path> Path of charsets file.
- -e <path> Path of configuration file.

It is possible to explicitly specify the path of the configuration or charsets files. If not specified, the default paths will be used.

#### I/O Specifications

- -i <path> Path of input file.
- -m <mailer> The program to which to pipe output (see the configuration file).
- -n Pipe output to the builtin SMTP client.
- -o <path> Path to output file.
- -p Add pseudo route to recipient address.
- -u Wants UNIX style from line.

Input/Output is controlled by command line arguments and this applies for the SMTP client and the redirect of output to arbitrary programs aswell. When using the builtin SMTP client, an SMTP connection to the recipient host (as specified by the command line arguments) will be opened. In the SMTP conversation, the specified sender and recipient addresses will be used. Therefore, make sure (when using this) that you have specified all three of these arguments.

#### Miscellaneous

- -g Return group match.
- -v Print out version.

It is possible the get information from Emil using the above flags. These arguments disables all other activities and should be used for testing purposes only. Emil will print the desired information and then exit.