~ubuntu-dev/ubuntu/lucid/mutt/lucid-201002110857

« back to all changes in this revision

Viewing changes to doc/Muttrc

  • Committer: Bazaar Package Importer
  • Author(s): أحمد المحمودي (Ahmed El-Mahmoudy)
  • Date: 2009-06-17 17:17:28 UTC
  • mfrom: (1.3.1 upstream)
  • mto: This revision was merged to the branch mainline in revision 22.
  • Revision ID: james.westby@ubuntu.com-20090617171728-61dkl7w5fgn7ybdq
Tags: upstream-1.5.20
Import upstream version 1.5.20

Show diffs side-by-side

added added

removed removed

Lines of Context:
268
268
269
269
270
270
# This variable is a colon-separated list of character encoding
271
 
# schemes for text file attachments.
 
271
# schemes for text file attachments. Mutt uses this setting to guess
 
272
# which encoding files being attached are encoded in to convert them to
 
273
# a proper character set given in $send_charset.
 
274
272
275
# If unset, the value of $charset will be used instead.
273
276
# For example, the following configuration would work for Japanese
274
277
# text handling:
349
352
# the section on $index_format.
350
353
351
354
 
355
# set auto_tag=no
 
356
#
 
357
# Name: auto_tag
 
358
# Type: boolean
 
359
# Default: no
 
360
 
361
 
362
# When set, functions in the index menu which affect a message
 
363
# will be applied to all tagged messages (if there are any).  When
 
364
# unset, you must first use the <tag-prefix> function (bound to ``;''
 
365
# by default) to make the next function apply to all tagged messages.
 
366
 
367
352
368
# set autoedit=no
353
369
#
354
370
# Name: autoedit
362
378
# message.  The send-menu may still be accessed once you have finished
363
379
# editing the body of your message.
364
380
 
381
# Note: when this option is set, you cannot use send-hooks that depend
 
382
# on the recipients when composing a new (non-reply) message, as the initial
 
383
# list of recipients is empty.
 
384
365
385
# Also see $fast_reply.
366
386
367
387
368
 
# set auto_tag=no
369
 
#
370
 
# Name: auto_tag
371
 
# Type: boolean
372
 
# Default: no
373
 
374
 
375
 
# When set, functions in the index menu which affect a message
376
 
# will be applied to all tagged messages (if there are any).  When
377
 
# unset, you must first use the <tag-prefix> function (bound to ``;''
378
 
# by default) to make the next function apply to all tagged messages.
379
 
380
 
381
388
# set beep=yes
382
389
#
383
390
# Name: beep
438
445
# visual terminals don't permit making the cursor invisible.
439
446
440
447
 
448
# set certificate_file="~/.mutt_certificates"
 
449
#
 
450
# Name: certificate_file
 
451
# Type: path
 
452
# Default: "~/.mutt_certificates"
 
453
 
454
 
455
# This variable specifies the file where the certificates you trust
 
456
# are saved. When an unknown certificate is encountered, you are asked
 
457
# if you accept it or not. If you accept it, the certificate can also
 
458
# be saved in this file and further connections are automatically
 
459
# accepted.
 
460
 
461
# You can also manually add CA certificates in this file. Any server
 
462
# certificate that is signed with one of these CA certificates is
 
463
# also automatically accepted.
 
464
 
465
# Example:
 
466
# set certificate_file=~/.mutt/certificates
 
467
 
468
 
469
# set charset=""
 
470
#
 
471
# Name: charset
 
472
# Type: string
 
473
# Default: ""
 
474
 
475
 
476
# Character set your terminal uses to display and enter textual data.
 
477
# It is also the fallback for $send_charset.
 
478
 
479
# Upon startup Mutt tries to derive this value from environment variables
 
480
# such as $LC_CTYPE or $LANG.
 
481
 
482
# Note: It should only be set in case Mutt isn't abled to determine the
 
483
# character set used correctly.
 
484
 
485
441
486
# set check_mbox_size=no
442
487
#
443
488
# Name: check_mbox_size
458
503
# Afterwards the new mail status is tracked by file size changes.
459
504
460
505
461
 
# set charset=""
462
 
#
463
 
# Name: charset
464
 
# Type: string
465
 
# Default: ""
466
 
467
 
468
 
# Character set your terminal uses to display and enter textual data.
469
 
# It is also the fallback for $send_charset.
470
 
471
 
# Upon startup Mutt tries to derive this value from environment variables
472
 
# such as $LC_CTYPE or $LANG.
473
 
474
 
# Note: It should only be set in case Mutt isn't abled to determine the
475
 
# character set used correctly.
476
 
477
 
478
506
# set check_new=yes
479
507
#
480
508
# Name: check_new
504
532
# unread messages.
505
533
506
534
507
 
# set uncollapse_jump=no
508
 
#
509
 
# Name: uncollapse_jump
510
 
# Type: boolean
511
 
# Default: no
512
 
513
 
514
 
# When set, Mutt will jump to the next unread message, if any,
515
 
# when the current thread is uncollapsed.
516
 
517
 
518
535
# set compose_format="-- Mutt: Compose  [Approx. msg size: %l   Atts: %a]%>-"
519
536
#
520
537
# Name: compose_format
610
627
# $save_name, $force_name and ``fcc-hook''.
611
628
612
629
 
630
# set crypt_autoencrypt=no
 
631
#
 
632
# Name: crypt_autoencrypt
 
633
# Type: boolean
 
634
# Default: no
 
635
 
636
 
637
# Setting this variable will cause Mutt to always attempt to PGP
 
638
# encrypt outgoing messages.  This is probably only useful in
 
639
# connection to the ``send-hook'' command.  It can be overridden
 
640
# by use of the pgp menu, when encryption is not required or
 
641
# signing is requested as well.  If $smime_is_default is set,
 
642
# then OpenSSL is used instead to create S/MIME messages and
 
643
# settings can be overridden by use of the smime menu instead.
 
644
# (Crypto only)
 
645
 
646
 
647
# set crypt_autopgp=yes
 
648
#
 
649
# Name: crypt_autopgp
 
650
# Type: boolean
 
651
# Default: yes
 
652
 
653
 
654
# This variable controls whether or not mutt may automatically enable
 
655
# PGP encryption/signing for messages.  See also $crypt_autoencrypt,
 
656
# $crypt_replyencrypt,
 
657
# $crypt_autosign, $crypt_replysign and $smime_is_default.
 
658
 
659
 
660
# set crypt_autosign=no
 
661
#
 
662
# Name: crypt_autosign
 
663
# Type: boolean
 
664
# Default: no
 
665
 
666
 
667
# Setting this variable will cause Mutt to always attempt to
 
668
# cryptographically sign outgoing messages.  This can be overridden
 
669
# by use of the pgp menu, when signing is not required or
 
670
# encryption is requested as well. If $smime_is_default is set,
 
671
# then OpenSSL is used instead to create S/MIME messages and settings can
 
672
# be overridden by use of the smime menu instead of the pgp menu.
 
673
# (Crypto only)
 
674
 
675
 
676
# set crypt_autosmime=yes
 
677
#
 
678
# Name: crypt_autosmime
 
679
# Type: boolean
 
680
# Default: yes
 
681
 
682
 
683
# This variable controls whether or not mutt may automatically enable
 
684
# S/MIME encryption/signing for messages. See also $crypt_autoencrypt,
 
685
# $crypt_replyencrypt,
 
686
# $crypt_autosign, $crypt_replysign and $smime_is_default.
 
687
 
688
 
689
# set crypt_replyencrypt=yes
 
690
#
 
691
# Name: crypt_replyencrypt
 
692
# Type: boolean
 
693
# Default: yes
 
694
 
695
 
696
# If set, automatically PGP or OpenSSL encrypt replies to messages which are
 
697
# encrypted.
 
698
# (Crypto only)
 
699
 
700
 
701
# set crypt_replysign=no
 
702
#
 
703
# Name: crypt_replysign
 
704
# Type: boolean
 
705
# Default: no
 
706
 
707
 
708
# If set, automatically PGP or OpenSSL sign replies to messages which are
 
709
# signed.
 
710
 
711
# Note: this does not work on messages that are encrypted
 
712
# and signed!
 
713
# (Crypto only)
 
714
 
715
 
716
# set crypt_replysignencrypted=no
 
717
#
 
718
# Name: crypt_replysignencrypted
 
719
# Type: boolean
 
720
# Default: no
 
721
 
722
 
723
# If set, automatically PGP or OpenSSL sign replies to messages
 
724
# which are encrypted. This makes sense in combination with
 
725
# $crypt_replyencrypt, because it allows you to sign all
 
726
# messages which are automatically encrypted.  This works around
 
727
# the problem noted in $crypt_replysign, that mutt is not able
 
728
# to find out whether an encrypted message is also signed.
 
729
# (Crypto only)
 
730
 
731
 
732
# set crypt_timestamp=yes
 
733
#
 
734
# Name: crypt_timestamp
 
735
# Type: boolean
 
736
# Default: yes
 
737
 
738
 
739
# If set, mutt will include a time stamp in the lines surrounding
 
740
# PGP or S/MIME output, so spoofing such lines is more difficult.
 
741
# If you are using colors to mark these lines, and rely on these,
 
742
# you may unset this setting.
 
743
# (Crypto only)
 
744
 
745
613
746
# set crypt_use_gpgme=no
614
747
#
615
748
# Name: crypt_use_gpgme
636
769
# verification (only supported by the GPGME backend).
637
770
638
771
639
 
# set crypt_autopgp=yes
640
 
#
641
 
# Name: crypt_autopgp
642
 
# Type: boolean
643
 
# Default: yes
644
 
645
 
646
 
# This variable controls whether or not mutt may automatically enable
647
 
# PGP encryption/signing for messages.  See also $crypt_autoencrypt,
648
 
# $crypt_replyencrypt,
649
 
# $crypt_autosign, $crypt_replysign and $smime_is_default.
650
 
651
 
652
 
# set crypt_autosmime=yes
653
 
#
654
 
# Name: crypt_autosmime
655
 
# Type: boolean
656
 
# Default: yes
657
 
658
 
659
 
# This variable controls whether or not mutt may automatically enable
660
 
# S/MIME encryption/signing for messages. See also $crypt_autoencrypt,
661
 
# $crypt_replyencrypt,
662
 
# $crypt_autosign, $crypt_replysign and $smime_is_default.
 
772
# set crypt_verify_sig=yes
 
773
#
 
774
# Name: crypt_verify_sig
 
775
# Type: quadoption
 
776
# Default: yes
 
777
 
778
 
779
# If ``yes'', always attempt to verify PGP or S/MIME signatures.
 
780
# If ``ask-*'', ask whether or not to verify the signature.
 
781
# If \Fi``no'', never attempt to verify cryptographic signatures.
 
782
# (Crypto only)
663
783
664
784
665
785
# set date_format="!%a, %b %d, %Y at %I:%M:%S%p %Z"
859
979
# misinterpreting the line as a mbox message separator).
860
980
861
981
 
982
# set entropy_file=""
 
983
#
 
984
# Name: entropy_file
 
985
# Type: path
 
986
# Default: ""
 
987
 
988
 
989
# The file which includes random data that is used to initialize SSL
 
990
# library functions.
 
991
 
