2 * Copyright (C) 1996-2002 Michael R. Elkins <me@mutt.org>
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation; either version 2 of the License, or
7 * (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, 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
46 #include <posix1_lim.h>
60 # define MB_LEN_MAX 16
64 # define MUTT_VERSION (VERSION SUBVERSION)
66 # define MUTT_VERSION (VERSION)
69 /* nifty trick I stole from ELM 2.5alpha. */
72 #define INITVAL(x) = x
78 #include "mutt_regex.h"
80 /* flags for mutt_copy_header() */
81 #define CH_UPDATE 1 /* update the status and x-status fields? */
82 #define CH_WEED (1<<1) /* weed the headers? */
83 #define CH_DECODE (1<<2) /* do RFC1522 decoding? */
84 #define CH_XMIT (1<<3) /* transmitting this message? */
85 #define CH_FROM (1<<4) /* retain the "From " message separator? */
86 #define CH_PREFIX (1<<5) /* use Prefix string? */
87 #define CH_NOSTATUS (1<<6) /* supress the status and x-status fields */
88 #define CH_REORDER (1<<7) /* Re-order output of headers */
89 #define CH_NONEWLINE (1<<8) /* don't output terminating newline */
90 #define CH_MIME (1<<9) /* ignore MIME fields */
91 #define CH_UPDATE_LEN (1<<10) /* update Lines: and Content-Length: */
92 #define CH_TXTPLAIN (1<<11) /* generate text/plain MIME headers */
93 #define CH_NOLEN (1<<12) /* don't write Content-Length: and Lines: */
94 #define CH_WEED_DELIVERED (1<<13) /* weed eventual Delivered-To headers */
95 #define CH_FORCE_FROM (1<<14) /* give CH_FROM precedence over CH_WEED? */
96 #define CH_NOQFROM (1<<15) /* give CH_FROM precedence over CH_WEED? */
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 */
149 /* types for mutt_add_hook() */
150 #define M_FOLDERHOOK 1
151 #define M_MBOXHOOK (1<<1)
152 #define M_SENDHOOK (1<<2)
153 #define M_FCCHOOK (1<<3)
154 #define M_SAVEHOOK (1<<4)
155 #define M_CHARSETHOOK (1<<5)
156 #define M_ICONVHOOK (1<<6)
157 #define M_MESSAGEHOOK (1<<7)
158 #define M_CRYPTHOOK (1<<8)
159 #define M_ACCOUNTHOOK (1<<9)
160 #define M_REPLYHOOK (1<<10)
162 /* tree characters for linearize_tree and print_enriched_string */
163 #define M_TREE_LLCORNER 1
164 #define M_TREE_ULCORNER 2
165 #define M_TREE_LTEE 3
166 #define M_TREE_HLINE 4
167 #define M_TREE_VLINE 5
168 #define M_TREE_SPACE 6
169 #define M_TREE_RARROW 7
170 #define M_TREE_STAR 8
171 #define M_TREE_HIDDEN 9
172 #define M_TREE_EQUALS 10
173 #define M_TREE_TTEE 11
174 #define M_TREE_BTEE 12
175 #define M_TREE_MISSING 13
176 #define M_TREE_MAX 14
178 #define M_THREAD_COLLAPSE (1<<0)
179 #define M_THREAD_UNCOLLAPSE (1<<1)
180 #define M_THREAD_GET_HIDDEN (1<<2)
181 #define M_THREAD_UNREAD (1<<3)
182 #define M_THREAD_NEXT_UNREAD (1<<4)
186 /* modes for mutt_view_attachment() */
191 /* action codes used by mutt_set_flag() and mutt_pattern_function() */
211 /* actions for mutt_pattern_comp/mutt_pattern_exec */
245 /* Options for Mailcap lookup */
251 /* options for socket code */
257 /* Options for mutt_save_attachment */
262 /* possible arguments to set_quadoption() */
271 /* quad-option vars */
284 OPT_PGPTRADITIONAL, /* create old-style PGP messages */
298 OPT_VERIFYSIG, /* verify PGP signatures */
304 OPT_FOLLOWUPTOPOSTER,
305 #endif /* USE_NNTP */
307 /* THIS MUST BE THE LAST VALUE. */
311 /* flags to ci_send_message() */
312 #define SENDREPLY (1<<0)
313 #define SENDGROUPREPLY (1<<1)
314 #define SENDLISTREPLY (1<<2)
315 #define SENDFORWARD (1<<3)
316 #define SENDPOSTPONED (1<<4)
317 #define SENDBATCH (1<<5)
318 #define SENDMAILX (1<<6)
319 #define SENDKEY (1<<7)
320 #define SENDRESEND (1<<8)
321 #define SENDNEWS (1<<9)
323 /* flags to _mutt_select_file() */
324 #define M_SEL_BUFFY (1<<0)
325 #define M_SEL_MULTI (1<<1)
326 #define M_SEL_FOLDER (1<<2)
371 OPTIGNORELISTREPLYTO,
381 #if defined(USE_SSL) || defined(USE_NSS)
394 OPTMENUSCROLL, /* scroll menu instead of implicit next-page */
395 OPTMETAKEY, /* interpret ALT-x as ESC-x */
400 OPTMIMESUBJECT, /* encode subject line with RFC2047 */
441 #ifdef HAVE_GETADDRINFO
448 OPTWRITEBCC, /* write out a bcc header? */
457 OPTCRYPTREPLYENCRYPT,
459 OPTCRYPTREPLYSIGNENCRYPTED,
463 OPTSDEFAULTDECRYPTKEY,
484 #endif /* USE_NNTP */
488 OPTAUXSORT, /* (pseudo) using auxillary sort function */
489 OPTFORCEREFRESH, /* (pseudo) refresh even during macros */
490 OPTLOCALES, /* (pseudo) set if user has valid locale definition */
491 OPTNOCURSES, /* (pseudo) when sending in batch mode */
492 OPTNEEDREDRAW, /* (pseudo) to notify caller of a submenu */
493 OPTSEARCHREVERSE, /* (pseudo) used by ci_search_command */
494 OPTMSGERR, /* (pseudo) used by mutt_error/mutt_message */
495 OPTSEARCHINVALID, /* (pseudo) used to invalidate the search pat */
496 OPTSIGNALSBLOCKED, /* (pseudo) using by mutt_block_signals () */
497 OPTSYSSIGNALSBLOCKED, /* (pseudo) using by mutt_block_signals_system () */
498 OPTNEEDRESORT, /* (pseudo) used to force a re-sort */
499 OPTRESORTINIT, /* (pseudo) used to force the next resort to be from scratch */
500 OPTVIEWATTACH, /* (pseudo) signals that we are viewing attachments */
501 OPTFORCEREDRAWINDEX, /* (pseudo) used to force a redraw in the main index */
502 OPTFORCEREDRAWPAGER, /* (pseudo) used to force a redraw in the pager */
503 OPTSORTSUBTHREADS, /* (pseudo) used when $sort_aux changes */
504 OPTNEEDRESCORE, /* (pseudo) set when the `score' command is used */
505 OPTATTACHMSG, /* (pseudo) used by attach-message */
506 OPTHIDEREAD, /* (pseudo) whether or not hide read messages */
507 OPTKEEPQUIET, /* (pseudo) shut up the message and refresh
508 * functions while we are executing an
511 OPTMENUCALLER, /* (pseudo) tell menu to give caller a take */
512 OPTREDRAWTREE, /* (pseudo) redraw the thread tree */
513 OPTPGPCHECKTRUST, /* (pseudo) used by pgp_select_key () */
514 OPTDONTHANDLEPGPKEYS, /* (pseudo) used to extract PGP keys */
515 OPTUNBUFFEREDINPUT, /* (pseudo) don't use key buffer */
518 OPTNEWS, /* (pseudo) used to change reader mode */
519 OPTNEWSSEND, /* (pseudo) used to change behavior when posting */
520 OPTNEWSCACHE, /* (pseudo) used to indicate if news cache exist */
526 #define mutt_bit_alloc(n) calloc ((n + 7) / 8, sizeof (char))
527 #define mutt_bit_set(v,n) v[n/8] |= (1 << (n % 8))
528 #define mutt_bit_unset(v,n) v[n/8] &= ~(1 << (n % 8))
529 #define mutt_bit_toggle(v,n) v[n/8] ^= (1 << (n % 8))
530 #define mutt_bit_isset(v,n) (v[n/8] & (1 << (n % 8)))
532 #define set_option(x) mutt_bit_set(Options,x)
533 #define unset_option(x) mutt_bit_unset(Options,x)
534 #define toggle_option(x) mutt_bit_toggle(Options,x)
535 #define option(x) mutt_bit_isset(Options,x)
537 /* Exit values used in send_msg() */
541 typedef struct list_t
547 typedef struct rx_list_t
550 struct rx_list_t *next;
553 #define mutt_new_list() safe_calloc (1, sizeof (LIST))
554 #define mutt_new_rx_list() safe_calloc (1, sizeof (RX_LIST))
555 void mutt_free_list (LIST **);
556 void mutt_free_rx_list (RX_LIST **);
557 int mutt_matches_ignore (const char *, LIST *);
559 /* add an element to a list */
560 LIST *mutt_add_list (LIST *, const char *);
562 void mutt_init (int, LIST *);
566 struct alias *self; /* XXX - ugly hack */
575 typedef struct envelope
577 ADDRESS *return_path;
584 ADDRESS *mail_followup_to;
586 char *real_subj; /* offset of the real subject */
598 LIST *references; /* message references (in reverse order) */
599 LIST *in_reply_to; /* in-reply-to header content */
600 LIST *userhdrs; /* user defined headers */
603 typedef struct parameter
607 struct parameter *next;
610 /* Information that helps in determing the Content-* of an attachment */
611 typedef struct content
613 long hibin; /* 8-bit characters */
614 long lobin; /* unprintable 7-bit chars (eg., control chars) */
615 long crlf; /* '\r' and '\n' characters */
616 long ascii; /* number of ascii chars */
617 long linemax; /* length of the longest line in the file */
618 unsigned int space : 1; /* whitespace at the end of lines? */
619 unsigned int binary : 1; /* long lines, or CR not in CRLF pair */
620 unsigned int from : 1; /* has a line beginning with "From "? */
621 unsigned int dot : 1; /* has a line consisting of a single dot? */
622 unsigned int cr : 1; /* has CR, even when in a CRLF pair */
627 char *xtype; /* content-type if x-unknown */
628 char *subtype; /* content-type subtype */
629 PARAMETER *parameter; /* parameters of the content-type */
630 char *description; /* content-description */
631 char *form_name; /* Content-Disposition form-data name param */
632 long hdr_offset; /* offset in stream where the headers begin.
633 * this info is used when invoking metamail,
634 * where we need to send the headers of the
637 long offset; /* offset where the actual data begins */
638 long length; /* length (in bytes) of attachment */
639 char *filename; /* when sending a message, this is the file
640 * to which this structure refers
642 char *d_filename; /* filename to be used for the
643 * content-disposition header.
644 * If NULL, filename is used
647 CONTENT *content; /* structure used to store detailed info about
648 * the content of the attachment. this is used
649 * to determine what content-transfer-encoding
650 * is required when sending mail.
652 struct body *next; /* next attachment in the list */
653 struct body *parts; /* parts of a multipart or message/rfc822 */
654 struct header *hdr; /* header information for message/rfc822 */
656 struct attachptr *aptr; /* Menu information, used in recvattach.c */
658 time_t stamp; /* time stamp of last
662 unsigned int type : 4; /* content-type primary type */
663 unsigned int encoding : 3; /* content-transfer-encoding */
664 unsigned int disposition : 2; /* content-disposition */
665 unsigned int use_disp : 1; /* Content-Disposition uses filename= ? */
666 unsigned int unlink : 1; /* flag to indicate the the file named by
667 * "filename" should be unlink()ed before
668 * free()ing this structure
670 unsigned int tagged : 1;
671 unsigned int deleted : 1; /* attachment marked for deletion */
673 unsigned int noconv : 1; /* don't do character set conversion */
674 unsigned int force_charset : 1;
675 /* send mode: don't adjust the character
676 * set when in send-mode.
679 unsigned int goodsig : 1; /* good cryptographic signature */
680 unsigned int badsig : 1; /* bad cryptographic signature (needed to check encrypted s/mime-signatures) */
682 unsigned int collapsed : 1; /* used by recvattach */
686 typedef struct header
688 unsigned int security : 9; /* bit 0-6: flags, bit 7,8: application.
689 see: crypt.h pgplib.h, smime.h */
691 unsigned int mime : 1; /* has a Mime-Version header? */
692 unsigned int flagged : 1; /* marked important? */
693 unsigned int tagged : 1;
694 unsigned int appended : 1; /* has been saved */
695 unsigned int purged : 1; /* bypassing the trash folder */
696 unsigned int deleted : 1;
697 unsigned int changed : 1;
698 unsigned int attach_del : 1; /* has an attachment marked for deletion */
699 unsigned int old : 1;
700 unsigned int read : 1;
701 unsigned int expired : 1; /* already expired? */
702 unsigned int superseded : 1; /* got superseded? */
703 unsigned int replied : 1;
704 unsigned int subject_changed : 1; /* used for threading */
705 unsigned int threaded : 1; /* used for threading */
706 unsigned int display_subject : 1; /* used for threading */
707 unsigned int recip_valid : 1; /* is_recipient is valid */
708 unsigned int active : 1; /* message is not to be removed */
709 unsigned int trash : 1; /* message is marked as trashed on disk.
710 * This flag is used by the maildir_trash
714 /* timezone of the sender of this message */
715 unsigned int zhours : 5;
716 unsigned int zminutes : 6;
717 unsigned int zoccident : 1;
719 /* bits used for caching when searching */
720 unsigned int searched : 1;
721 unsigned int matched : 1;
723 /* the following are used to support collapsing threads */
724 unsigned int collapsed : 1; /* is this message part of a collapsed thread? */
725 unsigned int limited : 1; /* is this message in a limited view? */
726 size_t num_hidden; /* number of hidden messages in this view */
728 short recipient; /* user_is_recipient()'s return value, cached */
730 int pair; /* color-pair to use when displaying in the index */
732 time_t date_sent; /* time when the message was sent (UTC) */
733 time_t received; /* time when the message was placed in the mailbox */
734 long offset; /* where in the stream does this message begin? */
735 int lines; /* how many lines in the body of this message? */
736 int index; /* the absolute (unsorted) message number */
737 int msgno; /* number displayed to the user */
738 int virtual; /* virtual message number */
740 ENVELOPE *env; /* envelope information */
741 BODY *content; /* list of MIME parts */
747 char *tree; /* character string to print thread tree */
748 struct thread *thread;
755 int refno; /* message number on server */
758 #if defined USE_POP || defined USE_IMAP || defined USE_NNTP
759 void *data; /* driver-specific data */
762 char *maildir_flags; /* unknown maildir flags */
765 typedef struct thread
767 unsigned int fake_thread : 1;
768 unsigned int duplicate_thread : 1;
769 unsigned int sort_children : 1;
770 unsigned int check_subject : 1;
771 unsigned int visible : 1;
772 unsigned int deep : 1;
773 unsigned int subtree_visible : 2;
774 unsigned int next_subtree_visible : 1;
775 struct thread *parent;
776 struct thread *child;
784 /* flag to mutt_pattern_comp() */
785 #define M_FULL_MSG 1 /* enable body and header matching */
788 M_MATCH_FULL_ADDRESS = 1
791 typedef struct pattern_t
798 struct pattern_t *next;
799 struct pattern_t *child; /* arguments to logical op */
808 time_t mtime_cur; /* used with maildir folders */
811 char *pattern; /* limit pattern string */
812 pattern_t *limit_pattern; /* compiled limit pattern */
814 THREAD *tree; /* top of thread tree */
815 HASH *id_hash; /* hash table by msg id */
816 HASH *subj_hash; /* hash table by subject */
817 HASH *thread_hash; /* hash table for threading */
818 int *v2r; /* mapping from virtual to real msgno */
819 int hdrmax; /* number of pointers in hdrs */
820 int msgcount; /* number of messages in the mailbox */
821 int vcount; /* the number of virtual messages */
822 int tagged; /* how many messages are tagged? */
823 int new; /* how many new messages? */
824 int unread; /* how many unread messages? */
825 int deleted; /* how many deleted messages */
826 int appended; /* how many saved messages? */
827 int flagged; /* how many flagged messages */
828 int msgnotreadyet; /* which msg "new" in pager, -1 if none */
829 #if defined USE_POP || defined USE_IMAP || defined USE_NNTP
830 void *data; /* driver specific data */
831 #endif /* USE_IMAP */
833 short magic; /* mailbox type */
835 unsigned int locked : 1; /* is the mailbox locked? */
836 unsigned int changed : 1; /* mailbox has been modified */
837 unsigned int readonly : 1; /* don't allow changes to the mailbox */
838 unsigned int dontwrite : 1; /* dont write the mailbox on close */
839 unsigned int append : 1; /* mailbox is opened in append mode */
840 unsigned int quiet : 1; /* inhibit status messages? */
841 unsigned int collapsed : 1; /* are all threads collapsed? */
842 unsigned int closing : 1; /* mailbox is being closed */
845 typedef struct attachptr
862 /* used by enter.c */
874 /* flags for the STATE struct */
875 #define M_DISPLAY (1<<0) /* output is displayed to the user */
876 #define M_VERIFY (1<<1) /* perform signature verification */
877 #define M_PENDINGPREFIX (1<<2) /* prefix to write, but character must follow */
878 #define M_WEED (1<<3) /* weed headers even when not in display mode */
879 #define M_CHARCONV (1<<4) /* Do character set conversions */
880 #define M_PRINTING (1<<5) /* are we printing? - M_DISPLAY "light" */
882 #define state_set_prefix(s) ((s)->flags |= M_PENDINGPREFIX)
883 #define state_reset_prefix(s) ((s)->flags &= ~M_PENDINGPREFIX)
884 #define state_puts(x,y) fputs(x,(y)->fpout)
885 #define state_putc(x,y) fputc(x,(y)->fpout)
887 void state_mark_attach (STATE *);
888 void state_attach_puts (const char *, STATE *);
889 void state_prefix_putc (char, STATE *);
890 int state_printf(STATE *, const char *, ...);