157
169
<em class="replaceable"><code>background</code></em>
159
171
<em class="replaceable"><code>pattern</code></em>
160
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#color" title="9. Using color and mono video attributes">uncolor</a></code>
172
<br /><code class="command"><a class="link" href="configuration.html#color" title="9. Using Color and Mono Video Attributes">uncolor</a></code> {
161
173
<code class="option">index</code>
175
<code class="option">header</code>
177
<code class="option">body</code>
179
<em class="replaceable"><code>*</code></em>
181
<em class="replaceable"><code>pattern</code></em>
182
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#crypt-hook" title="21. Choosing the Cryptographic Key of the Recipient">crypt-hook</a></code>
183
<em class="replaceable"><code>pattern</code></em>
163
<em class="replaceable"><code>pattern</code></em>
164
... </p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#exec" title="23. Executing functions">exec</a></code>
185
<em class="replaceable"><code>keyid</code></em>
186
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#exec" title="23. Executing Functions">exec</a></code>
165
187
<em class="replaceable"><code>function</code></em>
167
189
<em class="replaceable"><code>function</code></em>
168
...]</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#fcc-hook" title="17. Specify default Fcc: mailbox when composing">fcc-hook</a></code>
169
<em class="replaceable"><code>[!]pattern</code></em>
171
<em class="replaceable"><code>mailbox</code></em>
172
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#fcc-save-hook" title="18. Specify default save filename and default Fcc: mailbox at once">fcc-save-hook</a></code>
173
<em class="replaceable"><code>[!]pattern</code></em>
175
<em class="replaceable"><code>mailbox</code></em>
176
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#folder-hook" title="7. Setting variables based upon mailbox">folder-hook</a></code>
190
...]</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#fcc-hook" title="17. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></code>
191
<em class="replaceable"><code>[!]pattern</code></em>
193
<em class="replaceable"><code>mailbox</code></em>
194
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#fcc-save-hook" title="18. Specify Default Save Filename and Default Fcc: Mailbox at Once">fcc-save-hook</a></code>
195
<em class="replaceable"><code>[!]pattern</code></em>
197
<em class="replaceable"><code>mailbox</code></em>
198
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#folder-hook" title="7. Setting Variables Based Upon Mailbox">folder-hook</a></code>
177
199
<em class="replaceable"><code>[!]regexp</code></em>
179
201
<em class="replaceable"><code>command</code></em>
180
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#addrgroup" title="3. Address groups">group</a></code> [
181
<code class="option">-group</code>
182
<em class="replaceable"><code>name</code></em>
184
<code class="option">-rx</code>
185
<em class="replaceable"><code>expr</code></em>
187
<code class="option">-addr</code>
188
<em class="replaceable"><code>expr</code></em>
189
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#addrgroup" title="3. Address groups">ungroup</a></code> [
190
<code class="option">-group</code>
191
<em class="replaceable"><code>name</code></em>
193
<em class="replaceable"><code>*</code></em>
195
<code class="option">-rx</code>
196
<em class="replaceable"><code>expr</code></em>
198
<code class="option">-addr</code>
199
<em class="replaceable"><code>expr</code></em>
200
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#hdr-order">hdr_order</a></code>
201
<em class="replaceable"><code>header</code></em>
203
<em class="replaceable"><code>header</code></em>
204
...]</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#hdr-order">unhdr_order</a></code> {
205
<em class="replaceable"><code>*</code></em>
207
<em class="replaceable"><code>header</code></em>
208
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#ignore" title="10. Message header display">ignore</a></code>
209
<em class="replaceable"><code>pattern</code></em>
211
<em class="replaceable"><code>pattern</code></em>
212
...]</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#ignore" title="10. Message header display">unignore</a></code> {
213
<em class="replaceable"><code>*</code></em>
215
<em class="replaceable"><code>pattern</code></em>
216
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#lists" title="12. Mailing lists">lists</a></code> [
202
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#addrgroup" title="3. Address Groups">group</a></code> [
203
<code class="option">-group</code>
204
<em class="replaceable"><code>name</code></em>
206
<code class="option">-rx</code>
207
<em class="replaceable"><code>expr</code></em>
209
<code class="option">-addr</code>
210
<em class="replaceable"><code>expr</code></em>
211
... }<br /><code class="command"><a class="link" href="configuration.html#addrgroup" title="3. Address Groups">ungroup</a></code> [
212
<code class="option">-group</code>
213
<em class="replaceable"><code>name</code></em>
215
<em class="replaceable"><code>*</code></em>
217
<code class="option">-rx</code>
218
<em class="replaceable"><code>expr</code></em>
220
<code class="option">-addr</code>
221
<em class="replaceable"><code>expr</code></em>
222
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#hdr-order" title="10.2. Ordering Displayed Headers">hdr_order</a></code>
223
<em class="replaceable"><code>header</code></em>
225
<em class="replaceable"><code>header</code></em>
226
...]<br /><code class="command"><a class="link" href="configuration.html#hdr-order" title="10.2. Ordering Displayed Headers">unhdr_order</a></code> {
227
<em class="replaceable"><code>*</code></em>
229
<em class="replaceable"><code>header</code></em>
230
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#ignore" title="10.1. Selecting Headers">ignore</a></code>
231
<em class="replaceable"><code>pattern</code></em>
233
<em class="replaceable"><code>pattern</code></em>
234
...]<br /><code class="command"><a class="link" href="configuration.html#ignore" title="10.1. Selecting Headers">unignore</a></code> {
235
<em class="replaceable"><code>*</code></em>
237
<em class="replaceable"><code>pattern</code></em>
238
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#lists" title="12. Mailing Lists">lists</a></code> [
217
239
<code class="option">-group</code>
218
240
<em class="replaceable"><code>name</code></em>
220
242
<em class="replaceable"><code>regexp</code></em>
222
244
<em class="replaceable"><code>regexp</code></em>
223
...]</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#lists" title="12. Mailing lists">unlists</a></code> [
245
...]<br /><code class="command"><a class="link" href="configuration.html#lists" title="12. Mailing Lists">unlists</a></code> [
224
246
<code class="option">-group</code>
225
247
<em class="replaceable"><code>name</code></em>
227
249
<em class="replaceable"><code>*</code></em>
229
251
<em class="replaceable"><code>regexp</code></em>
230
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#macro" title="8. Keyboard macros">macro</a></code>
252
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#macro" title="8. Keyboard Macros">macro</a></code>
231
253
<em class="replaceable"><code>menu</code></em>
233
255
<em class="replaceable"><code>key</code></em>
636
674
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="copy"></a>3.35. copy</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
637
675
Default: yes</p></div><p>
638
676
This variable controls whether or not copies of your outgoing messages
639
will be saved for later references. Also see <a class="link" href="reference.html#record" title="3.240. record">$record</a>,
640
<a class="link" href="reference.html#save-name" title="3.252. save_name">$save_name</a>, <a class="link" href="reference.html#force-name" title="3.61. force_name">$force_name</a> and “<span class="quote"><a class="link" href="configuration.html#fcc-hook" title="17. Specify default Fcc: mailbox when composing">fcc-hook</a></span>”.
641
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-gpgme"></a>3.36. crypt_use_gpgme</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
677
will be saved for later references. Also see <a class="link" href="reference.html#record" title="3.211. record">$record</a>,
678
<a class="link" href="reference.html#save-name" title="3.223. save_name">$save_name</a>, <a class="link" href="reference.html#force-name" title="3.69. force_name">$force_name</a> and “<span class="quote"><a class="link" href="configuration.html#fcc-hook" title="17. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></span>”.
679
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autoencrypt"></a>3.36. crypt_autoencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
680
Default: no</p></div><p>
681
Setting this variable will cause Mutt to always attempt to PGP
682
encrypt outgoing messages. This is probably only useful in
683
connection to the “<span class="quote"><a class="link" href="configuration.html#send-hook" title="19. Change Settings Based Upon Message Recipients">send-hook</a></span>” command. It can be overridden
684
by use of the pgp menu, when encryption is not required or
685
signing is requested as well. If <a class="link" href="reference.html#smime-is-default" title="3.252. smime_is_default">$smime_is_default</a> is <span class="emphasis"><em>set</em></span>,
686
then OpenSSL is used instead to create S/MIME messages and
687
settings can be overridden by use of the smime menu instead.
689
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autopgp"></a>3.37. crypt_autopgp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
690
Default: yes</p></div><p>
691
This variable controls whether or not mutt may automatically enable
692
PGP encryption/signing for messages. See also <a class="link" href="reference.html#crypt-autoencrypt" title="3.36. crypt_autoencrypt">$crypt_autoencrypt</a>,
693
<a class="link" href="reference.html#crypt-replyencrypt" title="3.40. crypt_replyencrypt">$crypt_replyencrypt</a>,
694
<a class="link" href="reference.html#crypt-autosign" title="3.38. crypt_autosign">$crypt_autosign</a>, <a class="link" href="reference.html#crypt-replysign" title="3.41. crypt_replysign">$crypt_replysign</a> and <a class="link" href="reference.html#smime-is-default" title="3.252. smime_is_default">$smime_is_default</a>.
695
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosign"></a>3.38. crypt_autosign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
696
Default: no</p></div><p>
697
Setting this variable will cause Mutt to always attempt to
698
cryptographically sign outgoing messages. This can be overridden
699
by use of the pgp menu, when signing is not required or
700
encryption is requested as well. If <a class="link" href="reference.html#smime-is-default" title="3.252. smime_is_default">$smime_is_default</a> is <span class="emphasis"><em>set</em></span>,
701
then OpenSSL is used instead to create S/MIME messages and settings can
702
be overridden by use of the smime menu instead of the pgp menu.
704
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosmime"></a>3.39. crypt_autosmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
705
Default: yes</p></div><p>
706
This variable controls whether or not mutt may automatically enable
707
S/MIME encryption/signing for messages. See also <a class="link" href="reference.html#crypt-autoencrypt" title="3.36. crypt_autoencrypt">$crypt_autoencrypt</a>,
708
<a class="link" href="reference.html#crypt-replyencrypt" title="3.40. crypt_replyencrypt">$crypt_replyencrypt</a>,
709
<a class="link" href="reference.html#crypt-autosign" title="3.38. crypt_autosign">$crypt_autosign</a>, <a class="link" href="reference.html#crypt-replysign" title="3.41. crypt_replysign">$crypt_replysign</a> and <a class="link" href="reference.html#smime-is-default" title="3.252. smime_is_default">$smime_is_default</a>.
710
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replyencrypt"></a>3.40. crypt_replyencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
711
Default: yes</p></div><p>
712
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL encrypt replies to messages which are
715
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysign"></a>3.41. crypt_replysign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
716
Default: no</p></div><p>
717
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL sign replies to messages which are
720
<span class="bold"><strong>Note:</strong></span> this does not work on messages that are encrypted
721
<span class="emphasis"><em>and</em></span> signed!
723
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysignencrypted"></a>3.42. crypt_replysignencrypted</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
724
Default: no</p></div><p>
725
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL sign replies to messages
726
which are encrypted. This makes sense in combination with
727
<a class="link" href="reference.html#crypt-replyencrypt" title="3.40. crypt_replyencrypt">$crypt_replyencrypt</a>, because it allows you to sign all
728
messages which are automatically encrypted. This works around
729
the problem noted in <a class="link" href="reference.html#crypt-replysign" title="3.41. crypt_replysign">$crypt_replysign</a>, that mutt is not able
730
to find out whether an encrypted message is also signed.
732
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-timestamp"></a>3.43. crypt_timestamp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
733
Default: yes</p></div><p>
734
If <span class="emphasis"><em>set</em></span>, mutt will include a time stamp in the lines surrounding
735
PGP or S/MIME output, so spoofing such lines is more difficult.
736
If you are using colors to mark these lines, and rely on these,
737
you may <span class="emphasis"><em>unset</em></span> this setting.
739
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-gpgme"></a>3.44. crypt_use_gpgme</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
642
740
Default: no</p></div><p>
643
741
This variable controls the use of the GPGME-enabled crypto backends.
644
742
If it is <span class="emphasis"><em>set</em></span> and Mutt was built with gpgme support, the gpgme code for
645
743
S/MIME and PGP will be used instead of the classic code. Note that
646
744
you need to set this option in .muttrc; it won't have any effect when
647
745
used interactively.
648
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-pka"></a>3.37. crypt_use_pka</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
746
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-pka"></a>3.45. crypt_use_pka</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
649
747
Default: no</p></div><p>
650
748
Controls whether mutt uses PKA
651
749
(see http://www.g10code.de/docs/pka-intro.de.pdf) during signature
652
750
verification (only supported by the GPGME backend).
653
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autopgp"></a>3.38. crypt_autopgp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
654
Default: yes</p></div><p>
655
This variable controls whether or not mutt may automatically enable
656
PGP encryption/signing for messages. See also <a class="link" href="reference.html#crypt-autoencrypt" title="3.144. crypt_autoencrypt">$crypt_autoencrypt</a>,
657
<a class="link" href="reference.html#crypt-replyencrypt" title="3.146. crypt_replyencrypt">$crypt_replyencrypt</a>,
658
<a class="link" href="reference.html#crypt-autosign" title="3.143. crypt_autosign">$crypt_autosign</a>, <a class="link" href="reference.html#crypt-replysign" title="3.147. crypt_replysign">$crypt_replysign</a> and <a class="link" href="reference.html#smime-is-default" title="3.152. smime_is_default">$smime_is_default</a>.
659
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosmime"></a>3.39. crypt_autosmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
660
Default: yes</p></div><p>
661
This variable controls whether or not mutt may automatically enable
662
S/MIME encryption/signing for messages. See also <a class="link" href="reference.html#crypt-autoencrypt" title="3.144. crypt_autoencrypt">$crypt_autoencrypt</a>,
663
<a class="link" href="reference.html#crypt-replyencrypt" title="3.146. crypt_replyencrypt">$crypt_replyencrypt</a>,
664
<a class="link" href="reference.html#crypt-autosign" title="3.143. crypt_autosign">$crypt_autosign</a>, <a class="link" href="reference.html#crypt-replysign" title="3.147. crypt_replysign">$crypt_replysign</a> and <a class="link" href="reference.html#smime-is-default" title="3.152. smime_is_default">$smime_is_default</a>.
665
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="date-format"></a>3.40. date_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
751
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-verify-sig"></a>3.46. crypt_verify_sig</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
752
Default: yes</p></div><p>
753
If <span class="emphasis"><em>“<span class="quote">yes</span>”</em></span>, always attempt to verify PGP or S/MIME signatures.
754
If <span class="emphasis"><em>“<span class="quote">ask-*</span>”</em></span>, ask whether or not to verify the signature.
755
If \Fi“<span class="quote">no</span>”, never attempt to verify cryptographic signatures.
757
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="date-format"></a>3.47. date_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
666
758
Default: “<span class="quote"><code class="literal">!%a, %b %d, %Y at %I:%M:%S%p %Z</code></span>”</p></div><p>
667
759
This variable controls the format of the date printed by the “<span class="quote">%d</span>”
668
sequence in <a class="link" href="reference.html#index-format" title="3.101. index_format">$index_format</a>. This is passed to the <code class="literal">strftime(3)</code>
760
sequence in <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a>. This is passed to the <code class="literal">strftime(3)</code>
669
761
function to process the date, see the man page for the proper syntax.
671
763
Unless the first character in the string is a bang (“<span class="quote">!</span>”), the month
672
764
and week day names are expanded according to the locale specified in
673
the variable <a class="link" href="reference.html#locale" title="3.104. locale">$locale</a>. If the first character in the string is a
765
the variable <a class="link" href="reference.html#locale" title="3.117. locale">$locale</a>. If the first character in the string is a
674
766
bang, the bang is discarded, and the month and week day names in the
675
767
rest of the string are expanded in the <span class="emphasis"><em>C</em></span> locale (that is in US
677
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="default-hook"></a>3.41. default_hook</h3></div></div></div><div class="literallayout"><p>Type: string<br />
769
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="default-hook"></a>3.48. default_hook</h3></div></div></div><div class="literallayout"><p>Type: string<br />
678
770
Default: “<span class="quote"><code class="literal">˜f %s !˜P | (˜P ˜C %s)</code></span>”</p></div><p>
679
This variable controls how “<span class="quote"><a class="link" href="configuration.html#message-hook" title="20. Change settings before formatting a message">message-hook</a></span>”, “<span class="quote"><a class="link" href="configuration.html#reply-hook">reply-hook</a></span>”, “<span class="quote"><a class="link" href="configuration.html#send-hook" title="19. Change settings based upon message recipients">send-hook</a></span>”,
680
“<span class="quote"><a class="link" href="configuration.html#send2-hook">send2-hook</a></span>”, “<span class="quote"><a class="link" href="configuration.html#save-hook" title="16. Specify default save mailbox">save-hook</a></span>”, and “<span class="quote"><a class="link" href="configuration.html#fcc-hook" title="17. Specify default Fcc: mailbox when composing">fcc-hook</a></span>” will
771
This variable controls how “<span class="quote"><a class="link" href="configuration.html#message-hook" title="20. Change Settings Before Formatting a Message">message-hook</a></span>”, “<span class="quote"><a class="link" href="configuration.html#reply-hook">reply-hook</a></span>”, “<span class="quote"><a class="link" href="configuration.html#send-hook" title="19. Change Settings Based Upon Message Recipients">send-hook</a></span>”,
772
“<span class="quote"><a class="link" href="configuration.html#send2-hook">send2-hook</a></span>”, “<span class="quote"><a class="link" href="configuration.html#save-hook" title="16. Specify Default Save Mailbox">save-hook</a></span>”, and “<span class="quote"><a class="link" href="configuration.html#fcc-hook" title="17. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></span>” will
681
773
be interpreted if they are specified with only a simple regexp,
682
774
instead of a matching pattern. The hooks are expanded when they are
683
775
declared, so a hook will be interpreted according to the value of this
743
834
</p><pre class="screen">
744
835
set dsn_return=hdrs
747
<span class="bold"><strong>Note:</strong></span> when using <a class="link" href="reference.html#sendmail" title="3.258. sendmail">$sendmail</a> for delivery, you should not enable
837
<span class="bold"><strong>Note:</strong></span> when using <a class="link" href="reference.html#sendmail" title="3.230. sendmail">$sendmail</a> for delivery, you should not enable
748
838
this unless you are either using Sendmail 8.8.x or greater or a MTA
749
839
providing a <code class="literal">sendmail(1)</code>-compatible interface supporting the <code class="literal">-R</code> option
750
840
for DSN. For SMTP delivery, DSN support is autodetected so that it
751
841
depends on the server whether DSN will be used or not.
752
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="duplicate-threads"></a>3.49. duplicate_threads</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
842
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="duplicate-threads"></a>3.56. duplicate_threads</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
753
843
Default: yes</p></div><p>
754
This variable controls whether mutt, when <a class="link" href="reference.html#sort" title="3.271. sort">$sort</a> is set to <span class="emphasis"><em>threads</em></span>, threads
844
This variable controls whether mutt, when <a class="link" href="reference.html#sort" title="3.263. sort">$sort</a> is set to <span class="emphasis"><em>threads</em></span>, threads
755
845
messages with the same Message-Id together. If it is <span class="emphasis"><em>set</em></span>, it will indicate
756
846
that it thinks they are duplicates of each other with an equals sign
757
847
in the thread tree.
758
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="edit-headers"></a>3.50. edit_headers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
848
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="edit-headers"></a>3.57. edit_headers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
759
849
Default: no</p></div><p>
760
850
This option allows you to edit the header of your outgoing messages
761
851
along with the body of your message.
763
853
<span class="bold"><strong>Note</strong></span> that changes made to the References: and Date: headers are
764
854
ignored for interoperability reasons.
765
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="editor"></a>3.51. editor</h3></div></div></div><div class="literallayout"><p>Type: path<br />
855
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="editor"></a>3.58. editor</h3></div></div></div><div class="literallayout"><p>Type: path<br />
766
856
Default: (empty)</p></div><p>
767
857
This variable specifies which editor is used by mutt.
768
858
It defaults to the value of the <code class="literal">$VISUAL</code>, or <code class="literal">$EDITOR</code>, environment
769
859
variable, or to the string “<span class="quote">vi</span>” if neither of those are set.
770
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="encode-from"></a>3.52. encode_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
860
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="encode-from"></a>3.59. encode_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
771
861
Default: no</p></div><p>
772
862
When <span class="emphasis"><em>set</em></span>, mutt will quoted-printable encode messages when
773
863
they contain the string “<span class="quote">From </span>” (note the trailing space) in the beginning of a line.
774
864
This is useful to avoid the tampering certain mail delivery and transport
775
865
agents tend to do with messages (in order to prevent tools from
776
866
misinterpreting the line as a mbox message separator).
777
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="envelope-from-address"></a>3.53. envelope_from_address</h3></div></div></div><div class="literallayout"><p>Type: e-mail address<br />
867
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="entropy-file"></a>3.60. entropy_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
868
Default: (empty)</p></div><p>
869
The file which includes random data that is used to initialize SSL
871
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="envelope-from-address"></a>3.61. envelope_from_address</h3></div></div></div><div class="literallayout"><p>Type: e-mail address<br />
778
872
Default: (empty)</p></div><p>
779
873
Manually sets the <span class="emphasis"><em>envelope</em></span> sender for outgoing messages.
780
This value is ignored if <a class="link" href="reference.html#use-envelope-from" title="3.294. use_envelope_from">$use_envelope_from</a> is <span class="emphasis"><em>unset</em></span>.
781
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="escape"></a>3.54. escape</h3></div></div></div><div class="literallayout"><p>Type: string<br />
874
This value is ignored if <a class="link" href="reference.html#use-envelope-from" title="3.298. use_envelope_from">$use_envelope_from</a> is <span class="emphasis"><em>unset</em></span>.
875
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="escape"></a>3.62. escape</h3></div></div></div><div class="literallayout"><p>Type: string<br />
782
876
Default: “<span class="quote"><code class="literal">˜</code></span>”</p></div><p>
783
877
Escape character to use for functions in the builtin editor.
784
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fast-reply"></a>3.55. fast_reply</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
878
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fast-reply"></a>3.63. fast_reply</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
785
879
Default: no</p></div><p>
786
880
When <span class="emphasis"><em>set</em></span>, the initial prompt for recipients and subject are skipped
787
881
when replying to messages, and the initial prompt for subject is
788
882
skipped when forwarding messages.
790
<span class="bold"><strong>Note:</strong></span> this variable has no effect when the <a class="link" href="reference.html#autoedit" title="3.17. autoedit">$autoedit</a>
884
<span class="bold"><strong>Note:</strong></span> this variable has no effect when the <a class="link" href="reference.html#autoedit" title="3.18. autoedit">$autoedit</a>
791
885
variable is <span class="emphasis"><em>set</em></span>.
792
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-attach"></a>3.56. fcc_attach</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
886
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-attach"></a>3.64. fcc_attach</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
793
887
Default: yes</p></div><p>
794
888
This variable controls whether or not attachments on outgoing messages
795
889
are saved along with the main body of your message.
796
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-clear"></a>3.57. fcc_clear</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
890
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-clear"></a>3.65. fcc_clear</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
797
891
Default: no</p></div><p>
798
892
When this variable is <span class="emphasis"><em>set</em></span>, FCCs will be stored unencrypted and
799
893
unsigned, even when the actual message is encrypted and/or
802
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="folder"></a>3.58. folder</h3></div></div></div><div class="literallayout"><p>Type: path<br />
896
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="folder"></a>3.66. folder</h3></div></div></div><div class="literallayout"><p>Type: path<br />
803
897
Default: “<span class="quote"><code class="literal">˜/Mail</code></span>”</p></div><p>
804
898
Specifies the default location of your mailboxes. A “<span class="quote">+</span>” or “<span class="quote">=</span>” at the
805
899
beginning of a pathname will be expanded to the value of this
806
900
variable. Note that if you change this variable (from the default)
807
901
value you need to make sure that the assignment occurs <span class="emphasis"><em>before</em></span>
808
902
you use “<span class="quote">+</span>” or “<span class="quote">=</span>” for any other variables since expansion takes place
809
when handling the “<span class="quote"><a class="link" href="configuration.html#mailboxes" title="14. Monitoring incoming mail">mailboxes</a></span>” command.
810
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="folder-format"></a>3.59. folder_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
903
when handling the “<span class="quote"><a class="link" href="configuration.html#mailboxes" title="14. Monitoring Incoming Mail">mailboxes</a></span>” command.
904
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="folder-format"></a>3.67. folder_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
811
905
Default: “<span class="quote"><code class="literal">%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f</code></span>”</p></div><p>
812
906
This variable allows you to customize the file browser display to your
813
personal taste. This string is similar to <a class="link" href="reference.html#index-format" title="3.101. index_format">$index_format</a>, but has
907
personal taste. This string is similar to <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a>, but has
814
908
its own set of <code class="literal">printf(3)</code>-like sequences:
816
</p><div class="variablelist"><dl><dt><span class="term">%C </span></dt><dd><p>current file number
817
</p></dd><dt><span class="term">%d </span></dt><dd><p>date/time folder was last modified
818
</p></dd><dt><span class="term">%f </span></dt><dd><p>filename
819
</p></dd><dt><span class="term">%F </span></dt><dd><p>file permissions
820
</p></dd><dt><span class="term">%g </span></dt><dd><p>group name (or numeric gid, if missing)
821
</p></dd><dt><span class="term">%l </span></dt><dd><p>number of hard links
822
</p></dd><dt><span class="term">%N </span></dt><dd><p>N if folder has new mail, blank otherwise
823
</p></dd><dt><span class="term">%s </span></dt><dd><p>size in bytes
824
</p></dd><dt><span class="term">%t </span></dt><dd><p>“<span class="quote">*</span>” if the file is tagged, blank otherwise
825
</p></dd><dt><span class="term">%u </span></dt><dd><p>owner name (or numeric uid, if missing)
826
</p></dd><dt><span class="term">%>X </span></dt><dd><p>right justify the rest of the string and pad with character “<span class="quote">X</span>”
827
</p></dd><dt><span class="term">%|X </span></dt><dd><p>pad to the end of the line with character “<span class="quote">X</span>”
828
</p></dd><dt><span class="term">%*X </span></dt><dd><p>soft-fill with character “<span class="quote">X</span>” as pad
829
</p></dd></dl></div><p>
830
For an explanation of “<span class="quote">soft-fill</span>”, see the <a class="link" href="reference.html#index-format" title="3.101. index_format">$index_format</a> documentation.
831
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="followup-to"></a>3.60. followup_to</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
910
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%C </td><td>current file number
911
</td></tr><tr><td>%d </td><td>date/time folder was last modified
912
</td></tr><tr><td>%f </td><td>filename (“<span class="quote">/</span>” is appended to directory names,
913
“<span class="quote">@</span>” to symbolic links and “<span class="quote">*</span>” to executable
915
</td></tr><tr><td>%F </td><td>file permissions
916
</td></tr><tr><td>%g </td><td>group name (or numeric gid, if missing)
917
</td></tr><tr><td>%l </td><td>number of hard links
918
</td></tr><tr><td>%N </td><td>N if folder has new mail, blank otherwise
919
</td></tr><tr><td>%s </td><td>size in bytes
920
</td></tr><tr><td>%t </td><td>“<span class="quote">*</span>” if the file is tagged, blank otherwise
921
</td></tr><tr><td>%u </td><td>owner name (or numeric uid, if missing)
922
</td></tr><tr><td>%>X </td><td>right justify the rest of the string and pad with character “<span class="quote">X</span>”
923
</td></tr><tr><td>%|X </td><td>pad to the end of the line with character “<span class="quote">X</span>”
924
</td></tr><tr><td>%*X </td><td>soft-fill with character “<span class="quote">X</span>” as pad
925
</td></tr></tbody></table></div><p>
926
For an explanation of “<span class="quote">soft-fill</span>”, see the <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a> documentation.
927
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="followup-to"></a>3.68. followup_to</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
832
928
Default: yes</p></div><p>
833
929
Controls whether or not the “<span class="quote">Mail-Followup-To:</span>” header field is
834
930
generated when sending mail. When <span class="emphasis"><em>set</em></span>, Mutt will generate this
835
931
field when you are replying to a known mailing list, specified with
836
the “<span class="quote"><a class="link" href="configuration.html#subscribe">subscribe</a></span>” or “<span class="quote"><a class="link" href="configuration.html#lists" title="12. Mailing lists">lists</a></span>” commands.
932
the “<span class="quote"><a class="link" href="configuration.html#subscribe">subscribe</a></span>” or “<span class="quote"><a class="link" href="configuration.html#lists" title="12. Mailing Lists">lists</a></span>” commands.
838
934
This field has two purposes. First, preventing you from
839
935
receiving duplicate copies of replies to messages which you send
1136
1270
function <code class="literal">printf(3)</code> to format output (see the man page for more details).
1137
1271
The following sequences are defined in Mutt:
1139
</p><div class="variablelist"><dl><dt><span class="term">%a </span></dt><dd><p>address of the author
1140
</p></dd><dt><span class="term">%A </span></dt><dd><p>reply-to address (if present; otherwise: address of author)
1141
</p></dd><dt><span class="term">%b </span></dt><dd><p>filename of the original message folder (think mailbox)
1142
</p></dd><dt><span class="term">%B </span></dt><dd><p>the list to which the letter was sent, or else the folder name (%b).
1143
</p></dd><dt><span class="term">%c </span></dt><dd><p>number of characters (bytes) in the message
1144
</p></dd><dt><span class="term">%C </span></dt><dd><p>current message number
1145
</p></dd><dt><span class="term">%d </span></dt><dd><p>date and time of the message in the format specified by
1146
<a class="link" href="reference.html#date-format" title="3.40. date_format">$date_format</a> converted to sender's time zone
1147
</p></dd><dt><span class="term">%D </span></dt><dd><p>date and time of the message in the format specified by
1148
<a class="link" href="reference.html#date-format" title="3.40. date_format">$date_format</a> converted to the local time zone
1149
</p></dd><dt><span class="term">%e </span></dt><dd><p>current message number in thread
1150
</p></dd><dt><span class="term">%E </span></dt><dd><p>number of messages in current thread
1151
</p></dd><dt><span class="term">%f </span></dt><dd><p>sender (address + real name), either From: or Return-Path:
1152
</p></dd><dt><span class="term">%F </span></dt><dd><p>author name, or recipient name if the message is from you
1153
</p></dd><dt><span class="term">%H </span></dt><dd><p>spam attribute(s) of this message
1154
</p></dd><dt><span class="term">%i </span></dt><dd><p>message-id of the current message
1155
</p></dd><dt><span class="term">%l </span></dt><dd><p>number of lines in the message (does not work with maildir,
1273
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%a </td><td>address of the author
1274
</td></tr><tr><td>%A </td><td>reply-to address (if present; otherwise: address of author)
1275
</td></tr><tr><td>%b </td><td>filename of the original message folder (think mailbox)
1276
</td></tr><tr><td>%B </td><td>the list to which the letter was sent, or else the folder name (%b).
1277
</td></tr><tr><td>%c </td><td>number of characters (bytes) in the message
1278
</td></tr><tr><td>%C </td><td>current message number
1279
</td></tr><tr><td>%d </td><td>date and time of the message in the format specified by
1280
<a class="link" href="reference.html#date-format" title="3.47. date_format">$date_format</a> converted to sender's time zone
1281
</td></tr><tr><td>%D </td><td>date and time of the message in the format specified by
1282
<a class="link" href="reference.html#date-format" title="3.47. date_format">$date_format</a> converted to the local time zone
1283
</td></tr><tr><td>%e </td><td>current message number in thread
1284
</td></tr><tr><td>%E </td><td>number of messages in current thread
1285
</td></tr><tr><td>%f </td><td>sender (address + real name), either From: or Return-Path:
1286
</td></tr><tr><td>%F </td><td>author name, or recipient name if the message is from you
1287
</td></tr><tr><td>%H </td><td>spam attribute(s) of this message
1288
</td></tr><tr><td>%i </td><td>message-id of the current message
1289
</td></tr><tr><td>%l </td><td>number of lines in the message (does not work with maildir,
1156
1290
mh, and possibly IMAP folders)
1157
</p></dd><dt><span class="term">%L </span></dt><dd><p>If an address in the “<span class="quote">To:</span>” or “<span class="quote">Cc:</span>” header field matches an address
1291
</td></tr><tr><td>%L </td><td>If an address in the “<span class="quote">To:</span>” or “<span class="quote">Cc:</span>” header field matches an address
1158
1292
defined by the users “<span class="quote"><a class="link" href="configuration.html#subscribe">subscribe</a></span>” command, this displays
1159
1293
"To <list-name>", otherwise the same as %F.
1160
</p></dd><dt><span class="term">%m </span></dt><dd><p>total number of message in the mailbox
1161
</p></dd><dt><span class="term">%M </span></dt><dd><p>number of hidden messages if the thread is collapsed.
1162
</p></dd><dt><span class="term">%N </span></dt><dd><p>message score
1163
</p></dd><dt><span class="term">%n </span></dt><dd><p>author's real name (or address if missing)
1164
</p></dd><dt><span class="term">%O </span></dt><dd><p>original save folder where mutt would formerly have
1294
</td></tr><tr><td>%m </td><td>total number of message in the mailbox
1295
</td></tr><tr><td>%M </td><td>number of hidden messages if the thread is collapsed.
1296
</td></tr><tr><td>%N </td><td>message score
1297
</td></tr><tr><td>%n </td><td>author's real name (or address if missing)
1298
</td></tr><tr><td>%O </td><td>original save folder where mutt would formerly have
1165
1299
stashed the message: list name or recipient name
1166
1300
if not sent to a list
1167
</p></dd><dt><span class="term">%P </span></dt><dd><p>progress indicator for the builtin pager (how much of the file has been displayed)
1168
</p></dd><dt><span class="term">%s </span></dt><dd><p>subject of the message
1169
</p></dd><dt><span class="term">%S </span></dt><dd><p>status of the message (“<span class="quote">N</span>”/“<span class="quote">D</span>”/“<span class="quote">d</span>”/“<span class="quote">!</span>”/“<span class="quote">r</span>”/*)
1170
</p></dd><dt><span class="term">%t </span></dt><dd><p>“<span class="quote">To:</span>” field (recipients)
1171
</p></dd><dt><span class="term">%T </span></dt><dd><p>the appropriate character from the <a class="link" href="reference.html#to-chars" title="3.290. to_chars">$to_chars</a> string
1172
</p></dd><dt><span class="term">%u </span></dt><dd><p>user (login) name of the author
1173
</p></dd><dt><span class="term">%v </span></dt><dd><p>first name of the author, or the recipient if the message is from you
1174
</p></dd><dt><span class="term">%X </span></dt><dd><p>number of attachments
1301
</td></tr><tr><td>%P </td><td>progress indicator for the builtin pager (how much of the file has been displayed)
1302
</td></tr><tr><td>%s </td><td>subject of the message
1303
</td></tr><tr><td>%S </td><td>status of the message (“<span class="quote">N</span>”/“<span class="quote">D</span>”/“<span class="quote">d</span>”/“<span class="quote">!</span>”/“<span class="quote">r</span>”/*)
1304
</td></tr><tr><td>%t </td><td>“<span class="quote">To:</span>” field (recipients)
1305
</td></tr><tr><td>%T </td><td>the appropriate character from the <a class="link" href="reference.html#to-chars" title="3.293. to_chars">$to_chars</a> string
1306
</td></tr><tr><td>%u </td><td>user (login) name of the author
1307
</td></tr><tr><td>%v </td><td>first name of the author, or the recipient if the message is from you
1308
</td></tr><tr><td>%X </td><td>number of attachments
1175
1309
(please see the “<span class="quote"><a class="link" href="mimesupport.html#attachments" title="6. Attachment Searching and Counting">attachments</a></span>” section for possible speed effects)
1176
</p></dd><dt><span class="term">%y </span></dt><dd><p>“<span class="quote">X-Label:</span>” field, if present
1177
</p></dd><dt><span class="term">%Y </span></dt><dd><p>“<span class="quote">X-Label:</span>” field, if present, and <span class="emphasis"><em>(1)</em></span> not at part of a thread tree,
1310
</td></tr><tr><td>%y </td><td>“<span class="quote">X-Label:</span>” field, if present
1311
</td></tr><tr><td>%Y </td><td>“<span class="quote">X-Label:</span>” field, if present, and <span class="emphasis"><em>(1)</em></span> not at part of a thread tree,
1178
1312
<span class="emphasis"><em>(2)</em></span> at the top of a thread, or <span class="emphasis"><em>(3)</em></span> “<span class="quote">X-Label:</span>” is different from
1179
1313
preceding message's “<span class="quote">X-Label:</span>”.
1180
</p></dd><dt><span class="term">%Z </span></dt><dd><p>message status flags
1181
</p></dd><dt><span class="term">%{fmt} </span></dt><dd><p>the date and time of the message is converted to sender's
1182
time zone, and “<span class="quote">fmt</span>” is expanded by the library function
1183
<code class="literal">strftime(3)</code>; a leading bang disables locales
1184
</p></dd><dt><span class="term">%[fmt] </span></dt><dd><p>the date and time of the message is converted to the local
1185
time zone, and “<span class="quote">fmt</span>” is expanded by the library function
1186
<code class="literal">strftime(3)</code>; a leading bang disables locales
1187
</p></dd><dt><span class="term">%(fmt) </span></dt><dd><p>the local date and time when the message was received.
1314
</td></tr><tr><td>%Z </td><td>message status flags
1315
</td></tr><tr><td>%{fmt} </td><td>the date and time of the message is converted to sender's
1316
time zone, and “<span class="quote">fmt</span>” is expanded by the library function
1317
<code class="literal">strftime(3)</code>; a leading bang disables locales
1318
</td></tr><tr><td>%[fmt] </td><td>the date and time of the message is converted to the local
1319
time zone, and “<span class="quote">fmt</span>” is expanded by the library function
1320
<code class="literal">strftime(3)</code>; a leading bang disables locales
1321
</td></tr><tr><td>%(fmt) </td><td>the local date and time when the message was received.
1188
1322
“<span class="quote">fmt</span>” is expanded by the library function <code class="literal">strftime(3)</code>;
1189
1323
a leading bang disables locales
1190
</p></dd><dt><span class="term">%<fmt> </span></dt><dd><p>the current local time. “<span class="quote">fmt</span>” is expanded by the library
1324
</td></tr><tr><td>%<fmt> </td><td>the current local time. “<span class="quote">fmt</span>” is expanded by the library
1191
1325
function <code class="literal">strftime(3)</code>; a leading bang disables locales.
1192
</p></dd><dt><span class="term">%>X </span></dt><dd><p>right justify the rest of the string and pad with character “<span class="quote">X</span>”
1193
</p></dd><dt><span class="term">%|X </span></dt><dd><p>pad to the end of the line with character “<span class="quote">X</span>”
1194
</p></dd><dt><span class="term">%*X </span></dt><dd><p>soft-fill with character “<span class="quote">X</span>” as pad
1195
</p></dd></dl></div><p>
1326
</td></tr><tr><td>%>X </td><td>right justify the rest of the string and pad with character “<span class="quote">X</span>”
1327
</td></tr><tr><td>%|X </td><td>pad to the end of the line with character “<span class="quote">X</span>”
1328
</td></tr><tr><td>%*X </td><td>soft-fill with character “<span class="quote">X</span>” as pad
1329
</td></tr></tbody></table></div><p>
1196
1330
“<span class="quote">Soft-fill</span>” deserves some explanation: Normal right-justification
1197
1331
will print everything to the left of the “<span class="quote">%></span>”, displaying padding and
1198
1332
whatever lies to the right only if there's room. By contrast,
1232
1366
<span class="bold"><strong>DON'T CHANGE THIS SETTING UNLESS YOU ARE REALLY SURE WHAT YOU ARE
1233
1367
DOING!</strong></span>
1234
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache"></a>3.108. header_cache</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1235
Default: (empty)</p></div><p>
1236
This variable points to the header cache database.
1237
If pointing to a directory Mutt will contain a header cache
1238
database file per folder, if pointing to a file that file will
1239
be a single global header cache. By default it is <span class="emphasis"><em>unset</em></span> so no header
1240
caching will be used.
1242
Header caching can greatly improve speed when opening POP, IMAP
1243
MH or Maildir folders, see “<span class="quote"><a class="link" href="optionalfeatures.html#caching" title="7. Local caching">caching</a></span>” for details.
1244
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-header-cache-verify"></a>3.109. maildir_header_cache_verify</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1368
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-header-cache-verify"></a>3.121. maildir_header_cache_verify</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1245
1369
Default: yes</p></div><p>
1246
1370
Check for Maildir unaware programs other than mutt having modified maildir
1247
1371
files when the header cache is in use. This incurs one <code class="literal">stat(2)</code> per
1248
1372
message every time the folder is opened (which can be very slow for NFS
1250
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache-pagesize"></a>3.110. header_cache_pagesize</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1251
Default: “<span class="quote"><code class="literal">16384</code></span>”</p></div><p>
1252
When mutt is compiled with either gdbm or bdb4 as the header cache backend,
1253
this option changes the database page size. Too large or too small
1254
values can waste space, memory, or CPU time. The default should be more
1255
or less optimal for most use cases.
1256
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache-compress"></a>3.111. header_cache_compress</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1257
Default: yes</p></div><p>
1258
When mutt is compiled with qdbm or tokyocabinet as header cache backend,
1259
this option determines whether the database will be compressed.
1260
Compression results in database files roughly being one fifth
1261
of the usual diskspace, but the uncompression can result in a
1262
slower opening of cached folder(s) which in general is still
1263
much faster than opening non header cached folders.
1264
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-trash"></a>3.112. maildir_trash</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1374
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-trash"></a>3.122. maildir_trash</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1265
1375
Default: no</p></div><p>
1266
1376
If <span class="emphasis"><em>set</em></span>, messages marked as deleted will be saved with the maildir
1267
1377
trashed flag instead of unlinked. <span class="bold"><strong>Note:</strong></span> this only applies
1268
1378
to maildir-style mailboxes. Setting it will have no effect on other
1270
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mark-old"></a>3.113. mark_old</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1380
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mark-old"></a>3.123. mark_old</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1271
1381
Default: yes</p></div><p>
1272
1382
Controls whether or not mutt marks <span class="emphasis"><em>new</em></span> <span class="bold"><strong>unread</strong></span>
1273
1383
messages as <span class="emphasis"><em>old</em></span> if you exit a mailbox without reading them.
1274
1384
With this option <span class="emphasis"><em>set</em></span>, the next time you start mutt, the messages
1275
1385
will show up with an “<span class="quote">O</span>” next to them in the index menu,
1276
1386
indicating that they are old.
1277
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="markers"></a>3.114. markers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1387
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="markers"></a>3.124. markers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1278
1388
Default: yes</p></div><p>
1279
1389
Controls the display of wrapped lines in the internal pager. If set, a
1280
1390
“<span class="quote">+</span>” marker is displayed at the beginning of wrapped lines.
1282
Also see the <a class="link" href="reference.html#smart-wrap" title="3.265. smart_wrap">$smart_wrap</a> variable.
1283
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mask"></a>3.115. mask</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
1392
Also see the <a class="link" href="reference.html#smart-wrap" title="3.238. smart_wrap">$smart_wrap</a> variable.
1393
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mask"></a>3.125. mask</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
1284
1394
Default: “<span class="quote"><code class="literal">!^\.[^.]</code></span>”</p></div><p>
1285
1395
A regular expression used in the file browser, optionally preceded by
1286
1396
the <span class="emphasis"><em>not</em></span> operator “<span class="quote">!</span>”. Only files whose names match this mask
1287
1397
will be shown. The match is always case-sensitive.
1288
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mbox"></a>3.116. mbox</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1398
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mbox"></a>3.126. mbox</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1289
1399
Default: “<span class="quote"><code class="literal">˜/mbox</code></span>”</p></div><p>
1290
This specifies the folder into which read mail in your <a class="link" href="reference.html#spoolfile" title="3.277. spoolfile">$spoolfile</a>
1400
This specifies the folder into which read mail in your <a class="link" href="reference.html#spoolfile" title="3.269. spoolfile">$spoolfile</a>
1291
1401
folder will be appended.
1293
Also see the <a class="link" href="reference.html#move" title="3.132. move">$move</a> variable.
1294
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mbox-type"></a>3.117. mbox_type</h3></div></div></div><div class="literallayout"><p>Type: folder magic<br />
1403
Also see the <a class="link" href="reference.html#move" title="3.145. move">$move</a> variable.
1404
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mbox-type"></a>3.127. mbox_type</h3></div></div></div><div class="literallayout"><p>Type: folder magic<br />
1295
1405
Default: mbox</p></div><p>
1296
1406
The default mailbox type used when creating new folders. May be any of
1297
“<span class="quote">mbox</span>”, “<span class="quote">MMDF</span>”, “<span class="quote">MH</span>” and “<span class="quote">Maildir</span>”.
1298
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="metoo"></a>3.118. metoo</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1299
Default: no</p></div><p>
1300
If <span class="emphasis"><em>unset</em></span>, Mutt will remove your address (see the “<span class="quote"><a class="link" href="configuration.html#alternates" title="11. Alternative addresses">alternates</a></span>”
1301
command) from the list of recipients when replying to a message.
1302
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-context"></a>3.119. menu_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1407
“<span class="quote">mbox</span>”, “<span class="quote">MMDF</span>”, “<span class="quote">MH</span>” and “<span class="quote">Maildir</span>”. This is overriden by the
1408
<code class="literal">-m</code> command-line option.
1409
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-context"></a>3.128. menu_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1303
1410
Default: 0</p></div><p>
1304
1411
This variable controls the number of lines of context that are given
1305
when scrolling through menus. (Similar to <a class="link" href="reference.html#pager-context" title="3.139. pager_context">$pager_context</a>.)
1306
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-move-off"></a>3.120. menu_move_off</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1412
when scrolling through menus. (Similar to <a class="link" href="reference.html#pager-context" title="3.149. pager_context">$pager_context</a>.)
1413
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-move-off"></a>3.129. menu_move_off</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1307
1414
Default: yes</p></div><p>
1308
1415
When <span class="emphasis"><em>unset</em></span>, the bottom entry of menus will never scroll up past
1309
1416
the bottom of the screen, unless there are less entries than lines.
1310
1417
When <span class="emphasis"><em>set</em></span>, the bottom entry may move off the bottom.
1311
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-scroll"></a>3.121. menu_scroll</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1418
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-scroll"></a>3.130. menu_scroll</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1312
1419
Default: no</p></div><p>
1313
1420
When <span class="emphasis"><em>set</em></span>, menus will be scrolled up or down one line when you
1314
1421
attempt to move across a screen boundary. If <span class="emphasis"><em>unset</em></span>, the screen
1315
1422
is cleared and the next or previous page of the menu is displayed
1316
1423
(useful for slow links to avoid many redraws).
1317
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="meta-key"></a>3.122. meta_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1424
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-cache-clean"></a>3.131. message_cache_clean</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1425
Default: no</p></div><p>
1426
If <span class="emphasis"><em>set</em></span>, mutt will clean out obsolete entries from the message cache when
1427
the mailbox is synchronized. You probably only want to set it
1428
every once in a while, since it can be a little slow
1429
(especially for large folders).
1430
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-cachedir"></a>3.132. message_cachedir</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1431
Default: (empty)</p></div><p>
1432
Set this to a directory and mutt will cache copies of messages from
1433
your IMAP and POP servers here. You are free to remove entries at any
1436
When setting this variable to a directory, mutt needs to fetch every
1437
remote message only once and can perform regular expression searches
1438
as fast as for local folders.
1440
Also see the <a class="link" href="reference.html#message-cache-clean" title="3.131. message_cache_clean">$message_cache_clean</a> variable.
1441
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-format"></a>3.133. message_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1442
Default: “<span class="quote"><code class="literal">%s</code></span>”</p></div><p>
1443
This is the string displayed in the “<span class="quote">attachment</span>” menu for
1444
attachments of type <code class="literal">message/rfc822</code>. For a full listing of defined
1445
<code class="literal">printf(3)</code>-like sequences see the section on <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a>.
1446
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="meta-key"></a>3.134. meta_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1318
1447
Default: no</p></div><p>
1319
1448
If <span class="emphasis"><em>set</em></span>, forces Mutt to interpret keystrokes with the high bit (bit 8)
1320
1449
set as if the user had pressed the Esc key and whatever key remains
1350
1483
to switch between MIME and not MIME from mail to mail, set this
1351
1484
variable to “<span class="quote">ask-no</span>” or “<span class="quote">ask-yes</span>”.
1353
Also see <a class="link" href="reference.html#forward-decode" title="3.62. forward_decode">$forward_decode</a> and <a class="link" href="reference.html#mime-forward-decode" title="3.128. mime_forward_decode">$mime_forward_decode</a>.
1354
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-decode"></a>3.128. mime_forward_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1486
Also see <a class="link" href="reference.html#forward-decode" title="3.70. forward_decode">$forward_decode</a> and <a class="link" href="reference.html#mime-forward-decode" title="3.141. mime_forward_decode">$mime_forward_decode</a>.
1487
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-decode"></a>3.141. mime_forward_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1355
1488
Default: no</p></div><p>
1356
1489
Controls the decoding of complex MIME messages into <code class="literal">text/plain</code> when
1357
forwarding a message while <a class="link" href="reference.html#mime-forward" title="3.127. mime_forward">$mime_forward</a> is <span class="emphasis"><em>set</em></span>. Otherwise
1358
<a class="link" href="reference.html#forward-decode" title="3.62. forward_decode">$forward_decode</a> is used instead.
1359
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-rest"></a>3.129. mime_forward_rest</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1490
forwarding a message while <a class="link" href="reference.html#mime-forward" title="3.140. mime_forward">$mime_forward</a> is <span class="emphasis"><em>set</em></span>. Otherwise
1491
<a class="link" href="reference.html#forward-decode" title="3.70. forward_decode">$forward_decode</a> is used instead.
1492
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-rest"></a>3.142. mime_forward_rest</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1360
1493
Default: yes</p></div><p>
1361
1494
When forwarding multiple attachments of a MIME message from the attachment
1362
1495
menu, attachments which cannot be decoded in a reasonable manner will
1363
1496
be attached to the newly composed message if this option is <span class="emphasis"><em>set</em></span>.
1364
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mix-entry-format"></a>3.130. mix_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1497
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mix-entry-format"></a>3.143. mix_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1365
1498
Default: “<span class="quote"><code class="literal">%4n %c %-16s %a</code></span>”</p></div><p>
1366
1499
This variable describes the format of a remailer line on the mixmaster
1367
1500
chain selection screen. The following <code class="literal">printf(3)</code>-like sequences are
1370
</p><div class="variablelist"><dl><dt><span class="term">%n </span></dt><dd><p>The running number on the menu.
1371
</p></dd><dt><span class="term">%c </span></dt><dd><p>Remailer capabilities.
1372
</p></dd><dt><span class="term">%s </span></dt><dd><p>The remailer's short name.
1373
</p></dd><dt><span class="term">%a </span></dt><dd><p>The remailer's e-mail address.
1374
</p></dd></dl></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mixmaster"></a>3.131. mixmaster</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1503
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%n </td><td>The running number on the menu.
1504
</td></tr><tr><td>%c </td><td>Remailer capabilities.
1505
</td></tr><tr><td>%s </td><td>The remailer's short name.
1506
</td></tr><tr><td>%a </td><td>The remailer's e-mail address.
1507
</td></tr></tbody></table></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mixmaster"></a>3.144. mixmaster</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1375
1508
Default: “<span class="quote"><code class="literal">mixmaster</code></span>”</p></div><p>
1376
1509
This variable contains the path to the Mixmaster binary on your
1377
1510
system. It is used with various sets of parameters to gather the
1378
1511
list of known remailers, and to finally send a message through the
1379
1512
mixmaster chain.
1380
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="move"></a>3.132. move</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1513
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="move"></a>3.145. move</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1381
1514
Default: no</p></div><p>
1382
1515
Controls whether or not Mutt will move read messages
1383
from your spool mailbox to your <a class="link" href="reference.html#mbox" title="3.116. mbox">$mbox</a> mailbox, or as a result of
1384
a “<span class="quote"><a class="link" href="configuration.html#mbox-hook" title="13. Using Multiple spool mailboxes">mbox-hook</a></span>” command.
1385
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-cachedir"></a>3.133. message_cachedir</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1386
Default: (empty)</p></div><p>
1387
Set this to a directory and mutt will cache copies of messages from
1388
your IMAP and POP servers here. You are free to remove entries at any
1391
When setting this variable to a directory, mutt needs to fetch every
1392
remote message only once and can perform regular expression searches
1393
as fast as for local folders.
1395
Also see the <a class="link" href="reference.html#message-cache-clean" title="3.134. message_cache_clean">$message_cache_clean</a> variable.
1396
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-cache-clean"></a>3.134. message_cache_clean</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1397
Default: no</p></div><p>
1398
If <span class="emphasis"><em>set</em></span>, mutt will clean out obsolete entries from the message cache when
1399
the mailbox is synchronized. You probably only want to set it
1400
every once in a while, since it can be a little slow
1401
(especially for large folders).
1402
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-format"></a>3.135. message_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1403
Default: “<span class="quote"><code class="literal">%s</code></span>”</p></div><p>
1404
This is the string displayed in the “<span class="quote">attachment</span>” menu for
1405
attachments of type <code class="literal">message/rfc822</code>. For a full listing of defined
1406
<code class="literal">printf(3)</code>-like sequences see the section on <a class="link" href="reference.html#index-format" title="3.101. index_format">$index_format</a>.
1407
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="narrow-tree"></a>3.136. narrow_tree</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1516
from your spool mailbox to your <a class="link" href="reference.html#mbox" title="3.126. mbox">$mbox</a> mailbox, or as a result of
1517
a “<span class="quote"><a class="link" href="configuration.html#mbox-hook" title="13. Using Multiple Spool Mailboxes">mbox-hook</a></span>” command.
1518
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="narrow-tree"></a>3.146. narrow_tree</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1408
1519
Default: no</p></div><p>
1409
1520
This variable, when <span class="emphasis"><em>set</em></span>, makes the thread tree narrower, allowing
1410
1521
deeper threads to fit on the screen.
1411
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="net-inc"></a>3.137. net_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1522
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="net-inc"></a>3.147. net_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1412
1523
Default: 10</p></div><p>
1413
1524
Operations that expect to transfer a large amount of data over the
1414
network will update their progress every <a class="link" href="reference.html#net-inc" title="3.137. net_inc">$net_inc</a> kilobytes.
1525
network will update their progress every <a class="link" href="reference.html#net-inc" title="3.147. net_inc">$net_inc</a> kilobytes.
1415
1526
If set to 0, no progress messages will be displayed.
1417
See also <a class="link" href="reference.html#read-inc" title="3.236. read_inc">$read_inc</a>, <a class="link" href="reference.html#write-inc" title="3.305. write_inc">$write_inc</a> and <a class="link" href="reference.html#net-inc" title="3.137. net_inc">$net_inc</a>.
1418
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager"></a>3.138. pager</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1528
See also <a class="link" href="reference.html#read-inc" title="3.207. read_inc">$read_inc</a>, <a class="link" href="reference.html#write-inc" title="3.310. write_inc">$write_inc</a> and <a class="link" href="reference.html#net-inc" title="3.147. net_inc">$net_inc</a>.
1529
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager"></a>3.148. pager</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1419
1530
Default: “<span class="quote"><code class="literal">builtin</code></span>”</p></div><p>
1420
1531
This variable specifies which pager you would like to use to view
1421
1532
messages. The value “<span class="quote">builtin</span>” means to use the builtin pager, otherwise this
1449
1564
for the status bar from the index, so a setting of 6
1450
1565
will only show 5 lines of the actual index. A value of 0 results in
1451
1566
no index being shown. If the number of messages in the current folder
1452
is less than <a class="link" href="reference.html#pager-index-lines" title="3.141. pager_index_lines">$pager_index_lines</a>, then the index will only use as
1567
is less than <a class="link" href="reference.html#pager-index-lines" title="3.151. pager_index_lines">$pager_index_lines</a>, then the index will only use as
1453
1568
many lines as it needs.
1454
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager-stop"></a>3.142. pager_stop</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1569
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager-stop"></a>3.152. pager_stop</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1455
1570
Default: no</p></div><p>
1456
1571
When <span class="emphasis"><em>set</em></span>, the internal-pager will <span class="bold"><strong>not</strong></span> move to the next message
1457
1572
when you are at the end of a message and invoke the <code class="literal"><next-page></code>
1459
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosign"></a>3.143. crypt_autosign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1460
Default: no</p></div><p>
1461
Setting this variable will cause Mutt to always attempt to
1462
cryptographically sign outgoing messages. This can be overridden
1463
by use of the pgp menu, when signing is not required or
1464
encryption is requested as well. If <a class="link" href="reference.html#smime-is-default" title="3.152. smime_is_default">$smime_is_default</a> is <span class="emphasis"><em>set</em></span>,
1465
then OpenSSL is used instead to create S/MIME messages and settings can
1466
be overridden by use of the smime menu instead of the pgp menu.
1468
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autoencrypt"></a>3.144. crypt_autoencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1469
Default: no</p></div><p>
1470
Setting this variable will cause Mutt to always attempt to PGP
1471
encrypt outgoing messages. This is probably only useful in
1472
connection to the “<span class="quote"><a class="link" href="configuration.html#send-hook" title="19. Change settings based upon message recipients">send-hook</a></span>” command. It can be overridden
1473
by use of the pgp menu, when encryption is not required or
1474
signing is requested as well. If <a class="link" href="reference.html#smime-is-default" title="3.152. smime_is_default">$smime_is_default</a> is <span class="emphasis"><em>set</em></span>,
1475
then OpenSSL is used instead to create S/MIME messages and
1476
settings can be overridden by use of the smime menu instead.
1478
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-ignore-subkeys"></a>3.145. pgp_ignore_subkeys</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1479
Default: yes</p></div><p>
1480
Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead,
1481
the principal key will inherit the subkeys' capabilities. <span class="emphasis"><em>Unset</em></span> this
1482
if you want to play interesting key selection games.
1484
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replyencrypt"></a>3.146. crypt_replyencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1485
Default: yes</p></div><p>
1486
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL encrypt replies to messages which are
1489
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysign"></a>3.147. crypt_replysign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1490
Default: no</p></div><p>
1491
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL sign replies to messages which are
1494
<span class="bold"><strong>Note:</strong></span> this does not work on messages that are encrypted
1495
<span class="emphasis"><em>and</em></span> signed!
1497
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysignencrypted"></a>3.148. crypt_replysignencrypted</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1498
Default: no</p></div><p>
1499
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL sign replies to messages
1500
which are encrypted. This makes sense in combination with
1501
<a class="link" href="reference.html#crypt-replyencrypt" title="3.146. crypt_replyencrypt">$crypt_replyencrypt</a>, because it allows you to sign all
1502
messages which are automatically encrypted. This works around
1503
the problem noted in <a class="link" href="reference.html#crypt-replysign" title="3.147. crypt_replysign">$crypt_replysign</a>, that mutt is not able
1504
to find out whether an encrypted message is also signed.
1506
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-timestamp"></a>3.149. crypt_timestamp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1507
Default: yes</p></div><p>
1508
If <span class="emphasis"><em>set</em></span>, mutt will include a time stamp in the lines surrounding
1509
PGP or S/MIME output, so spoofing such lines is more difficult.
1510
If you are using colors to mark these lines, and rely on these,
1511
you may <span class="emphasis"><em>unset</em></span> this setting.
1513
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-use-gpg-agent"></a>3.150. pgp_use_gpg_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1514
Default: no</p></div><p>
1515
If <span class="emphasis"><em>set</em></span>, mutt will use a possibly-running <code class="literal">gpg-agent(1)</code> process.
1517
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-verify-sig"></a>3.151. crypt_verify_sig</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1518
Default: yes</p></div><p>
1519
If <span class="emphasis"><em>“<span class="quote">yes</span>”</em></span>, always attempt to verify PGP or S/MIME signatures.
1520
If <span class="emphasis"><em>“<span class="quote">ask-*</span>”</em></span>, ask whether or not to verify the signature.
1521
If \Fi“<span class="quote">no</span>”, never attempt to verify cryptographic signatures.
1523
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-is-default"></a>3.152. smime_is_default</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1524
Default: no</p></div><p>
1525
The default behaviour of mutt is to use PGP on all auto-sign/encryption
1526
operations. To override and to use OpenSSL instead this must be <span class="emphasis"><em>set</em></span>.
1527
However, this has no effect while replying, since mutt will automatically
1528
select the same application that was used to sign/encrypt the original
1529
message. (Note that this variable can be overridden by unsetting <a class="link" href="reference.html#crypt-autosmime" title="3.39. crypt_autosmime">$crypt_autosmime</a>.)
1531
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ask-cert-label"></a>3.153. smime_ask_cert_label</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1532
Default: yes</p></div><p>
1533
This flag controls whether you want to be asked to enter a label
1534
for a certificate about to be added to the database or not. It is
1535
<span class="emphasis"><em>set</em></span> by default.
1537
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-use-default-key"></a>3.154. smime_decrypt_use_default_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1538
Default: yes</p></div><p>
1539
If <span class="emphasis"><em>set</em></span> (default) this tells mutt to use the default key for decryption. Otherwise,
1540
if managing multiple certificate-key-pairs, mutt will try to use the mailbox-address
1541
to determine the key to use. It will ask you to supply a key, if it can't find one.
1543
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-entry-format"></a>3.155. pgp_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1574
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-auto-decode"></a>3.153. pgp_auto_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1575
Default: no</p></div><p>
1576
If <span class="emphasis"><em>set</em></span>, mutt will automatically attempt to decrypt traditional PGP
1577
messages whenever the user performs an operation which ordinarily would
1578
result in the contents of the message being operated on. For example,
1579
if the user displays a pgp-traditional message which has not been manually
1580
checked with the <code class="literal"><a class="link" href="gettingstarted.html#check-traditional-pgp"><check-traditional-pgp></a></code> function, mutt will automatically
1581
check the message for traditional pgp.
1582
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-autoinline"></a>3.154. pgp_autoinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1583
Default: no</p></div><p>
1584
This option controls whether Mutt generates old-style inline
1585
(traditional) PGP encrypted or signed messages under certain
1586
circumstances. This can be overridden by use of the pgp menu,
1587
when inline is not required.
1589
Note that Mutt might automatically use PGP/MIME for messages
1590
which consist of more than a single MIME part. Mutt can be
1591
configured to ask before sending PGP/MIME messages when inline
1592
(traditional) would not work.
1594
Also see the <a class="link" href="reference.html#pgp-mime-auto" title="3.170. pgp_mime_auto">$pgp_mime_auto</a> variable.
1596
Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>
1597
<span class="bold"><strong>deprecated</strong></span>.
1599
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-check-exit"></a>3.155. pgp_check_exit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1600
Default: yes</p></div><p>
1601
If <span class="emphasis"><em>set</em></span>, mutt will check the exit code of the PGP subprocess when
1602
signing or encrypting. A non-zero exit code means that the
1605
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-clearsign-command"></a>3.156. pgp_clearsign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1606
Default: (empty)</p></div><p>
1607
This format is used to create an old-style “<span class="quote">clearsigned</span>” PGP
1608
message. Note that the use of this format is <span class="bold"><strong>strongly</strong></span>
1609
<span class="bold"><strong>deprecated</strong></span>.
1611
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
1612
possible <code class="literal">printf(3)</code>-like sequences.
1614
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decode-command"></a>3.157. pgp_decode_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1615
Default: (empty)</p></div><p>
1616
This format strings specifies a command which is used to decode
1617
application/pgp attachments.
1619
The PGP command formats have their own set of <code class="literal">printf(3)</code>-like sequences:
1621
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%p </td><td>Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
1622
string otherwise. Note: This may be used with a %? construct.
1623
</td></tr><tr><td>%f </td><td>Expands to the name of a file containing a message.
1624
</td></tr><tr><td>%s </td><td>Expands to the name of a file containing the signature part
1625
of a <code class="literal">multipart/signed</code> attachment when verifying it.
1626
</td></tr><tr><td>%a </td><td>The value of <a class="link" href="reference.html#pgp-sign-as" title="3.174. pgp_sign_as">$pgp_sign_as</a>.
1627
</td></tr><tr><td>%r </td><td>One or more key IDs.
1628
</td></tr></tbody></table></div><p>
1629
For examples on how to configure these formats for the various versions
1630
of PGP which are floating around, see the pgp and gpg sample configuration files in
1631
the <code class="literal">samples/</code> subdirectory which has been installed on your system
1632
alongside the documentation.
1634
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decrypt-command"></a>3.158. pgp_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1635
Default: (empty)</p></div><p>
1636
This command is used to decrypt a PGP encrypted message.
1638
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
1639
possible <code class="literal">printf(3)</code>-like sequences.
1641
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-only-command"></a>3.159. pgp_encrypt_only_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1642
Default: (empty)</p></div><p>
1643
This command is used to encrypt a body part without signing it.
1645
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
1646
possible <code class="literal">printf(3)</code>-like sequences.
1648
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-sign-command"></a>3.160. pgp_encrypt_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1649
Default: (empty)</p></div><p>
1650
This command is used to both sign and encrypt a body part.
1652
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
1653
possible <code class="literal">printf(3)</code>-like sequences.
1655
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-entry-format"></a>3.161. pgp_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1544
1656
Default: “<span class="quote"><code class="literal">%4n %t%f %4l/0x%k %-4a %2c %u</code></span>”</p></div><p>
1545
1657
This variable allows you to customize the PGP key selection menu to
1546
your personal taste. This string is similar to <a class="link" href="reference.html#index-format" title="3.101. index_format">$index_format</a>, but
1658
your personal taste. This string is similar to <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a>, but
1547
1659
has its own set of <code class="literal">printf(3)</code>-like sequences:
1549
</p><div class="variablelist"><dl><dt><span class="term">%n </span></dt><dd><p>number
1550
</p></dd><dt><span class="term">%k </span></dt><dd><p>key id
1551
</p></dd><dt><span class="term">%u </span></dt><dd><p>user id
1552
</p></dd><dt><span class="term">%a </span></dt><dd><p>algorithm
1553
</p></dd><dt><span class="term">%l </span></dt><dd><p>key length
1554
</p></dd><dt><span class="term">%f </span></dt><dd><p>flags
1555
</p></dd><dt><span class="term">%c </span></dt><dd><p>capabilities
1556
</p></dd><dt><span class="term">%t </span></dt><dd><p>trust/validity of the key-uid association
1557
</p></dd><dt><span class="term">%[<s>] </span></dt><dd><p>date of the key where <s> is an <code class="literal">strftime(3)</code> expression
1558
</p></dd></dl></div><p>
1560
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-good-sign"></a>3.156. pgp_good_sign</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
1661
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%n </td><td>number
1662
</td></tr><tr><td>%k </td><td>key id
1663
</td></tr><tr><td>%u </td><td>user id
1664
</td></tr><tr><td>%a </td><td>algorithm
1665
</td></tr><tr><td>%l </td><td>key length
1666
</td></tr><tr><td>%f </td><td>flags
1667
</td></tr><tr><td>%c </td><td>capabilities
1668
</td></tr><tr><td>%t </td><td>trust/validity of the key-uid association
1669
</td></tr><tr><td>%[<s>] </td><td>date of the key where <s> is an <code class="literal">strftime(3)</code> expression
1670
</td></tr></tbody></table></div><p>
1672
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-export-command"></a>3.162. pgp_export_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1673
Default: (empty)</p></div><p>
1674
This command is used to export a public key from the user's
1677
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
1678
possible <code class="literal">printf(3)</code>-like sequences.
1680
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-getkeys-command"></a>3.163. pgp_getkeys_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1681
Default: (empty)</p></div><p>
1682
This command is invoked whenever mutt will need public key information.
1683
Of the sequences supported by <a class="link" href="reference.html#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a>, %r is the only
1684
<code class="literal">printf(3)</code>-like sequence used with this format.
1686
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-good-sign"></a>3.164. pgp_good_sign</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
1561
1687
Default: (empty)</p></div><p>
1562
1688
If you assign a text to this variable, then a PGP signature is only
1563
considered verified if the output from <a class="link" href="reference.html#pgp-verify-command" title="3.171. pgp_verify_command">$pgp_verify_command</a> contains
1689
considered verified if the output from <a class="link" href="reference.html#pgp-verify-command" title="3.180. pgp_verify_command">$pgp_verify_command</a> contains
1564
1690
the text. Use this variable if the exit code from the command is 0
1565
1691
even for bad signatures.
1567
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-check-exit"></a>3.157. pgp_check_exit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1693
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-ignore-subkeys"></a>3.165. pgp_ignore_subkeys</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1568
1694
Default: yes</p></div><p>
1569
If <span class="emphasis"><em>set</em></span>, mutt will check the exit code of the PGP subprocess when
1570
signing or encrypting. A non-zero exit code means that the
1573
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-long-ids"></a>3.158. pgp_long_ids</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1695
Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead,
1696
the principal key will inherit the subkeys' capabilities. <span class="emphasis"><em>Unset</em></span> this
1697
if you want to play interesting key selection games.
1699
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-import-command"></a>3.166. pgp_import_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1700
Default: (empty)</p></div><p>
1701
This command is used to import a key from a message into
1702
the user's public key ring.
1704
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
1705
possible <code class="literal">printf(3)</code>-like sequences.
1707
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-pubring-command"></a>3.167. pgp_list_pubring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1708
Default: (empty)</p></div><p>
1709
This command is used to list the public key ring's contents. The
1710
output format must be analogous to the one used by
1712
</p><pre class="screen">
1713
gpg --list-keys --with-colons.
1715
This format is also generated by the <code class="literal">pgpring</code> utility which comes
1718
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
1719
possible <code class="literal">printf(3)</code>-like sequences.
1721
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-secring-command"></a>3.168. pgp_list_secring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1722
Default: (empty)</p></div><p>
1723
This command is used to list the secret key ring's contents. The
1724
output format must be analogous to the one used by:
1726
</p><pre class="screen">
1727
gpg --list-keys --with-colons.
1729
This format is also generated by the <code class="literal">pgpring</code> utility which comes
1732
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
1733
possible <code class="literal">printf(3)</code>-like sequences.
1735
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-long-ids"></a>3.169. pgp_long_ids</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1574
1736
Default: no</p></div><p>
1575
1737
If <span class="emphasis"><em>set</em></span>, use 64 bit PGP key IDs, if <span class="emphasis"><em>unset</em></span> use the normal 32 bit key IDs.
1577
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-retainable-sigs"></a>3.159. pgp_retainable_sigs</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1578
Default: no</p></div><p>
1579
If <span class="emphasis"><em>set</em></span>, signed and encrypted messages will consist of nested
1580
<code class="literal">multipart/signed</code> and <code class="literal">multipart/encrypted</code> body parts.
1582
This is useful for applications like encrypted and signed mailing
1583
lists, where the outer layer (<code class="literal">multipart/encrypted</code>) can be easily
1584
removed, while the inner <code class="literal">multipart/signed</code> part is retained.
1586
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-autoinline"></a>3.160. pgp_autoinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1587
Default: no</p></div><p>
1588
This option controls whether Mutt generates old-style inline
1589
(traditional) PGP encrypted or signed messages under certain
1590
circumstances. This can be overridden by use of the pgp menu,
1591
when inline is not required.
1593
Note that Mutt might automatically use PGP/MIME for messages
1594
which consist of more than a single MIME part. Mutt can be
1595
configured to ask before sending PGP/MIME messages when inline
1596
(traditional) would not work.
1598
Also see the <a class="link" href="reference.html#pgp-mime-auto" title="3.167. pgp_mime_auto">$pgp_mime_auto</a> variable.
1739
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-mime-auto"></a>3.170. pgp_mime_auto</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1740
Default: ask-yes</p></div><p>
1741
This option controls whether Mutt will prompt you for
1742
automatically sending a (signed/encrypted) message using
1743
PGP/MIME when inline (traditional) fails (for any reason).
1600
1745
Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>
1601
1746
<span class="bold"><strong>deprecated</strong></span>.
1603
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-replyinline"></a>3.161. pgp_replyinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1748
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-replyinline"></a>3.171. pgp_replyinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1604
1749
Default: no</p></div><p>
1605
1750
Setting this variable will cause Mutt to always attempt to
1606
1751
create an inline (traditional) message when replying to a
1615
1760
configured to ask before sending PGP/MIME messages when inline
1616
1761
(traditional) would not work.
1618
Also see the <a class="link" href="reference.html#pgp-mime-auto" title="3.167. pgp_mime_auto">$pgp_mime_auto</a> variable.
1763
Also see the <a class="link" href="reference.html#pgp-mime-auto" title="3.170. pgp_mime_auto">$pgp_mime_auto</a> variable.
1620
1765
Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>
1621
1766
<span class="bold"><strong>deprecated</strong></span>.
1623
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-show-unusable"></a>3.162. pgp_show_unusable</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1768
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-retainable-sigs"></a>3.172. pgp_retainable_sigs</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1769
Default: no</p></div><p>
1770
If <span class="emphasis"><em>set</em></span>, signed and encrypted messages will consist of nested
1771
<code class="literal">multipart/signed</code> and <code class="literal">multipart/encrypted</code> body parts.
1773
This is useful for applications like encrypted and signed mailing
1774
lists, where the outer layer (<code class="literal">multipart/encrypted</code>) can be easily
1775
removed, while the inner <code class="literal">multipart/signed</code> part is retained.
1777
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-show-unusable"></a>3.173. pgp_show_unusable</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1624
1778
Default: yes</p></div><p>
1625
1779
If <span class="emphasis"><em>set</em></span>, mutt will display non-usable keys on the PGP key selection
1626
1780
menu. This includes keys which have been revoked, have expired, or
1627
1781
have been marked as “<span class="quote">disabled</span>” by the user.
1629
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-as"></a>3.163. pgp_sign_as</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1783
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-as"></a>3.174. pgp_sign_as</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1630
1784
Default: (empty)</p></div><p>
1631
1785
If you have more than one key pair, this option allows you to specify
1632
1786
which of your private keys to use. It is recommended that you use the
1633
1787
keyid form to specify your key (e.g. <code class="literal">0x00112233</code>).
1635
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-strict-enc"></a>3.164. pgp_strict_enc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1789
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-command"></a>3.175. pgp_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1790
Default: (empty)</p></div><p>
1791
This command is used to create the detached PGP signature for a
1792
<code class="literal">multipart/signed</code> PGP/MIME body part.
1794
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
1795
possible <code class="literal">printf(3)</code>-like sequences.
1797
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sort-keys"></a>3.176. pgp_sort_keys</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
1798
Default: address</p></div><p>
1799
Specifies how the entries in the pgp menu are sorted. The
1800
following are legal values:
1802
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>address </td><td>sort alphabetically by user id
1803
</td></tr><tr><td>keyid </td><td>sort alphabetically by key id
1804
</td></tr><tr><td>date </td><td>sort by key creation date
1805
</td></tr><tr><td>trust </td><td>sort by the trust of the key
1806
</td></tr></tbody></table></div><p>
1807
If you prefer reverse order of the above values, prefix it with
1808
“<span class="quote">reverse-</span>”.
1810
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-strict-enc"></a>3.177. pgp_strict_enc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1636
1811
Default: yes</p></div><p>
1637
1812
If <span class="emphasis"><em>set</em></span>, Mutt will automatically encode PGP/MIME signed messages as
1638
1813
quoted-printable. Please note that unsetting this variable may
1639
1814
lead to problems with non-verifyable PGP signatures, so only change
1640
1815
this if you know what you are doing.
1642
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-timeout"></a>3.165. pgp_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1817
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-timeout"></a>3.178. pgp_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1643
1818
Default: 300</p></div><p>
1644
1819
The number of seconds after which a cached passphrase will expire if
1647
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sort-keys"></a>3.166. pgp_sort_keys</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
1648
Default: address</p></div><p>
1649
Specifies how the entries in the pgp menu are sorted. The
1650
following are legal values:
1652
</p><div class="variablelist"><dl><dt><span class="term">address </span></dt><dd><p>sort alphabetically by user id
1653
</p></dd><dt><span class="term">keyid </span></dt><dd><p>sort alphabetically by key id
1654
</p></dd><dt><span class="term">date </span></dt><dd><p>sort by key creation date
1655
</p></dd><dt><span class="term">trust </span></dt><dd><p>sort by the trust of the key
1656
</p></dd></dl></div><p>
1657
If you prefer reverse order of the above values, prefix it with
1658
“<span class="quote">reverse-</span>”.
1660
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-mime-auto"></a>3.167. pgp_mime_auto</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1661
Default: ask-yes</p></div><p>
1662
This option controls whether Mutt will prompt you for
1663
automatically sending a (signed/encrypted) message using
1664
PGP/MIME when inline (traditional) fails (for any reason).
1666
Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>
1667
<span class="bold"><strong>deprecated</strong></span>.
1669
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-auto-decode"></a>3.168. pgp_auto_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1822
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-use-gpg-agent"></a>3.179. pgp_use_gpg_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1670
1823
Default: no</p></div><p>
1671
If <span class="emphasis"><em>set</em></span>, mutt will automatically attempt to decrypt traditional PGP
1672
messages whenever the user performs an operation which ordinarily would
1673
result in the contents of the message being operated on. For example,
1674
if the user displays a pgp-traditional message which has not been manually
1675
checked with the <code class="literal"><a class="link" href="gettingstarted.html#check-traditional-pgp"><check-traditional-pgp></a></code> function, mutt will automatically
1676
check the message for traditional pgp.
1677
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decode-command"></a>3.169. pgp_decode_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1678
Default: (empty)</p></div><p>
1679
This format strings specifies a command which is used to decode
1680
application/pgp attachments.
1682
The PGP command formats have their own set of <code class="literal">printf(3)</code>-like sequences:
1684
</p><div class="variablelist"><dl><dt><span class="term">%p </span></dt><dd><p>Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
1685
string otherwise. Note: This may be used with a %? construct.
1686
</p></dd><dt><span class="term">%f </span></dt><dd><p>Expands to the name of a file containing a message.
1687
</p></dd><dt><span class="term">%s </span></dt><dd><p>Expands to the name of a file containing the signature part
1688
of a <code class="literal">multipart/signed</code> attachment when verifying it.
1689
</p></dd><dt><span class="term">%a </span></dt><dd><p>The value of <a class="link" href="reference.html#pgp-sign-as" title="3.163. pgp_sign_as">$pgp_sign_as</a>.
1690
</p></dd><dt><span class="term">%r </span></dt><dd><p>One or more key IDs.
1691
</p></dd></dl></div><p>
1692
For examples on how to configure these formats for the various versions
1693
of PGP which are floating around, see the pgp and gpg sample configuration files in
1694
the <code class="literal">samples/</code> subdirectory which has been installed on your system
1695
alongside the documentation.
1697
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-getkeys-command"></a>3.170. pgp_getkeys_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1698
Default: (empty)</p></div><p>
1699
This command is invoked whenever mutt will need public key information.
1700
Of the sequences supported by <a class="link" href="reference.html#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a>, %r is the only
1701
<code class="literal">printf(3)</code>-like sequence used with this format.
1703
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-command"></a>3.171. pgp_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1824
If <span class="emphasis"><em>set</em></span>, mutt will use a possibly-running <code class="literal">gpg-agent(1)</code> process.
1826
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-command"></a>3.180. pgp_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1704
1827
Default: (empty)</p></div><p>
1705
1828
This command is used to verify PGP signatures.
1707
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
1708
possible <code class="literal">printf(3)</code>-like sequences.
1710
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decrypt-command"></a>3.172. pgp_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1711
Default: (empty)</p></div><p>
1712
This command is used to decrypt a PGP encrypted message.
1714
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
1715
possible <code class="literal">printf(3)</code>-like sequences.
1717
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-clearsign-command"></a>3.173. pgp_clearsign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1718
Default: (empty)</p></div><p>
1719
This format is used to create a old-style “<span class="quote">clearsigned</span>” PGP
1720
message. Note that the use of this format is <span class="bold"><strong>strongly</strong></span>
1721
<span class="bold"><strong>deprecated</strong></span>.
1723
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
1724
possible <code class="literal">printf(3)</code>-like sequences.
1726
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-command"></a>3.174. pgp_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1727
Default: (empty)</p></div><p>
1728
This command is used to create the detached PGP signature for a
1729
<code class="literal">multipart/signed</code> PGP/MIME body part.
1731
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
1732
possible <code class="literal">printf(3)</code>-like sequences.
1734
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-sign-command"></a>3.175. pgp_encrypt_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1735
Default: (empty)</p></div><p>
1736
This command is used to both sign and encrypt a body part.
1738
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
1739
possible <code class="literal">printf(3)</code>-like sequences.
1741
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-only-command"></a>3.176. pgp_encrypt_only_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1742
Default: (empty)</p></div><p>
1743
This command is used to encrypt a body part without signing it.
1745
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
1746
possible <code class="literal">printf(3)</code>-like sequences.
1748
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-import-command"></a>3.177. pgp_import_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1749
Default: (empty)</p></div><p>
1750
This command is used to import a key from a message into
1751
the user's public key ring.
1753
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
1754
possible <code class="literal">printf(3)</code>-like sequences.
1756
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-export-command"></a>3.178. pgp_export_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1757
Default: (empty)</p></div><p>
1758
This command is used to export a public key from the user's
1761
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
1762
possible <code class="literal">printf(3)</code>-like sequences.
1764
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-key-command"></a>3.179. pgp_verify_key_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1830
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
1831
possible <code class="literal">printf(3)</code>-like sequences.
1833
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-key-command"></a>3.181. pgp_verify_key_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1765
1834
Default: (empty)</p></div><p>
1766
1835
This command is used to verify key information from the key selection
1769
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
1770
possible <code class="literal">printf(3)</code>-like sequences.
1772
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-secring-command"></a>3.180. pgp_list_secring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1773
Default: (empty)</p></div><p>
1774
This command is used to list the secret key ring's contents. The
1775
output format must be analogous to the one used by:
1777
</p><pre class="screen">
1778
gpg --list-keys --with-colons.
1781
This format is also generated by the <code class="literal">pgpring</code> utility which comes
1784
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
1785
possible <code class="literal">printf(3)</code>-like sequences.
1787
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-pubring-command"></a>3.181. pgp_list_pubring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1788
Default: (empty)</p></div><p>
1789
This command is used to list the public key ring's contents. The
1790
output format must be analogous to the one used by
1792
</p><pre class="screen">
1793
gpg --list-keys --with-colons.
1796
This format is also generated by the <code class="literal">pgpring</code> utility which comes
1799
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
1800
possible <code class="literal">printf(3)</code>-like sequences.
1802
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="forward-decrypt"></a>3.182. forward_decrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1803
Default: yes</p></div><p>
1804
Controls the handling of encrypted messages when forwarding a message.
1805
When <span class="emphasis"><em>set</em></span>, the outer layer of encryption is stripped off. This
1806
variable is only used if <a class="link" href="reference.html#mime-forward" title="3.127. mime_forward">$mime_forward</a> is <span class="emphasis"><em>set</em></span> and
1807
<a class="link" href="reference.html#mime-forward-decode" title="3.128. mime_forward_decode">$mime_forward_decode</a> is <span class="emphasis"><em>unset</em></span>.
1809
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-timeout"></a>3.183. smime_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1810
Default: 300</p></div><p>
1811
The number of seconds after which a cached passphrase will expire if
1814
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-with"></a>3.184. smime_encrypt_with</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1815
Default: (empty)</p></div><p>
1816
This sets the algorithm that should be used for encryption.
1817
Valid choices are “<span class="quote">des</span>”, “<span class="quote">des3</span>”, “<span class="quote">rc2-40</span>”, “<span class="quote">rc2-64</span>”, “<span class="quote">rc2-128</span>”.
1818
If <span class="emphasis"><em>unset</em></span>, “<span class="quote">3des</span>” (TripleDES) is used.
1820
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-keys"></a>3.185. smime_keys</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1821
Default: (empty)</p></div><p>
1822
Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
1823
storage and retrieval of keys/certs by itself. This is very basic right now,
1824
and stores keys and certificates in two different directories, both
1825
named as the hash-value retrieved from OpenSSL. There is an index file
1826
which contains mailbox-address keyid pair, and which can be manually
1827
edited. This option points to the location of the private keys.
1829
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ca-location"></a>3.186. smime_ca_location</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1830
Default: (empty)</p></div><p>
1831
This variable contains the name of either a directory, or a file which
1832
contains trusted certificates for use with OpenSSL.
1834
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-certificates"></a>3.187. smime_certificates</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1835
Default: (empty)</p></div><p>
1836
Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
1837
storage and retrieval of keys by itself. This is very basic right
1838
now, and keys and certificates are stored in two different
1839
directories, both named as the hash-value retrieved from
1840
OpenSSL. There is an index file which contains mailbox-address
1841
keyid pairs, and which can be manually edited. This option points to
1842
the location of the certificates.
1844
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-command"></a>3.188. smime_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1845
Default: (empty)</p></div><p>
1846
This format string specifies a command which is used to decrypt
1847
<code class="literal">application/x-pkcs7-mime</code> attachments.
1849
The OpenSSL command formats have their own set of <code class="literal">printf(3)</code>-like sequences
1852
</p><div class="variablelist"><dl><dt><span class="term">%f </span></dt><dd><p>Expands to the name of a file containing a message.
1853
</p></dd><dt><span class="term">%s </span></dt><dd><p>Expands to the name of a file containing the signature part
1854
of a <code class="literal">multipart/signed</code> attachment when verifying it.
1855
</p></dd><dt><span class="term">%k </span></dt><dd><p>The key-pair specified with <a class="link" href="reference.html#smime-default-key" title="3.199. smime_default_key">$smime_default_key</a>
1856
</p></dd><dt><span class="term">%c </span></dt><dd><p>One or more certificate IDs.
1857
</p></dd><dt><span class="term">%a </span></dt><dd><p>The algorithm used for encryption.
1858
</p></dd><dt><span class="term">%C </span></dt><dd><p>CA location: Depending on whether <a class="link" href="reference.html#smime-ca-location" title="3.186. smime_ca_location">$smime_ca_location</a>
1859
points to a directory or file, this expands to
1860
“<span class="quote">-CApath <a class="link" href="reference.html#smime-ca-location" title="3.186. smime_ca_location">$smime_ca_location</a></span>” or “<span class="quote">-CAfile <a class="link" href="reference.html#smime-ca-location" title="3.186. smime_ca_location">$smime_ca_location</a></span>”.
1861
</p></dd></dl></div><p>
1862
For examples on how to configure these formats, see the <code class="literal">smime.rc</code> in
1863
the <code class="literal">samples/</code> subdirectory which has been installed on your system
1864
alongside the documentation.
1866
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-command"></a>3.189. smime_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1867
Default: (empty)</p></div><p>
1868
This command is used to verify S/MIME signatures of type <code class="literal">multipart/signed</code>.
1870
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
1871
possible <code class="literal">printf(3)</code>-like sequences.
1873
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-opaque-command"></a>3.190. smime_verify_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1874
Default: (empty)</p></div><p>
1875
This command is used to verify S/MIME signatures of type
1876
<code class="literal">application/x-pkcs7-mime</code>.
1878
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
1879
possible <code class="literal">printf(3)</code>-like sequences.
1881
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-command"></a>3.191. smime_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1882
Default: (empty)</p></div><p>
1883
This command is used to created S/MIME signatures of type
1884
<code class="literal">multipart/signed</code>, which can be read by all mail clients.
1886
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
1887
possible <code class="literal">printf(3)</code>-like sequences.
1889
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-opaque-command"></a>3.192. smime_sign_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1890
Default: (empty)</p></div><p>
1891
This command is used to created S/MIME signatures of type
1892
<code class="literal">application/x-pkcs7-signature</code>, which can only be handled by mail
1893
clients supporting the S/MIME extension.
1895
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
1896
possible <code class="literal">printf(3)</code>-like sequences.
1898
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-command"></a>3.193. smime_encrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1899
Default: (empty)</p></div><p>
1900
This command is used to create encrypted S/MIME messages.
1902
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
1903
possible <code class="literal">printf(3)</code>-like sequences.
1905
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-pk7out-command"></a>3.194. smime_pk7out_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1906
Default: (empty)</p></div><p>
1907
This command is used to extract PKCS7 structures of S/MIME signatures,
1908
in order to extract the public X509 certificate(s).
1910
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
1911
possible <code class="literal">printf(3)</code>-like sequences.
1913
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-command"></a>3.195. smime_get_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1914
Default: (empty)</p></div><p>
1915
This command is used to extract X509 certificates from a PKCS7 structure.
1917
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
1918
possible <code class="literal">printf(3)</code>-like sequences.
1920
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-signer-cert-command"></a>3.196. smime_get_signer_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1921
Default: (empty)</p></div><p>
1922
This command is used to extract only the signers X509 certificate from a S/MIME
1923
signature, so that the certificate's owner may get compared to the
1924
email's “<span class="quote">From:</span>” field.
1926
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
1927
possible <code class="literal">printf(3)</code>-like sequences.
1929
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-import-cert-command"></a>3.197. smime_import_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1930
Default: (empty)</p></div><p>
1931
This command is used to import a certificate via smime_keys.
1933
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
1934
possible <code class="literal">printf(3)</code>-like sequences.
1936
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-email-command"></a>3.198. smime_get_cert_email_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1937
Default: (empty)</p></div><p>
1938
This command is used to extract the mail address(es) used for storing
1939
X509 certificates, and for verification purposes (to check whether the
1940
certificate was issued for the sender's mailbox).
1942
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
1943
possible <code class="literal">printf(3)</code>-like sequences.
1945
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-default-key"></a>3.199. smime_default_key</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1946
Default: (empty)</p></div><p>
1947
This is the default key-pair to use for signing. This must be set to the
1948
keyid (the hash-value that OpenSSL generates) to work properly
1950
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-client-cert"></a>3.200. ssl_client_cert</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1951
Default: (empty)</p></div><p>
1952
The file containing a client certificate and its associated private
1954
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-force-tls"></a>3.201. ssl_force_tls</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1955
Default: no</p></div><p>
1956
If this variable is <span class="emphasis"><em>set</em></span>, Mutt will require that all connections
1957
to remote servers be encrypted. Furthermore it will attempt to
1958
negotiate TLS even if the server does not advertise the capability,
1959
since it would otherwise have to abort the connection anyway. This
1960
option supersedes <a class="link" href="reference.html#ssl-starttls" title="3.202. ssl_starttls">$ssl_starttls</a>.
1961
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-starttls"></a>3.202. ssl_starttls</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1962
Default: yes</p></div><p>
1963
If <span class="emphasis"><em>set</em></span> (the default), mutt will attempt to use <code class="literal">STARTTLS</code> on servers
1964
advertising the capability. When <span class="emphasis"><em>unset</em></span>, mutt will not attempt to
1965
use <code class="literal">STARTTLS</code> regardless of the server's capabilities.
1966
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="certificate-file"></a>3.203. certificate_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1967
Default: “<span class="quote"><code class="literal">˜/.mutt_certificates</code></span>”</p></div><p>
1968
This variable specifies the file where the certificates you trust
1969
are saved. When an unknown certificate is encountered, you are asked
1970
if you accept it or not. If you accept it, the certificate can also
1971
be saved in this file and further connections are automatically
1974
You can also manually add CA certificates in this file. Any server
1975
certificate that is signed with one of these CA certificates is
1976
also automatically accepted.
1980
</p><pre class="screen">
1981
set certificate_file=~/.mutt/certificates
1983
</pre></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-usesystemcerts"></a>3.204. ssl_usesystemcerts</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1984
Default: yes</p></div><p>
1985
If set to <span class="emphasis"><em>yes</em></span>, mutt will use CA certificates in the
1986
system-wide certificate store when checking if a server certificate
1987
is signed by a trusted CA.
1988
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="entropy-file"></a>3.205. entropy_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1989
Default: (empty)</p></div><p>
1990
The file which includes random data that is used to initialize SSL
1992
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv2"></a>3.206. ssl_use_sslv2</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1993
Default: yes</p></div><p>
1994
This variables specifies whether to attempt to use SSLv2 in the
1995
SSL authentication process.
1996
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv3"></a>3.207. ssl_use_sslv3</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1997
Default: yes</p></div><p>
1998
This variables specifies whether to attempt to use SSLv3 in the
1999
SSL authentication process.
2000
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-tlsv1"></a>3.208. ssl_use_tlsv1</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2001
Default: yes</p></div><p>
2002
This variables specifies whether to attempt to use TLSv1 in the
2003
SSL authentication process.
2004
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-min-dh-prime-bits"></a>3.209. ssl_min_dh_prime_bits</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2005
Default: 0</p></div><p>
2006
This variable specifies the minimum acceptable prime size (in bits)
2007
for use in any Diffie-Hellman key exchange. A value of 0 will use
2008
the default from the GNUTLS library.
2009
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-ca-certificates-file"></a>3.210. ssl_ca_certificates_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2010
Default: (empty)</p></div><p>
2011
This variable specifies a file containing trusted CA certificates.
2012
Any server certificate that is signed with one of these CA
2013
certificates is also automatically accepted.
2017
</p><pre class="screen">
2018
set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
2020
</pre></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-split"></a>3.211. pipe_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2021
Default: no</p></div><p>
2022
Used in connection with the <code class="literal"><pipe-message></code> function following
2023
<code class="literal"><tag-prefix></code>. If this variable is <span class="emphasis"><em>unset</em></span>, when piping a list of
2024
tagged messages Mutt will concatenate the messages and will pipe them
2025
all concatenated. When <span class="emphasis"><em>set</em></span>, Mutt will pipe the messages one by one.
2026
In both cases the messages are piped in the current sorted order,
2027
and the <a class="link" href="reference.html#pipe-sep" title="3.213. pipe_sep">$pipe_sep</a> separator is added after each message.
2028
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-decode"></a>3.212. pipe_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1838
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
1839
possible <code class="literal">printf(3)</code>-like sequences.
1841
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-decode"></a>3.182. pipe_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2029
1842
Default: no</p></div><p>
2030
1843
Used in connection with the <code class="literal"><pipe-message></code> command. When <span class="emphasis"><em>unset</em></span>,
2031
1844
Mutt will pipe the messages without any preprocessing. When <span class="emphasis"><em>set</em></span>, Mutt
2032
1845
will weed headers and will attempt to decode the messages
2034
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-sep"></a>3.213. pipe_sep</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1847
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-sep"></a>3.183. pipe_sep</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2035
1848
Default: “<span class="quote"><code class="literal">\n</code></span>”</p></div><p>
2036
1849
The separator to add between messages when piping a list of tagged
2037
1850
messages to an external Unix command.
2038
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-authenticators"></a>3.214. pop_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1851
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-split"></a>3.184. pipe_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1852
Default: no</p></div><p>
1853
Used in connection with the <code class="literal"><pipe-message></code> function following
1854
<code class="literal"><tag-prefix></code>. If this variable is <span class="emphasis"><em>unset</em></span>, when piping a list of
1855
tagged messages Mutt will concatenate the messages and will pipe them
1856
all concatenated. When <span class="emphasis"><em>set</em></span>, Mutt will pipe the messages one by one.
1857
In both cases the messages are piped in the current sorted order,
1858
and the <a class="link" href="reference.html#pipe-sep" title="3.183. pipe_sep">$pipe_sep</a> separator is added after each message.
1859
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-auth-try-all"></a>3.185. pop_auth_try_all</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1860
Default: yes</p></div><p>
1861
If <span class="emphasis"><em>set</em></span>, Mutt will try all available authentication methods.
1862
When <span class="emphasis"><em>unset</em></span>, Mutt will only fall back to other authentication
1863
methods if the previous methods are unavailable. If a method is
1864
available but authentication fails, Mutt will not connect to the POP server.
1865
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-authenticators"></a>3.186. pop_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2039
1866
Default: (empty)</p></div><p>
2040
1867
This is a colon-delimited list of authentication methods mutt may
2041
1868
attempt to use to log in to an POP server, in the order mutt should
2124
1943
</p><pre class="screen">
2125
1944
set preconnect="ssh -f -q -L 1234:mailhost.net:143 mailhost.net \
2126
1945
sleep 20 < /dev/null > /dev/null"
2129
1947
Mailbox “<span class="quote">foo</span>” on “<span class="quote">mailhost.net</span>” can now be reached
2130
1948
as “<span class="quote">{localhost:1234}foo</span>”.
2132
1950
Note: For this example to work, you must be able to log in to the
2133
1951
remote machine without having to enter a password.
2134
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print"></a>3.227. print</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1952
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print"></a>3.198. print</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
2135
1953
Default: ask-no</p></div><p>
2136
1954
Controls whether or not Mutt really prints messages.
2137
1955
This is set to “<span class="quote">ask-no</span>” by default, because some people
2138
1956
accidentally hit “<span class="quote">p</span>” often.
2139
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-command"></a>3.228. print_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1957
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-command"></a>3.199. print_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2140
1958
Default: “<span class="quote"><code class="literal">lpr</code></span>”</p></div><p>
2141
1959
This specifies the command pipe that should be used to print messages.
2142
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-decode"></a>3.229. print_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1960
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-decode"></a>3.200. print_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2143
1961
Default: yes</p></div><p>
2144
1962
Used in connection with the <code class="literal"><print-message></code> command. If this
2145
1963
option is <span class="emphasis"><em>set</em></span>, the message is decoded before it is passed to the
2146
external command specified by <a class="link" href="reference.html#print-command" title="3.228. print_command">$print_command</a>. If this option
1964
external command specified by <a class="link" href="reference.html#print-command" title="3.199. print_command">$print_command</a>. If this option
2147
1965
is <span class="emphasis"><em>unset</em></span>, no processing will be applied to the message when
2148
1966
printing it. The latter setting may be useful if you are using
2149
1967
some advanced printer filter which is able to properly format
2150
1968
e-mail messages for printing.
2151
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-split"></a>3.230. print_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1969
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-split"></a>3.201. print_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2152
1970
Default: no</p></div><p>
2153
1971
Used in connection with the <code class="literal"><print-message></code> command. If this option
2154
is <span class="emphasis"><em>set</em></span>, the command specified by <a class="link" href="reference.html#print-command" title="3.228. print_command">$print_command</a> is executed once for
1972
is <span class="emphasis"><em>set</em></span>, the command specified by <a class="link" href="reference.html#print-command" title="3.199. print_command">$print_command</a> is executed once for
2155
1973
each message which is to be printed. If this option is <span class="emphasis"><em>unset</em></span>,
2156
the command specified by <a class="link" href="reference.html#print-command" title="3.228. print_command">$print_command</a> is executed only once, and
1974
the command specified by <a class="link" href="reference.html#print-command" title="3.199. print_command">$print_command</a> is executed only once, and
2157
1975
all the messages are concatenated, with a form feed as the message
2160
1978
Those who use the <code class="literal">enscript</code>(1) program's mail-printing mode will
2161
1979
most likely want to <span class="emphasis"><em>set</em></span> this option.
2162
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="prompt-after"></a>3.231. prompt_after</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1980
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="prompt-after"></a>3.202. prompt_after</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2163
1981
Default: yes</p></div><p>
2164
If you use an <span class="emphasis"><em>external</em></span> <a class="link" href="reference.html#pager" title="3.138. pager">$pager</a>, setting this variable will
1982
If you use an <span class="emphasis"><em>external</em></span> <a class="link" href="reference.html#pager" title="3.148. pager">$pager</a>, setting this variable will
2165
1983
cause Mutt to prompt you for a command when the pager exits rather
2166
1984
than returning to the index menu. If <span class="emphasis"><em>unset</em></span>, Mutt will return to the
2167
1985
index menu when the external pager exits.
2168
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="query-command"></a>3.232. query_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1986
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="query-command"></a>3.203. query_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2169
1987
Default: (empty)</p></div><p>
2170
1988
This specifies the command that mutt will use to make external address
2171
1989
queries. The string should contain a “<span class="quote">%s</span>”, which will be substituted
2172
1990
with the query string the user types. See “<span class="quote"><a class="link" href="advancedusage.html#query" title="5. External Address Queries">query</a></span>” for more
2174
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="query-format"></a>3.233. query_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1992
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="query-format"></a>3.204. query_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2175
1993
Default: “<span class="quote"><code class="literal">%4c %t %-25.25a %-25.25n %?e?(%e)?</code></span>”</p></div><p>
2176
1994
This variable describes the format of the “<span class="quote">query</span>” menu. The
2177
1995
following <code class="literal">printf(3)</code>-style sequences are understood:
2179
</p><div class="variablelist"><dl><dt><span class="term">%a </span></dt><dd><p>destination address
2180
</p></dd><dt><span class="term">%c </span></dt><dd><p>current entry number
2181
</p></dd><dt><span class="term">%e </span></dt><dd><p>extra information *
2182
</p></dd><dt><span class="term">%n </span></dt><dd><p>destination name
2183
</p></dd><dt><span class="term">%t </span></dt><dd><p>“<span class="quote">*</span>” if current entry is tagged, a space otherwise
2184
</p></dd><dt><span class="term">%>X </span></dt><dd><p>right justify the rest of the string and pad with “<span class="quote">X</span>”
2185
</p></dd><dt><span class="term">%|X </span></dt><dd><p>pad to the end of the line with “<span class="quote">X</span>”
2186
</p></dd><dt><span class="term">%*X </span></dt><dd><p>soft-fill with character “<span class="quote">X</span>” as pad
2187
</p></dd></dl></div><p>
2188
For an explanation of “<span class="quote">soft-fill</span>”, see the <a class="link" href="reference.html#index-format" title="3.101. index_format">$index_format</a> documentation.
1997
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%a </td><td>destination address
1998
</td></tr><tr><td>%c </td><td>current entry number
1999
</td></tr><tr><td>%e </td><td>extra information *
2000
</td></tr><tr><td>%n </td><td>destination name
2001
</td></tr><tr><td>%t </td><td>“<span class="quote">*</span>” if current entry is tagged, a space otherwise
2002
</td></tr><tr><td>%>X </td><td>right justify the rest of the string and pad with “<span class="quote">X</span>”
2003
</td></tr><tr><td>%|X </td><td>pad to the end of the line with “<span class="quote">X</span>”
2004
</td></tr><tr><td>%*X </td><td>soft-fill with character “<span class="quote">X</span>” as pad
2005
</td></tr></tbody></table></div><p>
2006
For an explanation of “<span class="quote">soft-fill</span>”, see the <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a> documentation.
2190
* = can be optionally printed if nonzero, see the <a class="link" href="reference.html#status-format" title="3.279. status_format">$status_format</a> documentation.
2191
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="quit"></a>3.234. quit</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
2008
* = can be optionally printed if nonzero, see the <a class="link" href="reference.html#status-format" title="3.282. status_format">$status_format</a> documentation.
2009
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="quit"></a>3.205. quit</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
2192
2010
Default: yes</p></div><p>
2193
2011
This variable controls whether “<span class="quote">quit</span>” and “<span class="quote">exit</span>” actually quit
2194
2012
from mutt. If this option is <span class="emphasis"><em>set</em></span>, they do quit, if it is <span class="emphasis"><em>unset</em></span>, they
2195
2013
have no effect, and if it is set to <span class="emphasis"><em>ask-yes</em></span> or <span class="emphasis"><em>ask-no</em></span>, you are
2196
2014
prompted for confirmation when you try to quit.
2197
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="quote-regexp"></a>3.235. quote_regexp</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
2015
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="quote-regexp"></a>3.206. quote_regexp</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
2198
2016
Default: “<span class="quote"><code class="literal">^([ \t]*[|>:}#])+</code></span>”</p></div><p>
2199
2017
A regular expression used in the internal pager to determine quoted
2200
2018
sections of text in the body of a message. Quoted text may be filtered
2333
2148
Also note that setting this parameter will <span class="emphasis"><em>not</em></span> have the effect
2334
2149
that mutt <span class="emphasis"><em>generates</em></span> this kind of encoding. Instead, mutt will
2335
2150
unconditionally use the encoding specified in RFC2231.
2336
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-address"></a>3.249. save_address</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2151
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-address"></a>3.220. save_address</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2337
2152
Default: no</p></div><p>
2338
2153
If <span class="emphasis"><em>set</em></span>, mutt will take the sender's full address when choosing a
2339
default folder for saving a mail. If <a class="link" href="reference.html#save-name" title="3.252. save_name">$save_name</a> or <a class="link" href="reference.html#force-name" title="3.61. force_name">$force_name</a>
2154
default folder for saving a mail. If <a class="link" href="reference.html#save-name" title="3.223. save_name">$save_name</a> or <a class="link" href="reference.html#force-name" title="3.69. force_name">$force_name</a>
2340
2155
is <span class="emphasis"><em>set</em></span> too, the selection of the Fcc folder will be changed as well.
2341
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-empty"></a>3.250. save_empty</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2156
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-empty"></a>3.221. save_empty</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2342
2157
Default: yes</p></div><p>
2343
2158
When <span class="emphasis"><em>unset</em></span>, mailboxes which contain no saved messages will be removed
2344
when closed (the exception is <a class="link" href="reference.html#spoolfile" title="3.277. spoolfile">$spoolfile</a> which is never removed).
2159
when closed (the exception is <a class="link" href="reference.html#spoolfile" title="3.269. spoolfile">$spoolfile</a> which is never removed).
2345
2160
If <span class="emphasis"><em>set</em></span>, mailboxes are never removed.
2347
2162
<span class="bold"><strong>Note:</strong></span> This only applies to mbox and MMDF folders, Mutt does not
2348
2163
delete MH and Maildir directories.
2349
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-history"></a>3.251. save_history</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2164
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-history"></a>3.222. save_history</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2350
2165
Default: 0</p></div><p>
2351
2166
This variable controls the size of the history (per category) saved in the
2352
<a class="link" href="reference.html#history-file" title="3.78. history_file">$history_file</a> file.
2353
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-name"></a>3.252. save_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2167
<a class="link" href="reference.html#history-file" title="3.90. history_file">$history_file</a> file.
2168
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-name"></a>3.223. save_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2354
2169
Default: no</p></div><p>
2355
2170
This variable controls how copies of outgoing messages are saved.
2356
2171
When <span class="emphasis"><em>set</em></span>, a check is made to see if a mailbox specified by the
2357
2172
recipient address exists (this is done by searching for a mailbox in
2358
the <a class="link" href="reference.html#folder" title="3.58. folder">$folder</a> directory with the <span class="emphasis"><em>username</em></span> part of the
2173
the <a class="link" href="reference.html#folder" title="3.66. folder">$folder</a> directory with the <span class="emphasis"><em>username</em></span> part of the
2359
2174
recipient address). If the mailbox exists, the outgoing message will
2360
2175
be saved to that mailbox, otherwise the message is saved to the
2361
<a class="link" href="reference.html#record" title="3.240. record">$record</a> mailbox.
2176
<a class="link" href="reference.html#record" title="3.211. record">$record</a> mailbox.
2363
Also see the <a class="link" href="reference.html#force-name" title="3.61. force_name">$force_name</a> variable.
2364
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score"></a>3.253. score</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2178
Also see the <a class="link" href="reference.html#force-name" title="3.69. force_name">$force_name</a> variable.
2179
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score"></a>3.224. score</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2365
2180
Default: yes</p></div><p>
2366
2181
When this variable is <span class="emphasis"><em>unset</em></span>, scoring is turned off. This can
2367
2182
be useful to selectively disable scoring for certain folders when the
2368
<a class="link" href="reference.html#score-threshold-delete" title="3.254. score_threshold_delete">$score_threshold_delete</a> variable and related are used.
2369
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-delete"></a>3.254. score_threshold_delete</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2183
<a class="link" href="reference.html#score-threshold-delete" title="3.225. score_threshold_delete">$score_threshold_delete</a> variable and related are used.
2184
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-delete"></a>3.225. score_threshold_delete</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2370
2185
Default: -1</p></div><p>
2371
2186
Messages which have been assigned a score equal to or lower than the value
2372
2187
of this variable are automatically marked for deletion by mutt. Since
2373
2188
mutt scores are always greater than or equal to zero, the default setting
2374
2189
of this variable will never mark a message for deletion.
2375
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-flag"></a>3.255. score_threshold_flag</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2190
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-flag"></a>3.226. score_threshold_flag</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2376
2191
Default: 9999</p></div><p>
2377
2192
Messages which have been assigned a score greater than or equal to this
2378
2193
variable's value are automatically marked "flagged".
2379
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-read"></a>3.256. score_threshold_read</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2194
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-read"></a>3.227. score_threshold_read</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2380
2195
Default: -1</p></div><p>
2381
2196
Messages which have been assigned a score equal to or lower than the value
2382
2197
of this variable are automatically marked as read by mutt. Since
2383
2198
mutt scores are always greater than or equal to zero, the default setting
2384
2199
of this variable will never mark a message read.
2385
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="send-charset"></a>3.257. send_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2200
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="search-context"></a>3.228. search_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2201
Default: 0</p></div><p>
2202
For the pager, this variable specifies the number of lines shown
2203
before search results. By default, search results will be top-aligned.
2204
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="send-charset"></a>3.229. send_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2386
2205
Default: “<span class="quote"><code class="literal">us-ascii:iso-8859-1:utf-8</code></span>”</p></div><p>
2387
2206
A colon-delimited list of character sets for outgoing messages. Mutt will use the
2388
2207
first character set into which the text can be converted exactly.
2447
2266
will automatically expand it to the value specified by this variable by
2448
2267
replacing “<span class="quote">%s</span>” with the supplied string.
2449
2268
For the default value, “<span class="quote">joe</span>” would be expanded to: “<span class="quote">˜f joe | ˜s joe</span>”.
2450
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smart-wrap"></a>3.265. smart_wrap</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2269
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sleep-time"></a>3.237. sleep_time</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2270
Default: 1</p></div><p>
2271
Specifies time, in seconds, to pause while displaying certain informational
2272
messages, while moving from folder to folder and after expunging
2273
messages from the current folder. The default is to pause one second, so
2274
a value of zero for this option suppresses the pause.
2275
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smart-wrap"></a>3.238. smart_wrap</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2451
2276
Default: yes</p></div><p>
2452
2277
Controls the display of lines longer than the screen width in the
2453
2278
internal pager. If <span class="emphasis"><em>set</em></span>, long lines are wrapped at a word boundary. If
2454
2279
<span class="emphasis"><em>unset</em></span>, lines are simply wrapped at the screen edge. Also see the
2455
<a class="link" href="reference.html#markers" title="3.114. markers">$markers</a> variable.
2456
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smileys"></a>3.266. smileys</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
2280
<a class="link" href="reference.html#markers" title="3.124. markers">$markers</a> variable.
2281
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smileys"></a>3.239. smileys</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
2457
2282
Default: “<span class="quote"><code class="literal">(>From )|(:[-^]?[][)(><}{|/DP])</code></span>”</p></div><p>
2458
2283
The <span class="emphasis"><em>pager</em></span> uses this variable to catch some common false
2459
positives of <a class="link" href="reference.html#quote-regexp" title="3.235. quote_regexp">$quote_regexp</a>, most notably smileys and not consider
2460
a line quoted text if it also matches <a class="link" href="reference.html#smileys" title="3.266. smileys">$smileys</a>. This mostly
2284
positives of <a class="link" href="reference.html#quote-regexp" title="3.206. quote_regexp">$quote_regexp</a>, most notably smileys and not consider
2285
a line quoted text if it also matches <a class="link" href="reference.html#smileys" title="3.239. smileys">$smileys</a>. This mostly
2461
2286
happens at the beginning of a line.
2462
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sleep-time"></a>3.267. sleep_time</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2463
Default: 1</p></div><p>
2464
Specifies time, in seconds, to pause while displaying certain informational
2465
messages, while moving from folder to folder and after expunging
2466
messages from the current folder. The default is to pause one second, so
2467
a value of zero for this option suppresses the pause.
2468
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smtp-authenticators"></a>3.268. smtp_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2287
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ask-cert-label"></a>3.240. smime_ask_cert_label</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2288
Default: yes</p></div><p>
2289
This flag controls whether you want to be asked to enter a label
2290
for a certificate about to be added to the database or not. It is
2291
<span class="emphasis"><em>set</em></span> by default.
2293
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ca-location"></a>3.241. smime_ca_location</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2294
Default: (empty)</p></div><p>
2295
This variable contains the name of either a directory, or a file which
2296
contains trusted certificates for use with OpenSSL.
2298
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-certificates"></a>3.242. smime_certificates</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2299
Default: (empty)</p></div><p>
2300
Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
2301
storage and retrieval of keys by itself. This is very basic right
2302
now, and keys and certificates are stored in two different
2303
directories, both named as the hash-value retrieved from
2304
OpenSSL. There is an index file which contains mailbox-address
2305
keyid pairs, and which can be manually edited. This option points to
2306
the location of the certificates.
2308
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-command"></a>3.243. smime_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2309
Default: (empty)</p></div><p>
2310
This format string specifies a command which is used to decrypt
2311
<code class="literal">application/x-pkcs7-mime</code> attachments.
2313
The OpenSSL command formats have their own set of <code class="literal">printf(3)</code>-like sequences
2316
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%f </td><td>Expands to the name of a file containing a message.
2317
</td></tr><tr><td>%s </td><td>Expands to the name of a file containing the signature part
2318
of a <code class="literal">multipart/signed</code> attachment when verifying it.
2319
</td></tr><tr><td>%k </td><td>The key-pair specified with <a class="link" href="reference.html#smime-default-key" title="3.245. smime_default_key">$smime_default_key</a>
2320
</td></tr><tr><td>%c </td><td>One or more certificate IDs.
2321
</td></tr><tr><td>%a </td><td>The algorithm used for encryption.
2322
</td></tr><tr><td>%C </td><td>CA location: Depending on whether <a class="link" href="reference.html#smime-ca-location" title="3.241. smime_ca_location">$smime_ca_location</a>
2323
points to a directory or file, this expands to
2324
“<span class="quote">-CApath <a class="link" href="reference.html#smime-ca-location" title="3.241. smime_ca_location">$smime_ca_location</a></span>” or “<span class="quote">-CAfile <a class="link" href="reference.html#smime-ca-location" title="3.241. smime_ca_location">$smime_ca_location</a></span>”.
2325
</td></tr></tbody></table></div><p>
2326
For examples on how to configure these formats, see the <code class="literal">smime.rc</code> in
2327
the <code class="literal">samples/</code> subdirectory which has been installed on your system
2328
alongside the documentation.
2330
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-use-default-key"></a>3.244. smime_decrypt_use_default_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2331
Default: yes</p></div><p>
2332
If <span class="emphasis"><em>set</em></span> (default) this tells mutt to use the default key for decryption. Otherwise,
2333
if managing multiple certificate-key-pairs, mutt will try to use the mailbox-address
2334
to determine the key to use. It will ask you to supply a key, if it can't find one.
2336
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-default-key"></a>3.245. smime_default_key</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2337
Default: (empty)</p></div><p>
2338
This is the default key-pair to use for signing. This must be set to the
2339
keyid (the hash-value that OpenSSL generates) to work properly
2341
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-command"></a>3.246. smime_encrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2342
Default: (empty)</p></div><p>
2343
This command is used to create encrypted S/MIME messages.
2345
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
2346
possible <code class="literal">printf(3)</code>-like sequences.
2348
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-with"></a>3.247. smime_encrypt_with</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2349
Default: (empty)</p></div><p>
2350
This sets the algorithm that should be used for encryption.
2351
Valid choices are “<span class="quote">des</span>”, “<span class="quote">des3</span>”, “<span class="quote">rc2-40</span>”, “<span class="quote">rc2-64</span>”, “<span class="quote">rc2-128</span>”.
2352
If <span class="emphasis"><em>unset</em></span>, “<span class="quote">3des</span>” (TripleDES) is used.
2354
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-command"></a>3.248. smime_get_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2355
Default: (empty)</p></div><p>
2356
This command is used to extract X509 certificates from a PKCS7 structure.
2358
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
2359
possible <code class="literal">printf(3)</code>-like sequences.
2361
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-email-command"></a>3.249. smime_get_cert_email_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2362
Default: (empty)</p></div><p>
2363
This command is used to extract the mail address(es) used for storing
2364
X509 certificates, and for verification purposes (to check whether the
2365
certificate was issued for the sender's mailbox).
2367
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
2368
possible <code class="literal">printf(3)</code>-like sequences.
2370
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-signer-cert-command"></a>3.250. smime_get_signer_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2371
Default: (empty)</p></div><p>
2372
This command is used to extract only the signers X509 certificate from a S/MIME
2373
signature, so that the certificate's owner may get compared to the
2374
email's “<span class="quote">From:</span>” field.
2376
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
2377
possible <code class="literal">printf(3)</code>-like sequences.
2379
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-import-cert-command"></a>3.251. smime_import_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2380
Default: (empty)</p></div><p>
2381
This command is used to import a certificate via smime_keys.
2383
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
2384
possible <code class="literal">printf(3)</code>-like sequences.
2386
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-is-default"></a>3.252. smime_is_default</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2387
Default: no</p></div><p>
2388
The default behaviour of mutt is to use PGP on all auto-sign/encryption
2389
operations. To override and to use OpenSSL instead this must be <span class="emphasis"><em>set</em></span>.
2390
However, this has no effect while replying, since mutt will automatically
2391
select the same application that was used to sign/encrypt the original
2392
message. (Note that this variable can be overridden by unsetting <a class="link" href="reference.html#crypt-autosmime" title="3.39. crypt_autosmime">$crypt_autosmime</a>.)
2394
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-keys"></a>3.253. smime_keys</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2395
Default: (empty)</p></div><p>
2396
Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
2397
storage and retrieval of keys/certs by itself. This is very basic right now,
2398
and stores keys and certificates in two different directories, both
2399
named as the hash-value retrieved from OpenSSL. There is an index file
2400
which contains mailbox-address keyid pair, and which can be manually
2401
edited. This option points to the location of the private keys.
2403
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-pk7out-command"></a>3.254. smime_pk7out_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2404
Default: (empty)</p></div><p>
2405
This command is used to extract PKCS7 structures of S/MIME signatures,
2406
in order to extract the public X509 certificate(s).
2408
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
2409
possible <code class="literal">printf(3)</code>-like sequences.
2411
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-command"></a>3.255. smime_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2412
Default: (empty)</p></div><p>
2413
This command is used to created S/MIME signatures of type
2414
<code class="literal">multipart/signed</code>, which can be read by all mail clients.
2416
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
2417
possible <code class="literal">printf(3)</code>-like sequences.
2419
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-opaque-command"></a>3.256. smime_sign_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2420
Default: (empty)</p></div><p>
2421
This command is used to created S/MIME signatures of type
2422
<code class="literal">application/x-pkcs7-signature</code>, which can only be handled by mail
2423
clients supporting the S/MIME extension.
2425
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
2426
possible <code class="literal">printf(3)</code>-like sequences.
2428
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-timeout"></a>3.257. smime_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2429
Default: 300</p></div><p>
2430
The number of seconds after which a cached passphrase will expire if
2433
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-command"></a>3.258. smime_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2434
Default: (empty)</p></div><p>
2435
This command is used to verify S/MIME signatures of type <code class="literal">multipart/signed</code>.
2437
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
2438
possible <code class="literal">printf(3)</code>-like sequences.
2440
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-opaque-command"></a>3.259. smime_verify_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2441
Default: (empty)</p></div><p>
2442
This command is used to verify S/MIME signatures of type
2443
<code class="literal">application/x-pkcs7-mime</code>.
2445
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
2446
possible <code class="literal">printf(3)</code>-like sequences.
2448
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smtp-authenticators"></a>3.260. smtp_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2469
2449
Default: (empty)</p></div><p>
2470
2450
This is a colon-delimited list of authentication methods mutt may
2471
2451
attempt to use to log in to an SMTP server, in the order mutt should
2561
2538
</p></li></ul></div><p>
2562
2539
You may optionally use the “<span class="quote">reverse-</span>” prefix to specify reverse sorting
2563
2540
order (example: “<span class="quote"><code class="literal">set sort_browser=reverse-date</code></span>”).
2564
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sort-re"></a>3.275. sort_re</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2541
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sort-re"></a>3.267. sort_re</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2565
2542
Default: yes</p></div><p>
2566
2543
This variable is only useful when sorting by threads with
2567
<a class="link" href="reference.html#strict-threads" title="3.281. strict_threads">$strict_threads</a> <span class="emphasis"><em>unset</em></span>. In that case, it changes the heuristic
2568
mutt uses to thread messages by subject. With <a class="link" href="reference.html#sort-re" title="3.275. sort_re">$sort_re</a> <span class="emphasis"><em>set</em></span>, mutt will
2544
<a class="link" href="reference.html#strict-threads" title="3.284. strict_threads">$strict_threads</a> <span class="emphasis"><em>unset</em></span>. In that case, it changes the heuristic
2545
mutt uses to thread messages by subject. With <a class="link" href="reference.html#sort-re" title="3.267. sort_re">$sort_re</a> <span class="emphasis"><em>set</em></span>, mutt will
2569
2546
only attach a message as the child of another message by subject if
2570
2547
the subject of the child message starts with a substring matching the
2571
setting of <a class="link" href="reference.html#reply-regexp" title="3.241. reply_regexp">$reply_regexp</a>. With <a class="link" href="reference.html#sort-re" title="3.275. sort_re">$sort_re</a> <span class="emphasis"><em>unset</em></span>, mutt will attach
2548
setting of <a class="link" href="reference.html#reply-regexp" title="3.212. reply_regexp">$reply_regexp</a>. With <a class="link" href="reference.html#sort-re" title="3.267. sort_re">$sort_re</a> <span class="emphasis"><em>unset</em></span>, mutt will attach
2572
2549
the message whether or not this is the case, as long as the
2573
non-<a class="link" href="reference.html#reply-regexp" title="3.241. reply_regexp">$reply_regexp</a> parts of both messages are identical.
2574
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="spam-separator"></a>3.276. spam_separator</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2550
non-<a class="link" href="reference.html#reply-regexp" title="3.212. reply_regexp">$reply_regexp</a> parts of both messages are identical.
2551
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="spam-separator"></a>3.268. spam_separator</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2575
2552
Default: “<span class="quote"><code class="literal">,</code></span>”</p></div><p>
2576
2553
This variable controls what happens when multiple spam headers
2577
2554
are matched: if <span class="emphasis"><em>unset</em></span>, each successive header will overwrite any
2578
2555
previous matches value for the spam label. If <span class="emphasis"><em>set</em></span>, each successive
2579
2556
match will append to the previous, using this variable's value as a
2581
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="spoolfile"></a>3.277. spoolfile</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2558
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="spoolfile"></a>3.269. spoolfile</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2582
2559
Default: (empty)</p></div><p>
2583
2560
If your spool mailbox is in a non-default place where Mutt cannot find
2584
2561
it, you can specify its location with this variable. Mutt will
2585
automatically set this variable to the value of the environment
2586
variable <code class="literal">$MAIL</code> if it is not set.
2587
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="status-chars"></a>3.278. status_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2562
initially set this variable to the value of the environment
2563
variable <code class="literal">$MAIL</code> or <code class="literal">$MAILDIR</code> if either is defined.
2564
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-ca-certificates-file"></a>3.270. ssl_ca_certificates_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2565
Default: (empty)</p></div><p>
2566
This variable specifies a file containing trusted CA certificates.
2567
Any server certificate that is signed with one of these CA
2568
certificates is also automatically accepted.
2572
</p><pre class="screen">
2573
set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
2574
</pre></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-client-cert"></a>3.271. ssl_client_cert</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2575
Default: (empty)</p></div><p>
2576
The file containing a client certificate and its associated private
2578
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-force-tls"></a>3.272. ssl_force_tls</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2579
Default: no</p></div><p>
2580
If this variable is <span class="emphasis"><em>set</em></span>, Mutt will require that all connections
2581
to remote servers be encrypted. Furthermore it will attempt to
2582
negotiate TLS even if the server does not advertise the capability,
2583
since it would otherwise have to abort the connection anyway. This
2584
option supersedes <a class="link" href="reference.html#ssl-starttls" title="3.274. ssl_starttls">$ssl_starttls</a>.
2585
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-min-dh-prime-bits"></a>3.273. ssl_min_dh_prime_bits</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2586
Default: 0</p></div><p>
2587
This variable specifies the minimum acceptable prime size (in bits)
2588
for use in any Diffie-Hellman key exchange. A value of 0 will use
2589
the default from the GNUTLS library.
2590
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-starttls"></a>3.274. ssl_starttls</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
2591
Default: yes</p></div><p>
2592
If <span class="emphasis"><em>set</em></span> (the default), mutt will attempt to use <code class="literal">STARTTLS</code> on servers
2593
advertising the capability. When <span class="emphasis"><em>unset</em></span>, mutt will not attempt to
2594
use <code class="literal">STARTTLS</code> regardless of the server's capabilities.
2595
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv2"></a>3.275. ssl_use_sslv2</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2596
Default: no</p></div><p>
2597
This variable specifies whether to attempt to use SSLv2 in the
2598
SSL authentication process.
2599
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv3"></a>3.276. ssl_use_sslv3</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2600
Default: yes</p></div><p>
2601
This variable specifies whether to attempt to use SSLv3 in the
2602
SSL authentication process.
2603
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-tlsv1"></a>3.277. ssl_use_tlsv1</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2604
Default: yes</p></div><p>
2605
This variable specifies whether to attempt to use TLSv1 in the
2606
SSL authentication process.
2607
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-usesystemcerts"></a>3.278. ssl_usesystemcerts</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2608
Default: yes</p></div><p>
2609
If set to <span class="emphasis"><em>yes</em></span>, mutt will use CA certificates in the
2610
system-wide certificate store when checking if a server certificate
2611
is signed by a trusted CA.
2612
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-verify-dates"></a>3.279. ssl_verify_dates</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2613
Default: yes</p></div><p>
2614
If <span class="emphasis"><em>set</em></span> (the default), mutt will not automatically accept a server
2615
certificate that is either not yet valid or already expired. You should
2616
only unset this for particular known hosts, using the
2617
<code class="literal"><a class="link" href="optionalfeatures.html#account-hook" title="6. Managing Multiple Accounts"><account-hook></a></code> function.
2618
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-verify-host"></a>3.280. ssl_verify_host</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2619
Default: yes</p></div><p>
2620
If <span class="emphasis"><em>set</em></span> (the default), mutt will not automatically accept a server
2621
certificate whose host name does not match the host used in your folder
2622
URL. You should only unset this for particular known hosts, using
2623
the <code class="literal"><a class="link" href="optionalfeatures.html#account-hook" title="6. Managing Multiple Accounts"><account-hook></a></code> function.
2624
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="status-chars"></a>3.281. status_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2588
2625
Default: “<span class="quote"><code class="literal">-*%A</code></span>”</p></div><p>
2589
2626
Controls the characters used by the “<span class="quote">%r</span>” indicator in
2590
<a class="link" href="reference.html#status-format" title="3.279. status_format">$status_format</a>. The first character is used when the mailbox is
2627
<a class="link" href="reference.html#status-format" title="3.282. status_format">$status_format</a>. The first character is used when the mailbox is
2591
2628
unchanged. The second is used when the mailbox has been changed, and
2592
2629
it needs to be resynchronized. The third is used if the mailbox is in
2593
2630
read-only mode, or if the mailbox will not be written when exiting
2764
2801
</p><pre class="screen">
2765
2802
set tunnel="ssh -q mailhost.net /usr/local/libexec/imapd"
2768
2804
Note: For this example to work you must be able to log in to the remote
2769
2805
machine without having to enter a password.
2770
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-8bitmime"></a>3.292. use_8bitmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2807
When set, Mutt uses the tunnel for all remote connections.
2808
Please see “<span class="quote"><a class="link" href="optionalfeatures.html#account-hook" title="6. Managing Multiple Accounts">account-hook</a></span>” in the manual for how to use different
2809
tunnel commands per connection.
2810
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="uncollapse-jump"></a>3.295. uncollapse_jump</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2811
Default: no</p></div><p>
2812
When <span class="emphasis"><em>set</em></span>, Mutt will jump to the next unread message, if any,
2813
when the current thread is <span class="emphasis"><em>un</em></span>collapsed.
2814
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-8bitmime"></a>3.296. use_8bitmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2771
2815
Default: no</p></div><p>
2772
2816
<span class="bold"><strong>Warning:</strong></span> do not set this variable unless you are using a version
2773
2817
of sendmail which supports the <code class="literal">-B8BITMIME</code> flag (such as sendmail
2774
2818
8.8.x) or you may not be able to send mail.
2776
When <span class="emphasis"><em>set</em></span>, Mutt will invoke <a class="link" href="reference.html#sendmail" title="3.258. sendmail">$sendmail</a> with the <code class="literal">-B8BITMIME</code>
2820
When <span class="emphasis"><em>set</em></span>, Mutt will invoke <a class="link" href="reference.html#sendmail" title="3.230. sendmail">$sendmail</a> with the <code class="literal">-B8BITMIME</code>
2777
2821
flag when sending 8-bit messages to enable ESMTP negotiation.
2778
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-domain"></a>3.293. use_domain</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2822
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-domain"></a>3.297. use_domain</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2779
2823
Default: yes</p></div><p>
2780
2824
When <span class="emphasis"><em>set</em></span>, Mutt will qualify all local addresses (ones without the
2781
“<span class="quote">@host</span>” portion) with the value of <a class="link" href="reference.html#hostname" title="3.80. hostname">$hostname</a>. If <span class="emphasis"><em>unset</em></span>, no
2825
“<span class="quote">@host</span>” portion) with the value of <a class="link" href="reference.html#hostname" title="3.93. hostname">$hostname</a>. If <span class="emphasis"><em>unset</em></span>, no
2782
2826
addresses will be qualified.
2783
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-envelope-from"></a>3.294. use_envelope_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2827
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-envelope-from"></a>3.298. use_envelope_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2784
2828
Default: no</p></div><p>
2785
2829
When <span class="emphasis"><em>set</em></span>, mutt will set the <span class="emphasis"><em>envelope</em></span> sender of the message.
2786
If <a class="link" href="reference.html#envelope-from-address" title="3.53. envelope_from_address">$envelope_from_address</a> is <span class="emphasis"><em>set</em></span>, it will be used as the sender
2830
If <a class="link" href="reference.html#envelope-from-address" title="3.61. envelope_from_address">$envelope_from_address</a> is <span class="emphasis"><em>set</em></span>, it will be used as the sender
2787
2831
address. If <span class="emphasis"><em>unset</em></span>, mutt will attempt to derive the sender from the
2788
2832
“<span class="quote">From:</span>” header.
2790
2834
Note that this information is passed to sendmail command using the
2791
2835
<code class="literal">-f</code> command line switch. Therefore setting this option is not useful
2792
if the <a class="link" href="reference.html#sendmail" title="3.258. sendmail">$sendmail</a> variable already contains <code class="literal">-f</code> or if the
2793
executable pointed to by <a class="link" href="reference.html#sendmail" title="3.258. sendmail">$sendmail</a> doesn't support the <code class="literal">-f</code> switch.
2794
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-from"></a>3.295. use_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2836
if the <a class="link" href="reference.html#sendmail" title="3.230. sendmail">$sendmail</a> variable already contains <code class="literal">-f</code> or if the
2837
executable pointed to by <a class="link" href="reference.html#sendmail" title="3.230. sendmail">$sendmail</a> doesn't support the <code class="literal">-f</code> switch.
2838
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-from"></a>3.299. use_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2795
2839
Default: yes</p></div><p>
2796
2840
When <span class="emphasis"><em>set</em></span>, Mutt will generate the “<span class="quote">From:</span>” header field when
2797
2841
sending messages. If <span class="emphasis"><em>unset</em></span>, no “<span class="quote">From:</span>” header field will be
2798
generated unless the user explicitly sets one using the “<span class="quote"><a class="link" href="configuration.html#my-hdr" title="15. User defined headers">my_hdr</a></span>”
2842
generated unless the user explicitly sets one using the “<span class="quote"><a class="link" href="configuration.html#my-hdr" title="15. User-Defined Headers">my_hdr</a></span>”
2800
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-idn"></a>3.296. use_idn</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2844
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-idn"></a>3.300. use_idn</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2801
2845
Default: yes</p></div><p>
2802
2846
When <span class="emphasis"><em>set</em></span>, Mutt will show you international domain names decoded.
2803
2847
Note: You can use IDNs for addresses even if this is <span class="emphasis"><em>unset</em></span>.
2804
2848
This variable only affects decoding.
2805
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-ipv6"></a>3.297. use_ipv6</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2849
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-ipv6"></a>3.301. use_ipv6</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2806
2850
Default: yes</p></div><p>
2807
2851
When <span class="emphasis"><em>set</em></span>, Mutt will look for IPv6 addresses of hosts it tries to
2808
2852
contact. If this option is <span class="emphasis"><em>unset</em></span>, Mutt will restrict itself to IPv4 addresses.
2809
2853
Normally, the default should work.
2810
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="user-agent"></a>3.298. user_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2854
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="user-agent"></a>3.302. user_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2811
2855
Default: yes</p></div><p>
2812
2856
When <span class="emphasis"><em>set</em></span>, mutt will add a “<span class="quote">User-Agent:</span>” header to outgoing
2813
2857
messages, indicating which version of mutt was used for composing
2815
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="visual"></a>3.299. visual</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2859
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="visual"></a>3.303. visual</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2816
2860
Default: (empty)</p></div><p>
2817
2861
Specifies the visual editor to invoke when the “<span class="quote"><code class="literal">˜v</code></span>” command is
2818
2862
given in the builtin editor.
2819
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wait-key"></a>3.300. wait_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2863
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wait-key"></a>3.304. wait_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2820
2864
Default: yes</p></div><p>
2821
2865
Controls whether Mutt will ask you to press a key after an external command
2822
2866
has been invoked by these functions: <code class="literal"><shell-escape></code>,