992
862
993
# set envelope_from_address=""
863
994
#
864
995
# Name: envelope_from_address
898
1029
# set fcc_attach=yes
899
1030
#
900
1031
# Name: fcc_attach
901
 
# Type: boolean
 
1032
# Type: quadoption
902
1033
# Default: yes
903
1034
904
1035
946
1077
# its own set of printf(3)-like sequences:
947
1078
# %C      current file number
948
1079
# %d      date/time folder was last modified
949
 
# %f      filename
 
1080
# %f      filename (``/'' is appended to directory names,
 
1081
#         ``@'' to symbolic links and ``*'' to executable
 
1082
#         files)
950
1083
# %F      file permissions
951
1084
# %g      group name (or numeric gid, if missing)
952
1085
# %l      number of hard links
1015
1148
# otherwise $mime_forward_decode is used instead.
1016
1149
1017
1150
 
1151
# set forward_decrypt=yes
 
1152
#
 
1153
# Name: forward_decrypt
 
1154
# Type: boolean
 
1155
# Default: yes
 
1156
 
1157
 
1158
# Controls the handling of encrypted messages when forwarding a message.
 
1159
# When set, the outer layer of encryption is stripped off.  This
 
1160
# variable is only used if $mime_forward is set and
 
1161
# $mime_forward_decode is unset.
 
1162
# (PGP only)
 
1163
 
1164
1018
1165
# set forward_edit=yes
1019
1166
#
1020
1167
# Name: forward_edit
1077
1224
# If the GECOS field contains a string like ``lastname, firstname'' then you
1078
1225
# should set it to ``.*''.
1079
1226
1080
 
# This can be useful if you see the following behavior: you address a e-mail
 
1227
# This can be useful if you see the following behavior: you address an e-mail
1081
1228
# to user ID ``stevef'' whose full name is ``Steve Franklin''.  If mutt expands
1082
1229
# ``stevef'' to ``"Franklin" stevef@foo.bar'' then you should set the $gecos_mask to
1083
1230
# a regular expression that will match the whole name so mutt will expand
1109
1256
# The $weed setting applies.
1110
1257
1111
1258
 
1259
# set header_cache=""
 
1260
#
 
1261
# Name: header_cache
 
1262
# Type: path
 
1263
# Default: ""
 
1264
 
1265
 
1266
# This variable points to the header cache database.
 
1267
# If pointing to a directory Mutt will contain a header cache
 
1268
# database file per folder, if pointing to a file that file will
 
1269
# be a single global header cache. By default it is unset so no header
 
1270
# caching will be used.
 
1271
 
1272
# Header caching can greatly improve speed when opening POP, IMAP
 
1273
# MH or Maildir folders, see ``caching'' for details.
 
1274
 
1275
 
1276
# set header_cache_compress=yes
 
1277
#
 
1278
# Name: header_cache_compress
 
1279
# Type: boolean
 
1280
# Default: yes
 
1281
 
1282
 
1283
# When mutt is compiled with qdbm or tokyocabinet as header cache backend,
 
1284
# this option determines whether the database will be compressed.
 
1285
# Compression results in database files roughly being one fifth
 
1286
# of the usual diskspace, but the uncompression can result in a
 
1287
# slower opening of cached folder(s) which in general is still
 
1288
# much faster than opening non header cached folders.
 
1289
 
1290
 
1291
# set header_cache_pagesize="16384"
 
1292
#
 
1293
# Name: header_cache_pagesize
 
1294
# Type: string
 
1295
# Default: "16384"
 
1296
 
1297
 
1298
# When mutt is compiled with either gdbm or bdb4 as the header cache backend,
 
1299
# this option changes the database page size.  Too large or too small
 
1300
# values can waste space, memory, or CPU time. The default should be more
 
1301
# or less optimal for most use cases.
 
1302
 
1303
1112
1304
# set help=yes
1113
1305
#
1114
1306
# Name: help
1219
1411
# The file in which Mutt will save its history.
1220
1412
1221
1413
 
1414
# set honor_disposition=no
 
1415
#
 
1416
# Name: honor_disposition
 
1417
# Type: boolean
 
1418
# Default: no
 
1419
 
1420
 
1421
# When set, Mutt will not display attachments with a
 
1422
# disposition of ``attachment'' inline even if it could
 
1423
# render the part to plain text. These MIME parts can only
 
1424
# be viewed from the attachment menu.
 
1425
 
1426
# If unset, Mutt will render all MIME parts it can
 
1427
# properly transform to plain text.
 
1428
 
1429
1222
1430
# set honor_followup_to=yes
1223
1431
#
1224
1432
# Name: honor_followup_to
1412
1620
1413
1621
1414
1622
# Specifies the password for your IMAP account.  If unset, Mutt will
1415
 
# prompt you for your password when you invoke the <fetch-mail> function
 
1623
# prompt you for your password when you invoke the <imap-fetch-mail> function
1416
1624
# or try to open an IMAP folder.
1417
1625
1418
1626
# Warning: you should only use this option when you are on a
1537
1745
# message to which you are replying.  You are strongly encouraged not to
1538
1746
# change this value, as it tends to agitate the more fanatical netizens.
1539
1747
 
1748
# The value of this option is ignored if $text_flowed is set, too because
 
1749
# the quoting mechanism is strictly defined for format=flowed.
 
1750
1540
1751
# This option is a format string, please see the description of
1541
1752
# $index_format for supported printf(3)-style sequences.
1542
1753
1543
 
# Because for format=lowed style messages the quoting mechanism
1544
 
# is strictly defined, this setting is ignored if $text_flowed is
1545
 
# set.
1546
 
1547
1754
1548
1755
# set index_format="%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s"
1549
1756
#
1698
1905
# DOING!
1699
1906
1700
1907
1701
 
# set header_cache=""
1702
 
#
1703
 
# Name: header_cache
1704
 
# Type: path
1705
 
# Default: ""
1706
 
1707
 
1708
 
# This variable points to the header cache database.
1709
 
# If pointing to a directory Mutt will contain a header cache
1710
 
# database file per folder, if pointing to a file that file will
1711
 
# be a single global header cache. By default it is unset so no header
1712
 
# caching will be used.
1713
 
1714
 
# Header caching can greatly improve speed when opening POP, IMAP
1715
 
# MH or Maildir folders, see ``caching'' for details.
1716
 
1717
 
1718
1908
# set maildir_header_cache_verify=yes
1719
1909
#
1720
1910
# Name: maildir_header_cache_verify
1728
1918
# folders).
1729
1919
1730
1920
1731
 
# set header_cache_pagesize="16384"
1732
 
#
1733
 
# Name: header_cache_pagesize
1734
 
# Type: string
1735
 
# Default: "16384"
1736
 
1737
 
1738
 
# When mutt is compiled with either gdbm or bdb4 as the header cache backend,
1739
 
# this option changes the database page size.  Too large or too small
1740
 
# values can waste space, memory, or CPU time. The default should be more
1741
 
# or less optimal for most use cases.
1742
 
1743
 
1744
 
# set header_cache_compress=yes
1745
 
#
1746
 
# Name: header_cache_compress
1747
 
# Type: boolean
1748
 
# Default: yes
1749
 
1750
 
1751
 
# When mutt is compiled with qdbm or tokyocabinet as header cache backend,
1752
 
# this option determines whether the database will be compressed.
1753
 
# Compression results in database files roughly being one fifth
1754
 
# of the usual diskspace, but the uncompression can result in a
1755
 
# slower opening of cached folder(s) which in general is still
1756
 
# much faster than opening non header cached folders.
1757
 
1758
 
1759
1921
# set maildir_trash=no
1760
1922
#
1761
1923
# Name: maildir_trash
1829
1991
1830
1992
1831
1993
# The default mailbox type used when creating new folders. May be any of
1832
 
# ``mbox'', ``MMDF'', ``MH'' and ``Maildir''.
1833
 
1834
 
1835
 
# set metoo=no
1836
 
#
1837
 
# Name: metoo
1838
 
# Type: boolean
1839
 
# Default: no
1840
 
1841
 
1842
 
# If unset, Mutt will remove your address (see the ``alternates''
1843
 
# command) from the list of recipients when replying to a message.
 
1994
# ``mbox'', ``MMDF'', ``MH'' and ``Maildir''. This is overriden by the
 
1995
# -m command-line option.
1844
1996
1845
1997
1846
1998
# set menu_context=0
1879
2031
# (useful for slow links to avoid many redraws).
1880
2032
1881
2033
 
2034
# set message_cache_clean=no
 
2035
#
 
2036
# Name: message_cache_clean
 
2037
# Type: boolean
 
2038
# Default: no
 
2039
 
2040
 
2041
# If set, mutt will clean out obsolete entries from the message cache when
 
2042
# the mailbox is synchronized. You probably only want to set it
 
2043
# every once in a while, since it can be a little slow
 
2044
# (especially for large folders).
 
2045
 
2046
 
2047
# set message_cachedir=""
 
2048
#
 
2049
# Name: message_cachedir
 
2050
# Type: path
 
2051
# Default: ""
 
2052
 
2053
 
2054
# Set this to a directory and mutt will cache copies of messages from
 
2055
# your IMAP and POP servers here. You are free to remove entries at any
 
2056
# time.
 
2057
 
2058
# When setting this variable to a directory, mutt needs to fetch every
 
2059
# remote message only once and can perform regular expression searches
 
2060
# as fast as for local folders.
 
2061
 
2062
# Also see the $message_cache_clean variable.
 
2063
 
2064
 
2065
# set message_format="%s"
 
2066
#
 
2067
# Name: message_format
 
2068
# Type: string
 
2069
# Default: "%s"
 
2070
 
2071
 
2072
# This is the string displayed in the ``attachment'' menu for
 
2073
# attachments of type message/rfc822.  For a full listing of defined
 
2074
# printf(3)-like sequences see the section on $index_format.
 
2075
 
2076
1882
2077
# set meta_key=no
1883
2078
#
1884
2079
# Name: meta_key
1895
2090
# ``x''.
1896
2091
1897
2092
 
2093
# set metoo=no
 
2094
#
 
2095
# Name: metoo
 
2096
# Type: boolean
 
2097
# Default: no
 
2098
 
2099
 
2100
# If unset, Mutt will remove your address (see the ``alternates''
 
2101
# command) from the list of recipients when replying to a message.
 
2102
 
2103
1898
2104
# set mh_purge=no
1899
2105
#
1900
2106
# Name: mh_purge
2023
2229
# a ``mbox-hook'' command.
2024
2230
2025
2231
2026
 
# set message_cachedir=""
2027
 
#
2028
 
# Name: message_cachedir
2029
 
# Type: path
2030
 
# Default: ""
2031
 
2032
 
2033
 
# Set this to a directory and mutt will cache copies of messages from
2034
 
# your IMAP and POP servers here. You are free to remove entries at any
2035
 
# time.
2036
 
2037
 
# When setting this variable to a directory, mutt needs to fetch every
2038
 
# remote message only once and can perform regular expression searches
2039
 
# as fast as for local folders.
2040
 
2041
 
# Also see the $message_cache_clean variable.
2042
 
2043
 
2044
 
# set message_cache_clean=no
2045
 
#
2046
 
# Name: message_cache_clean
2047
 
