NAME
dtmail - the CDE Mailer
SYNOPSIS
dtmail [ -ch ] [ -f [server:][mailfile] ] [ -l deadletter ]
[ -a file1 ... fileN ] [ -T address ]
DESCRIPTION
dtmail is the mail user agent (MUA) for CDE. It provides an
intuitive, easy-to-use GUI for reading, sending, and manag-
ing electronic mail. dtmail supports both MIME and Sun Mail
Tool message formats for reading and sending messages. In
addition to local and NFS mailboxes, it also supports the
use of IMAP4 for accessing remote mailboxes. dtmail pro-
vides a mail-pervasive desktop environment by supporting the
Mail(4) and Display(4) Media Exchange messages. Other
applications can compose, send, and display electronic mail
messages using the ToolTalk API and these Media Exchange
messages.
OPTIONS
-a file1 ... fileN
Open a Compose window with file1 through fileN as
attachments.
-c Open a new Compose window.
-f [server:][filename]
Specify the mail file to be loaded in at start up time.
Ordinarily, the mail file pointed to by the environment
variable MAIL is read in as the user's inbox. Use of
the -f option overrides the use of the MAIL variable.
The optional server argument specifies the host name of
an IMAP server to use. If only server: is specified,
the Inbox on that IMAP server is opened (if it exists).
-h Display help for command-line options.
-l deadletter
Open a Compose window with the deadletter file loaded.
-T address
Open a Compose window with address in the To field.
FEATURES
IMAP4
dtmail supports the use of IMAP4 for accessing remote mail-
boxes. The use of this feature requires that an IMAP4
server be installed on the machine that manages your
mailboxes. You can configure the IMAP-related items in the
Basic and Move Menu Setup dialog boxes opened from the
Options menu.
Search
dtmail provides a search facility that allows you to create
your own complex queries as well as providing a GUI for sim-
ple searches. dtmail's advanced search facility supports
the following case-insensitive keywords:
o Header-related keywords: to, from, subject, cc, bcc,
text, body, header
o Date-related keywords: before, since, on, during,
today, yesterday, lastweek, thismonth, lastmonth
o Message State-related keywords: read, unread
o Logic operators: and, or, ~ (not), (, )
The following are examples of advanced searches:
- from kelly@tiger and subject "hi there" and during
lastweek
- (to gary or to tigerteam ) and ~ (to boss@tiger or cc
boss@tiger )
Nested parentheses are not allowed.
You can save your searches for use as a view via the Search
dialog box.
Signals
SIGUSR1 - Sending this signal to dtmail causes all mailboxes
to be closed. dtmail will exit if there are no compose win-
dows opened. This signal is also used by the Solstice Inter-
net Mail Server to inform a mail client to release control
of the mailbox.
SIGUSR2 - Sending this signal to dtmail causes all non-Inbox
mailboxes to be closed. This signal is also used by the
Solstice Internet Mail Server to inform a mail client to
release control of a non-Inbox mailbox.
Toolbar
You can customize the toolbar on the main mailbox window in
several ways:
o add or remove commands
o label buttons using either text or icon images
Configuring the toolbar is done via the Toolbar dialog
box opened from the Options menu.
If tooltip display is enabled then a tooltip label is
associated with each toolbar button. A tooltip label
describes the functionality of a button in a few words.
If tooltip display is disabled then the associated infor-
mation that would have been displayed via a tooltip label
is displayed in the status area.
ToolTalk
dtmail's ToolTalk interface enables other applications to
compose, send, and display email. dtmail supports the
Mail(4) and Display(4) Media Exchange messages. Other
applications can use these two types of requests to:
o Display a single message or a collection of messages
by using a Tttk_op value of TTME_DISPLAY and a media
type of RFC_822_MESSAGE.
o Open a Compose window with the supplied message data
loaded into the appropriate fields. This is done by
using a Tttk_op value of TTME_MAIL_EDIT and a media
type of RFC_822_MESSAGE.
o Open a Compose window with the supplied data loaded as
an attachment. This is done by using a Tttk_op value
of TTME_MAIL_EDIT and a media type of MAIL_TYPE.
o Open a new Compose window. This is done by using a
Tttk_op value of TTME_MAIL_COMPOSE and a media type of
RFC_822_MESSAGE.
o Send a message without using the GUI. This is done by
using a Tttk_op value of TTME_MAIL and a media type of
RFC_822_MESSAGE.
See the man page for ttmedia_load(3), Mail(4), and
Display(4) for more information on how to use ToolTalk
and the Media Exchange requests.
Vacation
You use the vacation facility to create a message that is
automatically sent to anyone who sends you email during a
period of time that you specify; for example, while you are
on vacation. You can set the start and end dates as well as
the reply interval for those who send you multiple messages
while you are away. Set up your vacation message in the
Vacation Message dialog box opened from the Options menu.
Views
You use the Views facility to display only those messages
that match certain criteria. Define the matching criteria
via the Search dialog box. You then create a view by naming
the the search criteria and saving it. The search criteria
is saved in the views variable in your $HOME/.mailrc file.
These views can be applied to any of your mailboxes.
dtmail provides two default views: all messages and new mes-
sages.
RESOURCES
dtmail provides the following resources:
Dtmail*Message_List*doubleClickInterval
The double-click time out (in milliseconds) for the
Message Header List. The default is 400 milliseconds.
Dtmail*Message_List*background
The color to use for the Message Header List back-
ground. The default is system-dependent.
Dtmail*Message_List*foreground
The color to use for the Message Header List fore-
ground. The default is system-dependent.
Dtmail*Message_List*fontList
The list of fonts to use in the Message Header List.
The list must contain two fonts. The first must be
tagged plain and is the font used to render the header
text. The second must be tagged attach and is used to
render the attachment indicator. The default is to use
system-dependent, fixed-width fonts.
Dtmail*Work_Area*Text*background
Color to use for the View and Compose window text back-
ground. The default is system-dependent.
Dtmail*Work_Area*Text*foreground
Color to use for the View and Compose window text fore-
ground. The default is system-dependent.
Dtmail*Work_Area*Text*fontList
The list of fonts to use in the View and Compose win-
dows. Font tag "plain". The default is to use a
system-dependent, variable-width font.
Dtmail*Work_Area*Text*highlightColorname1
Color to use for URL highlight before the link is
clicked on.
Dtmail*Work_Area*Text*highlightColorname2
Color to use for URL highlight after the link is
clicked on.
The widget hierarchy for dtmail's main window is shown
below. The widget class name is given first followed by
it's instance name.
Dtmail dtmail
XmMainWindow mainWindow
XmForm Work_Area
XmPanedWindow panedW
XmForm form2
XmScrolledWindow Message_ListSW
XmList Message_List
XmRowColumn Toolbar
XmForm form3
XmForm Message_Status
XmForm DtMailEditor
DtEditor Text
XmForm AttachPane
XmRowColumn menubar
XmMenuShell popup_Mailbox
XmRowColumn Mailbox
XmRowColumn Message
XmRowColumn Compose
XmRowColumn View
XmRowColumn Options
XmRowColumn Move
XmRowColumn Help
The widget hierarchy of dtmail's Compose window is shown
below. The widget class name is given first followed by it's
instance name.
TopLevelShell ComposeDialog
XmMainWindow mainWindow
XmForm Work_Area
XmForm StatusForm
XmForm HeaderArea
XmForm DtMailEditor
DtEditor Text
XmForm AttachPane
XmRowColumn menubar
XmMenuShell popup_File
XmRowColumn File
XmRowColumn Edit
XmRowColumn Attachments
XmRowColumn Format
XmRowColumn Help
MAIL VARIABLES
dtmail recognizes the following mailx(1) commands and
variables: unset, alias, group, set, ignore, source, else,
endif, alternates, keep, allnet, and metoo. See the mailx(1)
man page for more information. dtmail also recognizes the
variables listed below. They can be set by editing your
.mailrc file; however, since most of the variables are
accessible through the dtmail Options menu, we strongly
recommend that you modify them there to reduce the chance of
error. Unless otherwise noted, the default for the following
variables is off.
additionalfields
A list of header fields to access via the Format
menu. You can set this variable in the Compose
Window dialog box opened from the Options menu.
allowcorefile
dtmail will not produce a core file by default. If
you wish to produce a core file in dtmail you need
to set this variable. For more information on pro-
ducing core files please see the man page on
core(4).
bell The number of times to ring the bell when new mail
arrives. You can set this variable in the Notifi-
cation dialog box opened from the Options menu.
The default is 0.
cachedfilemenusize
Specifies the maximum number of entries that are
appended to the Move menu, as well as the Copy To
Mailbox, and Open Mailbox submenus. You can set
this variable in the Move Menu Setup dialog box
opened from the Options menu. The default is 10.
composeinterval
The interval in seconds for saving the contents of
the Compose window to the mail.dead.letter file.
The default is 10 minutes.
composewincols
The default width of the compose window (in
columns). You can set this variable in the Com-
pose Window dialog box opened from the Options
menu.
deaddir The folder in which the dead letter file will be
saved. You can set this variable in the Compose
Window dialog box opened from the Options menu.
The default is $HOME/DeadLetters.
displaymsgsizewarning
If set, a warning popup dialog will be displayed
when attempting to send a message that exceeds the
value specified by the msgsizelimit variable. You
can set this variable in the Advanced dialog box
opened from the Options menu.
dontautosave
Set this variable to prevent dtmail from automati-
cally saving changes made to your mailbox.
dontincludesignature
When set, the user defined signature is not
automatically added to outgoing messages. You can
set this variable in the Signature dialog box
opened from the Options menu. If a signature is
defined, this variable is not set by default
(which means the signature will be automatically
included in outgoing messages).
dontdisplaycachedfiles
Specifies whether to append file names to the Move
menu as well as the Copy To Mailbox and Open Mail-
box submenus.
dontlogmessages
Controls whether or not the Save Outgoing Mail
item is selected in the File Menu in the Compose
window. The default is to save outgoing mail. See
also the record variable.
If you choose this menu item but do not specify a
file under "Save a copy of outgoing mail in" in
the Basic dialog box opened from the Options menu,
dtmail saves your outgoing mail in
$HOME/sent.mail.
dontsavemimemessageformat
dtmail converts all Sun Mail Tool format messages
to MIME. Setting this variable prevents these
MIME translations from being written back to the
mailbox. However, setting this option sometimes
may cause a decrease in performance when you open
mailboxes. You can set this variable in the
Advanced dialog box opened from the Options menu.
dontsendmimeformat
Set this variable to send messages in Sun Mail
Tool message format instead of MIME. You can set
this variable in the Advanced dialog box opened
from the Options menu.
draftdir Specifies the default directory for draft mes-
sages.
filemenu2 A space-separated list of mailboxes that appear on
the Move menu, as well as the Copy To Mailbox and
Open Mailbox submenus. They can be absolute path
names or path names relative to the directory
specified in the folder variable. For IMAP mail-
boxes, see movemenu. You can set this variable in
the Move Menu Setup dialog box opened from the
Options menu.
filemenusize
Specifies the maximum number of entries in the
Move menu as well as the Copy To Mailbox and Open
Mailbox submenus. You can set this variable in
the Move Menu Setup dialog box opened from the
Options menu. The default is 10.
flash The number of times to flash the window or icon
when new mail arrives. You can set this variable
in the Notification dialog box opened from the
Options menu. The default is 0.
folder Specifies the default directory for mailboxes.
You can set this variable in the Move Menu Setup
dialog box opened from the Options menu.
headerlines
Specifies the number of message headers to display
in the Message Header List. You can set this
variable in the Basic dialog box opened from the
Options menu. The default is 15.
hideattachments
Set this variable to hide the attachments pane in
the Compose Message window. You can set this
variable in the Compose Window dialog box opened
from the Options menu.
imapfolder
Specifies the default directory for your IMAP
mailboxes. You can set this variable in the Move
Menu Setup dialog box opened from the Options
menu.
imapfolderserver
Specifies the name of the host on which your IMAP
mail folders reside. You can set this variable in
the Move Menu Setup dialog box opened from the
Options menu.
imapinboxserver
Specifies the name of the host on which your IMAP
Inbox is stored. You can set this variable in the
Basic dialog box opened from the Options menu.
inactivityinterval
The number of seconds between keystrokes before
dtmail checks for new email or does an auto save.
The default is 30 seconds.
indentprefix
Specifies the string used to mark indented text
from included messages. You can set this variable
in the Compose Window dialog box opened from the
Options menu. The default is "> ".
keepdeleted
Set this variable to prevent messages marked as
deleted from being destroyed when closing (exit-
ing) dtmail. You can set this variable in the
Basic dialog box opened from the Options menu. See
also quietdelete.
keepdeletedialog
Set this variable to "1" to enable the Select
Mailbox File Selection Box to remain on the desk-
top after you use it to delete a mailbox. This
behavior remains over multiple sessions. The
default behavior is for the Select Mailbox File
Selection Box to close immediately after deletion
of selected mailbox. To change the default
behavior for the current session only, select the
checkbox on the Select Mailbox GUI.
keepmovedialog
Set this variable to "1" to enable the Select
Mailbox File Selection Box to remain on the desk-
top after you use it to move or copy a message to
a mailbox. This behavior remains over multiple
sessions. The default behavior (in which keepmo-
vedialog is set to "0") is for the Select Mailbox
File Selection Box to close after a move or copy
operation. You can set this variable in the Move
Menu Setup dialog box opened from the Options
menu. To change the default behavior for the
current session only, select the checkbox on the
Select Mailbox GUI.
keepnewdialog
Set this variable to "1" to enable the Select
Mailbox File Selection Box to remain on the desk-
top after you use it to create a new mailbox.
This behavior remains over multiple sessions. The
default behavior is for the Select Mailbox File
Selection Box to close immediately after creation
of new mailbox. To change the default behavior for
the current session only, select the checkbox on
the Select Mailbox GUI.
keepopendialog
Set this variable to "1" to enable the Select
Mailbox File Selection Box to remain on the desk-
top after you use it to open an existing mailbox.
This behavior remains over multiple sessions. The
default behavior is for the Select Mailbox File
Selection Box to close after the mailbox is open.
To change the default behavior for the current
session only, select the checkbox on the Select
Mailbox GUI.
keeprenamedialog
Set this variable to "1" to enable the Select
Mailbox File Selection Box to remain on the desk-
top after you use it to rename a mailbox. This
behavior remains over multiple sessions. The
default behavior is for the Select Mailbox File
Selection Box to close immediately after mailbox
is renamed. To change the default behavior for the
current session only, select the checkbox on the
Select Mailbox GUI.
logdebug Set this variable to have all IMAP protocol and
miscellaneous debug messages printed to stdout.
logerror Set this variable to have all c-client fatal error
messages sent to stdout.
lognotify Set this variable to have all notifications from
the c-client sent to stdout.
movemenu A space-separated list of mailboxes that appear on
the Move menu, as well as the Copy To Mailbox and
Open Mailbox submenus. The mailbox names can be
absolute path names or path names relative to the
directory specified in the folder variable. This
list can also contain entries that refer to remote
IMAP mailboxes, of the form:
mailboxname,servername,imap. You can set this
variable in the Move Menu Setup dialog box opened
from the Options menu.
msgsizelimit
Specifies the maximum size of a message that you
can send without causing a warning message to be
posted. All messages whose size is greater than
or equal to this value will cause a warning mes-
sage to be posted. You can set this variable in
the Advanced dialog box opened from the Options
menu.
popuplines
Specifies the number of lines in the View Message
and Compose Message windows. You can set this
variable in the Message View dialog box opened
from the Options menu. The default value is 30.
quietdelete
If set, dtmail does not post a message that asks
if you would like to destroy the deleted messages
when you close (exit) dtmail. Set this variable
under "Destroy Deleted Messages" in the Basic dia-
log box opened from the Options menu. See also
keepdeleted.
realsound Specifies the name of the sound file played when
new mail arrives. You can set this variable in
the Notification dialog box opened from the
Options menu.
record Specifies the file in which to save your outgoing
messages. You can set this variable by filling in
the text field under "Save a copy of outgoing mail
in" in the Basic dialog box opened from the
Options menu. If you leave that field blank, but
choose to save outgoing mail, dtmail saves it in
$HOME/sent.mail.
To control whether or not to save outgoing mail on
a per-message basis, select or deselect Save Out-
going Mail from the File menu in the Compose win-
dow. The dontlogmessages variable controls whether
or not this item is selected by default. You can
set this variable in the Basic dialog box opened
from the Options menu.
retrieveinterval
Specifies the interval that dtmail waits to check
for new mail in your Inbox. You can set this vari-
able in the Basic dialog box opened from the
Options menu. The default is 300 seconds.
saveinterval
Specifies the length of time between saving the
state of your mailbox to disk. The default is 10
minutes and the maximum is 30 minutes. You can
set this variable in the Basic dialog box opened
from the Options menu. The dontautosave variable
overrides the saveinterval variable.
showmsgnum
Set this to show message numbers in the Message
Header List. You can set this variable in the
Basic dialog box opened from the Options menu.
showto Shows the "To" field of mail messages in the Mes-
sage Header List if the mail is from the same user
that is reading mail; for example, you. You can
set this variable in the Basic dialog box opened
from the Options menu.
signature Specifies the file whose contents will be included
in the Compose window. You can set this variable
in the Signature dialog box opened from the
Options menu.
smtpmailserver
Specifies the server where mail is to be sent
from. You can set this variable in the Advanced
dialog box opened from the Options menu.
templatedir
The default directory for template files.
templates A list of name:path pairs that represent the col-
lection of templates listed in the Use Templates
submenu in the Format menu in the Compose window.
name appears in the submenu; path is the file
included in the Compose window when you select
name. You can set this variable in the Templates
dialog box opened from the Options menu.
toolbarcommands
A space-separated list of command names that
define which commands are represented in the tool-
bar. You can set this variable in the Toolbar
dialog box opened from the Options menu.
toolbarusetext
Set this variable to have the toolbar use text
labels instead of icons. You can set this vari-
able in the Toolbar dialog box opened from the
Options menu.
toolcols The default width of the primary windows (in
columns). You can set this variable in the Mes-
sage View dialog box opened from the Options menu.
usealternates
If set, dtmail checks the address list of outgoing
mail for addresses specified by the mailx alter-
nates command. You can set this variable in the
Advanced dialog box opened from the Options menu.
vacationatjobhost
Specifies the host name where dtmail was running
when your vacation message was turned on.
vacationenddate
The date on which the vacation message will be
turned off. You can set this variable in the Vaca-
tion Message dialog box opened from the Options
menu.
vacationreplyinterval
Specifies the interval between replies to the same
sender. For example; if this variable is set to
3, someone who sends you a message while you are
away will not receive your vacation message again
until three days after receipt of the first vaca-
tion message from you. You can set this variable
in the Vacation Message dialog box opened from the
Options menu.
vacationstartatjobid
The id number returned from the "at" command used
to turn on your vacation message.
vacationstartdate
The date your vacation message is turned on. You
can set this variable in the Vacation Message dia-
log box opened from the Options menu.
vacationstopatjobid
The id number returned from the "at" command used
to turn off your vacation message.
slownet If set, when you click a message header, dtmail
loads the message text but not the attachment con-
tents. They are loaded only when you double-click
the attachment icon. You can also set this vari-
able by selecting When Open under Retrieve attach-
ments in the Login dialog box. Use this option in
a low-bandwidth connection.
views A list of name:value pairs separated by a semi-
colon (;), that represent the views you have
defined. The name portion can be any ASCII
string; spaces are allowed. The value portion can
be any valid IMAP4 search string. Define views
via the Search dialog box opened from the Message
menu.
ENVIRONMENT
The following environment variables affect the execution of
dtmail:
HOME=directory
The user's home directory.
MAIL=filename
The name of the initial mailbox file to read (in lieu
of the standard system mailbox). The default is
system-dependent. See FILES section.
MAILRC=filename
The name of the startup file. The default is
$HOME/.mailrc.
FILES
/var/mail/* (Sun)
/var/spool/mail/* (IBM)
/usr/mail* (HP)
System mailboxes
/etc/mail/mailx.rc
System setup file that is read in before $HOME/.mailrc.
$HOME/.mailrc
Startup file for dtmail.
/usr/dt/bin/dtmail
dtmail executable.
/usr/dt/app-defaults/<LANG>/Dtmail
Application defaults for dtmail.
SEE ALSO
mail(1), mailx(1), newaliases(1), sendmail(1M), vacation(1),
aliases(4), tooltips(3), ttmedia_load(3), Mail(4),
Display(4).
|
Закладки на сайте Проследить за страницей |
Created 1996-2025 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |