3 * Copyright (C) 1996-2002 Michael R. Elkins <me@mutt.org>
4 * Copyright (C) 2004 g10 Code GmbH
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
27 # include <unistd.h> /* needed for SEEK_SET */
30 # include <unix.h> /* needed for snprintf on QNX. */
32 #include <sys/types.h>
41 #if defined(HAVE_WCTYPE_H) && defined(HAVE_WC_FUNCS)
45 #ifndef _POSIX_PATH_MAX
60 # define MB_LEN_MAX 16
63 #define MUTT_VERSION (VERSION)
65 /* nifty trick I stole from ELM 2.5alpha. */
68 #define INITVAL(x) = x
74 #define WHERE_DEFINED 1
76 #include "mutt_regex.h"
78 /* flags for mutt_copy_header() */
79 #define CH_UPDATE 1 /* update the status and x-status fields? */
80 #define CH_WEED (1<<1) /* weed the headers? */
81 #define CH_DECODE (1<<2) /* do RFC1522 decoding? */
82 #define CH_XMIT (1<<3) /* transmitting this message? */
83 #define CH_FROM (1<<4) /* retain the "From " message separator? */
84 #define CH_PREFIX (1<<5) /* use Prefix string? */
85 #define CH_NOSTATUS (1<<6) /* supress the status and x-status fields */
86 #define CH_REORDER (1<<7) /* Re-order output of headers */
87 #define CH_NONEWLINE (1<<8) /* don't output terminating newline */
88 #define CH_MIME (1<<9) /* ignore MIME fields */
89 #define CH_UPDATE_LEN (1<<10) /* update Lines: and Content-Length: */
90 #define CH_TXTPLAIN (1<<11) /* generate text/plain MIME headers */
91 #define CH_NOLEN (1<<12) /* don't write Content-Length: and Lines: */
92 #define CH_WEED_DELIVERED (1<<13) /* weed eventual Delivered-To headers */
93 #define CH_FORCE_FROM (1<<14) /* give CH_FROM precedence over CH_WEED? */
94 #define CH_NOQFROM (1<<15) /* give CH_FROM precedence over CH_WEED? */
95 #define CH_UPDATE_IRT (1<<16) /* update In-Reply-To: */
96 #define CH_UPDATE_REFS (1<<17) /* update References: */
98 /* flags for mutt_enter_string() */
99 #define M_ALIAS 1 /* do alias "completion" by calling up the alias-menu */
100 #define M_FILE (1<<1) /* do file completion */
101 #define M_EFILE (1<<2) /* do file completion, plus incoming folders */
102 #define M_CMD (1<<3) /* do completion on previous word */
103 #define M_PASS (1<<4) /* password mode (no echo) */
104 #define M_CLEAR (1<<5) /* clear input if printable character is pressed */
105 #define M_COMMAND (1<<6) /* do command completion */
106 #define M_PATTERN (1<<7) /* pattern mode - only used for history classes */
108 /* flags for mutt_get_token() */
109 #define M_TOKEN_EQUAL 1 /* treat '=' as a special */
110 #define M_TOKEN_CONDENSE (1<<1) /* ^(char) to control chars (macros) */
111 #define M_TOKEN_SPACE (1<<2) /* don't treat whitespace as a term */
112 #define M_TOKEN_QUOTE (1<<3) /* don't interpret quotes */
113 #define M_TOKEN_PATTERN (1<<4) /* !)|~ are terms (for patterns) */
114 #define M_TOKEN_COMMENT (1<<5) /* don't reap comments */
115 #define M_TOKEN_SEMICOLON (1<<6) /* don't treat ; as special */
117 /* flags for km_dokey() */
118 #define M_KM_UNBUFFERED 1 /* don't read from the key buffer */
122 char *data; /* pointer to data */
123 char *dptr; /* current read/write position */
124 size_t dsize; /* length of data */
125 int destroy; /* destroy `data' when done? */
130 int ch; /* raw key pressed */
131 int op; /* function op */
134 /* flags for _mutt_system() */
135 #define M_DETACH_PROCESS 1 /* detach subprocess from group */
137 /* flags for mutt_FormatString() */
140 M_FORMAT_FORCESUBJ = (1<<0), /* print the subject even if unchanged */
141 M_FORMAT_TREE = (1<<1), /* draw the thread tree */
142 M_FORMAT_MAKEPRINT = (1<<2), /* make sure that all chars are printable */
143 M_FORMAT_OPTIONAL = (1<<3),
144 M_FORMAT_STAT_FILE = (1<<4), /* used by mutt_attach_fmt */
145 M_FORMAT_ARROWCURSOR = (1<<5), /* reserve space for arrow_cursor */
146 M_FORMAT_INDEX = (1<<6), /* this is a main index entry */
147 M_FORMAT_NOFILTER = (1<<7) /* do not allow filtering on this pass */
150 /* types for mutt_add_hook() */
151 #define M_FOLDERHOOK 1
152 #define M_MBOXHOOK (1<<1)
153 #define M_SENDHOOK (1<<2)
154 #define M_FCCHOOK (1<<3)
155 #define M_SAVEHOOK (1<<4)
156 #define M_CHARSETHOOK (1<<5)
157 #define M_ICONVHOOK (1<<6)
158 #define M_MESSAGEHOOK (1<<7)
159 #define M_CRYPTHOOK (1<<8)
160 #define M_ACCOUNTHOOK (1<<9)
161 #define M_REPLYHOOK (1<<10)
162 #define M_SEND2HOOK (1<<11)
164 /* tree characters for linearize_tree and print_enriched_string */
165 #define M_TREE_LLCORNER 1
166 #define M_TREE_ULCORNER 2
167 #define M_TREE_LTEE 3
168 #define M_TREE_HLINE 4
169 #define M_TREE_VLINE 5
170 #define M_TREE_SPACE 6
171 #define M_TREE_RARROW 7
172 #define M_TREE_STAR 8
173 #define M_TREE_HIDDEN 9
174 #define M_TREE_EQUALS 10
175 #define M_TREE_TTEE 11
176 #define M_TREE_BTEE 12
177 #define M_TREE_MISSING 13
178 #define M_TREE_MAX 14
180 #define M_THREAD_COLLAPSE (1<<0)
181 #define M_THREAD_UNCOLLAPSE (1<<1)
182 #define M_THREAD_GET_HIDDEN (1<<2)
183 #define M_THREAD_UNREAD (1<<3)
184 #define M_THREAD_NEXT_UNREAD (1<<4)
188 /* modes for mutt_view_attachment() */
193 /* action codes used by mutt_set_flag() and mutt_pattern_function() */
211 /* actions for mutt_pattern_comp/mutt_pattern_exec */
247 /* Options for Mailcap lookup */
253 /* options for socket code */
255 #ifdef USE_SSL_OPENSSL
259 /* Options for mutt_save_attachment */
264 /* possible arguments to set_quadoption() */
273 /* quad-option vars */
286 OPT_PGPMIMEAUTO, /* ask to revert to PGP/MIME when inline fails */
300 OPT_VERIFYSIG, /* verify PGP signatures */
302 /* THIS MUST BE THE LAST VALUE. */
306 /* flags to ci_send_message() */
307 #define SENDREPLY (1<<0)
308 #define SENDGROUPREPLY (1<<1)
309 #define SENDLISTREPLY (1<<2)
310 #define SENDFORWARD (1<<3)
311 #define SENDPOSTPONED (1<<4)
312 #define SENDBATCH (1<<5)
313 #define SENDMAILX (1<<6)
314 #define SENDKEY (1<<7)
315 #define SENDRESEND (1<<8)
317 /* flags to _mutt_select_file() */
318 #define M_SEL_BUFFY (1<<0)
319 #define M_SEL_MULTI (1<<1)
320 #define M_SEL_FOLDER (1<<2)
322 /* flags for parse_spam_list */
364 #endif /* HAVE_QDBM */
372 OPTHIDETHREADSUBJECT,
376 OPTIGNORELISTREPLYTO,
378 OPTIMAPCHECKSUBSCRIBED,
386 # ifndef USE_SSL_GNUTLS
389 # endif /* USE_SSL_GNUTLS */
393 #endif /* defined(USE_SSL) */
401 OPTMENUSCROLL, /* scroll menu instead of implicit next-page */
402 OPTMENUMOVEOFF, /* allow menu to scroll past last entry */
403 #if defined(USE_IMAP) || defined(USE_POP)
404 OPTMESSAGECACHECLEAN,
406 OPTMETAKEY, /* interpret ALT-x as ESC-x */
451 #ifdef HAVE_GETADDRINFO
458 OPTWRITEBCC, /* write out a bcc header? */
470 OPTCRYPTREPLYENCRYPT,
472 OPTCRYPTREPLYSIGNENCRYPTED,
476 OPTSDEFAULTDECRYPTKEY,
493 OPTAUXSORT, /* (pseudo) using auxillary sort function */
494 OPTFORCEREFRESH, /* (pseudo) refresh even during macros */
495 OPTLOCALES, /* (pseudo) set if user has valid locale definition */
496 OPTNOCURSES, /* (pseudo) when sending in batch mode */
497 OPTNEEDREDRAW, /* (pseudo) to notify caller of a submenu */
498 OPTSEARCHREVERSE, /* (pseudo) used by ci_search_command */
499 OPTMSGERR, /* (pseudo) used by mutt_error/mutt_message */
500 OPTSEARCHINVALID, /* (pseudo) used to invalidate the search pat */
501 OPTSIGNALSBLOCKED, /* (pseudo) using by mutt_block_signals () */
502 OPTSYSSIGNALSBLOCKED, /* (pseudo) using by mutt_block_signals_system () */
503 OPTNEEDRESORT, /* (pseudo) used to force a re-sort */
504 OPTRESORTINIT, /* (pseudo) used to force the next resort to be from scratch */
505 OPTVIEWATTACH, /* (pseudo) signals that we are viewing attachments */
506 OPTFORCEREDRAWINDEX, /* (pseudo) used to force a redraw in the main index */
507 OPTFORCEREDRAWPAGER, /* (pseudo) used to force a redraw in the pager */
508 OPTSORTSUBTHREADS, /* (pseudo) used when $sort_aux changes */
509 OPTNEEDRESCORE, /* (pseudo) set when the `score' command is used */
510 OPTATTACHMSG, /* (pseudo) used by attach-message */
511 OPTKEEPQUIET, /* (pseudo) shut up the message and refresh
512 * functions while we are executing an
515 OPTMENUCALLER, /* (pseudo) tell menu to give caller a take */
516 OPTREDRAWTREE, /* (pseudo) redraw the thread tree */
517 OPTPGPCHECKTRUST, /* (pseudo) used by pgp_select_key () */
518 OPTDONTHANDLEPGPKEYS, /* (pseudo) used to extract PGP keys */
519 OPTUNBUFFEREDINPUT, /* (pseudo) don't use key buffer */
524 #define mutt_bit_alloc(n) calloc ((n + 7) / 8, sizeof (char))
525 #define mutt_bit_set(v,n) v[n/8] |= (1 << (n % 8))
526 #define mutt_bit_unset(v,n) v[n/8] &= ~(1 << (n % 8))
527 #define mutt_bit_toggle(v,n) v[n/8] ^= (1 << (n % 8))
528 #define mutt_bit_isset(v,n) (v[n/8] & (1 << (n % 8)))
530 #define set_option(x) mutt_bit_set(Options,x)
531 #define unset_option(x) mutt_bit_unset(Options,x)
532 #define toggle_option(x) mutt_bit_toggle(Options,x)
533 #define option(x) mutt_bit_isset(Options,x)
535 typedef struct list_t
541 typedef struct rx_list_t
544 struct rx_list_t *next;
547 typedef struct spam_list_t
552 struct spam_list_t *next;
555 #define mutt_new_list() safe_calloc (1, sizeof (LIST))
556 #define mutt_new_rx_list() safe_calloc (1, sizeof (RX_LIST))
557 #define mutt_new_spam_list() safe_calloc (1, sizeof (SPAM_LIST))
558 void mutt_free_list (LIST **);
559 void mutt_free_rx_list (RX_LIST **);
560 void mutt_free_spam_list (SPAM_LIST **);
561 LIST *mutt_copy_list (LIST *);
562 int mutt_matches_ignore (const char *, LIST *);
564 /* add an element to a list */
565 LIST *mutt_add_list (LIST *, const char *);
566 LIST *mutt_add_list_n (LIST*, const void *, size_t);
568 void mutt_init (int, LIST *);
572 struct alias *self; /* XXX - ugly hack */
581 typedef struct envelope
583 ADDRESS *return_path;
590 ADDRESS *mail_followup_to;
591 char *list_post; /* this stores a mailto URL, or nothing */
593 char *real_subj; /* offset of the real subject */
599 LIST *references; /* message references (in reverse order) */
600 LIST *in_reply_to; /* in-reply-to header content */
601 LIST *userhdrs; /* user defined headers */
603 unsigned int irt_changed : 1; /* In-Reply-To changed to link/break threads */
604 unsigned int refs_changed : 1; /* References changed to break thread */
607 typedef struct parameter
611 struct parameter *next;
614 /* Information that helps in determing the Content-* of an attachment */
615 typedef struct content
617 long hibin; /* 8-bit characters */
618 long lobin; /* unprintable 7-bit chars (eg., control chars) */
619 long crlf; /* '\r' and '\n' characters */
620 long ascii; /* number of ascii chars */
621 long linemax; /* length of the longest line in the file */
622 unsigned int space : 1; /* whitespace at the end of lines? */
623 unsigned int binary : 1; /* long lines, or CR not in CRLF pair */
624 unsigned int from : 1; /* has a line beginning with "From "? */
625 unsigned int dot : 1; /* has a line consisting of a single dot? */
626 unsigned int cr : 1; /* has CR, even when in a CRLF pair */
631 char *xtype; /* content-type if x-unknown */
632 char *subtype; /* content-type subtype */
633 PARAMETER *parameter; /* parameters of the content-type */
634 char *description; /* content-description */
635 char *form_name; /* Content-Disposition form-data name param */
636 long hdr_offset; /* offset in stream where the headers begin.
637 * this info is used when invoking metamail,
638 * where we need to send the headers of the
641 LOFF_T offset; /* offset where the actual data begins */
642 LOFF_T length; /* length (in bytes) of attachment */
643 char *filename; /* when sending a message, this is the file
644 * to which this structure refers
646 char *d_filename; /* filename to be used for the
647 * content-disposition header.
648 * If NULL, filename is used
651 char *charset; /* charset of attached file */
652 CONTENT *content; /* structure used to store detailed info about
653 * the content of the attachment. this is used
654 * to determine what content-transfer-encoding
655 * is required when sending mail.
657 struct body *next; /* next attachment in the list */
658 struct body *parts; /* parts of a multipart or message/rfc822 */
659 struct header *hdr; /* header information for message/rfc822 */
661 struct attachptr *aptr; /* Menu information, used in recvattach.c */
663 signed short attach_count;
665 time_t stamp; /* time stamp of last
669 unsigned int type : 4; /* content-type primary type */
670 unsigned int encoding : 3; /* content-transfer-encoding */
671 unsigned int disposition : 2; /* content-disposition */
672 unsigned int use_disp : 1; /* Content-Disposition uses filename= ? */
673 unsigned int unlink : 1; /* flag to indicate the the file named by
674 * "filename" should be unlink()ed before
675 * free()ing this structure
677 unsigned int tagged : 1;
678 unsigned int deleted : 1; /* attachment marked for deletion */
680 unsigned int noconv : 1; /* don't do character set conversion */
681 unsigned int force_charset : 1;
682 /* send mode: don't adjust the character
683 * set when in send-mode.
685 unsigned int is_signed_data : 1; /* A lot of MUAs don't indicate
686 S/MIME signed-data correctly,
687 e.g. they use foo.p7m even for
688 the name of signed data. This
689 flag is used to keep track of
690 the actual message type. It
691 gets set during the verification
692 (which is done if the encryption
693 try failed) and check by the
694 function to figure the type of
697 unsigned int goodsig : 1; /* good cryptographic signature */
698 unsigned int warnsig : 1; /* maybe good signature */
699 unsigned int badsig : 1; /* bad cryptographic signature (needed to check encrypted s/mime-signatures) */
701 unsigned int collapsed : 1; /* used by recvattach */
702 unsigned int attach_qualifies : 1;
706 typedef struct header
708 unsigned int security : 11; /* bit 0-6: flags, bit 7,8: application.
709 see: crypt.h pgplib.h, smime.h */
711 unsigned int mime : 1; /* has a MIME-Version header? */
712 unsigned int flagged : 1; /* marked important? */
713 unsigned int tagged : 1;
714 unsigned int deleted : 1;
715 unsigned int changed : 1;
716 unsigned int attach_del : 1; /* has an attachment marked for deletion */
717 unsigned int old : 1;
718 unsigned int read : 1;
719 unsigned int expired : 1; /* already expired? */
720 unsigned int superseded : 1; /* got superseded? */
721 unsigned int replied : 1;
722 unsigned int subject_changed : 1; /* used for threading */
723 unsigned int threaded : 1; /* used for threading */
724 unsigned int display_subject : 1; /* used for threading */
725 unsigned int recip_valid : 1; /* is_recipient is valid */
726 unsigned int active : 1; /* message is not to be removed */
727 unsigned int trash : 1; /* message is marked as trashed on disk.
728 * This flag is used by the maildir_trash
732 /* timezone of the sender of this message */
733 unsigned int zhours : 5;
734 unsigned int zminutes : 6;
735 unsigned int zoccident : 1;
737 /* bits used for caching when searching */
738 unsigned int searched : 1;
739 unsigned int matched : 1;
741 /* tells whether the attachment count is valid */
742 unsigned int attach_valid : 1;
744 /* the following are used to support collapsing threads */
745 unsigned int collapsed : 1; /* is this message part of a collapsed thread? */
746 unsigned int limited : 1; /* is this message in a limited view? */
747 size_t num_hidden; /* number of hidden messages in this view */
749 short recipient; /* user_is_recipient()'s return value, cached */
751 int pair; /* color-pair to use when displaying in the index */
753 time_t date_sent; /* time when the message was sent (UTC) */
754 time_t received; /* time when the message was placed in the mailbox */
755 LOFF_T offset; /* where in the stream does this message begin? */
756 int lines; /* how many lines in the body of this message? */
757 int index; /* the absolute (unsorted) message number */
758 int msgno; /* number displayed to the user */
759 int virtual; /* virtual message number */
761 ENVELOPE *env; /* envelope information */
762 BODY *content; /* list of MIME parts */
765 char *tree; /* character string to print thread tree */
766 struct thread *thread;
768 /* Number of qualifying attachments in message, if attach_valid */
776 int refno; /* message number on server */
779 #if defined USE_POP || defined USE_IMAP
780 void *data; /* driver-specific data */
783 char *maildir_flags; /* unknown maildir flags */
786 typedef struct thread
788 unsigned int fake_thread : 1;
789 unsigned int duplicate_thread : 1;
790 unsigned int sort_children : 1;
791 unsigned int check_subject : 1;
792 unsigned int visible : 1;
793 unsigned int deep : 1;
794 unsigned int subtree_visible : 2;
795 unsigned int next_subtree_visible : 1;
796 struct thread *parent;
797 struct thread *child;
805 /* flag to mutt_pattern_comp() */
806 #define M_FULL_MSG (1<<0) /* enable body and header matching */
809 M_MATCH_FULL_ADDRESS = 1
812 typedef struct group_t
819 typedef struct group_context_t
822 struct group_context_t *next;
825 typedef struct pattern_t
828 unsigned int not : 1;
829 unsigned int alladdr : 1;
830 unsigned int stringmatch : 1;
831 unsigned int groupmatch : 1;
834 struct pattern_t *next;
835 struct pattern_t *child; /* arguments to logical op */
862 typedef struct _context
869 char *pattern; /* limit pattern string */
870 pattern_t *limit_pattern; /* compiled limit pattern */
872 HEADER *last_tag; /* last tagged msg. used to link threads */
873 THREAD *tree; /* top of thread tree */
874 HASH *id_hash; /* hash table by msg id */
875 HASH *subj_hash; /* hash table by subject */
876 HASH *thread_hash; /* hash table for threading */
877 int *v2r; /* mapping from virtual to real msgno */
878 int hdrmax; /* number of pointers in hdrs */
879 int msgcount; /* number of messages in the mailbox */
880 int vcount; /* the number of virtual messages */
881 int tagged; /* how many messages are tagged? */
882 int new; /* how many new messages? */
883 int unread; /* how many unread messages? */
884 int deleted; /* how many deleted messages */
885 int flagged; /* how many flagged messages */
886 int msgnotreadyet; /* which msg "new" in pager, -1 if none */
888 short magic; /* mailbox type */
890 unsigned char rights[(RIGHTSMAX + 7)/8]; /* ACL bits */
892 unsigned int locked : 1; /* is the mailbox locked? */
893 unsigned int changed : 1; /* mailbox has been modified */
894 unsigned int readonly : 1; /* don't allow changes to the mailbox */
895 unsigned int dontwrite : 1; /* dont write the mailbox on close */
896 unsigned int append : 1; /* mailbox is opened in append mode */
897 unsigned int quiet : 1; /* inhibit status messages? */
898 unsigned int collapsed : 1; /* are all threads collapsed? */
899 unsigned int closing : 1; /* mailbox is being closed */
902 void *data; /* driver specific data */
903 int (*mx_close)(struct _context *);
914 /* used by enter.c */
926 /* flags for the STATE struct */
927 #define M_DISPLAY (1<<0) /* output is displayed to the user */
928 #define M_VERIFY (1<<1) /* perform signature verification */
929 #define M_PENDINGPREFIX (1<<2) /* prefix to write, but character must follow */
930 #define M_WEED (1<<3) /* weed headers even when not in display mode */
931 #define M_CHARCONV (1<<4) /* Do character set conversions */
932 #define M_PRINTING (1<<5) /* are we printing? - M_DISPLAY "light" */
933 #define M_REPLYING (1<<6) /* are we replying? */
934 #define M_FIRSTDONE (1<<7) /* the first attachment has been done */
936 #define state_set_prefix(s) ((s)->flags |= M_PENDINGPREFIX)
937 #define state_reset_prefix(s) ((s)->flags &= ~M_PENDINGPREFIX)
938 #define state_puts(x,y) fputs(x,(y)->fpout)
939 #define state_putc(x,y) fputc(x,(y)->fpout)
941 void state_mark_attach (STATE *);
942 void state_attach_puts (const char *, STATE *);
943 void state_prefix_putc (char, STATE *);
944 int state_printf(STATE *, const char *, ...);
946 /* for attachment counter */
955 #define M_PARTS_TOPLEVEL (1<<0) /* is the top-level part */