# Type: boolean
2048
 
# Default: no
2049
 
2050
 
2051
 
# If set, mutt will clean out obsolete entries from the message cache when
2052
 
# the mailbox is synchronized. You probably only want to set it
2053
 
# every once in a while, since it can be a little slow
2054
 
# (especially for large folders).
2055
 
2056
 
2057
 
# set message_format="%s"
2058
 
#
2059
 
# Name: message_format
2060
 
# Type: string
2061
 
# Default: "%s"
2062
 
2063
 
2064
 
# This is the string displayed in the ``attachment'' menu for
2065
 
# attachments of type message/rfc822.  For a full listing of defined
2066
 
# printf(3)-like sequences see the section on $index_format.
2067
 
2068
 
2069
2232
# set narrow_tree=no
2070
2233
#
2071
2234
# Name: narrow_tree
2121
2284
# default, Mutt will display the line after the last one on the screen
2122
2285
# at the top of the next page (0 lines of context).
2123
2286
 
2287
# This variable also specifies the amount of context given for search
 
2288
# results. If positive, this many lines will be given before a match,
 
2289
# if 0, the match will be top-aligned.
 
2290
2124
2291
2125
2292
# set pager_format="-%Z- %C/%m: %-20.20n   %s%*  -- (%P)"
2126
2293
#
2167
2334
# function.
2168
2335
2169
2336
2170
 
# set crypt_autosign=no
2171
 
#
2172
 
# Name: crypt_autosign
2173
 
# Type: boolean
2174
 
# Default: no
2175
 
2176
 
2177
 
# Setting this variable will cause Mutt to always attempt to
2178
 
# cryptographically sign outgoing messages.  This can be overridden
2179
 
# by use of the pgp menu, when signing is not required or
2180
 
# encryption is requested as well. If $smime_is_default is set,
2181
 
# then OpenSSL is used instead to create S/MIME messages and settings can
2182
 
# be overridden by use of the smime menu instead of the pgp menu.
2183
 
# (Crypto only)
2184
 
2185
 
2186
 
# set crypt_autoencrypt=no
2187
 
#
2188
 
# Name: crypt_autoencrypt
2189
 
# Type: boolean
2190
 
# Default: no
2191
 
2192
 
2193
 
# Setting this variable will cause Mutt to always attempt to PGP
2194
 
# encrypt outgoing messages.  This is probably only useful in
2195
 
# connection to the ``send-hook'' command.  It can be overridden
2196
 
# by use of the pgp menu, when encryption is not required or
2197
 
# signing is requested as well.  If $smime_is_default is set,
2198
 
# then OpenSSL is used instead to create S/MIME messages and
2199
 
# settings can be overridden by use of the smime menu instead.
2200
 
# (Crypto only)
2201
 
2202
 
2203
 
# set pgp_ignore_subkeys=yes
2204
 
#
2205
 
# Name: pgp_ignore_subkeys
2206
 
# Type: boolean
2207
 
# Default: yes
2208
 
2209
 
2210
 
# Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead,
2211
 
# the principal key will inherit the subkeys' capabilities.  Unset this
2212
 
# if you want to play interesting key selection games.
2213
 
# (PGP only)
2214
 
2215
 
2216
 
# set crypt_replyencrypt=yes
2217
 
#
2218
 
# Name: crypt_replyencrypt
2219
 
# Type: boolean
2220
 
# Default: yes
2221
 
2222
 
2223
 
# If set, automatically PGP or OpenSSL encrypt replies to messages which are
2224
 
# encrypted.
2225
 
# (Crypto only)
2226
 
2227
 
2228
 
# set crypt_replysign=no
2229
 
#
2230
 
# Name: crypt_replysign
2231
 
# Type: boolean
2232
 
# Default: no
2233
 
2234
 
2235
 
# If set, automatically PGP or OpenSSL sign replies to messages which are
2236
 
# signed.
2237
 
2238
 
# Note: this does not work on messages that are encrypted
2239
 
# and signed!
2240
 
# (Crypto only)
2241
 
2242
 
2243
 
# set crypt_replysignencrypted=no
2244
 
#
2245
 
# Name: crypt_replysignencrypted
2246
 
# Type: boolean
2247
 
# Default: no
2248
 
2249
 
2250
 
# If set, automatically PGP or OpenSSL sign replies to messages
2251
 
# which are encrypted. This makes sense in combination with
2252
 
# $crypt_replyencrypt, because it allows you to sign all
2253
 
# messages which are automatically encrypted.  This works around
2254
 
# the problem noted in $crypt_replysign, that mutt is not able
2255
 
# to find out whether an encrypted message is also signed.
2256
 
# (Crypto only)
2257
 
2258
 
2259
 
# set crypt_timestamp=yes
2260
 
#
2261
 
# Name: crypt_timestamp
2262
 
# Type: boolean
2263
 
# Default: yes
2264
 
2265
 
2266
 
# If set, mutt will include a time stamp in the lines surrounding
2267
 
# PGP or S/MIME output, so spoofing such lines is more difficult.
2268
 
# If you are using colors to mark these lines, and rely on these,
2269
 
# you may unset this setting.
2270
 
# (Crypto only)
2271
 
2272
 
2273
 
# set pgp_use_gpg_agent=no
2274
 
#
2275
 
# Name: pgp_use_gpg_agent
2276
 
# Type: boolean
2277
 
# Default: no
2278
 
2279
 
2280
 
# If set, mutt will use a possibly-running gpg-agent(1) process.
2281
 
# (PGP only)
2282
 
2283
 
2284
 
# set crypt_verify_sig=yes
2285
 
#
2286
 
# Name: crypt_verify_sig
2287
 
# Type: quadoption
2288
 
# Default: yes
2289
 
2290
 
2291
 
# If ``yes'', always attempt to verify PGP or S/MIME signatures.
2292
 
# If ``ask-*'', ask whether or not to verify the signature.
2293
 
# If \Fi``no'', never attempt to verify cryptographic signatures.
2294
 
# (Crypto only)
2295
 
2296
 
2297
 
# set smime_is_default=no
2298
 
#
2299
 
# Name: smime_is_default
2300
 
# Type: boolean
2301
 
# Default: no
2302
 
2303
 
2304
 
# The default behaviour of mutt is to use PGP on all auto-sign/encryption
2305
 
# operations. To override and to use OpenSSL instead this must be set.
2306
 
# However, this has no effect while replying, since mutt will automatically
2307
 
# select the same application that was used to sign/encrypt the original
2308
 
# message.  (Note that this variable can be overridden by unsetting $crypt_autosmime.)
2309
 
# (S/MIME only)
2310
 
2311
 
2312
 
# set smime_ask_cert_label=yes
2313
 
#
2314
 
# Name: smime_ask_cert_label
2315
 
# Type: boolean
2316
 
# Default: yes
2317
 
2318
 
2319
 
# This flag controls whether you want to be asked to enter a label
2320
 
# for a certificate about to be added to the database or not. It is
2321
 
# set by default.
2322
 
# (S/MIME only)
2323
 
2324
 
2325
 
# set smime_decrypt_use_default_key=yes
2326
 
#
2327
 
# Name: smime_decrypt_use_default_key
2328
 
# Type: boolean
2329
 
# Default: yes
2330
 
2331
 
2332
 
# If set (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.
2335
 
# (S/MIME only)
 
2337
# set pgp_auto_decode=no
 
2338
#
 
2339
# Name: pgp_auto_decode
 
2340
# Type: boolean
 
2341
# Default: no
 
2342
 
2343
 
2344
# If set, mutt will automatically attempt to decrypt traditional PGP
 
2345
# messages whenever the user performs an operation which ordinarily would
 
2346
# result in the contents of the message being operated on.  For example,
 
2347
# if the user displays a pgp-traditional message which has not been manually
 
2348
# checked with the <check-traditional-pgp> function, mutt will automatically
 
2349
# check the message for traditional pgp.
 
2350
 
2351
 
2352
# set pgp_autoinline=no
 
2353
#
 
2354
# Name: pgp_autoinline
 
2355
# Type: boolean
 
2356
# Default: no
 
2357
 
2358
 
2359
# This option controls whether Mutt generates old-style inline
 
2360
# (traditional) PGP encrypted or signed messages under certain
 
2361
# circumstances.  This can be overridden by use of the pgp menu,
 
2362
# when inline is not required.
 
2363
 
2364
# Note that Mutt might automatically use PGP/MIME for messages
 
2365
# which consist of more than a single MIME part.  Mutt can be
 
2366
# configured to ask before sending PGP/MIME messages when inline
 
2367
# (traditional) would not work.
 
2368
 
2369
# Also see the $pgp_mime_auto variable.
 
2370
 
2371
# Also note that using the old-style PGP message format is strongly
 
2372
# deprecated.
 
2373
# (PGP only)
 
2374
 
2375
 
2376
# set pgp_check_exit=yes
 
2377
#
 
2378
# Name: pgp_check_exit
 
2379
# Type: boolean
 
2380
# Default: yes
 
2381
 
2382
 
2383
# If set, mutt will check the exit code of the PGP subprocess when
 
2384
# signing or encrypting.  A non-zero exit code means that the
 
2385
# subprocess failed.
 
2386
# (PGP only)
 
2387
 
2388
 
2389
# set pgp_clearsign_command=""
 
2390
#
 
2391
# Name: pgp_clearsign_command
 
2392
# Type: string
 
2393
# Default: ""
 
2394
 
2395
 
2396
# This format is used to create an old-style ``clearsigned'' PGP
 
2397
# message.  Note that the use of this format is strongly
 
2398
# deprecated.
 
2399
 
2400
# This is a format string, see the $pgp_decode_command command for
 
2401
# possible printf(3)-like sequences.
 
2402
# (PGP only)
 
2403
 
2404
 
2405
# set pgp_decode_command=""
 
2406
#
 
2407
# Name: pgp_decode_command
 
2408
# Type: string
 
2409
# Default: ""
 
2410
 
2411
 
2412
# This format strings specifies a command which is used to decode
 
2413
# application/pgp attachments.
 
2414
 
2415
# The PGP command formats have their own set of printf(3)-like sequences:
 
2416
# %p      Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
 
2417
#         string otherwise. Note: This may be used with a %? construct.
 
2418
# %f      Expands to the name of a file containing a message.
 
2419
# %s      Expands to the name of a file containing the signature part
 
2420
#                    of a multipart/signed attachment when verifying it.
 
2421
# %a      The value of $pgp_sign_as.
 
2422
# %r      One or more key IDs.
 
2423
 
2424
 
2425
# For examples on how to configure these formats for the various versions
 
2426
# of PGP which are floating around, see the pgp and gpg sample configuration files in
 
2427
# the samples/ subdirectory which has been installed on your system
 
2428
# alongside the documentation.
 
2429
# (PGP only)
 
2430
 
2431
 
2432
# set pgp_decrypt_command=""
 
2433
#
 
2434
# Name: pgp_decrypt_command
 
2435
# Type: string
 
2436
# Default: ""
 
2437
 
2438
 
2439
# This command is used to decrypt a PGP encrypted message.
 
2440
 
2441
# This is a format string, see the $pgp_decode_command command for
 
2442
# possible printf(3)-like sequences.
 
2443
# (PGP only)
 
2444
 
