Add FEDIT_ACCOUNT, gain better "no mail for"++ (messages)
[s-mailx.git] / nail.h
blob242da3fe60a8604eb302d5156c5bc30bae2c9def
1 /*@ S-nail - a mail user agent derived from Berkeley Mail.
2 *@ Header inclusion, macros, constants, types and the global var declarations.
3 *@ TODO Place in include/, split in object-based subheaders. And please: sort.
5 * Copyright (c) 2000-2004 Gunnar Ritter, Freiburg i. Br., Germany.
6 * Copyright (c) 2012 - 2018 Steffen (Daode) Nurpmeso <steffen@sdaoden.eu>.
7 */
8 /*
9 * Copyright (c) 1980, 1993
10 * The Regents of the University of California. All rights reserved.
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
14 * are met:
15 * 1. Redistributions of source code must retain the above copyright
16 * notice, this list of conditions and the following disclaimer.
17 * 2. Redistributions in binary form must reproduce the above copyright
18 * notice, this list of conditions and the following disclaimer in the
19 * documentation and/or other materials provided with the distribution.
20 * 3. Neither the name of the University nor the names of its contributors
21 * may be used to endorse or promote products derived from this software
22 * without specific prior written permission.
24 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
25 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
30 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
31 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 * SUCH DAMAGE.
36 #ifndef n_NAIL_H
37 # define n_NAIL_H
40 * Mail -- a mail program
42 * Author: Kurt Shoens (UCB) March 25, 1978
45 #include <mk-config.h>
47 #include <sys/stat.h>
48 #include <sys/types.h>
49 #include <sys/wait.h>
51 #ifdef HAVE_GETTIMEOFDAY
52 # include <sys/time.h>
53 #endif
55 #include <errno.h>
56 #include <fcntl.h>
57 #include <inttypes.h>
58 #include <limits.h>
59 #include <setjmp.h>
60 #include <signal.h>
61 #include <stdarg.h>
62 #include <stdio.h>
63 #include <stdlib.h>
64 #include <string.h>
65 #include <termios.h>
66 #include <time.h>
67 #include <unistd.h>
69 #ifdef HAVE_C90AMEND1
70 # include <wchar.h>
71 # include <wctype.h>
72 #endif
73 #ifdef HAVE_DEBUG
74 # include <assert.h>
75 #endif
76 #ifdef HAVE_ICONV
77 # include <iconv.h>
78 #endif
79 #ifdef HAVE_REGEX
80 # include <regex.h>
81 #endif
83 #ifdef HAVE_XTLS_MD5
84 # include <openssl/md5.h>
85 #endif
87 /* Many things possibly of interest for adjustments have been outsourced */
88 #include <config.h>
90 /* Special FD requests for n_child_run(), n_child_start() */
91 #define n_CHILD_FD_PASS -1
92 #define n_CHILD_FD_NULL -2
94 /* Colour stuff */
95 #ifdef HAVE_COLOUR
96 # define n_COLOUR(X) X
97 #else
98 # define n_COLOUR(X)
99 #endif
101 /* */
102 #define n_FROM_DATEBUF 64 /* Size of RFC 4155 From_ line date */
103 #define n_DATE_DAYSYEAR 365u
104 #define n_DATE_NANOSSEC (n_DATE_MICROSSEC * 1000)
105 #define n_DATE_MICROSSEC (n_DATE_MILLISSEC * 1000)
106 #define n_DATE_MILLISSEC 1000u
107 #define n_DATE_SECSMIN 60u
108 #define n_DATE_MINSHOUR 60u
109 #define n_DATE_HOURSDAY 24u
110 #define n_DATE_SECSHOUR (n_DATE_SECSMIN * n_DATE_MINSHOUR)
111 #define n_DATE_SECSDAY (n_DATE_SECSHOUR * n_DATE_HOURSDAY)
113 /* Network protocol newline */
114 #define NETNL "\015\012"
115 #define NETLINE(X) X NETNL
118 * OS, CC support, generic macros etc.
121 #define n_ISPOW2(X) ((((X) - 1) & (X)) == 0)
122 #define n_MIN(A,B) ((A) < (B) ? (A) : (B))
123 #define n_MAX(A,B) ((A) < (B) ? (B) : (A))
124 #define n_CLIP(X,A,B) (((X) <= (A)) ? (A) : (((X) >= (B)) ? (B) : (X)))
125 #define n_ABS(A) ((A) < 0 ? -(A) : (A))
127 /* OS: we're not a library, only set what needs special treatment somewhere */
128 #define n_OS_DRAGONFLY 0
129 #define n_OS_OPENBSD 0
130 #define n_OS_SOLARIS 0
131 #define n_OS_SUNOS 0
133 #ifdef __DragonFly__
134 # undef n_OS_DRAGONFLY
135 # define n_OS_DRAGONFLY 1
136 #elif defined __OpenBSD__
137 # undef n_OS_OPENBSD
138 # define n_OS_OPENBSD 1
139 #elif defined __solaris__ || defined __sun
140 # if defined __SVR4 || defined __svr4__
141 # undef n_OS_SOLARIS
142 # define n_OS_SOLARIS 1
143 # else
144 # undef n_OS_SUNOS
145 # define n_OS_SUNOS 1
146 # endif
147 #endif
149 /* CC */
150 #define CC_CLANG 0
151 #define PREREQ_CLANG(X,Y) 0
152 #define CC_GCC 0
153 #define PREREQ_GCC(X,Y) 0
154 #define CC_TCC 0
155 #define PREREQ_TCC(X,Y) 0
157 #ifdef __clang__
158 # undef CC_CLANG
159 # undef PREREQ_CLANG
160 # define CC_CLANG 1
161 # define PREREQ_CLANG(X,Y) \
162 (__clang_major__ + 0 > (X) || \
163 (__clang_major__ + 0 == (X) && __clang_minor__ + 0 >= (Y)))
164 # define __EXTEN __extension__
166 #elif defined __GNUC__
167 # undef CC_GCC
168 # undef PREREQ_GCC
169 # define CC_GCC 1
170 # define PREREQ_GCC(X,Y) \
171 (__GNUC__ + 0 > (X) || (__GNUC__ + 0 == (X) && __GNUC_MINOR__ + 0 >= (Y)))
172 # define __EXTEN __extension__
174 #elif defined __TINYC__
175 # undef CC_TCC
176 # define CC_TCC 1
177 #endif
179 #ifndef __EXTEN
180 # define __EXTEN
181 #endif
183 /* Suppress some technical warnings via #pragma's unless developing.
184 * XXX Wild guesses: clang(1) 1.7 and (OpenBSD) gcc(1) 4.2.1 don't work */
185 #ifndef HAVE_DEVEL
186 # if PREREQ_CLANG(3, 4)
187 # pragma clang diagnostic ignored "-Wassign-enum"
188 # pragma clang diagnostic ignored "-Wdisabled-macro-expansion"
189 # pragma clang diagnostic ignored "-Wformat"
190 # pragma clang diagnostic ignored "-Wunused-result"
191 # elif PREREQ_GCC(4, 7)
192 # pragma GCC diagnostic ignored "-Wunused-local-typedefs"
193 # pragma GCC diagnostic ignored "-Wunused-result"
194 # pragma GCC diagnostic ignored "-Wformat"
195 # endif
196 #endif
198 /* For injection macros like DBG(), n_NATCH_CHAR() */
199 #define COMMA ,
201 #define EMPTY_FILE() typedef int n_CONCAT(avoid_empty_file__, n_FILE);
203 /* Pointer to size_t */
204 #define PTR2SIZE(X) ((size_t)(uintptr_t)(X))
206 /* Pointer comparison (types from below) */
207 #define PTRCMP(A,C,B) ((uintptr_t)(A) C (uintptr_t)(B))
209 /* Ditto, compare (maybe mixed-signed) integers cases to T bits, unsigned;
210 * Note: doesn't sign-extend correctly, that's still up to the caller */
211 #define UICMP(T,A,C,B) ((ui ## T ## _t)(A) C (ui ## T ## _t)(B))
213 /* Align something to a size/boundary that cannot cause just any problem */
214 #define n_ALIGN(X) (((X) + 2*sizeof(void*)) & ~((2*sizeof(void*)) - 1))
215 #define n_ALIGN_SMALL(X) \
216 (((X) + n_MAX(sizeof(size_t), sizeof(void*))) &\
217 ~(n_MAX(sizeof(size_t), sizeof(void*)) - 1))
219 /* Members in constant array */
220 #define n_NELEM(A) (sizeof(A) / sizeof((A)[0]))
222 /* sizeof() for member fields */
223 #define n_SIZEOF_FIELD(T,F) sizeof(((T *)NULL)->F)
225 /* Casts-away (*NOT* cast-away) */
226 #define n_UNUSED(X) ((void)(X))
227 #define n_UNCONST(P) ((void*)(uintptr_t)(void const*)(P))
228 #define n_UNVOLATILE(P) ((void*)(uintptr_t)(void volatile*)(P))
229 /* To avoid warnings with modern compilers for "char*i; *(si32_t*)i=;" */
230 #define n_UNALIGN(T,P) ((T)(uintptr_t)(P))
231 #define n_UNXXX(T,C,P) ((T)(uintptr_t)(C)(P))
233 /* __STDC_VERSION__ is ISO C99, so also use __STDC__, which should work */
234 #if defined __STDC__ || defined __STDC_VERSION__ /*|| defined __cplusplus*/
235 # define n_STRING(X) #X
236 # define n_XSTRING(X) n_STRING(X)
237 # define n_CONCAT(S1,S2) n__CONCAT_1(S1, S2)
238 # define n__CONCAT_1(S1,S2) S1 ## S2
239 #else
240 # define n_STRING(X) "X"
241 # define n_XSTRING STRING
242 # define n_CONCAT(S1,S2) S1/* won't work out */S2
243 #endif
245 #if defined __STDC_VERSION__ && __STDC_VERSION__ + 0 >= 199901L
246 # define n_FIELD_INITN(N) n_CONCAT(., N) =
247 # define n_FIELD_INITI(I) [I] =
248 #else
249 # define n_FIELD_INITN(N)
250 # define n_FIELD_INITI(N)
251 #endif
253 #if defined __STDC_VERSION__ && __STDC_VERSION__ + 0 >= 199901L
254 # define n_VFIELD_SIZE(X)
255 # define n_VSTRUCT_SIZEOF(T,F) sizeof(T)
256 #else
257 # define n_VFIELD_SIZE(X) \
258 ((X) == 0 ? sizeof(size_t) \
259 : ((ssize_t)(X) < 0 ? sizeof(size_t) - n_ABS(X) : (size_t)(X)))
260 # define n_VSTRUCT_SIZEOF(T,F) (sizeof(T) - n_SIZEOF_FIELD(T, F))
261 #endif
263 #ifndef HAVE_INLINE
264 # define n_INLINE static
265 #endif
267 #undef __FUN__
268 #if defined __STDC_VERSION__ && __STDC_VERSION__ + 0 >= 199901L
269 # define __FUN__ __func__
270 #elif CC_CLANG || PREREQ_GCC(3, 4)
271 # define __FUN__ __extension__ __FUNCTION__
272 #else
273 # define __FUN__ n_empty /* Something that is not a literal */
274 #endif
276 #if defined __predict_true && defined __predict_false
277 # define n_LIKELY(X) __predict_true(X)
278 # define n_UNLIKELY(X) __predict_false(X)
279 #elif CC_CLANG || PREREQ_GCC(2, 96)
280 # define n_LIKELY(X) __builtin_expect(X, 1)
281 # define n_UNLIKELY(X) __builtin_expect(X, 0)
282 #else
283 # define n_LIKELY(X) (X)
284 # define n_UNLIKELY(X) (X)
285 #endif
287 #undef HAVE_NATCH_CHAR
288 #if defined HAVE_SETLOCALE && defined HAVE_C90AMEND1 && defined HAVE_WCWIDTH
289 # define HAVE_NATCH_CHAR
290 # define n_NATCH_CHAR(X) X
291 #else
292 # define n_NATCH_CHAR(X)
293 #endif
295 /* Compile-Time-Assert
296 * Problem is that some compilers warn on unused local typedefs, so add
297 * a special local CTA to overcome this */
298 #if defined __STDC_VERSION__ && __STDC_VERSION__ + 0 >= 201112L
299 # define n_CTA(T,M) _Static_assert(T, M)
300 # define n_LCTA(T,M) _Static_assert(T, M)
301 #else
302 # define n_CTA(T,M) n__CTA_1(T, n_FILE, __LINE__)
303 # define n_LCTA(T,M) n__LCTA_1(T, n_FILE, __LINE__)
304 #endif
305 #define n_CTAV(T) n_CTA(T, "Unexpected value of constant")
306 #define n_LCTAV(T) n_LCTA(T, "Unexpected value of constant")
308 #ifdef n_MAIN_SOURCE
309 # define n_MCTA(T,M) n_CTA(T, M);
310 #else
311 # define n_MCTA(T,M)
312 #endif
314 #define n__CTA_1(T,F,L) n__CTA_2(T, F, L)
315 #define n__CTA_2(T,F,L) \
316 typedef char ASSERTION_failed_in_file_## F ## _at_line_ ## L[(T) ? 1 : -1]
317 #define n__LCTA_1(T,F,L) n__LCTA_2(T, F, L)
318 #define n__LCTA_2(T,F,L) \
319 do{\
320 typedef char ASSERTION_failed_in_file_## F ## _at_line_ ## L[(T) ? 1 : -1];\
321 ASSERTION_failed_in_file_## F ## _at_line_ ## L __i_am_unused__;\
322 n_UNUSED(__i_am_unused__);\
323 }while(0)
325 #define n_UNINIT(N,V) N = V
327 /* Create a bit mask for the bit range LO..HI -- HI can't use highest bit! */
328 #define n_BITENUM_MASK(LO,HI) (((1u << ((HI) + 1)) - 1) & ~((1u << (LO)) - 1))
330 #undef DBG
331 #undef NDBG
332 #ifndef HAVE_DEBUG
333 # undef assert
334 # define assert(X) n_UNUSED(0)
335 # define DBG(X)
336 # define NDBG(X) X
337 # define DBGOR(X,Y) Y
338 #else
339 # define DBG(X) X
340 # define NDBG(X)
341 # define DBGOR(X,Y) X
342 #endif
344 /* Translation (init in main.c): may NOT set errno! */
345 #undef UIS
346 #undef A_
347 #undef _
348 #undef N_
349 #undef V_
350 #ifdef HAVE_UISTRINGS
351 # define UIS(X) X
352 # define A_(S) S
353 # define _(S) S
354 # define N_(S) S
355 # define V_(S) S
356 #else
357 # define UIS(X)
358 # define A_(S) S
359 # define _(S) n_empty
360 # define N_(S) ""
361 # define V_(S) n_empty
362 #endif
365 * Types TODO v15: n_XX_t
368 #ifdef UINT8_MAX
369 # define UI8_MAX UINT8_MAX
370 # define SI8_MIN INT8_MIN
371 # define SI8_MAX INT8_MAX
372 typedef uint8_t ui8_t;
373 typedef int8_t si8_t;
374 #elif UCHAR_MAX != 255
375 # error UCHAR_MAX must be 255
376 #else
377 # define UI8_MAX UCHAR_MAX
378 # define SI8_MIN CHAR_MIN
379 # define SI8_MAX CHAR_MAX
380 typedef unsigned char ui8_t;
381 typedef signed char si8_t;
382 #endif
384 #if !defined PRIu8 || !defined PRId8
385 # undef PRIu8
386 # undef PRId8
387 # define PRIu8 "hhu"
388 # define PRId8 "hhd"
389 #endif
391 #ifdef UINT16_MAX
392 # define UI16_MAX UINT16_MAX
393 # define SI16_MIN INT16_MIN
394 # define SI16_MAX INT16_MAX
395 typedef uint16_t ui16_t;
396 typedef int16_t si16_t;
397 #elif USHRT_MAX != 0xFFFFu
398 # error USHRT_MAX must be 0xFFFF
399 #else
400 # define UI16_MAX USHRT_MAX
401 # define SI16_MIN SHRT_MIN
402 # define SI16_MAX SHRT_MAX
403 typedef unsigned short ui16_t;
404 typedef signed short si16_t;
405 #endif
407 #if !defined PRIu16 || !defined PRId16
408 # undef PRIu16
409 # undef PRId16
410 # if UI16_MAX == UINT_MAX
411 # define PRIu16 "u"
412 # define PRId16 "d"
413 # else
414 # define PRIu16 "hu"
415 # define PRId16 "hd"
416 # endif
417 #endif
419 #ifdef UINT32_MAX
420 # define UI32_MAX UINT32_MAX
421 # define SI32_MIN INT32_MIN
422 # define SI32_MAX INT32_MAX
423 typedef uint32_t ui32_t;
424 typedef int32_t si32_t;
425 #elif ULONG_MAX == 0xFFFFFFFFu
426 # define UI32_MAX ULONG_MAX
427 # define SI32_MIN LONG_MIN
428 # define SI32_MAX LONG_MAX
429 typedef unsigned long int ui32_t;
430 typedef signed long int si32_t;
431 #elif UINT_MAX != 0xFFFFFFFFu
432 # error UINT_MAX must be 0xFFFFFFFF
433 #else
434 # define UI32_MAX UINT_MAX
435 # define SI32_MIN INT_MIN
436 # define SI32_MAX INT_MAX
437 typedef unsigned int ui32_t;
438 typedef signed int si32_t;
439 #endif
441 #if !defined PRIu32 || !defined PRId32
442 # undef PRIu32
443 # undef PRId32
444 # if UI32_MAX == ULONG_MAX
445 # define PRIu32 "lu"
446 # define PRId32 "ld"
447 # else
448 # define PRIu32 "u"
449 # define PRId32 "d"
450 # endif
451 #endif
453 #ifdef UINT64_MAX
454 # define UI64_MAX UINT64_MAX
455 # define SI64_MIN INT64_MIN
456 # define SI64_MAX INT64_MAX
457 typedef uint64_t ui64_t;
458 typedef int64_t si64_t;
459 #elif ULONG_MAX <= 0xFFFFFFFFu
460 # if !defined ULLONG_MAX || (ULLONG_MAX >> 31) < 0xFFFFFFFFu
461 # error We need a 64 bit integer
462 # else
463 # define UI64_MAX ULLONG_MAX
464 # define SI64_MIN LLONG_MIN
465 # define SI64_MAX LLONG_MAX
466 __EXTEN typedef unsigned long long ui64_t;
467 __EXTEN typedef signed long long si64_t;
468 # endif
469 #else
470 # define UI64_MAX ULONG_MAX
471 # define SI64_MIN LONG_MIN
472 # define SI64_MAX LONG_MAX
473 typedef unsigned long ui64_t;
474 typedef signed long si64_t;
475 #endif
477 /* PRIo64 for `vexpr' */
478 #if !defined PRIu64 || !defined PRId64 || !defined PRIX64 || !defined PRIo64
479 # undef PRIu64
480 # undef PRId64
481 # undef PRIX64
482 # undef PRIo64
483 # if defined ULLONG_MAX && UI64_MAX == ULLONG_MAX
484 # define PRIu64 "llu"
485 # define PRId64 "lld"
486 # define PRIX64 "llX"
487 # define PRIo64 "llo"
488 # else
489 # define PRIu64 "lu"
490 # define PRId64 "ld"
491 # define PRIX64 "lX"
492 # define PRIo64 "lo"
493 # endif
494 #endif
496 /* (So that we can use UICMP() for size_t comparison, too) */
497 typedef size_t uiz_t;
498 typedef ssize_t siz_t;
500 #undef PRIuZ
501 #undef PRIdZ
502 #if defined __STDC_VERSION__ && __STDC_VERSION__ + 0 >= 199901L
503 # define PRIuZ "zu"
504 # define PRIdZ "zd"
505 # define UIZ_MAX SIZE_MAX
506 #elif defined SIZE_MAX
507 /* UnixWare has size_t as unsigned as required but uses a signed limit
508 * constant (which is thus false!) */
509 # if SIZE_MAX == UI64_MAX || SIZE_MAX == SI64_MAX
510 # define PRIuZ PRIu64
511 # define PRIdZ PRId64
512 n_MCTA(sizeof(size_t) == sizeof(ui64_t),
513 "Format string mismatch, compile with ISO C99 compiler (-std=c99)!")
514 # elif SIZE_MAX == UI32_MAX || SIZE_MAX == SI32_MAX
515 # define PRIuZ PRIu32
516 # define PRIdZ PRId32
517 n_MCTA(sizeof(size_t) == sizeof(ui32_t),
518 "Format string mismatch, compile with ISO C99 compiler (-std=c99)!")
519 # else
520 # error SIZE_MAX is neither UI64_MAX nor UI32_MAX (please report this)
521 # endif
522 # define UIZ_MAX SIZE_MAX
523 #endif
524 #ifndef PRIuZ
525 # define PRIuZ "lu"
526 # define PRIdZ "ld"
527 n_MCTA(sizeof(size_t) == sizeof(unsigned long),
528 "Format string mismatch, compile with ISO C99 compiler (-std=c99)!")
529 # define UIZ_MAX ULONG_MAX
530 #endif
532 #ifndef UINTPTR_MAX
533 # ifdef SIZE_MAX
534 # define uintptr_t size_t
535 # else
536 # define uintptr_t unsigned long
537 # endif
538 #endif
540 #ifdef HAVE_C90AMEND1
541 typedef wchar_t wc_t;
542 # define n_WC_C(X) L ## X
543 #else
544 typedef char wc_t; /* Yep: really 8-bit char */
545 # define n_WC_C(X) X
546 #endif
548 enum {FAL0, TRU1, TRU2, TRUM1 = -1};
549 typedef si8_t bool_t;
551 /* Add shorter aliases for "normal" integers TODO v15 -> n_XX_t */
552 typedef unsigned long ul_i;
553 typedef unsigned int ui_i;
554 typedef unsigned short us_i;
555 typedef unsigned char uc_i;
557 typedef signed long sl_i;
558 typedef signed int si_i;
559 typedef signed short ss_i;
560 typedef signed char sc_i;
562 typedef void ( *sighandler_type)(int); /* TODO v15 obsolete */
563 typedef void ( *n_sighdl_t)(int);
565 enum n_announce_flags{
566 n_ANNOUNCE_NONE = 0, /* Only housekeeping */
567 n_ANNOUNCE_MAIN_CALL = 1u<<0, /* POSIX covered startup call */
568 n_ANNOUNCE_STATUS = 1u<<1, /* Only print status */
569 n_ANNOUNCE_CHANGE = 1u<<2, /* Folder changed */
571 n__ANNOUNCE_HEADER = 1u<<6,
572 n__ANNOUNCE_ANY = 1u<<7
575 enum authtype {
576 AUTHTYPE_NONE = 1<<0,
577 AUTHTYPE_PLAIN = 1<<1, /* POP3: APOP is covered by this */
578 AUTHTYPE_LOGIN = 1<<2,
579 AUTHTYPE_CRAM_MD5 = 1<<3,
580 AUTHTYPE_GSSAPI = 1<<4
583 enum expand_addr_flags {
584 EAF_NONE = 0, /* -> EAF_NOFILE | EAF_NOPIPE */
585 EAF_RESTRICT = 1<<0, /* "restrict" (do unless interaktive / -[~#]) */
586 EAF_FAIL = 1<<1, /* "fail" */
587 EAF_FAILINVADDR = 1<<2, /* "failinvaddr" */
588 /* TODO HACK! In pre-v15 we have a control flow problem (it is a general
589 * TODO design problem): if n_collect() calls makeheader(), e.g., for -t or
590 * TODO because of ~e diting, then that will checkaddr() and that will
591 * TODO remove invalid headers. However, this code path does not know
592 * TODO about keeping track of senderrors unless a pointer has been passed,
593 * TODO but which it doesn't for ~e, and shall not, too. Thus, invalid
594 * TODO addresses may be automatically removed, silently, and noone will
595 * TODO ever know, in particular not regarding "failinvaddr".
596 * TODO The hacky solution is this bit -- which can ONLY be used for fields
597 * TODO which will be subject to namelist_vaporise_head() later on!! --,
598 * TODO if it is set (by n_header_extract()) then checkaddr() will NOT strip
599 * TODO invalid headers off IF it deals with a NULL senderror pointer */
600 EAF_MAYKEEP = 1<<3,
601 /* Bits reused by enum expand_addr_check_mode! */
602 EAF_FILE = 1<<4, /* +"file" targets */
603 EAF_PIPE = 1<<5, /* +"pipe" command pipe targets */
604 EAF_NAME = 1<<6, /* +"name"s (non-address) names / MTA aliases */
605 EAF_ADDR = 1<<7, /* +"addr" network address (contain "@") */
607 EAF_TARGET_MASK = EAF_FILE | EAF_PIPE | EAF_NAME | EAF_ADDR,
608 EAF_RESTRICT_TARGETS = EAF_NAME | EAF_ADDR /* (default set if not set) */
611 enum expand_addr_check_mode {
612 EACM_NONE = 0, /* Don't care about *expandaddr* */
613 EACM_NORMAL = 1<<0, /* Use our normal *expandaddr* checking */
614 EACM_STRICT = 1<<1, /* Never allow any file or pipe addresse */
615 EACM_MODE_MASK = 0x3, /* _NORMAL and _STRICT are mutual! */
617 EACM_NOLOG = 1<<2, /* Don't log check errors */
619 /* Some special overwrites of EAF_TARGETs.
620 * May NOT clash with EAF_* bits which may be ORd to these here! */
622 EACM_NONAME = 1<<16
625 enum n_cmd_arg_flags{ /* TODO Most of these need to change, in fact in v15
626 * TODO i rather see the mechanism that is used in c_bind() extended and used
627 * TODO anywhere, i.e. n_cmd_arg_parse().
628 * TODO Note that we may NOT support arguments with strlen()>=UI32_MAX (?) */
629 n_CMD_ARG_TYPE_MSGLIST = 0, /* Message list type */
630 n_CMD_ARG_TYPE_NDMLIST = 1, /* Message list, no defaults */
631 n_CMD_ARG_TYPE_RAWDAT = 2, /* The plain string in an argv[] */
632 n_CMD_ARG_TYPE_STRING = 3, /* A pure string TODO obsolete */
633 n_CMD_ARG_TYPE_WYSH = 4, /* getrawlist(), sh(1) compatible */
634 n_CMD_ARG_TYPE_RAWLIST = 5, /* getrawlist(), old style TODO obsolete */
635 n_CMD_ARG_TYPE_WYRA = 6, /* _RAWLIST or _WYSH (with `wysh') TODO obs. */
636 n_CMD_ARG_TYPE_ARG = 7, /* n_cmd_arg_desc/n_cmd_arg() new-style */
637 n_CMD_ARG_TYPE_MASK = 7, /* Mask of the above */
639 n_CMD_ARG_A = 1u<<4, /* Needs an active mailbox */
640 n_CMD_ARG_F = 1u<<5, /* Is a conditional command */
641 n_CMD_ARG_G = 1u<<6, /* Is supposed to produce "gabby" history */
642 n_CMD_ARG_H = 1u<<7, /* Never place in `history' */
643 n_CMD_ARG_I = 1u<<8, /* Interactive command bit */
644 n_CMD_ARG_L = 1u<<9, /* Supports `local' prefix (only WYSH/WYRA) */
645 n_CMD_ARG_M = 1u<<10, /* Legal from send mode bit */
646 n_CMD_ARG_O = 1u<<11, /* n_OBSOLETE()d command */
647 n_CMD_ARG_P = 1u<<12, /* Autoprint dot after command */
648 n_CMD_ARG_R = 1u<<13, /* Forbidden in compose mode recursion */
649 n_CMD_ARG_SC = 1u<<14, /* Forbidden pre-n_PSO_STARTED_CONFIG */
650 n_CMD_ARG_S = 1u<<15, /* Forbidden pre-n_PSO_STARTED (POSIX) */
651 n_CMD_ARG_T = 1u<<16, /* Is a transparent command */
652 n_CMD_ARG_V = 1u<<17, /* Supports `vput' prefix (only WYSH/WYRA) */
653 n_CMD_ARG_W = 1u<<18, /* Invalid when read only bit */
654 n_CMD_ARG_X = 1u<<19, /* Valid command in n_PS_COMPOSE_FORKHOOK mode */
655 /* XXX Note that CMD_ARG_EM implies a _real_ return value for $! */
656 n_CMD_ARG_EM = 1u<<30 /* If error: n_pstate_err_no (4 $! aka. ok_v___em) */
659 enum n_cmd_arg_desc_flags{/* TODO incomplete, misses getmsglist() */
660 /* - A type */
661 n_CMD_ARG_DESC_STRING = 1u<<0, /* A !blankspacechar() string */
662 n_CMD_ARG_DESC_WYSH = 1u<<1, /* sh(1)ell-style quoted */
664 n__CMD_ARG_DESC_TYPE_MASK = n_CMD_ARG_DESC_STRING | n_CMD_ARG_DESC_WYSH,
666 /* - Optional flags */
667 /* It is not an error if an optional argument is missing; once an argument
668 * has been declared optional only optional arguments may follow */
669 n_CMD_ARG_DESC_OPTION = 1u<<16,
670 /* GREEDY: parse as many of that type as possible; must be last entry */
671 n_CMD_ARG_DESC_GREEDY = 1u<<17,
672 /* If greedy, join all given arguments separated by ASCII SP right away */
673 n_CMD_ARG_DESC_GREEDY_JOIN = 1u<<18,
674 /* Honour an overall "stop" request in one of the arguments (\c@ or #) */
675 n_CMD_ARG_DESC_HONOUR_STOP = 1u<<19,
677 n__CMD_ARG_DESC_FLAG_MASK = n_CMD_ARG_DESC_OPTION | n_CMD_ARG_DESC_GREEDY |
678 n_CMD_ARG_DESC_GREEDY_JOIN | n_CMD_ARG_DESC_HONOUR_STOP
681 #ifdef HAVE_COLOUR
682 /* We do have several contexts of colour IDs; since only one of them can be
683 * active at any given time let's share the value range */
684 enum n_colour_ctx{
685 n_COLOUR_CTX_SUM,
686 n_COLOUR_CTX_VIEW,
687 n_COLOUR_CTX_MLE,
688 n__COLOUR_CTX_MAX1
691 enum n_colour_id{
692 /* Header summary */
693 n_COLOUR_ID_SUM_DOTMARK = 0,
694 n_COLOUR_ID_SUM_HEADER,
695 n_COLOUR_ID_SUM_THREAD,
697 /* Message display */
698 n_COLOUR_ID_VIEW_FROM_ = 0,
699 n_COLOUR_ID_VIEW_HEADER,
700 n_COLOUR_ID_VIEW_MSGINFO,
701 n_COLOUR_ID_VIEW_PARTINFO,
703 /* Mailx-Line-Editor */
704 n_COLOUR_ID_MLE_POSITION = 0,
705 n_COLOUR_ID_MLE_PROMPT,
707 n__COLOUR_IDS = n_COLOUR_ID_VIEW_PARTINFO + 1
710 /* Colour preconditions, let's call them tags, cannot be an enum because for
711 * message display they are the actual header name of the current header. Thus
712 * let's use constants of pseudo pointers */
713 # define n_COLOUR_TAG_SUM_DOT ((char*)-2)
714 # define n_COLOUR_TAG_SUM_OLDER ((char*)-3)
715 #endif /* HAVE_COLOUR */
717 enum conversion {
718 CONV_NONE, /* no conversion */
719 CONV_7BIT, /* no conversion, is 7bit */
720 CONV_FROMQP, /* convert from quoted-printable */
721 CONV_TOQP, /* convert to quoted-printable */
722 CONV_8BIT, /* convert to 8bit (iconv) */
723 CONV_FROMB64, /* convert from base64 */
724 CONV_FROMB64_T, /* convert from base64/text */
725 CONV_TOB64, /* convert to base64 */
726 CONV_FROMHDR, /* convert from RFC1522 format */
727 CONV_TOHDR, /* convert to RFC1522 format */
728 CONV_TOHDR_A /* convert addresses for header */
731 enum cproto {
732 CPROTO_CERTINFO, /* Special dummy proto for TLS certificate info xxx */
733 CPROTO_CCRED, /* Special dummy credential proto (S/MIME etc.) */
734 CPROTO_SOCKS, /* Special dummy SOCKS5 proxy proto */
735 CPROTO_SMTP,
736 CPROTO_POP3
737 ,CPROTO_IMAP
740 enum n_dotlock_state{
741 n_DLS_NONE,
742 n_DLS_CANT_CHDIR, /* Failed to chdir(2) into desired path */
743 n_DLS_NAMETOOLONG, /* Lock file name would be too long */
744 n_DLS_ROFS, /* Read-only filesystem (no error, mailbox RO) */
745 n_DLS_NOPERM, /* No permission to creat lock file */
746 n_DLS_NOEXEC, /* Privilege separated dotlocker not found */
747 n_DLS_PRIVFAILED, /* Rising privileges failed in dotlocker */
748 n_DLS_EXIST, /* Lock file already exists, stale lock? */
749 n_DLS_FISHY, /* Something makes us think bad of situation */
750 n_DLS_DUNNO, /* Catch-all error */
751 n_DLS_PING, /* Not an error, but have to wait for lock */
752 n_DLS_ABANDON = 1<<7 /* ORd to any but _NONE: give up, don't retry */
755 /* enum n_err_number from mk-config.h, which is in sync with
756 * n_err_to_doc(), n_err_to_name() and n_err_from_name() */
758 enum n_exit_status{
759 n_EXIT_OK = EXIT_SUCCESS,
760 n_EXIT_ERR = EXIT_FAILURE,
761 n_EXIT_USE = 64, /* sysexits.h:EX_USAGE */
762 n_EXIT_NOUSER = 67, /* :EX_NOUSER */
763 n_EXIT_COLL_ABORT = 1<<1, /* Message collection was aborted */
764 n_EXIT_SEND_ERROR = 1<<2 /* Unspecified send error occurred */
767 enum fedit_mode {
768 FEDIT_NONE = 0,
769 FEDIT_SYSBOX = 1u<<0, /* %: prefix */
770 FEDIT_RDONLY = 1u<<1, /* Readonly (per-box, n_OPT_R_FLAG is global) */
771 FEDIT_NEWMAIL = 1u<<2, /* `newmail' operation TODO OBSOLETE THIS! */
772 FEDIT_ACCOUNT = 1u<<3 /* setfile() called by `account' */
775 enum fexp_mode {
776 FEXP_FULL, /* Full expansion */
777 FEXP_NOPROTO = 1<<0, /* TODO no which_protocol() to decide expansion */
778 FEXP_SILENT = 1<<1, /* Don't print but only return errors */
779 FEXP_MULTIOK = 1<<2, /* Expansion to many entries is ok */
780 FEXP_LOCAL = 1<<3, /* Result must be local file/maildir */
781 FEXP_NSHORTCUT = 1<<4, /* Don't expand shortcuts */
782 FEXP_NSPECIAL = 1<<5, /* No %,#,& specials */
783 FEXP_NFOLDER = 1<<6, /* NSPECIAL and no + folder, too */
784 FEXP_NSHELL = 1<<7, /* Don't do shell word exp. (but ~/, $VAR) */
785 FEXP_NVAR = 1<<8 /* ..not even $VAR expansion */
788 enum n_file_lock_type{
789 FLT_READ,
790 FLT_WRITE
793 enum n_fopen_state{ /* TODO add n_fopen_mode, too */
794 /* First n__PROTO_SHIFT bits are enum protocol! n_MCTA()d below */
795 n_FOPEN_STATE_NONE = 0,
796 n_FOPEN_STATE_EXISTS = 1u<<5
799 enum n_go_input_flags{
800 n_GO_INPUT_NONE,
801 n_GO_INPUT_CTX_BASE = 0, /* Generic shared base: don't use! */
802 n_GO_INPUT_CTX_DEFAULT = 1, /* Default input */
803 n_GO_INPUT_CTX_COMPOSE = 2, /* Compose mode input */
804 n__GO_INPUT_CTX_MASK = 3,
805 n__GO_INPUT_CTX_MAX1 = n_GO_INPUT_CTX_COMPOSE + 1,
807 n_GO_INPUT_HOLDALLSIGS = 1u<<8, /* hold_all_sigs() active TODO */
808 /* `xcall' is `call' (at the level where this is set): to be set when
809 * teardown of top level has undesired effects, e.g., for `account's and
810 * folder hooks etc., where we do not to loose our `localopts' unroll list */
811 n_GO_INPUT_NO_XCALL = 1u<<9,
813 n_GO_INPUT_FORCE_STDIN = 1u<<10, /* Even in macro, use stdin (`read')! */
814 n_GO_INPUT_NL_ESC = 1u<<11, /* Support "\\$" line continuation */
815 n_GO_INPUT_NL_FOLLOW = 1u<<12, /* ..on such a follow line */
816 n_GO_INPUT_PROMPT_NONE = 1u<<13, /* Don't print prompt */
817 n_GO_INPUT_PROMPT_EVAL = 1u<<14, /* Instead, evaluate *prompt* */
819 n_GO_INPUT_HIST_ADD = 1u<<16, /* Add the result to history list */
820 n_GO_INPUT_HIST_GABBY = 1u<<17, /* Consider history entry as gabby */
822 n__GO_FREEBIT = 24
825 enum n_go_input_inject_flags{
826 n_GO_INPUT_INJECT_NONE = 0,
827 n_GO_INPUT_INJECT_COMMIT = 1u<<0, /* Auto-commit input */
828 n_GO_INPUT_INJECT_HISTORY = 1u<<1 /* Allow history addition */
831 enum n_iconv_flags{
832 n_ICONV_NONE = 0,
833 n_ICONV_IGN_ILSEQ = 1<<0, /* Ignore EILSEQ in input (replacement char) */
834 n_ICONV_IGN_NOREVERSE = 1<<1, /* .. non-reversible conversions in output */
835 n_ICONV_UNIREPL = 1<<2, /* Use Unicode replacement 0xFFFD = EF BF BD */
836 n_ICONV_DEFAULT = n_ICONV_IGN_ILSEQ | n_ICONV_IGN_NOREVERSE,
837 n_ICONV_UNIDEFAULT = n_ICONV_DEFAULT | n_ICONV_UNIREPL
840 /* Special ignore (where _TYPE is covered by POSIX `ignore' / `retain').
841 * _ALL is very special in that it doesn't have a backing object.
842 * Go over enum to avoid cascads of (different) CC warnings for used CTA()s */
843 #define n_IGNORE_ALL ((struct n_ignore*)n__IGNORE_ALL)
844 #define n_IGNORE_TYPE ((struct n_ignore*)n__IGNORE_TYPE)
845 #define n_IGNORE_SAVE ((struct n_ignore*)n__IGNORE_SAVE)
846 #define n_IGNORE_FWD ((struct n_ignore*)n__IGNORE_FWD)
847 #define n_IGNORE_TOP ((struct n_ignore*)n__IGNORE_TOP)
849 enum{
850 n__IGNORE_ALL = -2,
851 n__IGNORE_TYPE = -3,
852 n__IGNORE_SAVE = -4,
853 n__IGNORE_FWD = -5,
854 n__IGNORE_TOP = -6,
855 n__IGNORE_ADJUST = 3,
856 n__IGNORE_MAX = 6 - n__IGNORE_ADJUST
859 enum n_idec_mode{
860 n_IDEC_MODE_NONE,
861 n_IDEC_MODE_SIGNED_TYPE = 1u<<0, /* To choose limits, error constants etc. */
862 /* If a power-of-two is used explicitly, or if base 0 is used and a known
863 * standard prefix is seen, enforce interpretation as unsigned. This only
864 * makes a difference in conjunction with n_IDEC_MODE_SIGNED_TYPE */
865 n_IDEC_MODE_POW2BASE_UNSIGNED = 1u<<1,
866 #if 0
867 n_IDEC_MODE_SIGN_FORCE_SIGNED_TYPE = 1u<<2,
868 #endif
869 n_IDEC_MODE_LIMIT_8BIT = 1u<<3, /* Saturate if result exceeds 8-bit */
870 n_IDEC_MODE_LIMIT_16BIT = 2u<<3,
871 n_IDEC_MODE_LIMIT_32BIT = 3u<<3,
872 n__IDEC_MODE_LIMIT_MASK = 3u<<3,
873 n_IDEC_MODE_LIMIT_NOERROR = 1u<<5, /* Not an error if limit is excessed! */
874 /* These bits are duplicated in the _state result bits! */
875 n__IDEC_MODE_MASK = (1u<<6) - 1
878 enum n_idec_state{
879 n_IDEC_STATE_NONE,
880 /* Malformed input, no usable result has been stored */
881 n_IDEC_STATE_EINVAL = 1u<<8,
882 /* Bad character according to base, but we have seen some good before,
883 * otherwise _EINVAL would have been used */
884 n_IDEC_STATE_EBASE = 2u<<8,
885 n_IDEC_STATE_EOVERFLOW = 3u<<8, /* Result too large */
886 n_IDEC_STATE_EMASK = 3u<<8, /* Any errors, that is */
887 n_IDEC_STATE_SEEN_MINUS = 1u<<16, /* Seen - in input? */
888 n_IDEC_STATE_CONSUMED = 1u<<17, /* All the input buffer was consumed */
889 n__IDEC_PRIVATE_SHIFT1 = 24u
891 n_MCTA(n__IDEC_MODE_MASK <= (1u<<8) - 1, "Shared bit range overlaps")
893 /* Buffer size needed by n_ienc_buf() including NUL and base prefixes */
894 #define n_IENC_BUFFER_SIZE 80
896 enum n_ienc_mode{
897 n_IENC_MODE_NONE,
898 n_IENC_MODE_SIGNED_TYPE = 1u<<1, /* Signedness correction etc. necessary */
899 n_IENC_MODE_SIGNED_PLUS = 1u<<2, /* Positive nubers shall have + prefix */
900 n_IENC_MODE_SIGNED_SPACE = 1u<<3, /* Ditto, ASCII SPACE (lesser priority) */
901 n_IENC_MODE_NO_PREFIX = 1u<<4, /* No base prefixes shall be written */
902 n_IENC_MODE_LOWERCASE = 1u<<5, /* Use lowercase letters (not prefix) */
903 n__IENC_MODE_SHIFT = 6u,
904 n__IENC_MODE_MASK = (1u<<n__IENC_MODE_SHIFT) - 1
907 enum mimecontent {
908 MIME_UNKNOWN, /* unknown content */
909 MIME_SUBHDR, /* inside a multipart subheader */
910 MIME_822, /* message/rfc822 content */
911 MIME_MESSAGE, /* other message/ content */
912 MIME_TEXT_PLAIN, /* text/plain content */
913 MIME_TEXT_HTML, /* text/html content */
914 MIME_TEXT, /* other text/ content */
915 MIME_ALTERNATIVE, /* multipart/alternative content */
916 MIME_RELATED, /* mime/related (RFC 2387) */
917 MIME_DIGEST, /* multipart/digest content */
918 MIME_SIGNED, /* multipart/signed */
919 MIME_ENCRYPTED, /* multipart/encrypted */
920 MIME_MULTI, /* other multipart/ content */
921 MIME_PKCS7, /* PKCS7 content */
922 MIME_DISCARD /* content is discarded */
925 enum mime_counter_evidence {
926 MIMECE_NONE,
927 MIMECE_SET = 1<<0, /* *mime-counter-evidence* was set */
928 MIMECE_BIN_OVWR = 1<<1, /* appli../octet-stream: check, ovw if possible */
929 MIMECE_ALL_OVWR = 1<<2, /* all: check, ovw if possible */
930 MIMECE_BIN_PARSE = 1<<3 /* appli../octet-stream: classify contents last */
933 /* Content-Transfer-Encodings as defined in RFC 2045:
934 * - Quoted-Printable, section 6.7
935 * - Base64, section 6.8 */
936 #define QP_LINESIZE (4 * 19) /* Max. compliant QP linesize */
938 #define B64_LINESIZE (4 * 19) /* Max. compliant Base64 linesize */
939 #define B64_ENCODE_INPUT_PER_LINE ((B64_LINESIZE / 4) * 3)
941 enum mime_enc {
942 MIMEE_NONE, /* message is not in MIME format */
943 MIMEE_BIN, /* message is in binary encoding */
944 MIMEE_8B, /* message is in 8bit encoding */
945 MIMEE_7B, /* message is in 7bit encoding */
946 MIMEE_QP, /* message is quoted-printable */
947 MIMEE_B64 /* message is in base64 encoding */
950 /* xxx QP came later, maybe rewrite all to use mime_enc_flags directly? */
951 enum mime_enc_flags {
952 MIMEEF_NONE,
953 MIMEEF_SALLOC = 1<<0, /* Use n_autorec_alloc(), not n_realloc().. */
954 /* ..result .s,.l point to user buffer of *_LINESIZE+[+[+]] bytes instead */
955 MIMEEF_BUF = 1<<1,
956 MIMEEF_CRLF = 1<<2, /* (encode) Append "\r\n" to lines */
957 MIMEEF_LF = 1<<3, /* (encode) Append "\n" to lines */
958 /* (encode) If one of _CRLF/_LF is set, honour *_LINESIZE+[+[+]] and
959 * inject the desired line-ending whenever a linewrap is desired */
960 MIMEEF_MULTILINE = 1<<4,
961 /* (encode) Quote with header rules, do not generate soft NL breaks?
962 * For mustquote(), specifies whether special RFC 2047 header rules
963 * should be used instead */
964 MIMEEF_ISHEAD = 1<<5,
965 /* (encode) Ditto; for mustquote() this furtherly fine-tunes behaviour in
966 * that characters which would not be reported as "must-quote" when
967 * detecting whether quoting is necessary at all will be reported as
968 * "must-quote" if they have to be encoded in an encoded word */
969 MIMEEF_ISENCWORD = 1<<6,
970 __MIMEEF_LAST = 6
973 enum qpflags {
974 QP_NONE = MIMEEF_NONE,
975 QP_SALLOC = MIMEEF_SALLOC,
976 QP_BUF = MIMEEF_BUF,
977 QP_ISHEAD = MIMEEF_ISHEAD,
978 QP_ISENCWORD = MIMEEF_ISENCWORD
981 enum b64flags {
982 B64_NONE = MIMEEF_NONE,
983 B64_SALLOC = MIMEEF_SALLOC,
984 B64_BUF = MIMEEF_BUF,
985 B64_CRLF = MIMEEF_CRLF,
986 B64_LF = MIMEEF_LF,
987 B64_MULTILINE = MIMEEF_MULTILINE,
988 /* Not used, but for clarity only */
989 B64_ISHEAD = MIMEEF_ISHEAD,
990 B64_ISENCWORD = MIMEEF_ISENCWORD,
991 /* Special version of Base64, "Base64URL", according to RFC 4648.
992 * Only supported for encoding! */
993 B64_RFC4648URL = 1<<(__MIMEEF_LAST+1),
994 /* Don't use any ("=") padding;
995 * may NOT be used with any of _CRLF, _LF or _MULTILINE */
996 B64_NOPAD = 1<<(__MIMEEF_LAST+2)
999 enum mime_parse_flags {
1000 MIME_PARSE_NONE,
1001 MIME_PARSE_DECRYPT = 1u<<0,
1002 MIME_PARSE_PARTS = 1u<<1,
1003 MIME_PARSE_SHALLOW = 1u<<2,
1004 /* In effect we parse this message for user display or quoting purposes, so
1005 * relaxed rules regarding content inspection may be applicable */
1006 MIME_PARSE_FOR_USER_CONTEXT = 1u<<3
1009 enum mime_handler_flags {
1010 MIME_HDL_NULL, /* No pipe- mimetype handler, go away */
1011 MIME_HDL_CMD, /* Normal command */
1012 MIME_HDL_TEXT, /* @ special cmd to force treatment as text */
1013 MIME_HDL_PTF, /* A special pointer-to-function handler */
1014 MIME_HDL_MSG, /* Display msg (returned as command string) */
1015 MIME_HDL_TYPE_MASK = 7u,
1016 MIME_HDL_COPIOUSOUTPUT = 1u<<4, /* _CMD produces reintegratable text */
1017 MIME_HDL_ISQUOTE = 1u<<5, /* Is quote action (we have info, keep it!) */
1018 MIME_HDL_NOQUOTE = 1u<<6, /* No MIME for quoting */
1019 MIME_HDL_ASYNC = 1u<<7, /* Should run asynchronously */
1020 MIME_HDL_NEEDSTERM = 1u<<8, /* Takes over terminal */
1021 MIME_HDL_TMPF = 1u<<9, /* Create temporary file (zero-sized) */
1022 MIME_HDL_TMPF_FILL = 1u<<10, /* Fill in the msg body content */
1023 MIME_HDL_TMPF_UNLINK = 1u<<11 /* Delete it later again */
1026 enum mlist_state {
1027 MLIST_OTHER = 0, /* Normal address */
1028 MLIST_KNOWN = 1, /* A known `mlist' */
1029 MLIST_SUBSCRIBED = -1 /* A `mlsubscribe'd list */
1032 enum oflags {
1033 OF_RDONLY = 1u<<0,
1034 OF_WRONLY = 1u<<1,
1035 OF_RDWR = 1u<<2,
1036 OF_APPEND = 1u<<3,
1037 OF_CREATE = 1u<<4,
1038 OF_TRUNC = 1u<<5,
1039 OF_EXCL = 1u<<6,
1040 OF_UNLINK = 1u<<7, /* Only for Ftmp(): unlink(2) after creation */
1041 OF_HOLDSIGS = 1u<<8, /* Ftmp(): await Ftmp_free(), mutual OF_UNLINK */
1042 OF_FN_AUTOREC = 1u<<9, /* Ftmp(): fn not on heap, mutual OF_UNLINK */
1043 OF_REGISTER = 1u<<10, /* Register file in our file table */
1044 OF_REGISTER_UNLINK = 1u<<11, /* unlink(2) upon unreg.; _REGISTER asserted */
1045 OF_SUFFIX = 1u<<12 /* Ftmp() name hint is mandatory! extension! */
1048 enum okay {
1049 STOP = 0,
1050 OKAY = 1
1053 enum okey_xlook_mode {
1054 OXM_PLAIN = 1<<0, /* Plain key always tested */
1055 OXM_H_P = 1<<1, /* Check PLAIN-.url_h_p */
1056 OXM_U_H_P = 1<<2, /* Check PLAIN-.url_u_h_p */
1057 OXM_ALL = 0x7
1060 /* <0 means "stop" unless *prompt* extensions are enabled. */
1061 enum prompt_exp {
1062 PROMPT_STOP = -1, /* \c */
1063 /* *prompt* extensions: \$, \@ etc. */
1064 PROMPT_DOLLAR = -2,
1065 PROMPT_AT = -3
1068 enum protocol {
1069 n_PROTO_NONE,
1070 n_PROTO_FILE, /* refers to a local file */
1071 PROTO_FILE = n_PROTO_FILE,
1072 n_PROTO_POP3, /* is a pop3 server string */
1073 PROTO_POP3 = n_PROTO_POP3,
1074 n_PROTO_IMAP,
1075 PROTO_IMAP = n_PROTO_IMAP,
1076 n_PROTO_MAILDIR, /* refers to a maildir folder */
1077 PROTO_MAILDIR = n_PROTO_MAILDIR,
1078 n_PROTO_UNKNOWN, /* unknown protocol */
1079 PROTO_UNKNOWN = n_PROTO_UNKNOWN,
1081 n__PROTO_SHIFT = n_PROTO_UNKNOWN,
1082 n_PROTO_MASK = (1u << n__PROTO_SHIFT) - 1
1084 n_MCTA(n__PROTO_SHIFT == 5, "enum n_fopen_state shift value must be adjusted!")
1086 enum sendaction {
1087 SEND_MBOX, /* no conversion to perform */
1088 SEND_RFC822, /* no conversion, no From_ line */
1089 SEND_TODISP, /* convert to displayable form */
1090 SEND_TODISP_ALL, /* same, include all MIME parts */
1091 SEND_TODISP_PARTS, /* same, but only interactive, user-selected parts */
1092 SEND_SHOW, /* convert to 'show' command form */
1093 SEND_TOSRCH, /* convert for IMAP SEARCH */
1094 SEND_TOFILE, /* convert for saving body to a file */
1095 SEND_TOPIPE, /* convert for pipe-content/subc. */
1096 SEND_QUOTE, /* convert for quoting */
1097 SEND_QUOTE_ALL, /* same, include all MIME parts */
1098 SEND_DECRYPT /* decrypt */
1101 enum n_shexp_parse_flags{
1102 n_SHEXP_PARSE_NONE,
1103 /* Don't perform expansions or interpret reverse solidus escape sequences.
1104 * Output may be NULL, otherwise the possibly trimmed non-expanded input is
1105 * used as output (implies _PARSE_META_KEEP) */
1106 n_SHEXP_PARSE_DRYRUN = 1u<<0,
1107 n_SHEXP_PARSE_TRUNC = 1u<<1, /* Truncate result storage on entry */
1108 n_SHEXP_PARSE_TRIM_SPACE = 1u<<2, /* ..surrounding tokens */
1109 n_SHEXP_PARSE_TRIM_IFSSPACE = 1u<<3, /* " */
1110 n_SHEXP_PARSE_LOG = 1u<<4, /* Log errors */
1111 n_SHEXP_PARSE_LOG_D_V = 1u<<5, /* Log errors if n_PO_D_V */
1112 n_SHEXP_PARSE_IFS_VAR = 1u<<6, /* IFS is *ifs*, not blankchar() */
1113 n_SHEXP_PARSE_IFS_ADD_COMMA = 1u<<7, /* Add comma , to normal "IFS" */
1114 n_SHEXP_PARSE_IFS_IS_COMMA = 1u<<8, /* Let comma , be the sole "IFS" */
1115 n_SHEXP_PARSE_IGNORE_EMPTY = 1u<<9, /* Ignore empty tokens, start over */
1117 /* Implicitly open quotes, and ditto closing. _AUTO_FIXED may only be used
1118 * if an auto-quote-mode is enabled, implies _AUTO_CLOSE and causes the
1119 * quote mode to be permanently active (cannot be closed) */
1120 n_SHEXP_PARSE_QUOTE_AUTO_FIXED = 1u<<16,
1121 n_SHEXP_PARSE_QUOTE_AUTO_SQ = 1u<<17,
1122 n_SHEXP_PARSE_QUOTE_AUTO_DQ = 1u<<18,
1123 n_SHEXP_PARSE_QUOTE_AUTO_DSQ = 1u<<19,
1124 n_SHEXP_PARSE_QUOTE_AUTO_CLOSE = 1u<<20, /* Ignore an open quote at EOS */
1125 n__SHEXP_PARSE_QUOTE_AUTO_MASK = n_SHEXP_PARSE_QUOTE_AUTO_SQ |
1126 n_SHEXP_PARSE_QUOTE_AUTO_DQ | n_SHEXP_PARSE_QUOTE_AUTO_DSQ,
1128 /* Recognize metacharacters to separate tokens */
1129 n_SHEXP_PARSE_META_VERTBAR = 1u<<21,
1130 n_SHEXP_PARSE_META_AMPERSAND = 1u<<22,
1131 /* Interpret ; as a sequencing operator, go_input_inject() remainder */
1132 n_SHEXP_PARSE_META_SEMICOLON = 1u<<23,
1133 /* LPAREN, RPAREN, LESSTHAN, GREATERTHAN */
1135 n_SHEXP_PARSE_META_MASK = n_SHEXP_PARSE_META_VERTBAR |
1136 n_SHEXP_PARSE_META_AMPERSAND | n_SHEXP_PARSE_META_SEMICOLON,
1138 /* Keep the metacharacter (or IFS character), do not skip over it */
1139 n_SHEXP_PARSE_META_KEEP = 1u<<24,
1141 n__SHEXP_PARSE_LAST = 24
1144 enum n_shexp_state{
1145 n_SHEXP_STATE_NONE,
1146 /* We have produced some output (or would have, with _PARSE_DRYRUN).
1147 * Note that empty quotes like '' produce no output but set this bit */
1148 n_SHEXP_STATE_OUTPUT = 1u<<0,
1149 /* Don't call the parser again (# comment seen; out of input).
1150 * Not (necessarily) mutual with _OUTPUT) */
1151 n_SHEXP_STATE_STOP = 1u<<1,
1152 n_SHEXP_STATE_UNICODE = 1u<<2, /* \[Uu] used */
1153 n_SHEXP_STATE_CONTROL = 1u<<3, /* Control characters seen */
1154 n_SHEXP_STATE_QUOTE = 1u<<4, /* Any quotes seen */
1155 n_SHEXP_STATE_WS_LEAD = 1u<<5, /* _TRIM_{IFS,}SPACE: seen.. */
1156 n_SHEXP_STATE_WS_TRAIL = 1u<<6, /* .. leading / trailing WS */
1157 n_SHEXP_STATE_META_VERTBAR = 1u<<7, /* Metacharacter | follows/ed */
1158 n_SHEXP_STATE_META_AMPERSAND = 1u<<8, /* Metacharacter & follows/ed */
1159 n_SHEXP_STATE_META_SEMICOLON = 1u<<9, /* Metacharacter ; follows/ed */
1161 n_SHEXP_STATE_META_MASK = n_SHEXP_STATE_META_VERTBAR |
1162 n_SHEXP_STATE_META_AMPERSAND | n_SHEXP_STATE_META_SEMICOLON,
1164 n_SHEXP_STATE_ERR_CONTROL = 1u<<16, /* \c notation with invalid arg. */
1165 n_SHEXP_STATE_ERR_UNICODE = 1u<<17, /* Valid \[Uu] and !n_PSO_UNICODE */
1166 n_SHEXP_STATE_ERR_NUMBER = 1u<<18, /* Bad number (\[UuXx]) */
1167 n_SHEXP_STATE_ERR_IDENTIFIER = 1u<<19, /* Invalid identifier */
1168 n_SHEXP_STATE_ERR_BADSUB = 1u<<20, /* Empty/bad ${}/[] substitution */
1169 n_SHEXP_STATE_ERR_GROUPOPEN = 1u<<21, /* _QUOTEOPEN + no }/]/)/ 4 ${/[/( */
1170 n_SHEXP_STATE_ERR_QUOTEOPEN = 1u<<22, /* Quote remains open at EOS */
1172 n_SHEXP_STATE_ERR_MASK = n_BITENUM_MASK(16, 22)
1175 enum n_sigman_flags{
1176 n_SIGMAN_NONE = 0,
1177 n_SIGMAN_HUP = 1<<0,
1178 n_SIGMAN_INT = 1<<1,
1179 n_SIGMAN_QUIT = 1<<2,
1180 n_SIGMAN_TERM = 1<<3,
1181 n_SIGMAN_PIPE = 1<<4,
1183 n_SIGMAN_IGN_HUP = 1<<5,
1184 n_SIGMAN_IGN_INT = 1<<6,
1185 n_SIGMAN_IGN_QUIT = 1<<7,
1186 n_SIGMAN_IGN_TERM = 1<<8,
1188 n_SIGMAN_ALL = 0xFF,
1189 /* Mostly for _leave() reraise flags */
1190 n_SIGMAN_VIPSIGS = n_SIGMAN_HUP | n_SIGMAN_INT | n_SIGMAN_QUIT |
1191 n_SIGMAN_TERM,
1192 n_SIGMAN_NTTYOUT_PIPE = 1<<16,
1193 n_SIGMAN_VIPSIGS_NTTYOUT = n_SIGMAN_HUP | n_SIGMAN_INT | n_SIGMAN_QUIT |
1194 n_SIGMAN_TERM | n_SIGMAN_NTTYOUT_PIPE,
1196 n__SIGMAN_PING = 1<<17
1199 enum n_str_trim_flags{
1200 n_STR_TRIM_FRONT = 1u<<0,
1201 n_STR_TRIM_END = 1u<<1,
1202 n_STR_TRIM_BOTH = n_STR_TRIM_FRONT | n_STR_TRIM_END
1205 #ifdef HAVE_TLS
1206 enum n_tls_verify_level{
1207 n_TLS_VERIFY_IGNORE,
1208 n_TLS_VERIFY_WARN,
1209 n_TLS_VERIFY_ASK,
1210 n_TLS_VERIFY_STRICT
1212 #endif
1214 enum tdflags {
1215 TD_NONE, /* no display conversion */
1216 TD_ISPR = 1<<0, /* use isprint() checks */
1217 TD_ICONV = 1<<1, /* use iconv() */
1218 TD_DELCTRL = 1<<2, /* delete control characters */
1221 * NOTE: _TD_EOF and _TD_BUFCOPY may be ORd with enum conversion and
1222 * enum sendaction, and may thus NOT clash with their bit range!
1224 _TD_EOF = 1<<14, /* EOF seen, last round! */
1225 _TD_BUFCOPY = 1<<15 /* Buffer may be constant, copy it */
1228 #ifdef n_HAVE_TCAP
1229 enum n_termcap_captype{
1230 n_TERMCAP_CAPTYPE_NONE = 0,
1231 /* Internally we share the bitspace, so ensure no value ends up as 0 */
1232 n_TERMCAP_CAPTYPE_BOOL = 1,
1233 n_TERMCAP_CAPTYPE_NUMERIC,
1234 n_TERMCAP_CAPTYPE_STRING,
1235 n__TERMCAP_CAPTYPE_MAX1
1238 /* Termcap commands; different to queries commands perform actions.
1239 * Commands are resolved upon init time, and are all termcap(5)-compatible,
1240 * therefore we use the short termcap(5) names.
1241 * Note this is parsed by make-tcap-map.pl, which expects the syntax
1242 * "CONSTANT, COMMENT" where COMMENT is "Capname/TCap-Code, TYPE[, FLAGS]",
1243 * and one of Capname and TCap-Code may be the string "-" meaning ENOENT;
1244 * a | vertical bar or end-of-comment ends processing; see termcap.c.
1245 * We may use the free-form part after | for the "Variable String" and notes on
1246 * necessary termcap_cmd() arguments; if those are in [] brackets they are not
1247 * regular but are only used when the command, i.e., its effect, is somehow
1248 * simulated / faked by a built-in fallback implementation.
1249 * Availability of built-in fallback indicated by leading @ (at-sign) */
1250 enum n_termcap_cmd{
1251 # ifdef HAVE_TERMCAP
1252 n_TERMCAP_CMD_te, /* rmcup/te, STRING | exit_ca_mode: -,- */
1253 n_TERMCAP_CMD_ti, /* smcup/ti, STRING | enter_ca_mode: -,- */
1255 n_TERMCAP_CMD_ks, /* smkx/ks, STRING | keypad_xmit: -,- */
1256 n_TERMCAP_CMD_ke, /* rmkx/ke, STRING | keypad_local: -,- */
1257 # endif
1259 # ifdef HAVE_MLE
1260 n_TERMCAP_CMD_ce, /* el/ce, STRING | @ clr_eol: [start-column],- */
1261 n_TERMCAP_CMD_ch, /* hpa/ch, STRING, IDX1 | column_address: column,- */
1262 n_TERMCAP_CMD_cr, /* cr/cr, STRING | @ carriage_return: -,- */
1263 n_TERMCAP_CMD_le, /* cub1/le, STRING, CNT | @ cursor_left: count,- */
1264 n_TERMCAP_CMD_nd, /* cuf1/nd, STRING, CNT | @ cursor_right: count,- */
1266 # ifdef HAVE_TERMCAP
1267 n_TERMCAP_CMD_cd, /* ed/cd, STRING | clr_eos: -,- */
1268 n_TERMCAP_CMD_ho, /* home/ho, STRING | cursor_home: -,- */
1269 # endif
1270 n_TERMCAP_CMD_cl, /* clear/cl, STRING | clear_screen(+home): -,- */
1271 # endif
1273 n__TERMCAP_CMD_MAX1,
1274 n__TERMCAP_CMD_MASK = (1<<24) - 1,
1276 /* Only perform command if ca-mode is used */
1277 n_TERMCAP_CMD_FLAG_CA_MODE = 1<<29,
1278 /* I/O should be flushed after command completed */
1279 n_TERMCAP_CMD_FLAG_FLUSH = 1<<30
1282 /* Termcap queries; a query is a command that returns a struct n_termcap_value.
1283 * Queries are resolved once they are used first, and may not be termcap(5)-
1284 * compatible, therefore we use terminfo(5) names.
1285 * Note this is parsed by make-tcap-map.pl, which expects the syntax
1286 * "CONSTANT, COMMENT" where COMMENT is "Capname/TCap-Code, TYPE[, FLAGS]",
1287 * and one of Capname and TCap-Code may be the string "-" meaning ENOENT;
1288 * a | vertical bar or end-of-comment ends processing; see termcap.c.
1289 * We may use the free-form part after | for the "Variable String" and notes.
1290 * The "xkey | X:" keys are Dickey's xterm extensions, see (our) manual */
1291 enum n_termcap_query{
1292 # ifdef HAVE_COLOUR
1293 n_TERMCAP_QUERY_colors, /* colors/Co, NUMERIC | max_colors */
1294 # endif
1296 /* --make-tcap-map--: only KEY_BINDINGS follow. DON'T CHANGE THIS LINE! */
1297 /* Update the `bind' manual on change! */
1298 # ifdef HAVE_KEY_BINDINGS
1299 n_TERMCAP_QUERY_key_backspace, /* kbs/kb, STRING */
1300 n_TERMCAP_QUERY_key_dc, /* kdch1/kD, STRING | delete-character */
1301 n_TERMCAP_QUERY_key_sdc, /* kDC / *4, STRING | ..shifted */
1302 n_TERMCAP_QUERY_key_eol, /* kel/kE, STRING | clear-to-end-of-line */
1303 n_TERMCAP_QUERY_key_exit, /* kext/@9, STRING */
1304 n_TERMCAP_QUERY_key_ic, /* kich1/kI, STRING | insert character */
1305 n_TERMCAP_QUERY_key_sic, /* kIC/#3, STRING | ..shifted */
1306 n_TERMCAP_QUERY_key_home, /* khome/kh, STRING */
1307 n_TERMCAP_QUERY_key_shome, /* kHOM/#2, STRING | ..shifted */
1308 n_TERMCAP_QUERY_key_end, /* kend/@7, STRING */
1309 n_TERMCAP_QUERY_key_send, /* kEND / *7, STRING | ..shifted */
1310 n_TERMCAP_QUERY_key_npage, /* knp/kN, STRING */
1311 n_TERMCAP_QUERY_key_ppage, /* kpp/kP, STRING */
1312 n_TERMCAP_QUERY_key_left, /* kcub1/kl, STRING */
1313 n_TERMCAP_QUERY_key_sleft, /* kLFT/#4, STRING | ..shifted */
1314 n_TERMCAP_QUERY_xkey_aleft, /* kLFT3/-, STRING | X: Alt+left */
1315 n_TERMCAP_QUERY_xkey_cleft, /* kLFT5/-, STRING | X: Control+left */
1316 n_TERMCAP_QUERY_key_right, /* kcuf1/kr, STRING */
1317 n_TERMCAP_QUERY_key_sright, /* kRIT/%i, STRING | ..shifted */
1318 n_TERMCAP_QUERY_xkey_aright, /* kRIT3/-, STRING | X: Alt+right */
1319 n_TERMCAP_QUERY_xkey_cright, /* kRIT5/-, STRING | X: Control+right */
1320 n_TERMCAP_QUERY_key_down, /* kcud1/kd, STRING */
1321 n_TERMCAP_QUERY_xkey_sdown, /* kDN/-, STRING | ..shifted */
1322 n_TERMCAP_QUERY_xkey_adown, /* kDN3/-, STRING | X: Alt+down */
1323 n_TERMCAP_QUERY_xkey_cdown, /* kDN5/-, STRING | X: Control+down */
1324 n_TERMCAP_QUERY_key_up, /* kcuu1/ku, STRING */
1325 n_TERMCAP_QUERY_xkey_sup, /* kUP/-, STRING | ..shifted */
1326 n_TERMCAP_QUERY_xkey_aup, /* kUP3/-, STRING | X: Alt+up */
1327 n_TERMCAP_QUERY_xkey_cup, /* kUP5/-, STRING | X: Control+up */
1328 n_TERMCAP_QUERY_kf0, /* kf0/k0, STRING */
1329 n_TERMCAP_QUERY_kf1, /* kf1/k1, STRING */
1330 n_TERMCAP_QUERY_kf2, /* kf2/k2, STRING */
1331 n_TERMCAP_QUERY_kf3, /* kf3/k3, STRING */
1332 n_TERMCAP_QUERY_kf4, /* kf4/k4, STRING */
1333 n_TERMCAP_QUERY_kf5, /* kf5/k5, STRING */
1334 n_TERMCAP_QUERY_kf6, /* kf6/k6, STRING */
1335 n_TERMCAP_QUERY_kf7, /* kf7/k7, STRING */
1336 n_TERMCAP_QUERY_kf8, /* kf8/k8, STRING */
1337 n_TERMCAP_QUERY_kf9, /* kf9/k9, STRING */
1338 n_TERMCAP_QUERY_kf10, /* kf10/k;, STRING */
1339 n_TERMCAP_QUERY_kf11, /* kf11/F1, STRING */
1340 n_TERMCAP_QUERY_kf12, /* kf12/F2, STRING */
1341 n_TERMCAP_QUERY_kf13, /* kf13/F3, STRING */
1342 n_TERMCAP_QUERY_kf14, /* kf14/F4, STRING */
1343 n_TERMCAP_QUERY_kf15, /* kf15/F5, STRING */
1344 n_TERMCAP_QUERY_kf16, /* kf16/F6, STRING */
1345 n_TERMCAP_QUERY_kf17, /* kf17/F7, STRING */
1346 n_TERMCAP_QUERY_kf18, /* kf18/F8, STRING */
1347 n_TERMCAP_QUERY_kf19, /* kf19/F9, STRING */
1348 # endif /* HAVE_KEY_BINDINGS */
1350 n__TERMCAP_QUERY_MAX1
1352 #endif /* n_HAVE_TCAP */
1354 enum n_url_flags{
1355 n_URL_TLS_REQUIRED = 1<<0, /* Whether protocol always uses SSL/TLS.. */
1356 n_URL_TLS_OPTIONAL = 1<<1, /* ..may later upgrade to SSL/TLS */
1357 n_URL_TLS_MASK = n_URL_TLS_REQUIRED | n_URL_TLS_OPTIONAL,
1358 n_URL_HAD_USER = 1<<2, /* Whether .url_user was part of the URL */
1359 n_URL_HOST_IS_NAME = 1<<3 /* .url_host not numeric address */
1362 enum n_visual_info_flags{
1363 n_VISUAL_INFO_NONE,
1364 n_VISUAL_INFO_ONE_CHAR = 1<<0, /* Step only one char, then return */
1365 n_VISUAL_INFO_SKIP_ERRORS = 1<<1, /* Treat via replacement, step byte */
1366 n_VISUAL_INFO_WIDTH_QUERY = 1<<2, /* Detect visual character widths */
1368 /* Rest only with HAVE_C90AMEND1, mutual with _ONE_CHAR */
1369 n_VISUAL_INFO_WOUT_CREATE = 1<<8, /* Use/create .vic_woudat */
1370 n_VISUAL_INFO_WOUT_SALLOC = 1<<9, /* ..autorec_alloc() it first */
1371 /* Only visuals into .vic_woudat - implies _WIDTH_QUERY */
1372 n_VISUAL_INFO_WOUT_PRINTABLE = 1<<10,
1373 n__VISUAL_INFO_FLAGS = n_VISUAL_INFO_WOUT_CREATE |
1374 n_VISUAL_INFO_WOUT_SALLOC | n_VISUAL_INFO_WOUT_PRINTABLE
1377 enum n_program_option{
1378 n_PO_DEBUG = 1u<<0, /* -d / *debug* */
1379 n_PO_VERB = 1u<<1, /* -v / *verbose* */
1380 n_PO_VERBVERB = 1u<<2, /* .. even more verbosity */
1381 n_PO_EXISTONLY = 1u<<3, /* -e */
1382 n_PO_HEADERSONLY = 1u<<4, /* -H */
1383 n_PO_HEADERLIST = 1u<<5, /* -L */
1384 n_PO_QUICKRUN_MASK = n_PO_EXISTONLY | n_PO_HEADERSONLY | n_PO_HEADERLIST,
1385 n_PO_E_FLAG = 1u<<6, /* -E / *skipemptybody* */
1386 n_PO_F_FLAG = 1u<<7, /* -F */
1387 n_PO_Mm_FLAG = 1u<<8, /* -M or -m (plus n_poption_arg_Mm) */
1388 n_PO_R_FLAG = 1u<<9, /* -R */
1389 n_PO_r_FLAG = 1u<<10, /* -r (plus n_poption_arg_r) */
1390 n_PO_S_FLAG_TEMPORARY = 1u<<11, /* -S about to set a variable */
1391 n_PO_t_FLAG = 1u<<12, /* -t */
1392 n_PO_TILDE_FLAG = 1u<<13, /* -~ */
1393 n_PO_BATCH_FLAG = 1u<<14, /* -# */
1395 /* */
1396 n_PO_MEMDEBUG = 1<<24, /* *memdebug* */
1398 /* Some easy-access shortcuts TODO n_PO_VERB+ should be mask(s) already! */
1399 n_PO_D_V = n_PO_DEBUG | n_PO_VERB,
1400 n_PO_D_VV = n_PO_DEBUG | n_PO_VERBVERB,
1401 n_PO_D_V_VV = n_PO_DEBUG | n_PO_VERB | n_PO_VERBVERB
1404 #define n_OBSOLETE(X) \
1405 do{\
1406 if(n_poption & n_PO_D_V_VV)\
1407 n_err("%s: %s\n", _("Obsoletion warning"), X);\
1408 }while(0)
1409 #define n_OBSOLETE2(X,Y) \
1410 do{\
1411 if(n_poption & n_PO_D_V_VV)\
1412 n_err("%s: %s: %s\n", _("Obsoletion warning"), X, Y);\
1413 }while(0)
1415 /* Program state bits which may regulary fluctuate */
1416 enum n_program_state{
1417 n_PS_ROOT = 1u<<30, /* Temporary "bypass any checks" bit */
1418 #define n_PS_ROOT_BLOCK(ACT) \
1419 do{\
1420 bool_t a___reset___ = !(n_pstate & n_PS_ROOT);\
1421 n_pstate |= n_PS_ROOT;\
1422 ACT;\
1423 if(a___reset___)\
1424 n_pstate &= ~n_PS_ROOT;\
1425 }while(0)
1427 /* XXX These are internal to the state machine and do not belong here,
1428 * XXX yet this was the easiest (accessible) approach */
1429 n_PS_ERR_XIT = 1u<<0, /* Unless `ignerr' seen -> n_PSO_XIT */
1430 n_PS_ERR_QUIT = 1u<<1, /* ..ditto: -> n_PSO_QUIT */
1431 n_PS_ERR_EXIT_MASK = n_PS_ERR_XIT | n_PS_ERR_QUIT,
1433 n_PS_SOURCING = 1u<<2, /* During load() or `source' */
1434 n_PS_ROBOT = 1u<<3, /* .. even more robotic */
1435 n_PS_COMPOSE_MODE = 1u<<4, /* State machine recursed */
1436 n_PS_COMPOSE_FORKHOOK = 1u<<5, /* A hook running in a subprocess */
1438 n_PS_HOOK_NEWMAIL = 1u<<7,
1439 n_PS_HOOK = 1u<<8,
1440 n_PS_HOOK_MASK = n_PS_HOOK_NEWMAIL | n_PS_HOOK,
1442 n_PS_EDIT = 1u<<9, /* Current mailbox no "system mailbox" */
1443 n_PS_SETFILE_OPENED = 1u<<10, /* (hack) setfile() opened a new box */
1444 n_PS_SAW_COMMAND = 1u<<11, /* ..after mailbox switch */
1445 n_PS_DID_PRINT_DOT = 1u<<12, /* Current message has been printed */
1447 n_PS_SIGWINCH_PEND = 1u<<13, /* Need update of $COLUMNS/$LINES */
1448 n_PS_PSTATE_PENDMASK = n_PS_SIGWINCH_PEND, /* pstate housekeeping needed */
1450 n_PS_ARGLIST_MASK = n_BITENUM_MASK(14, 16),
1451 n_PS_ARGMOD_LOCAL = 1u<<14, /* "local" modifier TODO struct CmdCtx */
1452 n_PS_ARGMOD_VPUT = 1u<<16, /* "vput" modifier TODO struct CmdCtx */
1453 n_PS_MSGLIST_GABBY = 1u<<14, /* getmsglist() saw something gabby */
1454 n_PS_MSGLIST_DIRECT = 1u<<15, /* A msg was directly chosen by number */
1455 /* TODO HACK: until v15 PS_MSGLIST_SAW_NO is an indication whether an entry
1456 * TODO may be placed in the history or not (grep this, see commands()),
1457 * TODO so avoid reusing this bit */
1458 n_PS_WYSHLIST_SAW_CONTROL = 1u<<15, /* ..saw C0+ control characters */
1460 n_PS_EXPAND_MULTIRESULT = 1u<<17, /* Last fexpand() with MULTIOK had .. */
1461 n_PS_ERRORS_PROMPT = 1u<<18, /* New error to be reported in prompt */
1463 /* Bad hacks */
1464 n_PS_HEADER_NEEDED_MIME = 1u<<24, /* mime_write_tohdr() not ASCII clean */
1465 n_PS_READLINE_NL = 1u<<25, /* readline_input()+ saw a \n */
1466 n_PS_BASE64_STRIP_CR = 1u<<26 /* Go for text output, strip CR's */
1469 /* Various states set once, and first time messages or initializers */
1470 enum n_program_state_once{
1471 /* We have four program states: (0) pre getopt() done, (_GETOPT) pre rcfile
1472 * loaded etc., (_CONFIG) only -X evaluation missing still, followed by
1473 * _STARTED when we are fully setup */
1474 n_PSO_STARTED_GETOPT = 1u<<0,
1475 n_PSO_STARTED_CONFIG = 1u<<1,
1476 n_PSO_STARTED = 1u<<2,
1478 /* Exit request pending (quick) */
1479 n_PSO_XIT = 1u<<3,
1480 n_PSO_QUIT = 1u<<4,
1481 n_PSO_EXIT_MASK = n_PSO_XIT | n_PSO_QUIT,
1483 /* Pre _STARTED */
1484 n_PSO_BIG_ENDIAN = 1u<<5,
1485 n_PSO_UNICODE = 1u<<6,
1486 n_PSO_ENC_MBSTATE = 1u<<7,
1488 n_PSO_REPRODUCIBLE = 1u<<8,
1489 n_PSO_SENDMODE = 1u<<9,
1490 n_PSO_INTERACTIVE = 1u<<10,
1491 n_PSO_TTYIN = 1u<<11,
1492 n_PSO_TTYOUT = 1u<<12, /* TODO should be TTYERR! */
1494 /* "Later" */
1495 n_PSO_t_FLAG_DONE = 1u<<15,
1496 n_PSO_ATTACH_QUOTE_NOTED = 1u<<16,
1497 n_PSO_ERRORS_NOTED = 1u<<17,
1498 n_PSO_LINE_EDITOR_INIT = 1u<<18,
1499 n_PSO_RANDOM_INIT = 1u<<19,
1500 n_PSO_TERMCAP_DISABLE = 1u<<20,
1501 n_PSO_TERMCAP_CA_MODE = 1u<<21,
1502 n_PSO_DOTLOCK_PRIVSEP_NOTED = 1u<<22
1505 /* {{{ A large enum with all the boolean and value options a.k.a their keys.
1506 * Only the constant keys are in here, to be looked up via ok_[bv]look(),
1507 * ok_[bv]set() and ok_[bv]clear().
1508 * Variable properties are placed in {PROP=VALUE[:,PROP=VALUE:]} comments,
1509 * a {\} comment causes the next line to be read for (overlong) properties.
1510 * Notes:
1511 * - see the comments in accmacvar.c before changing *anything* in here!
1512 * - virt= implies rdonly,nodel
1513 * - import= implies env
1514 * - num and posnum are mutual exclusive
1515 * - most default VAL_ues come from in from build system via ./make.rc
1516 * (Keep in SYNC: ./nail.h:okeys, ./nail.rc, ./nail.1:"Initial settings") */
1517 enum okeys {
1518 /* This is used for all macro(-local) variables etc., i.e.,
1519 * [*@#]|[1-9][0-9]*, in order to have something with correct properties.
1520 * It is also used for the ${^.+} multiplexer */
1521 ok_v___special_param, /* {nolopts=1,rdonly=1,nodel=1} */
1522 /*__qm/__em aka ?/! should be num=1 but that more expensive than what now */
1523 ok_v___qm, /* {name=?,nolopts=1,rdonly=1,nodel=1} */
1524 ok_v___em, /* {name=!,nolopts=1,rdonly=1,nodel=1} */
1526 ok_v_account, /* {nolopts=1,rdonly=1,nodel=1} */
1527 ok_b_add_file_recipients,
1528 ok_v_agent_shell_lookup, /* {obsolete=1} */
1529 ok_b_allnet,
1530 ok_b_append,
1531 /* *ask* is auto-mapped to *asksub* as imposed by standard! */
1532 ok_b_ask, /* {vip=1} */
1533 ok_b_askatend,
1534 ok_b_askattach,
1535 ok_b_askbcc,
1536 ok_b_askcc,
1537 ok_b_asksign,
1538 ok_b_asksend, /* {i3val=TRU1} */
1539 ok_b_asksub, /* {i3val=TRU1} */
1540 ok_v_attrlist,
1541 ok_v_autobcc,
1542 ok_v_autocc,
1543 ok_b_autocollapse,
1544 ok_b_autoprint,
1545 ok_b_autothread, /* {obsolete=1} */
1546 ok_v_autosort,
1548 ok_b_bang,
1549 ok_b_batch_exit_on_error, /* {obsolete=1} */
1550 ok_v_bind_timeout, /* {notempty=1,posnum=1} */
1551 ok_b_bsdannounce, /* {obsolete=1} */
1552 ok_b_bsdcompat,
1553 ok_b_bsdflags,
1554 ok_b_bsdheadline,
1555 ok_b_bsdmsgs,
1556 ok_b_bsdorder,
1557 ok_v_build_cc, /* {virt=VAL_BUILD_CC} */
1558 ok_v_build_ld, /* {virt=VAL_BUILD_LD} */
1559 ok_v_build_os, /* {virt=VAL_BUILD_OS} */
1560 ok_v_build_rest, /* {virt=VAL_BUILD_REST} */
1562 ok_v_COLUMNS, /* {notempty=1,posnum=1,env=1} */
1563 /* Charset lowercase conversion handled via vip= */
1564 ok_v_charset_7bit, /* {vip=1,notempty=1,defval=CHARSET_7BIT} */
1565 /* But unused without HAVE_ICONV, we use ok_vlook(CHARSET_8BIT_OKEY)! */
1566 ok_v_charset_8bit, /* {vip=1,notempty=1,defval=CHARSET_8BIT} */
1567 ok_v_charset_unknown_8bit, /* {vip=1} */
1568 ok_v_cmd,
1569 ok_b_colour_disable,
1570 ok_b_colour_pager,
1571 ok_v_contact_mail, /* {virt=VAL_CONTACT_MAIL} */
1572 ok_v_contact_web, /* {virt=VAL_CONTACT_WEB} */
1573 ok_v_crt, /* {posnum=1} */
1574 ok_v_customhdr, /* {vip=1} */
1576 ok_v_DEAD, /* {notempty=1,env=1,defval=VAL_DEAD} */
1577 ok_v_datefield, /* {i3val="%Y-%m-%d %H:%M"} */
1578 ok_v_datefield_markout_older, /* {i3val="%Y-%m-%d"} */
1579 ok_b_debug, /* {vip=1} */
1580 ok_b_disposition_notification_send,
1581 ok_b_dot,
1582 ok_b_dotlock_disable,
1583 ok_b_dotlock_ignore_error, /* {obsolete=1} */
1585 ok_v_EDITOR, /* {env=1,notempty=1,defval=VAL_EDITOR} */
1586 ok_v_editalong,
1587 ok_b_editheaders,
1588 ok_b_emptystart,
1589 ok_v_encoding, /* {obsolete=1} */
1590 ok_b_errexit,
1591 ok_v_escape, /* {defval=n_ESCAPE} */
1592 ok_v_expandaddr,
1593 ok_v_expandargv,
1595 ok_v_features, /* {virt=VAL_FEATURES} */
1596 ok_b_flipr,
1597 ok_v_folder, /* {vip=1} */
1598 ok_v_folder_resolved, /* {rdonly=1,nodel=1} */
1599 ok_v_folder_hook,
1600 ok_b_followup_to,
1601 ok_v_followup_to_honour,
1602 ok_b_forward_as_attachment,
1603 ok_v_forward_inject_head,
1604 ok_v_forward_inject_tail,
1605 ok_v_from, /* {vip=1} */
1606 ok_b_fullnames,
1607 ok_v_fwdheading, /* {obsolete=1} */
1609 ok_v_HOME, /* {vip=1,nodel=1,notempty=1,import=1} */
1610 ok_b_header, /* {i3val=TRU1} */
1611 ok_v_headline,
1612 ok_v_headline_bidi,
1613 ok_b_headline_plain,
1614 ok_v_history_file,
1615 ok_b_history_gabby,
1616 ok_b_history_gabby_persist,
1617 ok_v_history_size, /* {notempty=1,posnum=1} */
1618 ok_b_hold,
1619 ok_v_hostname, /* {vip=1} */
1621 ok_b_idna_disable,
1622 ok_v_ifs, /* {vip=1,defval=" \t\n"} */
1623 ok_v_ifs_ws, /* {vip=1,rdonly=1,nodel=1,i3val=" \t\n"} */
1624 ok_b_ignore,
1625 ok_b_ignoreeof,
1626 ok_v_inbox,
1627 ok_v_indentprefix, /* {defval="\t"} */
1629 ok_b_keep,
1630 ok_b_keep_content_length,
1631 ok_b_keepsave,
1633 ok_v_LANG, /* {vip=1,env=1,notempty=1} */
1634 ok_v_LC_ALL, /* {name=LC_ALL,vip=1,env=1,notempty=1} */
1635 ok_v_LC_CTYPE, /* {name=LC_CTYPE,vip=1,env=1,notempty=1} */
1636 ok_v_LINES, /* {notempty=1,posnum=1,env=1} */
1637 ok_v_LISTER, /* {env=1,notempty=1,defval=VAL_LISTER} */
1638 ok_v_LOGNAME, /* {rdonly=1,import=1} */
1639 ok_b_line_editor_disable,
1640 ok_b_line_editor_no_defaults,
1641 ok_v_log_prefix, /* {nodel=1,i3val=VAL_UAGENT ": "} */
1643 ok_v_MAIL, /* {env=1} */
1644 ok_v_MAILRC, /* {import=1,notempty=1,defval=VAL_MAILRC} */
1645 ok_b_MAILX_NO_SYSTEM_RC, /* {name=MAILX_NO_SYSTEM_RC,import=1} */
1646 ok_v_MBOX, /* {env=1,notempty=1,defval=VAL_MBOX} */
1647 ok_v_mailbox_resolved, /* {nolopts=1,rdonly=1,nodel=1} */
1648 ok_v_mailbox_display, /* {nolopts=1,rdonly=1,nodel=1} */
1649 ok_v_mailx_extra_rc,
1650 ok_b_markanswered,
1651 ok_b_mbox_rfc4155,
1652 ok_b_memdebug, /* {vip=1} */
1653 ok_b_message_id_disable,
1654 ok_v_message_inject_head,
1655 ok_v_message_inject_tail,
1656 ok_b_metoo,
1657 ok_b_mime_allow_text_controls,
1658 ok_b_mime_alternative_favour_rich,
1659 ok_v_mime_counter_evidence, /* {posnum=1} */
1660 ok_v_mime_encoding,
1661 ok_v_mimetypes_load_control,
1662 ok_v_mta, /* {notempty=1,defval=VAL_MTA} */
1663 ok_v_mta_arguments,
1664 ok_b_mta_no_default_arguments,
1665 ok_b_mta_no_receiver_arguments,
1666 ok_v_mta_argv0, /* {notempty=1,defval=VAL_MTA_ARGV0} */
1668 /* TODO likely temporary hook data, v15 drop */
1669 ok_v_mailx_command, /* {rdonly=1,nodel=1} */
1670 ok_v_mailx_subject, /* {rdonly=1,nodel=1} */
1671 ok_v_mailx_from, /* {rdonly=1,nodel=1} */
1672 ok_v_mailx_sender, /* {rdonly=1,nodel=1} */
1673 ok_v_mailx_to, /* {rdonly=1,nodel=1} */
1674 ok_v_mailx_cc, /* {rdonly=1,nodel=1} */
1675 ok_v_mailx_bcc, /* {rdonly=1,nodel=1} */
1676 ok_v_mailx_raw_to, /* {rdonly=1,nodel=1} */
1677 ok_v_mailx_raw_cc, /* {rdonly=1,nodel=1} */
1678 ok_v_mailx_raw_bcc, /* {rdonly=1,nodel=1} */
1679 ok_v_mailx_orig_from, /* {rdonly=1,nodel=1} */
1680 ok_v_mailx_orig_to, /* {rdonly=1,nodel=1} */
1681 ok_v_mailx_orig_cc, /* {rdonly=1,nodel=1} */
1682 ok_v_mailx_orig_bcc, /* {rdonly=1,nodel=1} */
1684 ok_v_NAIL_EXTRA_RC, /* {name=NAIL_EXTRA_RC,obsolete=1} */
1685 ok_b_NAIL_NO_SYSTEM_RC, /* {name=NAIL_NO_SYSTEM_RC,import=1,obsolete=1} */
1686 ok_v_NAIL_HEAD, /* {name=NAIL_HEAD,obsolete=1} */
1687 ok_v_NAIL_HISTFILE, /* {name=NAIL_HISTFILE,obsolete=1} */
1688 ok_v_NAIL_HISTSIZE, /* {name=NAIL_HISTSIZE,notempty=1,num=1,obsolete=1} */
1689 ok_v_NAIL_TAIL, /* {name=NAIL_TAIL,obsolete=1} */
1690 ok_v_NETRC, /* {env=1,notempty=1,defval=VAL_NETRC} */
1691 ok_b_netrc_lookup, /* {chain=1} */
1692 ok_v_netrc_pipe,
1693 ok_v_newfolders,
1694 ok_v_newmail,
1696 ok_v_on_account_cleanup, /* {notempty=1} */
1697 ok_v_on_compose_cleanup, /* {notempty=1} */
1698 ok_v_on_compose_enter, /* {notempty=1} */
1699 ok_v_on_compose_leave, /* {notempty=1} */
1700 ok_v_on_compose_splice, /* {notempty=1} */
1701 ok_v_on_compose_splice_shell, /* {notempty=1} */
1702 ok_v_on_resend_cleanup, /* {notempty=1} */
1703 ok_v_on_resend_enter, /* {notempty=1} */
1704 ok_b_outfolder,
1706 ok_v_PAGER, /* {env=1,notempty=1,defval=VAL_PAGER} */
1707 ok_v_PATH, /* {nodel=1,import=1} */
1708 ok_b_POSIXLY_CORRECT, /* {vip=1,import=1,name=POSIXLY_CORRECT} */
1709 ok_b_page,
1710 ok_v_password, /* {chain=1} */
1711 ok_b_piperaw,
1712 ok_v_pop3_auth, /* {chain=1} */
1713 ok_b_pop3_bulk_load,
1714 ok_v_pop3_keepalive, /* {notempty=1,posnum=1} */
1715 ok_b_pop3_no_apop, /* {chain=1} */
1716 ok_b_pop3_use_starttls, /* {chain=1} */
1717 ok_b_posix, /* {vip=1} */
1718 ok_b_print_alternatives,
1719 ok_v_prompt, /* {i3val="? "} */
1720 ok_v_prompt2, /* {i3val=".. "} */
1722 ok_b_quiet,
1723 ok_v_quote,
1724 ok_b_quote_as_attachment,
1725 ok_v_quote_chars, /* {vip=1,notempty=1,defval=">|}:"} */
1726 ok_v_quote_fold,
1727 ok_v_quote_inject_head,
1728 ok_v_quote_inject_tail,
1730 ok_b_r_option_implicit,
1731 ok_b_recipients_in_cc,
1732 ok_v_record,
1733 ok_b_record_files,
1734 ok_b_record_resent,
1735 ok_b_reply_in_same_charset,
1736 ok_v_reply_strings,
1737 ok_v_replyto, /* {obsolete=1} */
1738 ok_v_reply_to, /* {notempty=1} */
1739 ok_v_reply_to_honour,
1740 ok_b_rfc822_body_from_, /* {name=rfc822-body-from_} */
1742 ok_v_SHELL, /* {import=1,notempty=1,defval=VAL_SHELL} */
1743 ok_b_SYSV3, /* {env=1,obsolete=1} */
1744 ok_b_save, /* {i3val=TRU1} */
1745 ok_v_screen, /* {notempty=1,posnum=1} */
1746 ok_b_searchheaders,
1747 /* Charset lowercase conversion handled via vip= */
1748 ok_v_sendcharsets, /* {vip=1} */
1749 ok_b_sendcharsets_else_ttycharset,
1750 ok_v_sender, /* {vip=1} */
1751 ok_v_sendmail, /* {obsolete=1} */
1752 ok_v_sendmail_arguments, /* {obsolete=1} */
1753 ok_b_sendmail_no_default_arguments, /* {obsolete=1} */
1754 ok_v_sendmail_progname, /* {obsolete=1} */
1755 ok_b_sendwait,
1756 ok_b_showlast,
1757 ok_b_showname,
1758 ok_b_showto,
1759 ok_v_Sign,
1760 ok_v_sign,
1761 ok_v_signature, /* {obsolete=1} */
1762 ok_b_skipemptybody, /* {vip=1} */
1763 ok_v_smime_ca_dir,
1764 ok_v_smime_ca_file,
1765 ok_v_smime_ca_flags,
1766 ok_b_smime_ca_no_defaults,
1767 ok_v_smime_cipher, /* {chain=1} */
1768 ok_v_smime_crl_dir,
1769 ok_v_smime_crl_file,
1770 ok_v_smime_encrypt, /* {chain=1} */
1771 ok_b_smime_force_encryption,
1772 ok_b_smime_no_default_ca, /* {obsolete=1} */
1773 ok_b_smime_sign,
1774 ok_v_smime_sign_cert, /* {chain=1} */
1775 ok_v_smime_sign_digest, /* {chain=1} */
1776 ok_v_smime_sign_include_certs, /* {chain=1} */
1777 ok_v_smime_sign_message_digest, /* {chain=1,obsolete=1} */
1778 ok_v_smtp, /* {obsolete=1} */
1779 ok_v_smtp_auth, /* {chain=1} */
1780 ok_v_smtp_auth_password, /* {obsolete=1} */
1781 ok_v_smtp_auth_user, /* {obsolete=1} */
1782 ok_v_smtp_hostname, /* {vip=1} */
1783 ok_b_smtp_use_starttls, /* {chain=1} */
1784 ok_v_SOURCE_DATE_EPOCH, /* {\ } */
1785 /* {name=SOURCE_DATE_EPOCH,rdonly=1,import=1,notempty=1,posnum=1} */
1786 ok_v_socks_proxy, /* {chain=1,notempty=1} */
1787 ok_v_spam_interface,
1788 ok_v_spam_maxsize, /* {notempty=1,posnum=1} */
1789 ok_v_spamc_command,
1790 ok_v_spamc_arguments,
1791 ok_v_spamc_user,
1792 ok_v_spamd_socket, /* {obsolete=1} */
1793 ok_v_spamd_user, /* {obsolete=1} */
1794 ok_v_spamfilter_ham,
1795 ok_v_spamfilter_noham,
1796 ok_v_spamfilter_nospam,
1797 ok_v_spamfilter_rate,
1798 ok_v_spamfilter_rate_scanscore,
1799 ok_v_spamfilter_spam,
1800 ok_v_ssl_ca_dir, /* {chain=1,obsolete=1} */
1801 ok_v_ssl_ca_file, /* {chain=1,obsolete=1} */
1802 ok_v_ssl_ca_flags, /* {chain=1,obsolete=1} */
1803 ok_b_ssl_ca_no_defaults, /* {chain=1,obsolete=1} */
1804 ok_v_ssl_cert, /* {chain=1,obsolete=1} */
1805 ok_v_ssl_cipher_list, /* {chain=1,obsolete=1} */
1806 ok_v_ssl_config_file, /* {obsolete=1} */
1807 ok_v_ssl_config_module, /* {chain=1,obsolete=1} */
1808 ok_v_ssl_config_pairs, /* {chain=1,obsolete=1} */
1809 ok_v_ssl_curves, /* {chain=1,obsolete=1} */
1810 ok_v_ssl_crl_dir, /* {obsolete=1} */
1811 ok_v_ssl_crl_file, /* {obsolete=1} */
1812 ok_v_ssl_features, /* {virt=VAL_TLS_FEATURES,obsolete=1} */
1813 ok_v_ssl_key, /* {chain=1,obsolete=1} */
1814 ok_v_ssl_method, /* {chain=1,obsolete=1} */
1815 ok_b_ssl_no_default_ca, /* {obsolete=1} */
1816 ok_v_ssl_protocol, /* {chain=1,obsolete=1} */
1817 ok_v_ssl_rand_egd, /* {obsolete=1} */
1818 ok_v_ssl_rand_file, /* {obsolete=1}*/
1819 ok_v_ssl_verify, /* {chain=1,obsolete=1} */
1820 ok_v_stealthmua,
1821 ok_v_system_mailrc, /* {virt=VAL_SYSCONFDIR "/" VAL_SYSCONFRC} */
1823 ok_v_TERM, /* {env=1} */
1824 ok_v_TMPDIR, /* {import=1,vip=1,notempty=1,defval=VAL_TMPDIR} */
1825 ok_v_termcap,
1826 ok_b_termcap_ca_mode,
1827 ok_b_termcap_disable,
1828 ok_v_tls_ca_dir, /* {chain=1} */
1829 ok_v_tls_ca_file, /* {chain=1} */
1830 ok_v_tls_ca_flags, /* {chain=1} */
1831 ok_b_tls_ca_no_defaults, /* {chain=1} */
1832 ok_v_tls_config_file,
1833 ok_v_tls_config_module, /* {chain=1} */
1834 ok_v_tls_config_pairs, /* {chain=1} */
1835 ok_v_tls_crl_dir,
1836 ok_v_tls_crl_file,
1837 ok_v_tls_features, /* {virt=VAL_TLS_FEATURES} */
1838 ok_v_tls_fingerprint, /* {chain=1} */
1839 ok_v_tls_fingerprint_digest, /* {chain=1} */
1840 ok_v_tls_rand_file,
1841 ok_v_tls_verify, /* {chain=1} */
1842 ok_v_toplines, /* {notempty=1,num=1,defval="5"} */
1843 ok_b_topsqueeze,
1844 /* Charset lowercase conversion handled via vip= */
1845 ok_v_ttycharset, /* {vip=1,notempty=1,defval=CHARSET_8BIT} */
1846 ok_b_typescript_mode, /* {vip=1} */
1848 ok_v_USER, /* {rdonly=1,import=1} */
1849 ok_v_umask, /* {vip=1,nodel=1,posnum=1,i3val="0077"} */
1850 ok_v_user, /* {notempty=1,chain=1} */
1852 ok_v_VISUAL, /* {env=1,notempty=1,defval=VAL_VISUAL} */
1853 ok_b_v15_compat,
1854 ok_b_verbose, /* {vip=1} */
1855 ok_v_version, /* {virt=n_VERSION} */
1856 ok_v_version_date, /* {virt=n_VERSION_DATE} */
1857 ok_v_version_hexnum, /* {virt=n_VERSION_HEXNUM,posnum=1} */
1858 ok_v_version_major, /* {virt=n_VERSION_MAJOR,posnum=1} */
1859 ok_v_version_minor, /* {virt=n_VERSION_MINOR,posnum=1} */
1860 ok_v_version_update, /* {virt=n_VERSION_UPDATE,posnum=1} */
1862 ok_b_writebackedited
1864 , /* Obsolete IMAP related non-sorted */
1865 ok_b_disconnected, /* {chain=1} */
1866 ok_v_imap_auth, /* {chain=1} */
1867 ok_v_imap_cache,
1868 ok_v_imap_delim, /* {chain=1} */
1869 ok_v_imap_keepalive, /* {chain=1} */
1870 ok_v_imap_list_depth,
1871 ok_b_imap_use_starttls /* {chain=1} */
1872 }; /* }}} */
1873 enum {n_OKEYS_MAX = ok_b_imap_use_starttls};
1875 /* Locale-independent character classes */
1876 enum {
1877 C_CNTRL = 1<<0,
1878 C_BLANK = 1<<1,
1879 C_WHITE = 1<<2,
1880 C_SPACE = 1<<3,
1881 C_PUNCT = 1<<4,
1882 C_OCTAL = 1<<5,
1883 C_DIGIT = 1<<6,
1884 C_UPPER = 1<<7,
1885 C_LOWER = 1<<8
1888 struct str {
1889 char *s; /* the string's content */
1890 size_t l; /* the stings's length */
1893 struct n_string{
1894 char *s_dat; /*@ May contain NULs, not automatically terminated */
1895 ui32_t s_len; /*@ gth of string */
1896 ui32_t s_auto : 1; /* Stored in auto-reclaimed storage? */
1897 ui32_t s_size : 31; /* of .s_dat, -1 */
1900 struct n_strlist{
1901 struct n_strlist *sl_next;
1902 size_t sl_len;
1903 char sl_dat[n_VFIELD_SIZE(0)];
1905 #define n_STRLIST_ALLOC(SZ) /* XXX -> nailfuns.h (and pimp interface) */\
1906 n_alloc(n_VSTRUCT_SIZEOF(struct n_strlist, sl_dat) + (SZ) +1)
1907 #define n_STRLIST_AUTOREC_ALLOC(SZ) \
1908 n_autorec_alloc(n_VSTRUCT_SIZEOF(struct n_strlist, sl_dat) + (SZ) +1)
1909 #define n_STRLIST_LOFI_ALLOC(SZ) \
1910 n_lofi_alloc(n_VSTRUCT_SIZEOF(struct n_strlist, sl_dat) + (SZ) +1)
1912 struct bidi_info {
1913 struct str bi_start; /* Start of (possibly) bidirectional text */
1914 struct str bi_end; /* End of ... */
1915 size_t bi_pad; /* No of visual columns to reserve for BIDI pad */
1918 struct n_cmd_arg_desc{
1919 char cad_name[12]; /* Name of command */
1920 ui32_t cad_no; /* Number of entries in cad_ent_flags */
1921 /* [enum n_cmd_arg_desc_flags,arg-dep] */
1922 ui32_t cad_ent_flags[n_VFIELD_SIZE(0)][2];
1924 /* ISO C(99) doesn't allow initialization of "flex array" */
1925 #define n_CMD_ARG_DESC_SUBCLASS_DEF(CMD,NO,VAR) \
1926 struct n_cmd_arg_desc_ ## CMD {\
1927 char cad_name[12];\
1928 ui32_t cad_no;\
1929 ui32_t cad_ent_flags[NO][2];\
1930 } const VAR = { #CMD "\0", NO,
1931 #define n_CMD_ARG_DESC_SUBCLASS_DEF_END }
1932 #define n_CMD_ARG_DESC_SUBCLASS_CAST(P) ((struct n_cmd_arg_desc const*)P)
1934 struct n_cmd_arg_ctx{
1935 struct n_cmd_arg_desc const *cac_desc; /* Input: description of command */
1936 char const *cac_indat; /* Input that shall be parsed */
1937 size_t cac_inlen; /* Input length (UIZ_MAX: do a strlen()) */
1938 size_t cac_no; /* Output: number of parsed arguments */
1939 struct n_cmd_arg *cac_arg; /* Output: parsed arguments */
1940 char const *cac_vput; /* "Output": vput prefix used: varname */
1943 struct n_cmd_arg{/* TODO incomplete, misses getmsglist() */
1944 struct n_cmd_arg *ca_next;
1945 char const *ca_indat; /*[PRIV] Pointer into n_cmd_arg_ctx.cac_indat */
1946 size_t ca_inlen; /*[PRIV] of .ca_indat of this arg (not terminated) */
1947 ui32_t ca_ent_flags[2]; /* Copy of n_cmd_arg_desc.cad_ent_flags[X] */
1948 ui32_t ca_arg_flags; /* [Output: _WYSH: copy of parse result flags] */
1949 ui8_t ca__dummy[4];
1950 union{
1951 struct str ca_str; /* _STRING, _WYSH */
1952 } ca_arg; /* Output: parsed result */
1955 struct n_cmd_desc{
1956 char const *cd_name; /* Name of command */
1957 int (*cd_func)(void*); /* Implementor of command */
1958 enum n_cmd_arg_flags cd_caflags;
1959 si16_t cd_msgflag; /* Required flags of msgs */
1960 si16_t cd_msgmask; /* Relevant flags of msgs */
1961 struct n_cmd_arg_desc const *cd_cadp;
1962 #ifdef HAVE_DOCSTRINGS
1963 char const *cd_doc; /* One line doc for command */
1964 #endif
1966 /* Yechh, can't initialize unions */
1967 #define cd_minargs cd_msgflag /* Minimum argcount for WYSH/WYRA/RAWLIST */
1968 #define cd_maxargs cd_msgmask /* Max argcount for WYSH/WYRA/RAWLIST */
1970 #ifdef HAVE_COLOUR
1971 struct n_colour_env{
1972 struct n_colour_env *ce_last;
1973 bool_t ce_enabled; /* Colour enabled on this level */
1974 ui8_t ce_ctx; /* enum n_colour_ctx */
1975 ui8_t ce_ispipe; /* .ce_outfp known to be a pipe */
1976 ui8_t ce__pad[5];
1977 FILE *ce_outfp;
1978 struct a_colour_map *ce_current; /* Active colour or NULL */
1981 struct n_colour_pen;
1982 #endif
1984 struct url {
1985 char const *url_input; /* Input as given (really) */
1986 ui32_t url_flags;
1987 ui16_t url_portno; /* atoi .url_port or default, host endian */
1988 ui8_t url_cproto; /* enum cproto as given */
1989 ui8_t url_proto_len; /* Length of .url_proto (to first '\0') */
1990 char url_proto[16]; /* Communication protocol as 'xy\0://\0' */
1991 char const *url_port; /* Port (if given) or NULL */
1992 struct str url_user; /* User, exactly as given / looked up */
1993 struct str url_user_enc; /* User, urlxenc()oded */
1994 struct str url_pass; /* Pass (urlxdec()oded) or NULL */
1995 /* TODO we don't know whether .url_host is a name or an address. Us
1996 * TODO Net::IPAddress::fromString() to check that, then set
1997 * TODO n_URL_HOST_IS_NAME solely based on THAT! Until then,
1998 * TODO n_URL_HOST_IS_NAME ONLY set if n_URL_TLS_MASK and HAVE_GETADDRINFO */
1999 struct str url_host; /* Service hostname TODO we don't know */
2000 struct str url_path; /* Path suffix or NULL */
2001 /* TODO: url_get_component(url *, enum COMPONENT, str *store) */
2002 struct str url_h_p; /* .url_host[:.url_port] */
2003 /* .url_user@.url_host
2004 * Note: for CPROTO_SMTP this may resolve HOST via *smtp-hostname* (->
2005 * *hostname*)! (And may later be overwritten according to *from*!) */
2006 struct str url_u_h;
2007 struct str url_u_h_p; /* .url_user@.url_host[:.url_port] */
2008 struct str url_eu_h_p; /* .url_user_enc@.url_host[:.url_port] */
2009 char const *url_p_u_h_p; /* .url_proto://.url_u_h_p */
2010 char const *url_p_eu_h_p; /* .url_proto://.url_eu_h_p */
2011 char const *url_p_eu_h_p_p; /* .url_proto://.url_eu_h_p[/.url_path] */
2014 struct ccred {
2015 enum cproto cc_cproto; /* Communication protocol */
2016 enum authtype cc_authtype; /* Desired authentication */
2017 char const *cc_auth; /* Authentication type as string */
2018 struct str cc_user; /* User (urlxdec()oded) or NULL */
2019 struct str cc_pass; /* Password (urlxdec()oded) or NULL */
2022 #ifdef HAVE_DOTLOCK
2023 struct n_dotlock_info{
2024 char const *di_file_name; /* Mailbox to lock */
2025 char const *di_lock_name; /* .di_file_name + .lock */
2026 char const *di_hostname; /* ..filled in parent (due resolver delays) */
2027 char const *di_randstr; /* ..ditto, random string */
2028 size_t di_pollmsecs; /* Delay in between locking attempts */
2029 struct stat *di_stb;
2031 #endif
2033 struct n_file_type{
2034 char const *ft_ext_dat; /* Extension this handles, without first period */
2035 size_t ft_ext_len;
2036 char const *ft_load_dat; /* And the load and save command strings */
2037 size_t ft_load_len;
2038 char const *ft_save_dat;
2039 size_t ft_save_len;
2042 struct n_go_data_ctx{
2043 /* The memory pool may be inherited from outer context, so we
2044 * .gdc_mempool may be NE .gdc__mempool_buf */
2045 void *gdc_mempool;
2046 void *gdc_ifcond; /* Saved state of conditional stack */
2047 #ifdef HAVE_COLOUR
2048 struct n_colour_env *gdc_colour;
2049 bool_t gdc_colour_active;
2050 ui8_t gdc__colour_pad[7];
2051 # define n_COLOUR_IS_ACTIVE() \
2052 (/*n_go_data->gc_data.gdc_colour != NULL &&*/\
2053 /*n_go_data->gc_data.gdc_colour->ce_enabled*/ n_go_data->gdc_colour_active)
2054 #endif
2055 char gdc__mempool_buf[n_MEMORY_POOL_TYPE_SIZEOF];
2057 n_MCTA(n_MEMORY_POOL_TYPE_SIZEOF % sizeof(void*) == 0,
2058 "Inacceptible size of n_go_data_ctx.gdc_mempool")
2060 struct mime_handler {
2061 enum mime_handler_flags mh_flags;
2062 struct str mh_msg; /* Message describing this command */
2063 /* XXX union{} the following? */
2064 char const *mh_shell_cmd; /* For MIME_HDL_CMD */
2065 int (*mh_ptf)(void); /* PTF main() for MIME_HDL_PTF */
2068 struct quoteflt {
2069 FILE *qf_os; /* Output stream */
2070 char const *qf_pfix;
2071 ui32_t qf_pfix_len; /* Length of prefix: 0: bypass */
2072 ui32_t qf_qfold_min; /* Simple way: wrote prefix? */
2073 bool_t qf_bypass; /* Simply write to .qf_os TODO BYPASS, then! */
2074 /* TODO quoteflt.qf_nl_last is a hack that i have introduced so that we
2075 * TODO finally can gracefully place a newline last in the visual display.
2076 * TODO I.e., for cases where quoteflt shouldn't be used at all ;} */
2077 bool_t qf_nl_last; /* Last thing written/seen was NL */
2078 #ifndef HAVE_QUOTE_FOLD
2079 ui8_t __dummy[6];
2080 #else
2081 ui8_t qf_state; /* *quote-fold* state machine */
2082 bool_t qf_brk_isws; /* Breakpoint is at WS */
2083 ui32_t qf_qfold_max; /* Otherwise: line lengths */
2084 ui32_t qf_qfold_maxnws;
2085 ui32_t qf_wscnt; /* Whitespace count */
2086 char const *qf_quote_chars; /* *quote-chars* */
2087 ui32_t qf_brkl; /* Breakpoint */
2088 ui32_t qf_brkw; /* Visual width, breakpoint */
2089 ui32_t qf_datw; /* Current visual output line width */
2090 ui8_t __dummy2[4];
2091 struct str qf_dat; /* Current visual output line */
2092 struct str qf_currq; /* Current quote, compressed */
2093 mbstate_t qf_mbps[2];
2094 #endif
2097 #ifdef HAVE_FILTER_HTML_TAGSOUP
2098 struct htmlflt {
2099 FILE *hf_os; /* Output stream */
2100 ui32_t hf_flags;
2101 ui32_t hf_lmax; /* Maximum byte +1 in .hf_line/4 */
2102 ui32_t hf_len; /* Current bytes in .hf_line */
2103 ui32_t hf_last_ws; /* Last whitespace on line (fold purposes) */
2104 ui32_t hf_mboff; /* Last offset for "mbtowc" */
2105 ui32_t hf_mbwidth; /* We count characters not bytes if possible */
2106 char *hf_line; /* Output line buffer - MUST be last field! */
2107 si32_t hf_href_dist; /* Count of lines since last HREF flush */
2108 ui32_t hf_href_no; /* HREF sequence number */
2109 struct htmlflt_href *hf_hrefs;
2110 struct htmlflt_tag const *hf_ign_tag; /* Tag that will end ignore mode */
2111 char *hf_curr; /* Current cursor into .hf_bdat */
2112 char *hf_bmax; /* Maximum byte in .hf_bdat +1 */
2113 char *hf_bdat; /* (Temporary) Tag content data storage */
2115 #endif
2117 struct search_expr {
2118 /* XXX Type of search should not be evaluated but be enum */
2119 bool_t ss_field_exists; /* Only check whether field spec. exists */
2120 bool_t ss_skin; /* Shall work on (skin()ned) addresses */
2121 ui8_t ss__pad[6];
2122 char const *ss_field; /* Field spec. where to search (not always used) */
2123 char const *ss_body; /* Field body search expression */
2124 #ifdef HAVE_REGEX
2125 regex_t *ss_fieldre; /* Could be instead of .ss_field */
2126 regex_t *ss_bodyre; /* Ditto, .ss_body */
2127 regex_t ss__fieldre_buf;
2128 regex_t ss__bodyre_buf;
2129 #endif
2132 /* This is somewhat temporary for pre v15 */
2133 struct n_sigman{
2134 ui32_t sm_flags; /* enum n_sigman_flags */
2135 int sm_signo;
2136 struct n_sigman *sm_outer;
2137 sighandler_type sm_ohup;
2138 sighandler_type sm_oint;
2139 sighandler_type sm_oquit;
2140 sighandler_type sm_oterm;
2141 sighandler_type sm_opipe;
2142 sigjmp_buf sm_jump;
2145 struct n_timespec{
2146 si64_t ts_sec;
2147 siz_t ts_nsec;
2150 struct termios_state {
2151 struct termios ts_tios;
2152 char *ts_linebuf;
2153 size_t ts_linesize;
2154 bool_t ts_needs_reset;
2157 #define termios_state_reset() \
2158 do {\
2159 if (termios_state.ts_needs_reset) {\
2160 tcsetattr(STDIN_FILENO, TCSADRAIN, &termios_state.ts_tios);\
2161 termios_state.ts_needs_reset = FAL0;\
2163 } while (0)
2165 #ifdef n_HAVE_TCAP
2166 struct n_termcap_value{
2167 enum n_termcap_captype tv_captype;
2168 ui8_t tv__dummy[4];
2169 union n_termcap_value_data{
2170 bool_t tvd_bool;
2171 ui32_t tvd_numeric;
2172 char const *tvd_string;
2173 } tv_data;
2175 #endif
2177 struct n_visual_info_ctx{
2178 char const *vic_indat; /*I Input data */
2179 size_t vic_inlen; /*I If UIZ_MAX, strlen(.vic_indat) */
2180 char const *vic_oudat; /*O remains */
2181 size_t vic_oulen;
2182 size_t vic_chars_seen; /*O number of characters processed */
2183 size_t vic_bytes_seen; /*O number of bytes passed */
2184 size_t vic_vi_width; /*[O] visual width of the entire range */
2185 wc_t *vic_woudat; /*[O] if so requested */
2186 size_t vic_woulen; /*[O] entries in .vic_woudat, if used */
2187 wc_t vic_waccu; /*O The last wchar_t/char processed (if any) */
2188 enum n_visual_info_flags vic_flags; /*O Copy of parse flags */
2189 /* TODO bidi */
2190 #ifdef HAVE_C90AMEND1
2191 mbstate_t *vic_mbstate; /*IO .vic_mbs_def used if NULL */
2192 mbstate_t vic_mbs_def;
2193 #endif
2196 struct time_current { /* TODO si64_t, etc. */
2197 time_t tc_time;
2198 struct tm tc_gm;
2199 struct tm tc_local;
2200 char tc_ctime[32];
2203 struct sock { /* data associated with a socket */
2204 int s_fd; /* file descriptor */
2205 #ifdef HAVE_TLS
2206 int s_use_tls; /* SSL is used */
2207 # ifdef HAVE_XTLS
2208 void *s_tls; /* SSL object */
2209 # endif
2210 char *s_tls_finger; /* Set to autorec! store for CPROTO_CERTINFO */
2211 #endif
2212 char *s_wbuf; /* for buffered writes */
2213 int s_wbufsize; /* allocated size of s_buf */
2214 int s_wbufpos; /* position of first empty data byte */
2215 char *s_rbufptr; /* read pointer to s_rbuf */
2216 int s_rsz; /* size of last read in s_rbuf */
2217 char const *s_desc; /* description of error messages */
2218 void (*s_onclose)(void); /* execute on close */
2219 char s_rbuf[LINESIZE + 1]; /* for buffered reads */
2222 struct sockconn {
2223 struct url sc_url;
2224 struct ccred sc_cred;
2225 struct sock sc_sock;
2228 struct mailbox {
2229 enum {
2230 MB_NONE = 000, /* no reply expected */
2231 MB_COMD = 001, /* command reply expected */
2232 MB_MULT = 002, /* multiline reply expected */
2233 MB_PREAUTH = 004, /* not in authenticated state */
2234 MB_BYE = 010, /* may accept a BYE state */
2235 MB_FROM__WARNED = 1<<4 /* MBOX with invalid from seen & logged */
2236 } mb_active;
2237 FILE *mb_itf; /* temp file with messages, read open */
2238 FILE *mb_otf; /* same, write open */
2239 char *mb_sorted; /* sort method */
2240 enum {
2241 MB_VOID, /* no type (e. g. connection failed) */
2242 MB_FILE, /* local file */
2243 MB_POP3, /* POP3 mailbox */
2244 MB_IMAP, /* IMAP mailbox */
2245 MB_CACHE, /* IMAP cache */
2246 MB_MAILDIR /* maildir folder */
2247 } mb_type; /* type of mailbox */
2248 enum {
2249 MB_DELE = 01, /* may delete messages in mailbox */
2250 MB_EDIT = 02 /* may edit messages in mailbox */
2251 } mb_perm;
2252 int mb_threaded; /* mailbox has been threaded */
2253 #ifdef HAVE_IMAP
2254 enum mbflags {
2255 MB_NOFLAGS = 000,
2256 MB_UIDPLUS = 001 /* supports IMAP UIDPLUS */
2257 } mb_flags;
2258 ui64_t mb_uidvalidity; /* IMAP unique identifier validity */
2259 char *mb_imap_account; /* name of current IMAP account */
2260 char *mb_imap_pass; /* xxx v15-compat URL workaround */
2261 char *mb_imap_mailbox; /* name of current IMAP mailbox */
2262 char *mb_cache_directory; /* name of cache directory */
2263 char mb_imap_delim[8]; /* Directory separator(s), [0] += replacer */
2264 #endif
2265 struct sock mb_sock; /* socket structure */
2268 enum needspec {
2269 NEED_UNSPEC, /* unspecified need, don't fetch */
2270 NEED_HEADER, /* need the header of a message */
2271 NEED_BODY /* need header and body of a message */
2274 enum content_info {
2275 CI_NOTHING, /* Nothing downloaded yet */
2276 CI_HAVE_HEADER = 1u<<0, /* Header is downloaded */
2277 CI_HAVE_BODY = 1u<<1, /* Entire message is downloaded */
2278 CI_HAVE_MASK = CI_HAVE_HEADER | CI_HAVE_BODY,
2279 CI_MIME_ERRORS = 1u<<2, /* Defective MIME structure */
2280 CI_EXPANDED = 1u<<3, /* Container part (pk7m) exploded into X */
2281 CI_SIGNED = 1u<<4, /* Has a signature.. */
2282 CI_SIGNED_OK = 1u<<5, /* ..verified ok.. */
2283 CI_SIGNED_BAD = 1u<<6, /* ..verified bad (missing key).. */
2284 CI_ENCRYPTED = 1u<<7, /* Is encrypted.. */
2285 CI_ENCRYPTED_OK = 1u<<8, /* ..decryption possible/ok.. */
2286 CI_ENCRYPTED_BAD = 1u<<9 /* ..not possible/ok */
2289 /* Note: flags that are used in obs-imap-cache.c may not change */
2290 enum mflag {
2291 MUSED = 1u<<0, /* entry is used, but this bit isn't */
2292 MDELETED = 1u<<1, /* entry has been deleted */
2293 MSAVED = 1u<<2, /* entry has been saved */
2294 MTOUCH = 1u<<3, /* entry has been noticed */
2295 MPRESERVE = 1u<<4, /* keep entry in sys mailbox */
2296 MMARK = 1u<<5, /* message is marked! */
2297 MODIFY = 1u<<6, /* message has been modified */
2298 MNEW = 1u<<7, /* message has never been seen */
2299 MREAD = 1u<<8, /* message has been read sometime. */
2300 MSTATUS = 1u<<9, /* message status has changed */
2301 MBOX = 1u<<10, /* Send this to mbox, regardless */
2302 MNOFROM = 1u<<11, /* no From line */
2303 MHIDDEN = 1u<<12, /* message is hidden to user */
2304 MFULLYCACHED = 1u<<13, /* IMAP cached */
2305 MBOXED = 1u<<14, /* message has been sent to mbox */
2306 MUNLINKED = 1u<<15, /* Unlinked from IMAP cache */
2307 MNEWEST = 1u<<16, /* message is very new (newmail) */
2308 MFLAG = 1u<<17, /* message has been flagged recently */
2309 MUNFLAG = 1u<<18, /* message has been unflagged */
2310 MFLAGGED = 1u<<19, /* message is `flagged' */
2311 MANSWER = 1u<<20, /* message has been answered recently */
2312 MUNANSWER = 1u<<21, /* message has been unanswered */
2313 MANSWERED = 1u<<22, /* message is `answered' */
2314 MDRAFT = 1u<<23, /* message has been drafted recently */
2315 MUNDRAFT = 1u<<24, /* message has been undrafted */
2316 MDRAFTED = 1u<<25, /* message is marked as `draft' */
2317 MOLDMARK = 1u<<26, /* messages was marked previously */
2318 MSPAM = 1u<<27, /* message is classified as spam */
2319 MSPAMUNSURE = 1u<<28 /* message may be spam, but it is unsure */
2321 #define MMNORM (MDELETED | MSAVED | MHIDDEN)
2322 #define MMNDEL (MDELETED | MHIDDEN)
2324 #define visible(mp) (((mp)->m_flag & MMNDEL) == 0)
2326 struct mimepart {
2327 enum mflag m_flag;
2328 enum content_info m_content_info;
2329 #ifdef HAVE_SPAM
2330 ui32_t m_spamscore; /* Spam score as int, 24:8 bits */
2331 #else
2332 ui8_t m__pad1[4];
2333 #endif
2334 int m_block; /* block number of this part */
2335 size_t m_offset; /* offset in block of part */
2336 size_t m_size; /* Bytes in the part */
2337 size_t m_xsize; /* Bytes in the full part */
2338 long m_lines; /* Lines in the message: write format! */
2339 long m_xlines; /* Lines in the full message; ditto */
2340 time_t m_time; /* time the message was sent */
2341 char const *m_from; /* message sender */
2342 struct mimepart *m_nextpart; /* next part at same level */
2343 struct mimepart *m_multipart; /* parts of multipart */
2344 struct mimepart *m_parent; /* enclosing multipart part */
2345 char const *m_ct_type; /* content-type */
2346 char const *m_ct_type_plain; /* content-type without specs */
2347 char const *m_ct_type_usr_ovwr; /* Forcefully overwritten one */
2348 char const *m_charset;
2349 char const *m_ct_enc; /* Content-Transfer-Encoding */
2350 enum mimecontent m_mimecontent; /* ..in enum */
2351 enum mime_enc m_mime_enc; /* ..in enum */
2352 char *m_partstring; /* Part level string */
2353 char *m_filename; /* ..of attachment */
2354 char const *m_content_description;
2355 char const *m_external_body_url; /* message/external-body: access-type=URL */
2356 struct mime_handler *m_handler; /* MIME handler if yet classified */
2359 struct message {
2360 enum mflag m_flag; /* flags */
2361 enum content_info m_content_info;
2362 #ifdef HAVE_SPAM
2363 ui32_t m_spamscore; /* Spam score as int, 24:8 bits */
2364 #else
2365 ui8_t m__pad1[4];
2366 #endif
2367 int m_block; /* block number of this message */
2368 size_t m_offset; /* offset in block of message */
2369 size_t m_size; /* Bytes in the message */
2370 size_t m_xsize; /* Bytes in the full message */
2371 long m_lines; /* Lines in the message */
2372 long m_xlines; /* Lines in the full message */
2373 time_t m_time; /* time the message was sent */
2374 time_t m_date; /* time in the 'Date' field */
2375 #ifdef HAVE_IMAP
2376 ui64_t m_uid; /* IMAP unique identifier */
2377 #endif
2378 #ifdef HAVE_MAILDIR
2379 char const *m_maildir_file; /* original maildir file of msg */
2380 ui32_t m_maildir_hash; /* hash of file name in maildir sub */
2381 #endif
2382 int m_collapsed; /* collapsed thread information */
2383 unsigned m_idhash; /* hash on Message-ID for threads */
2384 unsigned m_level; /* thread level of message */
2385 long m_threadpos; /* position in threaded display */
2386 struct message *m_child; /* first child of this message */
2387 struct message *m_younger; /* younger brother of this message */
2388 struct message *m_elder; /* elder brother of this message */
2389 struct message *m_parent; /* parent of this message */
2392 /* Given a file address, determine the block number it represents */
2393 #define mailx_blockof(off) ((int) ((off) / 4096))
2394 #define mailx_offsetof(off) ((int) ((off) % 4096))
2395 #define mailx_positionof(block, offset) ((off_t)(block) * 4096 + (offset))
2397 enum gfield{ /* TODO -> enum m_grab_head, m_GH_xy */
2398 GNONE,
2399 GTO = 1u<<0, /* Grab To: line */
2400 GSUBJECT = 1u<<1, /* Likewise, Subject: line */
2401 GCC = 1u<<2, /* And the Cc: line */
2402 GBCC = 1u<<3, /* And also the Bcc: line */
2404 GNL = 1u<<4, /* Print blank line after */
2405 GDEL = 1u<<5, /* Entity removed from list */
2406 GCOMMA = 1u<<6, /* detract() puts in commas */
2407 GUA = 1u<<7, /* User-Agent field */
2408 GMIME = 1u<<8, /* MIME 1.0 fields */
2409 GMSGID = 1u<<9, /* a Message-ID */
2410 GNAMEONLY = 1u<<10, /* detract() does NOT use fullnames */
2412 GIDENT = 1u<<11, /* From:, Reply-To:, MFT: (user headers) */
2413 GREF = 1u<<12, /* References:, In-Reply-To:, (Message-ID:) */
2414 GREF_IRT = 1u<<30, /* XXX Hack; only In-Reply-To: -> n_run_editor() */
2415 GDATE = 1u<<13, /* Date: field */
2416 GFULL = 1u<<14, /* Include full names, comments etc. */
2417 GSKIN = 1u<<15, /* Skin names */
2418 GEXTRA = 1u<<16, /* Extra fields (mostly like GIDENT XXX) */
2419 GFILES = 1u<<17, /* Include filename and pipe addresses */
2420 GFULLEXTRA = 1u<<18, /* Only with GFULL: GFULL less address */
2421 GBCC_IS_FCC = 1u<<19 /* This GBCC is (or was) indeed a Fcc: */
2423 #define GMASK (GTO | GSUBJECT | GCC | GBCC)
2425 enum header_flags {
2426 HF_NONE = 0,
2427 HF_LIST_REPLY = 1<< 0,
2428 HF_MFT_SENDER = 1<< 1, /* Add ourselves to Mail-Followup-To: */
2429 HF_RECIPIENT_RECORD = 1<<10, /* Save message in file named after rec. */
2430 HF__NEXT_SHIFT = 11
2433 /* Structure used to pass about the current state of a message (header) */
2434 struct n_header_field{
2435 struct n_header_field *hf_next;
2436 ui32_t hf_nl; /* Field-name length */
2437 ui32_t hf_bl; /* Field-body length*/
2438 char hf_dat[n_VFIELD_SIZE(0)];
2441 struct header {
2442 ui32_t h_flags; /* enum header_flags bits */
2443 ui32_t h_dummy;
2444 char *h_subject; /* Subject string */
2445 char const *h_charset; /* preferred charset */
2446 struct name *h_from; /* overridden "From:" field */
2447 struct name *h_sender; /* overridden "Sender:" field */
2448 struct name *h_to; /* Dynamic "To:" string */
2449 struct name *h_cc; /* Carbon copies string */
2450 struct name *h_bcc; /* Blind carbon copies */
2451 struct name *h_fcc; /* Fcc: file carbon copies to */
2452 struct name *h_ref; /* References (possibly overridden) */
2453 struct attachment *h_attach; /* MIME attachments */
2454 struct name *h_reply_to; /* overridden "Reply-To:" field */
2455 struct name *h_message_id; /* overridden "Message-ID:" field */
2456 struct name *h_in_reply_to;/* overridden "In-Reply-To:" field */
2457 struct name *h_mft; /* Mail-Followup-To */
2458 char const *h_list_post; /* Address from List-Post:, for `Lreply' */
2459 struct n_header_field *h_user_headers;
2460 struct n_header_field *h_custom_headers; /* (Cached result) */
2461 /* Raw/original versions of the header(s). If any */
2462 char const *h_mailx_command;
2463 struct name *h_mailx_raw_to;
2464 struct name *h_mailx_raw_cc;
2465 struct name *h_mailx_raw_bcc;
2466 struct name *h_mailx_orig_from;
2467 struct name *h_mailx_orig_to;
2468 struct name *h_mailx_orig_cc;
2469 struct name *h_mailx_orig_bcc;
2472 /* Handling of namelist nodes used in processing the recipients of mail and
2473 * aliases, inspection of mail-addresses and all that kind of stuff */
2474 enum nameflags {
2475 NAME_SKINNED = 1u<<0, /* Is actually skin()ned */
2476 NAME_IDNA = 1u<<1, /* IDNA was applied */
2477 NAME_NAME_SALLOC = 1u<<2, /* .n_name is doped */
2479 NAME_ADDRSPEC_ISFILE = 1u<<3, /* ..is a file path */
2480 NAME_ADDRSPEC_ISPIPE = 1u<<4, /* ..is a command for piping */
2481 NAME_ADDRSPEC_ISFILEORPIPE = NAME_ADDRSPEC_ISFILE | NAME_ADDRSPEC_ISPIPE,
2482 NAME_ADDRSPEC_ISNAME = 1u<<5, /* ..is an alias name */
2483 NAME_ADDRSPEC_ISADDR = 1u<<6, /* ..is a mail network address.. */
2484 NAME_ADDRSPEC_WITHOUT_DOMAIN = 1u<<7, /* ..but without domain name */
2485 NAME_ADDRSPEC_ISMASK = n_BITENUM_MASK(3,6),
2487 NAME_ADDRSPEC_ERR_EMPTY = 1u<<9, /* An empty string (or NULL) */
2488 NAME_ADDRSPEC_ERR_ATSEQ = 1u<<10, /* Weird @ sequence */
2489 NAME_ADDRSPEC_ERR_CHAR = 1u<<11, /* Invalid character */
2490 NAME_ADDRSPEC_ERR_IDNA = 1u<<12, /* IDNA convertion failed */
2491 NAME_ADDRSPEC_ERR_NAME = 1u<<13, /* Alias with invalid content */
2492 NAME_ADDRSPEC_INVALID = NAME_ADDRSPEC_ERR_EMPTY |
2493 NAME_ADDRSPEC_ERR_ATSEQ | NAME_ADDRSPEC_ERR_CHAR |
2494 NAME_ADDRSPEC_ERR_IDNA | NAME_ADDRSPEC_ERR_NAME,
2496 /* Error storage (we must fit in 31-bit) */
2497 _NAME_SHIFTWC = 14,
2498 _NAME_MAXWC = 0x1FFFF,
2499 _NAME_MASKWC = _NAME_MAXWC << _NAME_SHIFTWC
2500 /* Bit 31 (32) == SI32_MIN temporarily used */
2503 /* In the !_ERR_EMPTY case, the failing character can be queried */
2504 #define NAME_ADDRSPEC_ERR_GETWC(F) \
2505 ((((unsigned int)(F) & _NAME_MASKWC) >> _NAME_SHIFTWC) & _NAME_MAXWC)
2506 #define NAME_ADDRSPEC_ERR_SET(F, E, WC) \
2507 do {\
2508 (F) = ((F) & ~(NAME_ADDRSPEC_INVALID | _NAME_MASKWC)) |\
2509 (E) | (((unsigned int)(WC) & _NAME_MAXWC) << _NAME_SHIFTWC);\
2510 } while (0)
2512 struct name{
2513 struct name *n_flink; /* Forward link in list. */
2514 struct name *n_blink; /* Backward list link */
2515 enum gfield n_type; /* From which list it came */
2516 ui32_t n_flags; /* enum nameflags */
2517 char *n_name; /* This fella's address */
2518 char *n_fullname; /* Ditto, unless GFULL including comment */
2519 char *n_fullextra; /* GFULL, without address */
2522 struct n_addrguts{
2523 /* Input string as given (maybe replaced with a fixed one!) */
2524 char const *ag_input;
2525 size_t ag_ilen; /* strlen() of input */
2526 size_t ag_iaddr_start; /* Start of *addr-spec* in .ag_input */
2527 size_t ag_iaddr_aend; /* ..and one past its end */
2528 char *ag_skinned; /* Output (alloced if !=.ag_input) */
2529 size_t ag_slen; /* strlen() of .ag_skinned */
2530 size_t ag_sdom_start; /* Start of domain in .ag_skinned, */
2531 enum nameflags ag_n_flags; /* enum nameflags of .ag_skinned */
2534 /* MIME attachments */
2535 enum attach_conv {
2536 AC_DEFAULT, /* _get_lc() -> _iter_*() */
2537 AC_FIX_INCS, /* "charset=".a_input_charset (nocnv) */
2538 AC_TMPFILE /* attachment.a_tmpf is converted */
2541 enum n_attach_error{
2542 n_ATTACH_ERR_NONE,
2543 n_ATTACH_ERR_FILE_OPEN,
2544 n_ATTACH_ERR_ICONV_FAILED,
2545 n_ATTACH_ERR_ICONV_NAVAIL,
2546 n_ATTACH_ERR_OTHER
2549 struct attachment {
2550 struct attachment *a_flink; /* Forward link in list. */
2551 struct attachment *a_blink; /* Backward list link */
2552 char const *a_path_user; /* Path as given (maybe including iconv spec) */
2553 char const *a_path; /* Path as opened */
2554 char const *a_path_bname; /* Basename of path as opened */
2555 char const *a_name; /* File name to be stored (EQ a_path_bname) */
2556 char const *a_content_type; /* content type */
2557 char const *a_content_disposition; /* content disposition */
2558 struct name *a_content_id; /* content id */
2559 char const *a_content_description; /* content description */
2560 char const *a_input_charset; /* Interpretation depends on .a_conv */
2561 char const *a_charset; /* ... */
2562 FILE *a_tmpf; /* If AC_TMPFILE */
2563 enum attach_conv a_conv; /* User chosen conversion */
2564 int a_msgno; /* message number */
2567 struct sendbundle {
2568 struct header *sb_hp;
2569 struct name *sb_to;
2570 FILE *sb_input;
2571 struct str sb_signer; /* USER@HOST for signing+ */
2572 struct url sb_url;
2573 struct ccred sb_ccred;
2576 /* For saving the current directory and later returning */
2577 struct cw {
2578 #ifdef HAVE_FCHDIR
2579 int cw_fd;
2580 #else
2581 char cw_wd[PATH_MAX];
2582 #endif
2586 * Global variable declarations
2588 * These become instantiated in main.c.
2591 #undef VL
2592 #ifdef n_MAIN_SOURCE
2593 # ifndef HAVE_AMALGAMATION
2594 # define VL
2595 # else
2596 # define VL static
2597 # endif
2598 #else
2599 # define VL extern
2600 #endif
2602 #ifndef HAVE_AMALGAMATION
2603 VL char const n_month_names[12 + 1][4];
2604 VL char const n_weekday_names[7 + 1][4];
2606 VL char const n_uagent[sizeof VAL_UAGENT];
2607 # ifdef HAVE_UISTRINGS
2608 VL char const n_error[sizeof n_ERROR];
2609 # endif
2610 VL char const n_path_devnull[sizeof n_PATH_DEVNULL];
2611 VL char const n_reproducible_name[sizeof "reproducible_build"];
2612 VL char const n_unirepl[sizeof n_UNIREPL];
2613 VL char const n_empty[1];
2614 VL char const n_0[2];
2615 VL char const n_1[2];
2616 VL char const n_m1[3]; /* -1 */
2617 VL char const n_em[2]; /* Exclamation-mark ! */
2618 VL char const n_ns[2]; /* Number sign # */
2619 VL char const n_star[2]; /* Asterisk * */
2620 VL char const n_hy[2]; /* Hyphen-Minus - */
2621 VL char const n_qm[2]; /* Question-mark ? */
2622 VL char const n_at[2]; /* Commercial at @ */
2623 VL ui16_t const n_class_char[1 + 0x7F];
2624 #endif /* HAVE_AMALGAMATION */
2626 VL FILE *n_stdin;
2627 VL FILE *n_stdout;
2628 VL FILE *n_stderr;
2629 VL FILE *n_tty_fp; /* Our terminal output TODO input channel */
2630 VL void *n_readctl_overlay; /* `readctl' overlay (see c_readctl()) */
2632 VL ui32_t n_mb_cur_max; /* Value of MB_CUR_MAX */
2633 VL ui32_t n_realscreenheight; /* The real screen height */
2634 VL ui32_t n_scrnwidth; /* Screen width/guess; also n_SCRNWIDTH_LIST */
2635 VL ui32_t n_scrnheight; /* Screen height/guess (for header summary+) */
2637 VL char const *n_progname; /* Our name */
2639 VL gid_t n_group_id; /* getgid() and getuid() */
2640 VL uid_t n_user_id;
2641 VL pid_t n_pid; /* getpid() (lazy initialized) */
2643 VL int n_exit_status; /* Program exit status TODO long term: ex_no */
2644 VL ui32_t n_poption; /* Bits of enum n_program_option */
2645 VL struct n_header_field *n_poption_arg_C; /* -C custom header list */
2646 VL char const *n_poption_arg_Mm; /* Argument for -[Mm] aka n_PO_[Mm]_FLAG */
2647 VL struct name *n_poption_arg_r; /* Argument to -r option */
2648 VL char const **n_smopts; /* MTA options from command line */
2649 VL size_t n_smopts_cnt; /* Entries in n_smopts */
2651 /* The current execution data context */
2652 VL struct n_go_data_ctx *n_go_data;
2653 VL ui32_t n_psonce; /* Bits of enum n_program_state_once */
2654 VL ui32_t n_pstate; /* Bits of enum n_program_state */
2655 /* TODO "cmd_tab.h ARG_EM set"-storage (n_[01..]) as long as we don't have a
2656 * TODO struct CmdCtx where each command has its own ARGC/ARGV, errno and exit
2657 * TODO status and may-place-in-history bit, need to manage a global bypass.. */
2658 VL si32_t n_pstate_err_no; /* What backs $! n_ERR_* TODO ..HACK */
2659 VL si32_t n_pstate_ex_no; /* What backs $? n_EX_* TODO ..HACK ->64-bit */
2660 #define n_err_no errno /* Don't use errno directly, for later XXX */
2661 VL si32_t n_iconv_err_no; /* TODO HACK: part of CTX to not get lost */
2663 /* XXX stylish sorting */
2664 VL int msgCount; /* Count of messages read in */
2665 VL struct mailbox mb; /* Current mailbox */
2666 VL char mailname[PATH_MAX]; /* Name of current file TODO URL/object*/
2667 VL char displayname[80 - 16]; /* Prettyfied for display TODO URL/obj*/
2668 VL char prevfile[PATH_MAX]; /* Name of previous file TODO URL/obj */
2669 VL off_t mailsize; /* Size of system mailbox */
2670 VL struct message *dot; /* Pointer to current message */
2671 VL struct message *prevdot; /* Previous current message */
2672 VL struct message *message; /* The actual message structure */
2673 VL struct message *threadroot; /* first threaded message */
2674 VL int *n_msgvec; /* Folder setmsize(), list.c res. store*/
2675 #ifdef HAVE_IMAP
2676 VL int imap_created_mailbox; /* hack to get feedback from imap */
2677 #endif
2679 VL struct n_header_field *n_customhdr_list; /* *customhdr* list */
2681 VL struct time_current time_current; /* time(3); send: mail1() XXXcarrier */
2682 VL struct termios_state termios_state; /* getpassword(); see commands().. */
2684 #ifdef HAVE_TLS
2685 VL enum n_tls_verify_level n_tls_verify_level; /* TODO local per-context! */
2686 #endif
2688 #ifdef HAVE_ICONV
2689 VL iconv_t iconvd;
2690 #endif
2692 VL volatile int interrupts; /* TODO rid! */
2693 VL sighandler_type dflpipe;
2696 * Finally, let's include the function prototypes XXX embed
2699 #ifndef n_PRIVSEP_SOURCE
2700 # include "nailfuns.h"
2701 #endif
2703 #endif /* n_NAIL_H */
2704 /* s-it-mode */