Put in remaining pages and wiki contents.
[ikiwiki.git] / docs / handbook / handbook-mail-agents.mdwn
1 \r
2 \r
3 ## Mail User Agents \r
4 \r
5 ***Contributed by Marc Silver. ***\r
6 \r
7 A Mail User Agent (MUA) is an application that is used to send and receive email. Furthermore, as email ***evolves*** and becomes more complex, MUA's are becoming increasingly powerful in the way they interact with email; this gives users increased functionality and flexibility. DragonFly contains support for numerous mail user agents, all of which can be easily installed using the [pkgsrcĀ®](pkgsrc.html) collection. Users may choose between graphical email clients such as ***evolution*** or ***balsa***, console based clients such as ***mutt***, ***pine*** or `mail`, or the web interfaces used by some large organizations.\r
8 \r
9 ### mail \r
10 \r
11 [mail(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#mail&section1) is the default Mail User Agent (MUA) in DragonFly. It is a console based MUA that offers all the basic functionality required to send and receive text-based email, though it is limited in interaction abilities with attachments and can only support local mailboxes.\r
12 \r
13 Although `mail` does not natively support interaction with POP or IMAP servers, these mailboxes may be downloaded to a local `mbox` file using an application such as ***fetchmail***, which will be discussed later in [in this Chapter](mail-fetchmail.html).\r
14 \r
15 In order to send and receive email, simply invoke the `mail` command as per the following example:\r
16 \r
17     \r
18     % mail\r
19 \r
20 \r
21 The contents of the user mailbox in `/var/mail` are automatically read by the `mail` utility. Should the mailbox be empty, the utility exits with a message indicating that no mails could be found. Once the mailbox has been read, the application interface is started, and a list of messages will be displayed. Messages are automatically numbered, as can be seen in the following example:\r
22 \r
23     \r
24     Mail version 8.1 6/6/93.  Type ? for help.\r
25     "/var/mail/marcs": 3 messages 3 new\r
26     >N  1 root@localhost        Mon Mar  8 14:05  14/510   "test"\r
27      N  2 root@localhost        Mon Mar  8 14:05  14/509   "user account"\r
28      N  3 root@localhost        Mon Mar  8 14:05  14/509   "sample"\r
29 \r
30 \r
31 Messages can now be read by using the  **t**  `mail` command, suffixed by the message number that should be displayed. In this example, we will read the first email:\r
32 \r
33     \r
34     & t 1\r
35     Message 1:\r
36     From root@localhost  Mon Mar  8 14:05:52 2004\r
37     X-Original-To: marcs@localhost\r
38     Delivered-To: marcs@localhost\r
39     To: marcs@localhost\r
40     Subject: test\r
41     Date: Mon,  8 Mar 2004 14:05:52 +0200 (SAST)\r
42     From: root@localhost (Charlie Root)\r
43     \r
44     This is a test message, please reply if you receive it.\r
45 \r
46 \r
47 As can be seen in the example above, the  **t**  key will cause the message to be displayed with full headers. To display the list of messages again, the  **h**  key should be used.\r
48 \r
49 If the email requires a response, you may use `mail` to reply, by using either the  **R**  or  **r**  `mail` keys. The  **R**  key instructs `mail` to reply only to the sender of the email, while  **r**  replies not only to the sender, but also to other recipients of the message. You may also suffix these commands with the mail number which you would like make a reply to. Once this has been done, the response should be entered, and the end of the message should be marked by a single  **.**  on a new line. An example can be seen below:\r
50 \r
51     \r
52     & R 1\r
53     To: root@localhost\r
54     Subject: Re: test\r
55     \r
56     Thank you, I did get your email.\r
57     .\r
58     EOT\r
59 \r
60 \r
61 In order to send new email, the  **m**  key should be used, followed by the recipient email address. Multiple recipients may also be specified by separating each address with the ***',***' delimiter. The subject of the message may then be entered, followed by the message contents. The end of the message should be specified by putting a single  **.**  on a new line.\r
62 \r
63     \r
64     & mail root@localhost\r
65     Subject: I mastered mail\r
66     \r
67     Now I can send and receive email using mail ... :)\r
68     .\r
69     EOT\r
70 \r
71 \r
72 While inside the `mail` utility, the  **?**  command may be used to display help at any time, the [mail(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#mail&section1) manual page should also be consulted for more help with `mail`.\r
73 \r
74  **Note:** As previously mentioned, the [mail(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#mail&section1) command was not originally designed to handle attachments, and thus deals with them very poorly. Newer MUAs such as ***mutt*** handle attachments in a much more intelligent way. But should you still wish to use the `mail` command, the [converters/mpack](http://pkgsrc.se/converters/mpack) port may be of considerable use.\r
75 \r
76 ### mutt \r
77 \r
78 ***mutt*** is a small yet very powerful Mail User Agent, with excellent features, just some of which include:\r
79 \r
81 * The ability to thread messages;\r
83 * PGP support for digital signing and encryption of email;\r
85 * MIME Support;\r
87 * Maildir Support;\r
89 * Highly customizable.\r
90 \r
91 All of these features help to make ***mutt*** one of the most advanced mail user agents available. See http://www.mutt.org for more information on ***mutt***.\r
92 \r
93 The stable version of ***mutt*** may be installed using the [mail/mutt](http://pkgsrc.se/mail/mutt) port, while the current development version may be installed via the [mail/mutt-devel](http://pkgsrc.se/mail/mutt-devel) port. After the port has been installed, ***mutt*** can be started by issuing the following command:\r
94 \r
95     \r
96     % mutt\r
97 \r
98 \r
99 ***mutt*** will automatically read the contents of the user mailbox in `/var/mail` and display the contents if applicable. If no mails are found in the user mailbox, then ***mutt*** will wait for commands from the user. The example below shows ***mutt*** displaying a list of messages:\r
100 \r
101 mail/mutt1.png\r
102 \r
103 In order to read an email, simply select it using the cursor keys, and press the  **Enter**  key. An example of  **mutt**  displaying email can be seen below:\r
104 \r
105 mail/mutt2.png\r
106 \r
107 As with the [mail(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#mail&section1) command,  **mutt**  allows users to reply only to the sender of the message as well as to all recipients. To reply only to the sender of the email, use the  **r**  keyboard shortcut. To send a group reply, which will be sent to the original sender as well as all the message recipients, use the  **g**  shortcut.\r
108 \r
109  **Note:**  **mutt**  makes use of the [vi(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#vi&section1) command as an editor for creating and replying to emails. This may be customized by the user by creating or editing their own `.muttrc` file in their home directory and setting the `editor` variable.\r
110 \r
111 In order to compose a new mail message, press  **m** . After a valid subject has been given,  **mutt**  will start [vi(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#vi&section1) and the mail can be written. Once the contents of the mail are complete, save and quit from `vi` and  **mutt**  will resume, displaying a summary screen of the mail that is to be delivered. In order to send the mail, press  **y** . An example of the summary screen can be seen below:\r
112 \r
113 mail/mutt3.png\r
114 \r
115  **mutt**  also contains extensive help, which can be accessed from most of the menus by pressing the  **?**  key. The top line also displays the keyboard shortcuts where appropriate.\r
116 \r
117 ### pine \r
118 \r
119  **pine**  is aimed at a beginner user, but also includes some advanced features.\r
120 \r
121  **Warning:** The  **pine**  software has had several remote vulnerabilities discovered in the past, which allowed remote attackers to execute arbitrary code as users on the local system, by the action of sending a specially-prepared email. All such ***known*** problems have been fixed, but the  **pine**  code is written in a very insecure style and the DragonFly Security Officer believes there are likely to be other undiscovered vulnerabilities. You install  **pine**  at your own risk.\r
122 \r
123 The current version of  **pine**  may be installed using the [`mail/pine4`](http://pkgsrc.se/mail/pine4) port. Once the port has installed,  **pine**  can be started by issuing the following command:\r
124 \r
125     \r
126     pine\r
127 \r
128 \r
129 The first time that  **pine**  is run it displays a greeting page with a brief introduction, as well as a request from the  **pine**  development team to send an anonymous email message allowing them to judge how many users are using their client. To send this anonymous message, press  **Enter** , or alternatively press  **E**  to exit the greeting without sending an anonymous message. An example of the greeting page can be seen below:\r
130 \r
131 mail/pine1.png\r
132 \r
133 Users are then presented with the main menu, which can be easily navigated using the cursor keys. This main menu provides shortcuts for the composing new mails, browsing of mail directories, and even the administration of address book entries. Below the main menu, relevant keyboard shortcuts to perform functions specific to the task at hand are shown.\r
134 \r
135 The default directory opened by  **pine**  is the `inbox`. To view the message index, press  **I** , or select the MESSAGE INDEX option as seen below:\r
136 \r
137 mail/pine2.png\r
138 \r
139 The message index shows messages in the current directory, and can be navigated by using the cursor keys. Highlighted messages can be read by pressing the  **Enter**  key.\r
140 \r
141 mail/pine3.png\r
142 \r
143 In the screenshot below, a sample message is displayed by  **pine** . Keyboard shortcuts are displayed as a reference at the bottom of the screen. An example of one of these shortcuts is the  **r**  key, which tells the MUA to reply to the current message being displayed.\r
144 \r
145 mail/pine4.png\r
146 \r
147 Replying to an email in  **pine**  is done using the  **pico**  editor, which is installed by default with  **pine** . The  **pico**  utility makes it easy to navigate around the message and is slightly more forgiving on novice users than [vi(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#vi&section1) or [mail(1)](http://leaf.dragonflybsd.org/cgi/web-man?command=mail&section=1). Once the reply is complete, the message can be sent by pressing  **Ctrl** + **X** . The  **pine**  application will ask for confirmation.\r
148 \r
149 mail/pine5.png\r
150 \r
151 The  **pine**  application can be customized using the SETUP option from the main menu. Consult http://www.washington.edu/pine/ for more information.\r
152 \r
153 \r
154 \r
155 CategoryHandbook\r
156 CategoryHandbook-email\r