2445
 
2446
# set pgp_encrypt_only_command=""
 
2447
#
 
2448
# Name: pgp_encrypt_only_command
 
2449
# Type: string
 
2450
# Default: ""
 
2451
 
2452
 
2453
# This command is used to encrypt a body part without signing it.
 
2454
 
2455
# This is a format string, see the $pgp_decode_command command for
 
2456
# possible printf(3)-like sequences.
 
2457
# (PGP only)
 
2458
 
2459
 
2460
# set pgp_encrypt_sign_command=""
 
2461
#
 
2462
# Name: pgp_encrypt_sign_command
 
2463
# Type: string
 
2464
# Default: ""
 
2465
 
2466
 
2467
# This command is used to both sign and encrypt a body part.
 
2468
 
2469
# This is a format string, see the $pgp_decode_command command for
 
2470
# possible printf(3)-like sequences.
 
2471
# (PGP only)
2336
2472
2337
2473
2338
2474
# set pgp_entry_format="%4n %t%f %4l/0x%k %-4a %2c %u"
2359
2495
# (PGP only)
2360
2496
2361
2497
 
2498
# set pgp_export_command=""
 
2499
#
 
2500
# Name: pgp_export_command
 
2501
# Type: string
 
2502
# Default: ""
 
2503
 
2504
 
2505
# This command is used to export a public key from the user's
 
2506
# key ring.
 
2507
 
2508
# This is a format string, see the $pgp_decode_command command for
 
2509
# possible printf(3)-like sequences.
 
2510
# (PGP only)
 
2511
 
2512
 
2513
# set pgp_getkeys_command=""
 
2514
#
 
2515
# Name: pgp_getkeys_command
 
2516
# Type: string
 
2517
# Default: ""
 
2518
 
2519
 
2520
# This command is invoked whenever mutt will need public key information.
 
2521
# Of the sequences supported by $pgp_decode_command, %r is the only
 
2522
# printf(3)-like sequence used with this format.
 
2523
# (PGP only)
 
2524
 
2525
2362
2526
# set pgp_good_sign=""
2363
2527
#
2364
2528
# Name: pgp_good_sign
2373
2537
# (PGP only)
2374
2538
2375
2539
2376
 
# set pgp_check_exit=yes
 
2540
# set pgp_ignore_subkeys=yes
2377
2541
#
2378
 
# Name: pgp_check_exit
 
2542
# Name: pgp_ignore_subkeys
2379
2543
# Type: boolean
2380
2544
# Default: yes
2381
2545
2382
2546
2383
 
# If set, mutt will check the exit code of the PGP subprocess when
2384
 
# signing or encrypting.  A non-zero exit code means that the
2385
 
# subprocess failed.
 
2547
# Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead,
 
2548
# the principal key will inherit the subkeys' capabilities.  Unset this
 
2549
# if you want to play interesting key selection games.
 
2550
# (PGP only)
 
2551
 
2552
 
2553
# set pgp_import_command=""
 
2554
#
 
2555
# Name: pgp_import_command
 
2556
# Type: string
 
2557
# Default: ""
 
2558
 
2559
 
2560
# This command is used to import a key from a message into
 
2561
# the user's public key ring.
 
2562
 
2563
# This is a format string, see the $pgp_decode_command command for
 
2564
# possible printf(3)-like sequences.
 
2565
# (PGP only)
 
2566
 
2567
 
2568
# set pgp_list_pubring_command=""
 
2569
#
 
2570
# Name: pgp_list_pubring_command
 
2571
# Type: string
 
2572
# Default: ""
 
2573
 
2574
 
2575
# This command is used to list the public key ring's contents.  The
 
2576
# output format must be analogous to the one used by
 
2577
# gpg --list-keys --with-colons.
 
2578
 
2579
# This format is also generated by the pgpring utility which comes
 
2580
# with mutt.
 
2581
 
2582
# This is a format string, see the $pgp_decode_command command for
 
2583
# possible printf(3)-like sequences.
 
2584
# (PGP only)
 
2585
 
2586
 
2587
# set pgp_list_secring_command=""
 
2588
#
 
2589
# Name: pgp_list_secring_command
 
2590
# Type: string
 
2591
# Default: ""
 
2592
 
2593
 
2594
# This command is used to list the secret key ring's contents.  The
 
2595
# output format must be analogous to the one used by:
 
2596
# gpg --list-keys --with-colons.
 
2597
 
2598
# This format is also generated by the pgpring utility which comes
 
2599
# with mutt.
 
2600
 
2601
# This is a format string, see the $pgp_decode_command command for
 
2602
# possible printf(3)-like sequences.
2386
2603
# (PGP only)
2387
2604
2388
2605
2397
2614
# (PGP only)
2398
2615
2399
2616
2400
 
# set pgp_retainable_sigs=no
2401
 
#
2402
 
# Name: pgp_retainable_sigs
2403
 
# Type: boolean
2404
 
# Default: no
2405
 
2406
 
2407
 
# If set, signed and encrypted messages will consist of nested
2408
 
# multipart/signed and multipart/encrypted body parts.
2409
 
2410
 
# This is useful for applications like encrypted and signed mailing
2411
 
# lists, where the outer layer (multipart/encrypted) can be easily
2412
 
# removed, while the inner multipart/signed part is retained.
2413
 
# (PGP only)
2414
 
2415
 
2416
 
# set pgp_autoinline=no
2417
 
#
2418
 
# Name: pgp_autoinline
2419
 
# Type: boolean
2420
 
# Default: no
2421
 
2422
 
2423
 
# This option controls whether Mutt generates old-style inline
2424
 
# (traditional) PGP encrypted or signed messages under certain
2425
 
# circumstances.  This can be overridden by use of the pgp menu,
2426
 
# when inline is not required.
2427
 
2428
 
# Note that Mutt might automatically use PGP/MIME for messages
2429
 
# which consist of more than a single MIME part.  Mutt can be
2430
 
# configured to ask before sending PGP/MIME messages when inline
2431
 
# (traditional) would not work.
2432
 
2433
 
# Also see the $pgp_mime_auto variable.
 
2617
# set pgp_mime_auto=ask-yes
 
2618
#
 
2619
# Name: pgp_mime_auto
 
2620
# Type: quadoption
 
2621
# Default: ask-yes
 
2622
 
2623
 
2624
# This option controls whether Mutt will prompt you for
 
2625
# automatically sending a (signed/encrypted) message using
 
2626
# PGP/MIME when inline (traditional) fails (for any reason).
2434
2627
2435
2628
# Also note that using the old-style PGP message format is strongly
2436
2629
# deprecated.
2464
2657
# (PGP only)
2465
2658
2466
2659
 
2660
# set pgp_retainable_sigs=no
 
2661
#
 
2662
# Name: pgp_retainable_sigs
 
2663
# Type: boolean
 
2664
# Default: no
 
2665
 
2666
 
2667
# If set, signed and encrypted messages will consist of nested
 
2668
# multipart/signed and multipart/encrypted body parts.
 
2669
 
2670
# This is useful for applications like encrypted and signed mailing
 
2671
# lists, where the outer layer (multipart/encrypted) can be easily
 
2672
# removed, while the inner multipart/signed part is retained.
 
2673
# (PGP only)
 
2674
 
2675
2467
2676
# set pgp_show_unusable=yes
2468
2677
#
2469
2678
# Name: pgp_show_unusable
2490
2699
# (PGP only)
2491
2700
2492
2701
2493
 
# set pgp_strict_enc=yes
2494
 
#
2495
 
# Name: pgp_strict_enc
2496
 
# Type: boolean
2497
 
# Default: yes
2498
 
2499
 
2500
 
# If set, Mutt will automatically encode PGP/MIME signed messages as
2501
 
# quoted-printable.  Please note that unsetting this variable may
2502
 
# lead to problems with non-verifyable PGP signatures, so only change
2503
 
# this if you know what you are doing.
2504
 
# (PGP only)
2505
 
2506
 
2507
 
# set pgp_timeout=300
2508
 
#
2509
 
# Name: pgp_timeout
2510
 
# Type: number
2511
 
# Default: 300
2512
 
2513
 
2514
 
# The number of seconds after which a cached passphrase will expire if
2515
 
# not used.
 
2702
# set pgp_sign_command=""
 
2703
#
 
2704
# Name: pgp_sign_command
 
2705
# Type: string
 
2706
# Default: ""
 
2707
 
2708
 
2709
# This command is used to create the detached PGP signature for a
 
2710
# multipart/signed PGP/MIME body part.
 
2711
 
2712
# This is a format string, see the $pgp_decode_command command for
 
2713
# possible printf(3)-like sequences.
2516
2714
# (PGP only)
2517
2715
2518
2716
2536
2734
# (PGP only)
2537
2735
2538
2736
2539
 
# set pgp_mime_auto=ask-yes
2540
 
#
2541
 
# Name: pgp_mime_auto
2542
 
# Type: quadoption
2543
 
# Default: ask-yes
2544
 
2545
 
2546
 
# This option controls whether Mutt will prompt you for
2547
 
# automatically sending a (signed/encrypted) message using
2548
 
# PGP/MIME when inline (traditional) fails (for any reason).
2549
 
2550
 
# Also note that using the old-style PGP message format is strongly
2551
 
# deprecated.
2552
 
# (PGP only)
2553
 
2554
 
2555
 
# set pgp_auto_decode=no
2556
 
#
2557
 
# Name: pgp_auto_decode
 
2737
# set pgp_strict_enc=yes
 
2738
#
 
2739
# Name: pgp_strict_enc
 
2740
# Type: boolean
 
2741
# Default: yes
 
2742
 
2743
 
2744
# If set, Mutt will automatically encode PGP/MIME signed messages as
 
2745
# quoted-printable.  Please note that unsetting this variable may
 
2746
# lead to problems with non-verifyable PGP signatures, so only change
 
2747
# this if you know what you are doing.
 
2748
# (PGP only)
 
2749
 
2750
 
2751
# set pgp_timeout=300
 
2752
#
 
2753
# Name: pgp_timeout
 
2754
# Type: number
 
2755
# Default: 300
 
2756
 
2757
 
2758
# The number of seconds after which a cached passphrase will expire if
 
2759
# not used.
 
2760
# (PGP only)
 
2761
 
2762
 
2763
# set pgp_use_gpg_agent=no
 
2764
#
 
2765
# Name: pgp_use_gpg_agent
2558
2766
# Type: boolean
2559
2767
# Default: no
2560
2768
2561
2769
2562
 
# If set, mutt will automatically attempt to decrypt traditional PGP
2563
 
# messages whenever the user performs an operation which ordinarily would
2564
 
# result in the contents of the message being operated on.  For example,
2565
 
# if the user displays a pgp-traditional message which has not been manually
2566
 
# checked with the <check-traditional-pgp> function, mutt will automatically
2567
 
# check the message for traditional pgp.
2568
 
2569
 
2570
 
# set pgp_decode_command=""
2571
 
#
2572
 
# Name: pgp_decode_command
2573
 
# Type: string
2574
 
# Default: ""
2575
 
2576
 
2577
 
# This format strings specifies a command which is used to decode
2578
 
# application/pgp attachments.
2579
 
2580
 
# The PGP command formats have their own set of printf(3)-like sequences:
2581
 
