PMDF User's Guide
UNIX Edition
send
Sends a mail message using PMDF.
restrictions
None.
Syntax
pmdf send message-file-spec[,...] recipient-address[,...]
Qualifiers |
Defaults |
-abort
|
See text
|
-comments=comment
|
None
|
-delivery_receipt_to=address
|
None
|
-errors_to=address
|
None
|
-expand_limit=limit
|
None
|
-extra=header_line
|
None
|
-from=address
|
See text
|
-headers
|
-noheaders
|
-ignore
|
See text
|
-importance=importance
|
None
|
-keywords=keywords
|
None
|
-log=log-list
|
-nolog
|
-organization=organization
|
None
|
-priority=priority
|
None
|
-read_receipt_to=address
|
None
|
-references=references
|
None
|
-reply_to=address
|
None
|
-return_address=address
|
See text
|
-rfrom=address
|
None
|
-rreply_to=address
|
None
|
-sensitivity=sensitivity
|
None
|
-subaddress=subaddress
|
None
|
-subject=subject
|
None
|
-user=username
|
See text
|
-warnings_to=address
|
None
|
-x_ps_qualifiers=qualifiers
|
None
|
Positional Qualifiers |
Defaults |
-bcc
|
-to
|
-cc
|
-to
|
-encoding=encoding
|
See text
|
-filename
|
-nofilename
|
-mode=mode
|
-mode=TEXT
|
-to
|
-to
|
prompts
Message file:
|
message-file-spec[,...]
|
Address:
|
recipient-address
|
Parameters
message-file-spec[,...]
One or more files to comprise the message; wildcards are not allowed.
Each file is included in the mail message as a separate part.
recipient-address[,...]
The recipients who are to receive copies of the message. Standard RFC
822 format addresses must be used. Quoting may be needed to preserve
case and special characters.
Description
The pmdf send
utility provides a simple easy-to-use
interface to PMDF for sending messages.
Qualifiers
-abort
By default, if an error occurs while processing an input message file
or recipient address, pmdf send
will ask the user whether
or not to send the message anyhow. If the -abort
qualifier
is specified, then pmdf send
will merely exit (with an
error) when a problem occurs during file or address processing. The
-abort
and -ignore
qualifiers are mutually
exclusive --- only one or the other may be used.
-bcc
Positional parameter which may be used to specify that the given
recipient address, and subsequent recipient addresses, should be
treated as Bcc:
addresses. By default, recipient addresses
are interpreted as To:
addresses. Must be placed after the
address to which it should apply.
-cc
Positional parameter which may be used to specify that the given
recipient address, and subsequent recipient addresses, should be
treated as cc:
addresses. By default, recipient addresses
are interpreted as To:
addresses. Must be placed after the
address to which it should apply.
-comments=comments
This qualifier may be used to specify the contents of the
Comments:
header line. If this qualifier is not used, any
existing Comments:
header line is used; if none exists no
Comments:
header line will appear in the outgoing message
unless the PMDF_COMMENTS
environment variable is defined.
-delivery_receipt_to=address
This qualifier may be used to specify the contents of the
Delivery-receipt-to:
header line. If this qualifier is not
used, any existing Delivery-receipt-to:
header line is
used; if none exists, no Delivery-receipt-to:
header line
will appear in the outgoing message.
-encoding=encoding
Specify the encoding method to use to encode an input message file.
Normally, no encoding is used; however, this depends upon the file type
as determined by the file extension. The available encoding methods are
BASE32
, BASE64
, CBASE64
(compressed base64), BASE85
, BINHEX
,
BTOA HEXADECIMAL
, QUOTED_PRINTABLE
,
UUENCODE
, and CUUENCODE
(compressed
UUENCODE). No encoding may be specified for a file containing header
information (-header
). Must be placed after the address to
which it should apply.
-errors_to=address
This qualifier may be used to specify the contents of the
Errors-to:
header line. If this qualifier is not used, any
existing Errors-to:
header line is used; if none exists no
Errors-to:
header line will appear in the outgoing message
unless the PMDF_ERRORS_TO
environment variable is defined.
-expand_limit=limit
If, during the process of expanding the message's recipient addresses,
the count of recipients exceeds the specified limit then the address
expansion will be deferred. pmdf send
will expand the
addresses "off-line" so that the user need not wait.
-extra=header_line
Additional header lines may be specified with the -extra
qualifier. Specify the entire text of the header line; e.g.,
-extra="X-Sign: Aquarius"
. Multiple header lines should be
specified using the format -extra=(hdr1,hdr2,...)
; note
that you will need to escape the parentheses characters to the shell by
quoting each with a backslash.
-filename
-nofilename (default)
This positional qualifier, when specified, causes the name of the input
file to be included as a parameter to the associated MIME
Content-type:
header line. Must be placed after the
address to which it should apply.
-from=address
This qualifier may be used to specify the contents of the
From:
header line. If this qualifier is not used, any
existing From:
header line is used; if none exists and the
PMDF_FROM
environment variable is not defined, then a
From:
header line will be constructed from the username of
the user invoking pmdf send
and from the local host name.
Note that even if a From: address is provided your address will appear
in a Sender:
header line.
-headers
-noheaders (default)
The input message is assumed to have no header attached to it by
default. The -headers
qualifier tells pmdf
send
that a header is already attached to the message; it is
modified and used to form the header for the message that is actually
sent.
-ignore
By default, if an error occurs while processing an input message file
or recipient address, pmdf send
will ask the user whether
or not to send the message anyhow. If the -ignore
qualifier is specified, then pmdf send
will not ask the
user whether or not to send the message --- it will send the good input
files to the good recipient addresses. The -abort
and
-ignore
qualifiers are mutually exclusive --- only one or
the other may be used.
-importance=importance
This qualifier may be used to specify the contents of the
Importance:
header line. If this qualifier is not used,
any existing Importance:
header line is used; if none
exists no Importance:
header line will appear in the
outgoing message unless the PMDF_IMPORTANCE
environment
variable is defined.
-keywords=keywords
This qualifier may be used to specify the contents of the
Keywords:
header line. If this qualifier is not used, any
existing Keywords:
header line is used; if none exists no
Keywords:
header line will appear in the outgoing message
unless the PMDF_KEYWORDS
environment variable is defined.
-log=log-list
Specify what sort of informational message pmdf send
should issue. The log-list is a list of zero or more of the following:
NONE
, ADDRESSES
, FILES
,
MESSAGES
, IDS
, or ALL
.
NONE
indicates no logging, is equivalent to
-nolog
, and is the default. ADDRESSES
causes
one informational message to be output for each specified recipient
address. FILES
causes one information message to be output
for each input file. MESSAGES
produces a summary message
that indicates how many addresses and files were processed
successfully. IDS produces an informational message showing the
contents of the Message-Id:
header of the resulting
message. ALL activates all forms of logging; it cannot be specified
simultaneously with NONE
. -log=messages
is
the default if -log
is specified without an explicit
log-list.
-mode=mode
Specify the file access mode to use when reading an input message file.
By default, input files are read in text mode. The access modes are
TEXT
and BLOCK
. A file containing header
information must be accessed using TEXT mode. Must be placed after the
address to which it should apply.
-organization=organization
This qualifier may be used to specify the contents of the
Organization:
header line. This qualifier is ignored if an
Organization:
header line is already present. If this
qualifier is not specified or negated, no Organization:
header line is added unless the PMDF_ORGANIZATION
environment variable is defined.
-priority=priority
This qualifier may be used to specify the contents of the
Priority:
header line. If this qualifier is not used, any
existing Priority:
header line is used; if none exists, no
Priority:
header line will appear in the outgoing message.
-read_receipt_to=address
This qualifier may be used to specify the contents of the
Read-receipt-to:
header line. If this qualifier is not
used, any existing Read-receipt-to:
header line is used;
if none exists, no Read-receipt-to:
header line will
appear in the outgoing message.
-references=references
This qualifier may be used to specify the contents of the
References:
header line. If this qualifier is not used,
any existing References:
header line is used; if none
exists no References:
header line will appear in the
outgoing message unless the PMDF_REFERENCES
environment
variable is defined.
-reply_to=address
This qualifier may be used to specify the contents of the
Reply-to:
header line. If this qualifier is not used, any
existing Reply-to:
header line is used; if none exists, no
Reply-to:
header line will appear in the outgoing message
unless the PMDF_REPLY_TO
environment variable is defined.
-return_address=address
Specify the address to be used as the envelope originator address. If
the message is returned as undeliverable by the mail system transport
the non-delivery notice is normally sent to this address.
-rfrom=address
This qualifier may be used to specify the contents of the
Resent-From:
header line. If this qualifier is not used,
any existing Resent-From:
header line is used; if no such
header line exists, no Resent-From:
header line will be
attached to the outgoing message.
-rreply_to=address
This qualifier may be used to specify the contents of the
Resent-Reply-to:
header line. If this qualifier is not
used, any existing Resent-Reply-to:
header line is used;
if no such header line exists no Resent-Reply-to:
header
line will be attached to the outgoing message.
-sensitivity=sensitivity
This qualifier may be used to specify the contents of the
Sensitivity:
header line. If this qualifier is not used,
any existing Sensitivity:
header line is used; if none
exists, no Sensitivity:
header line will appear in the
outgoing message unless the PMDF_SENSITIVITY
environment
variable is defined.
-subaddress=subaddress
Specify a subaddress to attach to the envelope From:
address; e.g., if the envelope From:
address is
rex@example.com then specifying -subaddress="Postmaster"
would result in the envelope From:
address
rex+Postmaster@example.com.
-subject=subject
This qualifier may be used to specify the contents of the
Subject:
header line. If this qualifier is not used, any
existing Subject:
header line is used; if none exists no
Subject:
header line will appear in the outgoing message.
-to
Positional parameter which may be used to specify that a given
recipient address should be treated as a To:
address,
which is the default interpretation. Must be placed after the address
to which it should apply.
-user=username
Specify the local username to use in the message sender's address;
(this will be the From: address if no other From:
address
is given and the Sender:
address otherwise). You must
either have superuser privilege or be in the pmdf_world
or
pmdf_world_username
group id in order to use this
qualifier and specify a username other than your own. The special case
of a blank string will not insert any Sender:
information.
-warnings_to=address
This qualifier may be used to specify the contents of the
Warnings-to:
header line. If this qualifier is not used,
any existing Warnings-to:
header line is used; if none
exists, no Warnings-to:
header line will appear in the
outgoing message unless the PMDF_WARNINGS_TO
environment
variable is defined.
-x_ps_qualifiers=qualifiers
This qualifier may be used to specify the contents of the
X-ps-qualifiers:
header line. If this qualifier is not
used, any existing X-ps-qualifiers:
header line is used;
if none exists no X-ps-qualifiers:
header line will appear
in the outgoing message unless the PMDF_X_PS_QUALIFIERS
environment variable is defined.
EXAMPLES
#1 |
% pmdf send -subject=\"Test message\" msg.txt bob@example.com
|
This command will send as a mail message the contents of the file
msg.txt
to the address bob@example.com. The
Subject:
line of the message will read Subject: Test
message
.
#2 |
% pmdf send -subject=\"Test message\" \
-extra='("X-Favorite-Drink: Hot chocolate", \
"X-IQ: 20/20")' msg.txt bob@example.com
|
Send a message to bob@example.com with the header lines
Subject: Test message
X-Favorite-Drink: Hot chocolate
X-IQ: 20/20
|
(Of course, these will not be the only header lines present.)
#3 |
% pmdf send -headers hdr.txt,msg.txt bob@example.com
|
Send a message to bob@example.com. The headers for the message will be
derived from the file hdr.txt
while the body of the
message will be the contents of the file msg.txt
.
#4 |
% pmdf send msg.txt -filename bob@example.com -to, sue@college.com -cc
|
This command shows the use of the positional qualifiers
-filename
, -to
, and -cc
. They
are placed after the parameter to which they apply.