| Mandatory Options |
|
| -host:[user:pass@]host[:port] | Specifies the SMTP server to be used to deliver the message. A username and password may optionally be specified for SMTP authentication. Supported mechanisms are CRAM-MD5, PLAIN, and LOGIN (in order of preference). This setting cannot be used with -file. |
|
| -file:filename | Specifies a file name to write the constructed e-mail message to instead of sending it via SMTP. This setting cannot be used with -host. |
|
| -from:address[:name] | Specifies the e-mail address, and optional name, to appear in the 'From' header of the message. |
|
| -to:address[:name] | Adds a recipient, with an optional name, to appear in the 'To' field of the message. This setting may be specified multiple times. |
|
| -cc:address[:name] | Adds a recipient, with an optional name, to appear in the 'Cc' field of the message. This setting may be specified multiple times. |
|
| -bcc:address | Adds a recipient which is not visible in the message headers. This setting may be specified multiple times. |
|
| Content Control |
|
| -subject:subject text | Specifies the message subject (literal string). |
|
| -body:message body | Specifies the message body. Note: '\\','\r','\n', and '\t' are valid escape codes. |
|
| -body-64 | Use base64 encoding for the message body. |
|
| -body-qp | Use quoted-printable encoding for the message body. |
|
| -head:header:value | Add the specified header and header value to the message. This option may be specified multiple times. E.g. -head:X-No-Archive:Yes. |
|
| -mime | Force use of MIME for the message body in messages having no attachments. CMail by default sends only plain text messages only when no attachments are specified. |
|
| -smtp-transparency | When writing output to files, this repeats the first character on the line if it is '.'. Use this if the output files are to be sent via an SMTP server without further interpretation. |
|
| -- | Read message body from stdin. |
|
| Attachments |
|
| -a:filename | Attach the specified file. CMail will select base64 or quoted-printable encoding automatically. Files containing >85% ASCII text in the first 4kB will be quoted-printable encoded. |
|
| -a64:filename | Attach the specified file using base64 encoding. |
|
| -aqp:filename | Attach the specified file using quoted-printable encoding. |
|
| -auu:filename | Attach the specified file using UU encoding. These attachments are encoded within the message body. |
|
| -ayenc:filename | Attach the specified file using yEnc encoding. Note, yEnc encoding will most likely result in RFC violations in the output stream. These attachments are encoded within the message body. |
|
| Connection Control |
|
| -4 | Use IPv4. |
|
| -6 | Use IPv6. |
|
| -authtypes:type[,type...] | A comma-separated list of authentication types which may be used with the upstream server. Supported values are CRAM-MD5, PLAIN, and LOGIN. |
|
| -helo:hostname | Use the specified hostname in HELO/EHLO. |
|
| -proxy:[user:pass@]host[:port] | Connect via a proxy. Authentication is only supported for HTTPS proxies. |
|
| -proxytype:type | Supported proxy types are SOCKS (default proxy type, default port 1080), and HTTPS (default port 8080). |
|
| -requiretls | Require TLS is used for mail delivery. Implies -starttls. |
|
| -starttls | Attempt to use TLS if STARTTLS is advertised in response to EHLO. |
|
| Debugging |
|
| -d | Debug mode, show data to and from the server. |
|
| Command line only |
|
| -config:filename | Apply the configuration from the specified file. |
|
| -nodefault | Do not apply settings from the default cmail.conf. |
|
| -skipnofile | By default CMail checks attachments exist before sending the e-mail, and exits if they do not. This option disables this check. Note that e-mail will still be sent even if one or more attachments is deleted after this check, as CMail dynamically creates messages during the SMTP session. |
|
| Configuration |
|
| CMail applies configuration options from a default configuration file, a command line specified configuration file, and from the command line itself, in that order. Items for which multiple values can be assigned (E.g. to) are ADDED from each configuration. For settings that can only be specified once, the last occurance will be used. I.e. You can specify a default configuration in cmail.conf, and overide settings for individual messages by specifying another config file, or via the command line. |
|
| The default configuration is stored in ~/cmail.conf on *nix platforms, and %APPDATA%\cmail.conf on Windows. |
|
| Configuration files must contain one setting per line, and do not include the '-' prefix. |
|