# %p      Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
2582
 
#         string otherwise. Note: This may be used with a %? construct.
2583
 
# %f      Expands to the name of a file containing a message.
2584
 
# %s      Expands to the name of a file containing the signature part
2585
 
#                    of a multipart/signed attachment when verifying it.
2586
 
# %a      The value of $pgp_sign_as.
2587
 
# %r      One or more key IDs.
2588
 
2589
 
2590
 
# For examples on how to configure these formats for the various versions
2591
 
# of PGP which are floating around, see the pgp and gpg sample configuration files in
2592
 
# the samples/ subdirectory which has been installed on your system
2593
 
# alongside the documentation.
2594
 
# (PGP only)
2595
 
2596
 
2597
 
# set pgp_getkeys_command=""
2598
 
#
2599
 
# Name: pgp_getkeys_command
2600
 
# Type: string
2601
 
# Default: ""
2602
 
2603
 
2604
 
# This command is invoked whenever mutt will need public key information.
2605
 
# Of the sequences supported by $pgp_decode_command, %r is the only
2606
 
# printf(3)-like sequence used with this format.
 
2770
# If set, mutt will use a possibly-running gpg-agent(1) process.
2607
2771
# (PGP only)
2608
2772
2609
2773
2621
2785
# (PGP only)
2622
2786
2623
2787
2624
 
# set pgp_decrypt_command=""
2625
 
#
2626
 
# Name: pgp_decrypt_command
2627
 
# Type: string
2628
 
# Default: ""
2629
 
2630
 
2631
 
# This command is used to decrypt a PGP encrypted message.
2632
 
2633
 
# This is a format string, see the $pgp_decode_command command for
2634
 
# possible printf(3)-like sequences.
2635
 
# (PGP only)
2636
 
2637
 
2638
 
# set pgp_clearsign_command=""
2639
 
#
2640
 
# Name: pgp_clearsign_command
2641
 
# Type: string
2642
 
# Default: ""
2643
 
2644
 
2645
 
# This format is used to create a old-style ``clearsigned'' PGP
2646
 
# message.  Note that the use of this format is strongly
2647
 
# deprecated.
2648
 
2649
 
# This is a format string, see the $pgp_decode_command command for
2650
 
# possible printf(3)-like sequences.
2651
 
# (PGP only)
2652
 
2653
 
2654
 
# set pgp_sign_command=""
2655
 
#
2656
 
# Name: pgp_sign_command
2657
 
# Type: string
2658
 
# Default: ""
2659
 
2660
 
2661
 
# This command is used to create the detached PGP signature for a
2662
 
# multipart/signed PGP/MIME body part.
2663
 
2664
 
# This is a format string, see the $pgp_decode_command command for
2665
 
# possible printf(3)-like sequences.
2666
 
# (PGP only)
2667
 
2668
 
2669
 
# set pgp_encrypt_sign_command=""
2670
 
#
2671
 
# Name: pgp_encrypt_sign_command
2672
 
# Type: string
2673
 
# Default: ""
2674
 
2675
 
2676
 
# This command is used to both sign and encrypt a body part.
2677
 
2678
 
# This is a format string, see the $pgp_decode_command command for
2679
 
# possible printf(3)-like sequences.
2680
 
# (PGP only)
2681
 
2682
 
2683
 
# set pgp_encrypt_only_command=""
2684
 
#
2685
 
# Name: pgp_encrypt_only_command
2686
 
# Type: string
2687
 
# Default: ""
2688
 
2689
 
2690
 
# This command is used to encrypt a body part without signing it.
2691
 
2692
 
# This is a format string, see the $pgp_decode_command command for
2693
 
# possible printf(3)-like sequences.
2694
 
# (PGP only)
2695
 
2696
 
2697
 
# set pgp_import_command=""
2698
 
#
2699
 
# Name: pgp_import_command
2700
 
# Type: string
2701
 
# Default: ""
2702
 
2703
 
2704
 
# This command is used to import a key from a message into
2705
 
# the user's public key ring.
2706
 
2707
 
# This is a format string, see the $pgp_decode_command command for
2708
 
# possible printf(3)-like sequences.
2709
 
# (PGP only)
2710
 
2711
 
2712
 
# set pgp_export_command=""
2713
 
#
2714
 
# Name: pgp_export_command
2715
 
# Type: string
2716
 
# Default: ""
2717
 
2718
 
2719
 
# This command is used to export a public key from the user's
2720
 
# key ring.
2721
 
2722
 
# This is a format string, see the $pgp_decode_command command for
2723
 
# possible printf(3)-like sequences.
2724
 
# (PGP only)
2725
 
2726
 
2727
2788
# set pgp_verify_key_command=""
2728
2789
#
2729
2790
# Name: pgp_verify_key_command
2739
2800
# (PGP only)
2740
2801
2741
2802
2742
 
# set pgp_list_secring_command=""
2743
 
#
2744
 
# Name: pgp_list_secring_command
2745
 
# Type: string
2746
 
# Default: ""
2747
 
2748
 
2749
 
# This command is used to list the secret key ring's contents.  The
2750
 
# output format must be analogous to the one used by:
2751
 
# gpg --list-keys --with-colons.
2752
 
2753
 
# This format is also generated by the pgpring utility which comes
2754
 
# with mutt.
2755
 
2756
 
# This is a format string, see the $pgp_decode_command command for
2757
 
# possible printf(3)-like sequences.
2758
 
# (PGP only)
2759
 
2760
 
2761
 
# set pgp_list_pubring_command=""
2762
 
#
2763
 
# Name: pgp_list_pubring_command
2764
 
# Type: string
2765
 
# Default: ""
2766
 
2767
 
2768
 
# This command is used to list the public key ring's contents.  The
2769
 
# output format must be analogous to the one used by
2770
 
# gpg --list-keys --with-colons.
2771
 
2772
 
# This format is also generated by the pgpring utility which comes
2773
 
# with mutt.
2774
 
2775
 
# This is a format string, see the $pgp_decode_command command for
2776
 
# possible printf(3)-like sequences.
2777
 
# (PGP only)
2778
 
2779
 
2780
 
# set forward_decrypt=yes
2781
 
#
2782
 
# Name: forward_decrypt
2783
 
# Type: boolean
2784
 
# Default: yes
2785
 
2786
 
2787
 
# Controls the handling of encrypted messages when forwarding a message.
2788
 
# When set, the outer layer of encryption is stripped off.  This
2789
 
# variable is only used if $mime_forward is set and
2790
 
# $mime_forward_decode is unset.
2791
 
# (PGP only)
2792
 
2793
 
2794
 
# set smime_timeout=300
2795
 
#
2796
 
# Name: smime_timeout
2797
 
# Type: number
2798
 
# Default: 300
2799
 
2800
 
2801
 
# The number of seconds after which a cached passphrase will expire if
2802
 
# not used.
2803
 
# (S/MIME only)
2804
 
2805
 
2806
 
# set smime_encrypt_with=""
2807
 
#
2808
 
# Name: smime_encrypt_with
2809
 
# Type: string
2810
 
# Default: ""
2811
 
2812
 
2813
 
# This sets the algorithm that should be used for encryption.
2814
 
# Valid choices are ``des'', ``des3'', ``rc2-40'', ``rc2-64'', ``rc2-128''.
2815
 
# If unset, ``3des'' (TripleDES) is used.
2816
 
# (S/MIME only)
2817
 
2818
 
2819
 
# set smime_keys=""
2820
 
#
2821
 
# Name: smime_keys
2822
 
# Type: path
2823
 
# Default: ""
2824
 
2825
 
2826
 
# Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
2827
 
# storage and retrieval of keys/certs by itself. This is very basic right now,
2828
 
# and stores keys and certificates in two different directories, both
2829
 
# named as the hash-value retrieved from OpenSSL. There is an index file
2830
 
# which contains mailbox-address keyid pair, and which can be manually
2831
 
# edited. This option points to the location of the private keys.
2832
 
# (S/MIME only)
2833
 
2834
 
2835
 
# set smime_ca_location=""
2836
 
#
2837
 
# Name: smime_ca_location
2838
 
# Type: path
2839
 
# Default: ""
2840
 
2841
 
2842
 
# This variable contains the name of either a directory, or a file which
2843
 
# contains trusted certificates for use with OpenSSL.
2844
 
# (S/MIME only)
2845
 
2846
 
2847
 
# set smime_certificates=""
2848
 
#
2849
 
# Name: smime_certificates
2850
 
# Type: path
2851
 
# Default: ""
2852
 
2853
 
2854
 
# Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
2855
 
# storage and retrieval of keys by itself. This is very basic right
2856
 
# now, and keys and certificates are stored in two different
2857
 
# directories, both named as the hash-value retrieved from
2858
 
# OpenSSL. There is an index file which contains mailbox-address
2859
 
# keyid pairs, and which can be manually edited. This option points to
2860
 
# the location of the certificates.
2861
 
# (S/MIME only)
2862
 
2863
 
2864
 
# set smime_decrypt_command=""
2865
 
#
2866
 
# Name: smime_decrypt_command
2867
 
# Type: string
2868
 
# Default: ""
2869
 
2870
 
2871
 
# This format string specifies a command which is used to decrypt
2872
 
# application/x-pkcs7-mime attachments.
2873
 
2874
 
# The OpenSSL command formats have their own set of printf(3)-like sequences
2875
 
# similar to PGP's:
2876
 
# %f      Expands to the name of a file containing a message.
2877
 
# %s      Expands to the name of a file containing the signature part
2878
 
#                    of a multipart/signed attachment when verifying it.
2879
 
# %k      The key-pair specified with $smime_default_key
2880
 
# %c      One or more certificate IDs.
2881
 
# %a      The algorithm used for encryption.
2882
 
# %C      CA location:  Depending on whether $smime_ca_location
2883
 
#                    points to a directory or file, this expands to
2884
 
#                    ``-CApath $smime_ca_location'' or ``-CAfile $smime_ca_location''.
2885
 
2886
 
2887
 
# For examples on how to configure these formats, see the smime.rc in
2888
 
# the samples/ subdirectory which has been installed on your system
2889
 
# alongside the documentation.
2890
 
# (S/MIME only)
2891
 
2892
 
2893
 
# set smime_verify_command=""
2894
 
#
2895
 
# Name: smime_verify_command
2896
 
# Type: string
2897
 
# Default: ""
2898
 
2899
 
2900
 
# This command is used to verify S/MIME signatures of type multipart/signed.
2901
 
2902
 
# This is a format string, see the $smime_decrypt_command command for
2903
 
# possible printf(3)-like sequences.
2904
 
# (S/MIME only)
2905
 
2906
 
2907
 
# set smime_verify_opaque_command=""
2908
 
#
2909
 
# Name: smime_verify_opaque_command
2910
 
# Type: string
2911
 
# Default: ""
2912
 
2913
 
2914
 
# This command is used to verify S/MIME signatures of type
2915
 
# application/x-pkcs7-mime.
2916
 
2917
 
# This is a format string, see the $smime_decrypt_command command for
2918
 
# possible printf(3)-like sequences.
2919
 
# (S/MIME only)
2920
 
2921
 
2922
 
# set smime_sign_command=""
2923
 
#
2924
 
# Name: smime_sign_command
2925
 
# Type: string
2926
 
# Default: ""
2927
 
2928
 
2929
 
# This command is used to created S/MIME signatures of type
2930
 
# multipart/signed, which can be read by all mail clients.
2931
 
2932
 
# This is a format string, see the $smime_decrypt_command command for
2933
 
# possible printf(3)-like sequences.
2934
 
# (S/MIME only)
2935
 
2936
 
2937
 
# set smime_sign_opaque_command=""
2938
 
#
2939
 
# Name: smime_sign_opaque_command
2940
 
# Type: string
2941
 
# Default: ""
2942
 
2943
 
2944
 
# This command is used to created S/MIME signatures of type
2945
 
# application/x-pkcs7-signature, which can only be handled by mail
2946
 
# clients supporting the S/MIME extension.
2947
 
2948
 
# This is a format string, see the $smime_decrypt_command command for
2949
 
# possible printf(3)-like sequences.
2950
 
# (S/MIME only)
2951
 
2952
 
2953
 
# set smime_encrypt_command=""
2954
 
#
2955
 
# Name: smime_encrypt_command
2956
 
# Type: string
2957
 
# Default: ""
2958
 
2959
 
2960
 
# This command is used to create encrypted S/MIME messages.
2961
 
2962
 
# This is a format string, see the $smime_decrypt_command command for
2963
 
# possible printf(3)-like sequences.
2964
 
# (S/MIME only)
2965
 
2966
 
2967
 
# set smime_pk7out_command=""
2968
 
#
2969
 
# Name: smime_pk7out_command
2970
 
# Type: string
2971
 
# Default: ""
2972
 
2973
 
2974
 
# This command is used to extract PKCS7 structures of S/MIME signatures,
2975
 
# in order to extract the public X509 certificate(s).
2976
 
2977
 
# This is a format string, see the $smime_decrypt_command command for
2978
 
# possible printf(3)-like sequences.
2979
 
# (S/MIME only)
2980
 
2981
 
2982
 
# set smime_get_cert_command=""
2983
 
#
2984
 
# Name: smime_get_cert_command
2985
 
# Type: string
2986
 
# Default: ""
2987
 
2988
 
2989
 
# This command is used to extract X509 certificates from a PKCS7 structure.
2990
 
2991
 
# This is a format string, see the $smime_decrypt_command command for
2992
 
# possible printf(3)-like sequences.
2993
 
# (S/MIME only)
2994
 
2995
 
2996
 
# set smime_get_signer_cert_command=""
2997
 
#
2998
 
# Name: smime_get_signer_cert_command
2999
 
# Type: string
3000
 
# Default: ""
3001
 
3002
 
3003
 
# This command is used to extract only the signers X509 certificate from a S/MIME
3004
 
# signature, so that the certificate's owner may get compared to the
3005
 
# email's ``From:'' field.
3006
 
3007
 
# This is a format string, see the $smime_decrypt_command command for
3008
 
# possible printf(3)-like sequences.
3009
 
# (S/MIME only)
3010
 
3011
 
3012
 
# set smime_import_cert_command=""
3013
 
#
3014
 
# Name: smime_import_cert_command
3015
 
# Type: string
3016
 
# Default: ""
3017
 
3018
 
3019
 
# This command is used to import a certificate via smime_keys.
3020
 
3021
 
# This is a format string, see the $smime_decrypt_command command for
3022
 
# possible printf(3)-like sequences.
3023
 
# (S/MIME only)
3024
 
3025
 
3026
 
# set smime_get_cert_email_command=""
3027
 
#
3028
 
# Name: smime_get_cert_email_command
3029
 
# Type: string
3030
 
# Default: ""
3031
 
3032
 
3033
 
# This command is used to extract the mail address(es) used for storing
3034
 
# X509 certificates, and for verification purposes (to check whether the
3035
 
# certificate was issued for the sender's mailbox).
3036
 
3037
 
# This is a format string, see the $smime_decrypt_command command for
3038
 
# possible printf(3)-like sequences.
3039
 
# (S/MIME only)
3040
 
3041
 
3042
 
# set smime_default_key=""
3043
 
#
3044
 
# Name: smime_default_key
3045
 
# Type: string
3046
 
# Default: ""
3047
 
3048
 
3049
 
# This is the default key-pair to use for signing. This must be set to the
3050
 
# keyid (the hash-value that OpenSSL generates) to work properly
3051
 
# (S/MIME only)
3052
 
3053
 
3054
 
# set ssl_client_cert=""
3055
 
#
3056
 
# Name: ssl_client_cert
3057
 
# Type: path
3058
 
# Default: ""
3059
 
3060
 
3061
 
# The file containing a client certificate and its associated private
3062
 
# key.
3063
 
3064
 
3065
 
# set ssl_force_tls=no
3066
 
#
3067
 
# Name: ssl_force_tls
3068
 
# Type: boolean
3069
 
# Default: no
3070
 
3071
 
3072
 
# If this variable is set, Mutt will require that all connections
3073
 
# to remote servers be encrypted. Furthermore it will attempt to
3074
 
# negotiate TLS even if the server does not advertise the capability,
3075
 
# since it would otherwise have to abort the connection anyway. This
3076
 
# option supersedes $ssl_starttls.
3077
 
3078
 
3079
 
# set ssl_starttls=yes
3080
 
#
3081
 
# Name: ssl_starttls
3082
 
# Type: quadoption
3083
 
# Default: yes
3084
 
3085
 
3086
 
# If set (the default), mutt will attempt to use STARTTLS on servers
3087
 
# advertising the capability. When unset, mutt will not attempt to
3088
 
# use STARTTLS regardless of the server's capabilities.
3089
 
3090
 
3091
 
# set certificate_file="~/.mutt_certificates"
3092
 
#
3093
 
# Name: certificate_file
3094
 
# Type: path
3095
 
# Default: "~/.mutt_certificates"
3096
 
3097
 
3098
 
# This variable specifies the file where the certificates you trust
3099
 
# are saved. When an unknown certificate is encountered, you are asked
3100
 
# if you accept it or not. If you accept it, the certificate can also
3101
 
# be saved in this file and further connections are automatically
3102
 
# accepted.
3103
 
3104
 
# You can also manually add CA certificates in this file. Any server
3105
 
# certificate that is signed with one of these CA certificates is
3106
 
# also automatically accepted.
3107
 
3108
 
# Example:
3109
 
# set certificate_file=~/.mutt/certificates
3110
 
3111
 
3112
 
# set ssl_usesystemcerts=yes
3113
 
#
3114
 
# Name: ssl_usesystemcerts
3115
 
# Type: boolean
3116
 
# Default: yes
3117
 
3118
 
3119
 
# If set to yes, mutt will use CA certificates in the
3120
 
# system-wide certificate store when checking if a server certificate
3121
 
# is signed by a trusted CA.
3122
 
3123
 
3124
 
# set entropy_file=""
3125
 
#
3126
 
# Name: entropy_file
3127
 
# Type: path
3128
 
# Default: ""
3129
 
3130
 
3131
 
# The file which includes random data that is used to initialize SSL
3132
 
# library functions.
3133
 
3134
 
3135
 
# set ssl_use_sslv2=yes
3136
 
#
3137
 
# Name: ssl_use_sslv2
3138
 
# Type: boolean
3139
 
# Default: yes
3140
 
3141
 
3142
 
# This variables specifies whether to attempt to use SSLv2 in the
3143
 
# SSL authentication process.
3144
 
3145
 
3146
 
# set ssl_use_sslv3=yes
3147
 
#
3148
 
# Name: ssl_use_sslv3
3149
 
# Type: boolean
3150
 
# Default: yes
3151
 
3152
 
3153
 
# This variables specifies whether to attempt to use SSLv3 in the
3154
 
# SSL authentication process.
3155
 
3156
 
3157
 
# set ssl_use_tlsv1=yes
3158
 
#
3159
 
# Name: ssl_use_tlsv1
3160
 
# Type: boolean
3161
 
# Default: yes
3162
 
3163
 
3164
 
# This variables specifies whether to attempt to use TLSv1 in the
3165
 
# SSL authentication process.
3166
 
3167
 
3168
 
# set ssl_min_dh_prime_bits=0
3169
 
#
3170
 
# Name: ssl_min_dh_prime_bits
3171
 
# Type: number
3172
 
# Default: 0
3173
 
3174
 
3175
 
# This variable specifies the minimum acceptable prime size (in bits)
3176
 
# for use in any Diffie-Hellman key exchange. A value of 0 will use
3177
 
# the default from the GNUTLS library.
3178
 
3179
 
3180
 
# set ssl_ca_certificates_file=""
3181
 
#
3182
 
# Name: ssl_ca_certificates_file
3183
 
# Type: path
3184
 
# Default: ""
3185
 
3186
 
3187
 
# This variable specifies a file containing trusted CA certificates.
3188
 
# Any server certificate that is signed with one of these CA
3189
 
# certificates is also automatically accepted.
3190
 
3191
 
# Example:
3192
 
# set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
3193
 
3194
 
3195
 
# set pipe_split=no
3196
 
#
3197
 
# Name: pipe_split
3198
 
# Type: boolean
3199
 
# Default: no
3200
 
3201
 
3202
 
# Used in connection with the <pipe-message> function following
3203
 
# <tag-prefix>.  If this variable is unset, when piping a list of
3204
 
# tagged messages Mutt will concatenate the messages and will pipe them
3205
 
# all concatenated.  When set, Mutt will pipe the messages one by one.
3206
 
# In both cases the messages are piped in the current sorted order,
3207
 
# and the $pipe_sep separator is added after each message.
3208
 
3209
 
3210
2803
# set pipe_decode=no
3211
2804
#
3212
2805
# Name: pipe_decode
3231
2824
# messages to an external Unix command.
3232
2825
3233
2826
 
2827
# set pipe_split=no
 
2828
#
 
2829
# Name: pipe_split
 
2830
# Type: boolean
 
2831
# Default: no
 
2832
 
2833
 
2834
# Used in connection with the <pipe-message> function following
 
2835
# <tag-prefix>.  If this variable is unset, when piping a list of
 
2836
# tagged messages Mutt will concatenate the messages and will pipe them
 
2837
# all concatenated.  When set, Mutt will pipe the messages one by one.
 
2838
# In both cases the messages are piped in the current sorted order,
 
2839
# and the $pipe_sep separator is added after each message.
 
2840
 
2841
 
2842
# set pop_auth_try_all=yes
 
2843
#
 
2844
# Name: pop_auth_try_all
 
2845
# Type: boolean
 
2846
# Default: yes
 
2847
 
2848
 
2849
# If set, Mutt will try all available authentication methods.
 
2850
# When unset, Mutt will only fall back to other authentication
 
2851
# methods if the previous methods are unavailable. If a method is
 
2852
# available but authentication fails, Mutt will not connect to the POP server.
 
2853
 
2854
3234
2855
# set pop_authenticators=""
3235
2856
#
3236
2857
# Name: pop_authenticators
3250
2871
# set pop_authenticators="digest-md5:apop:user"
3251
2872
3252
2873
3253
 
# set pop_auth_try_all=yes
3254
 
#
3255
 
# Name: pop_auth_try_all
3256
 
# Type: boolean
3257
 
# Default: yes
3258
 
3259
 
3260
 
# If set, Mutt will try all available authentication methods.
3261
 
# When unset, Mutt will only fall back to other authentication
3262
 
# methods if the previous methods are unavailable. If a method is
3263
 
# available but authentication fails, Mutt will not connect to the POP server.
3264
 
3265
 
3266
2874
# set pop_checkinterval=60
3267
2875
#
3268
2876
# Name: pop_checkinterval
3312
2920
# the <fetch-mail> function.
3313
2921
3314
2922
 
2923
# set pop_pass=""
 
2924
#
 
2925
# Name: pop_pass
 
2926
# Type: string
 
2927
# Default: ""
 
2928
 
2929
 
2930
# Specifies the password for your POP account.  If unset, Mutt will
 
2931
# prompt you for your password when you open a POP mailbox.
 
2932
 
2933
# Warning: you should only use this option when you are on a
 
2934
# fairly secure machine, because the superuser can read your muttrc
 
2935
# even if you are the only one who can read the file.
 
2936
 
2937
3315
2938
# set pop_reconnect=ask-yes
3316
2939
#
3317
2940
# Name: pop_reconnect
3335
2958
# This variable defaults to your user name on the local machine.
3336
2959
3337
2960
3338
 
# set pop_pass=""
3339
 
#
3340
 
# Name: pop_pass
3341
 
# Type: string
3342
 
# Default: ""
3343
 
3344
 
3345
 
# Specifies the password for your POP account.  If unset, Mutt will
3346
 
# prompt you for your password when you open a POP mailbox.
3347
 
3348
 
# Warning: you should only use this option when you are on a
3349
 
# fairly secure machine, because the superuser can read your muttrc
3350
 
# even if you are the only one who can read the file.
3351
 
3352
 
3353
2961
# set post_indent_string=""
3354
2962
#
3355
2963
# Name: post_indent_string
3861
3469
# of this variable will never mark a message read.
3862
3470
3863
3471
 
3472
# set search_context=0
 
3473
#
 
3474
# Name: search_context
 
3475
# Type: number
 
3476
# Default: 0
 
3477
 
3478
 
3479
# For the pager, this variable specifies the number of lines shown
 
3480
# before search results. By default, search results will be top-aligned.
 
3481
 
3482
3864
3483
# set send_charset="us-ascii:iso-8859-1:utf-8"
3865
3484
#
3866
3485
# Name: send_charset
3982
3601
# For the default value, ``joe'' would be expanded to: ``~f joe | ~s joe''.
3983
3602
3984
3603
 
3604
# set sleep_time=1
 
3605
#
 
3606
# Name: sleep_time
 
3607
# Type: number
 
3608
# Default: 1
 
3609
 
3610
 
3611
# Specifies time, in seconds, to pause while displaying certain informational
 
3612
# messages, while moving from folder to folder and after expunging
 
3613
# messages from the current folder.  The default is to pause one second, so
 
3614
# a value of zero for this option suppresses the pause.
 
3615
 
3616
3985
3617
# set smart_wrap=yes
3986
3618
#
3987
3619
# Name: smart_wrap
4008
3640
# happens at the beginning of a line.
4009
3641
4010
3642
4011
 
# set sleep_time=1
4012
 
#
4013
 
# Name: sleep_time
 
3643
# set smime_ask_cert_label=yes
 
3644
#
 
3645
# Name: smime_ask_cert_label
 
3646
# Type: boolean
 
3647
# Default: yes
 
3648
 
3649
 
3650
# This flag controls whether you want to be asked to enter a label
 
3651
# for a certificate about to be added to the database or not. It is
 
3652
# set by default.
 
3653
# (S/MIME only)
 
3654
 
3655
 
3656
# set smime_ca_location=""
 
3657
#
 
3658
# Name: smime_ca_location
 
3659
# Type: path
 
3660
# Default: ""
 
3661
 
3662
 
3663
# This variable contains the name of either a directory, or a file which
 
3664
# contains trusted certificates for use with OpenSSL.
 
3665
# (S/MIME only)
 
3666
 
3667
 
3668
# set smime_certificates=""
 
3669
#
 
3670
# Name: smime_certificates
 
3671
# Type: path
 
3672
# Default: ""
 
3673
 
3674
 
3675
# Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
 
3676
# storage and retrieval of keys by itself. This is very basic right
 
3677
# now, and keys and certificates are stored in two different
 
3678
# directories, both named as the hash-value retrieved from
 
3679
# OpenSSL. There is an index file which contains mailbox-address
 
3680
# keyid pairs, and which can be manually edited. This option points to
 
3681
# the location of the certificates.
 
3682
# (S/MIME only)
 
3683
 
3684
 
3685
# set smime_decrypt_command=""
 
3686
#
 
3687
# Name: smime_decrypt_command
 
3688
# Type: string
 
3689
# Default: ""
 
3690
 
3691
 
3692
# This format string specifies a command which is used to decrypt
 
3693
# application/x-pkcs7-mime attachments.
 
3694
 
3695
# The OpenSSL command formats have their own set of printf(3)-like sequences
 
3696
# similar to PGP's:
 
3697
# %f      Expands to the name of a file containing a message.
 
3698
# %s      Expands to the name of a file containing the signature part
 
3699
#                    of a multipart/signed attachment when verifying it.
 
3700
# %k      The key-pair specified with $smime_default_key
 
3701
# %c      One or more certificate IDs.
 
3702
# %a      The algorithm used for encryption.
 
3703
# %C      CA location:  Depending on whether $smime_ca_location
 
3704
#                    points to a directory or file, this expands to
 
3705
#                    ``-CApath $smime_ca_location'' or ``-CAfile $smime_ca_location''.
 
3706
 
3707
 
3708
# For examples on how to configure these formats, see the smime.rc in
 
3709
# the samples/ subdirectory which has been installed on your system
 
3710
# alongside the documentation.
 
3711
# (S/MIME only)
 
3712
 
3713
 
3714
# set smime_decrypt_use_default_key=yes
 
3715
#
 
3716
# Name: smime_decrypt_use_default_key
 
3717
# Type: boolean
 
3718
# Default: yes
 
3719
 
3720
 
3721
# If set (default) this tells mutt to use the default key for decryption. Otherwise,
 
3722
# if managing multiple certificate-key-pairs, mutt will try to use the mailbox-address
 
3723
# to determine the key to use. It will ask you to supply a key, if it can't find one.
 
3724
# (S/MIME only)
 
3725
 
3726
 
3727
# set smime_default_key=""
 
3728
#
 
3729
# Name: smime_default_key
 
3730
# Type: string
 
3731
# Default: ""
 
3732
 
3733
 
3734
# This is the default key-pair to use for signing. This must be set to the
 
3735
# keyid (the hash-value that OpenSSL generates) to work properly
 
3736
# (S/MIME only)
 
3737
 
3738
 
3739
# set smime_encrypt_command=""
 
3740
#
 
3741
# Name: smime_encrypt_command
 
3742
# Type: string
 
3743
# Default: ""
 
3744
 
3745
 
3746
# This command is used to create encrypted S/MIME messages.
 
3747
 
3748
# This is a format string, see the $smime_decrypt_command command for
 
3749
# possible printf(3)-like sequences.
 
3750
# (S/MIME only)
 
3751
 
3752
 
3753
# set smime_encrypt_with=""
 
3754
#
 
3755
# Name: smime_encrypt_with
 
3756
# Type: string
 
3757
# Default: ""
 
3758
 
3759
 
3760
# This sets the algorithm that should be used for encryption.
 
3761
# Valid choices are ``des'', ``des3'', ``rc2-40'', ``rc2-64'', ``rc2-128''.
 
3762
# If unset, ``3des'' (TripleDES) is used.
 
3763
# (S/MIME only)
 
3764
 
3765
 
3766
# set smime_get_cert_command=""
 
3767
#
 
3768
# Name: smime_get_cert_command
 
3769
# Type: string
 
3770
# Default: ""
 
3771
 
3772
 
3773
# This command is used to extract X509 certificates from a PKCS7 structure.
 
3774
 
3775
# This is a format string, see the $smime_decrypt_command command for
 
3776
# possible printf(3)-like sequences.
 
3777
# (S/MIME only)
 
3778
 
3779
 
3780
# set smime_get_cert_email_command=""
 
3781
#
 
3782
# Name: smime_get_cert_email_command
 
3783
# Type: string
 
3784
# Default: ""
 
3785
 
3786
 
3787
# This command is used to extract the mail address(es) used for storing
 
3788
# X509 certificates, and for verification purposes (to check whether the
 
3789
# certificate was issued for the sender's mailbox).
 
3790
 
3791
# This is a format string, see the $smime_decrypt_command command for
 
3792
# possible printf(3)-like sequences.
 
3793
# (S/MIME only)
 
3794
 
3795
 
3796
# set smime_get_signer_cert_command=""
 
3797
#
 
3798
# Name: smime_get_signer_cert_command
 
3799
# Type: string
 
3800
# Default: ""
 
3801
 
3802
 
3803
# This command is used to extract only the signers X509 certificate from a S/MIME
 
3804
# signature, so that the certificate's owner may get compared to the
 
3805
# email's ``From:'' field.
 
3806
 
3807
# This is a format string, see the $smime_decrypt_command command for
 
3808
# possible printf(3)-like sequences.
 
3809
# (S/MIME only)
 
3810
 
3811
 
3812
# set smime_import_cert_command=""
 
3813
#
 
3814
# Name: smime_import_cert_command
 
3815
# Type: string
 
3816
# Default: ""
 
3817
 
3818
 
3819
# This command is used to import a certificate via smime_keys.
 
3820
 
3821
# This is a format string, see the $smime_decrypt_command command for
 
3822
# possible printf(3)-like sequences.
 
3823
# (S/MIME only)
 
3824
 
3825
 
3826
# set smime_is_default=no
 
3827
#
 
3828
# Name: smime_is_default
 
3829
# Type: boolean
 
3830
# Default: no
 
3831
 
3832
 
3833
# The default behaviour of mutt is to use PGP on all auto-sign/encryption
 
3834
# operations. To override and to use OpenSSL instead this must be set.
 
3835
# However, this has no effect while replying, since mutt will automatically
 
3836
# select the same application that was used to sign/encrypt the original
 
3837
# message.  (Note that this variable can be overridden by unsetting $crypt_autosmime.)
 
3838
# (S/MIME only)
 
3839
 
3840
 
3841
# set smime_keys=""
 
3842
#
 
3843
# Name: smime_keys
 
3844
# Type: path
 
3845
# Default: ""
 
3846
 
3847
 
3848
# Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
 
3849
# storage and retrieval of keys/certs by itself. This is very basic right now,
 
3850
# and stores keys and certificates in two different directories, both
 
3851
# named as the hash-value retrieved from OpenSSL. There is an index file
 
3852
# which contains mailbox-address keyid pair, and which can be manually
 
3853
# edited. This option points to the location of the private keys.
 
3854
# (S/MIME only)
 
3855
 
3856
 
3857
# set smime_pk7out_command=""
 
3858
#
 
3859
# Name: smime_pk7out_command
 
3860
# Type: string
 
3861
# Default: ""
 
3862
 
3863
 
3864
# This command is used to extract PKCS7 structures of S/MIME signatures,
 
3865
# in order to extract the public X509 certificate(s).
 
3866
 
3867
# This is a format string, see the $smime_decrypt_command command for
 
3868
# possible printf(3)-like sequences.
 
3869
# (S/MIME only)
 
3870
 
3871
 
3872
# set smime_sign_command=""
 
3873
#
 
3874
# Name: smime_sign_command
 
3875
# Type: string
 
3876
# Default: ""
 
3877
 
3878
 
3879
# This command is used to created S/MIME signatures of type
 
3880
# multipart/signed, which can be read by all mail clients.
 
3881
 
3882
# This is a format string, see the $smime_decrypt_command command for
 
3883
# possible printf(3)-like sequences.
 
3884
# (S/MIME only)
 
3885
 
3886
 
3887
# set smime_sign_opaque_command=""
 
3888
#
 
3889
# Name: smime_sign_opaque_command
 
3890
# Type: string
 
3891
# Default: ""
 
3892
 
3893
 
3894
# This command is used to created S/MIME signatures of type
 
3895
# application/x-pkcs7-signature, which can only be handled by mail
 
3896
# clients supporting the S/MIME extension.
 
3897
 
3898
# This is a format string, see the $smime_decrypt_command command for
 
3899
# possible printf(3)-like sequences.
 
3900
# (S/MIME only)
 
3901
 
3902
 
3903
# set smime_timeout=300
 
3904
#
 
3905
# Name: smime_timeout
4014
3906
# Type: number
4015
 
# Default: 1
4016
 
4017
 
4018
 
# Specifies time, in seconds, to pause while displaying certain informational
4019
 
# messages, while moving from folder to folder and after expunging
4020
 
# messages from the current folder.  The default is to pause one second, so
4021
 
# a value of zero for this option suppresses the pause.
 
3907
# Default: 300
 
3908
 
3909
 
3910
# The number of seconds after which a cached passphrase will expire if
 
3911
# not used.
 
3912
# (S/MIME only)
 
3913
 
3914
 
3915
# set smime_verify_command=""
 
3916
#
 
3917
# Name: smime_verify_command
 
3918
# Type: string
 
3919
# Default: ""
 
3920
 
3921
 
3922
# This command is used to verify S/MIME signatures of type multipart/signed.
 
3923
 
3924
# This is a format string, see the $smime_decrypt_command command for
 
3925
# possible printf(3)-like sequences.
 
3926
# (S/MIME only)
 
3927
 
3928
 
3929
# set smime_verify_opaque_command=""
 
3930
#
 
3931
# Name: smime_verify_opaque_command
 
3932
# Type: string
 
3933
# Default: ""
 
3934
 
3935
 
3936
# This command is used to verify S/MIME signatures of type
 
3937
# application/x-pkcs7-mime.
 
3938
 
3939
# This is a format string, see the $smime_decrypt_command command for
 
3940
# possible printf(3)-like sequences.
 
3941
# (S/MIME only)
4022
3942
4023
3943
4024
3944
# set smtp_authenticators=""
4067
3987
# delivery. This should take the form of an SMTP URL, eg:
4068
3988
# smtp[s]://[user[:pass]@]host[:port]/
4069
3989
4070
 
# ... where ``[...]'' denotes an optional part.
 
3990
# where ``[...]'' denotes an optional part.
4071
3991
# Setting this variable overrides the value of the $sendmail
4072
3992
# variable.
4073
3993
4196
4116
4197
4117
# If your spool mailbox is in a non-default place where Mutt cannot find
4198
4118
# it, you can specify its location with this variable.  Mutt will
4199
 
# automatically set this variable to the value of the environment
4200
 
# variable $MAIL if it is not set.
 
4119
# initially set this variable to the value of the environment
 
4120
# variable $MAIL or $MAILDIR if either is defined.
 
4121
 
4122
 
4123
# set ssl_ca_certificates_file=""
 
4124
#
 
4125
# Name: ssl_ca_certificates_file
 
4126
# Type: path
 
4127
# Default: ""
 
4128
 
4129
 
4130
# This variable specifies a file containing trusted CA certificates.
 
4131
# Any server certificate that is signed with one of these CA
 
4132
# certificates is also automatically accepted.
 
4133
 
4134
# Example:
 
4135
# set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
 
4136
 
4137
 
4138
# set ssl_client_cert=""
 
4139
#
 
4140
# Name: ssl_client_cert
 
4141
# Type: path
 
4142
# Default: ""
 
4143
 
4144
 
4145
# The file containing a client certificate and its associated private
 
4146
# key.
 
4147
 
4148
 
4149
# set ssl_force_tls=no
 
4150
#
 
4151
# Name: ssl_force_tls
 
4152
# Type: boolean
 
4153
# Default: no
 
4154
 
4155
 
4156
# If this variable is set, Mutt will require that all connections
 
4157
# to remote servers be encrypted. Furthermore it will attempt to
 
4158
# negotiate TLS even if the server does not advertise the capability,
 
4159
# since it would otherwise have to abort the connection anyway. This
 
4160
# option supersedes $ssl_starttls.
 
4161
 
4162
 
4163
# set ssl_min_dh_prime_bits=0
 
4164
#
 
4165
# Name: ssl_min_dh_prime_bits
 
4166
# Type: number
 
4167
# Default: 0
 
4168
 
4169
 
4170
# This variable specifies the minimum acceptable prime size (in bits)
 
4171
# for use in any Diffie-Hellman key exchange. A value of 0 will use
 
4172
# the default from the GNUTLS library.
 
4173
 
4174
 
4175
# set ssl_starttls=yes
 
4176
#
 
4177
# Name: ssl_starttls
 
4178
# Type: quadoption
 
4179
# Default: yes
 
4180
 
4181
 
4182
# If set (the default), mutt will attempt to use STARTTLS on servers
 
4183
# advertising the capability. When unset, mutt will not attempt to
 
4184
# use STARTTLS regardless of the server's capabilities.
 
4185
 
4186
 
4187
# set ssl_use_sslv2=no
 
4188
#
 
4189
# Name: ssl_use_sslv2
 
4190
# Type: boolean
 
4191
# Default: no
 
4192
 
4193
 
4194
# This variable specifies whether to attempt to use SSLv2 in the
 
4195
# SSL authentication process.
 
4196
 
4197
 
4198
# set ssl_use_sslv3=yes
 
4199
#
 
4200
# Name: ssl_use_sslv3
 
4201
# Type: boolean
 
4202
# Default: yes
 
4203
 
4204
 
4205
# This variable specifies whether to attempt to use SSLv3 in the
 
4206
# SSL authentication process.
 
4207
 
4208
 
4209
# set ssl_use_tlsv1=yes
 
4210
#
 
4211
# Name: ssl_use_tlsv1
 
4212
# Type: boolean
 
4213
# Default: yes
 
4214
 
4215
 
4216
# This variable specifies whether to attempt to use TLSv1 in the
 
4217
# SSL authentication process.
 
4218
 
4219
 
4220
# set ssl_usesystemcerts=yes
 
4221
#
 
4222
# Name: ssl_usesystemcerts
 
4223
# Type: boolean
 
4224
# Default: yes
 
4225
 
4226
 
4227
# If set to yes, mutt will use CA certificates in the
 
4228
# system-wide certificate store when checking if a server certificate
 
4229
# is signed by a trusted CA.
 
4230
 
4231
 
4232
# set ssl_verify_dates=yes
 
4233
#
 
4234
# Name: ssl_verify_dates
 
4235
# Type: boolean
 
4236
# Default: yes
 
4237
 
4238
 
4239
# If set (the default), mutt will not automatically accept a server
 
4240
# certificate that is either not yet valid or already expired. You should
 
4241
# only unset this for particular known hosts, using the
 
4242
# <account-hook> function.
 
4243
 
4244
 
4245
# set ssl_verify_host=yes
 
4246
#
 
4247
# Name: ssl_verify_host
 
4248
# Type: boolean
 
4249
# Default: yes
 
4250
 
4251
 
4252
# If set (the default), mutt will not automatically accept a server
 
4253
# certificate whose host name does not match the host used in your folder
 
4254
# URL. You should only unset this for particular known hosts, using
 
4255
# the <account-hook> function.
4201
4256
4202
4257
4203
4258
# set status_chars="-*%A"
4353
4408
# Note that $indent_string is ignored when this option is set.
4354
4409
4355
4410
4356
 
# set thread_received=no
4357
 
#
4358
 
# Name: thread_received
4359
 
# Type: boolean
4360
 
# Default: no
4361
 
4362
 
4363
 
# When set, mutt uses the date received rather than the date sent
4364
 
# to thread messages by subject.
4365
 
4366
 
4367
4411
# set thorough_search=no
4368
4412
#
4369
4413
# Name: thorough_search
4383
4427
# headers) which may lead to incorrect search results.
4384
4428
4385
4429
 
4430
# set thread_received=no
 
4431
#
 
4432
# Name: thread_received
 
4433
# Type: boolean
 
4434
# Default: no
 
4435
 
4436
 
4437
# When set, mutt uses the date received rather than the date sent
 
4438
# to thread messages by subject.
 
4439
 
4440
4386
4441
# set tilde=no
4387
4442
#
4388
4443
# Name: tilde
4477
4532
# Note: For this example to work you must be able to log in to the remote
4478
4533
# machine without having to enter a password.
4479
4534
 
4535
# When set, Mutt uses the tunnel for all remote connections.
 
4536
# Please see ``account-hook'' in the manual for how to use different
 
4537
# tunnel commands per connection.
 
4538
 
4539
 
4540
# set uncollapse_jump=no
 
4541
#
 
4542
# Name: uncollapse_jump
 
4543
# Type: boolean
 
4544
# Default: no
 
4545
 
4546
 
4547
# When set, Mutt will jump to the next unread message, if any,
 
4548
# when the current thread is uncollapsed.
 
4549
4480
4550
4481
4551
# set use_8bitmime=no
4482
4552
#
4649
4719
# (DEPRECATED) Equivalent to setting $wrap with a negative value.
4650
4720
4651
4721
4652
 
# set write_inc=10
4653
 
#
4654
 
# Name: write_inc
4655
 
# Type: number
4656
 
# Default: 10
4657
 
4658
 
4659
 
# When writing a mailbox, a message will be printed every
4660
 
# $write_inc messages to indicate progress.  If set to 0, only a
4661
 
# single message will be displayed before writing a mailbox.
4662
 
4663
 
# Also see the $read_inc, $net_inc and $time_inc variables and the
4664
 
# ``tuning'' section of the manual for performance considerations.
4665
 
4666
 
4667
4722
# set write_bcc=yes
4668
4723
#
4669
4724
# Name: write_bcc
4678
4733
# in this case.
4679
4734
4680
4735
 
4736
# set write_inc=10
 
4737
#
 
4738
# Name: write_inc
 
4739
# Type: number
 
4740
# Default: 10
 
4741
 
4742
 
4743
# When writing a mailbox, a message will be printed every
 
4744
# $write_inc messages to indicate progress.  If set to 0, only a
 
4745
# single message will be displayed before writing a mailbox.
 
4746
 
4747
# Also see the $read_inc, $net_inc and $time_inc variables and the
 
4748
# ``tuning'' section of the manual for performance considerations.
 
4749
 
4750