1 /*@ S-nail - a mail user agent derived from Berkeley Mail.
2 *@ Header inclusion, macros, constants, types and the global var declarations.
4 * Copyright (c) 2000-2004 Gunnar Ritter, Freiburg i. Br., Germany.
5 * Copyright (c) 2012 - 2015 Steffen (Daode) Nurpmeso <sdaoden@users.sf.net>.
8 * Copyright (c) 1980, 1993
9 * The Regents of the University of California. All rights reserved.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
19 * 3. Neither the name of the University nor the names of its contributors
20 * may be used to endorse or promote products derived from this software
21 * without specific prior written permission.
23 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
37 * Mail -- a mail program
39 * Author: Kurt Shoens (UCB) March 25, 1978
45 #include <sys/types.h>
47 #ifdef HAVE_GETTIMEOFDAY
48 # include <sys/time.h>
64 #if defined __STDC_VERSION__ && __STDC_VERSION__ + 0 >= 199901L
67 # include <inttypes.h>
84 #ifdef HAVE_OPENSSL_MD5
85 # include <openssl/md5.h>
89 * Constants, some nail-specific macros
92 #if !defined NI_MAXHOST
93 # define NI_MAXHOST 1025
96 /* TODO PATH_MAX: fixed-size buffer is always wrong (think NFS) */
99 # define PATH_MAX MAXPATHLEN
101 # define PATH_MAX 1024 /* _XOPEN_PATH_MAX POSIX 2008/Cor 1-2013 */
105 #ifndef HOST_NAME_MAX
106 # ifdef _POSIX_HOST_NAME_MAX
107 # define HOST_NAME_MAX _POSIX_HOST_NAME_MAX
109 # define HOST_NAME_MAX 255
114 # ifdef _POSIX_NAME_MAX
115 # define NAME_MAX _POSIX_NAME_MAX
121 # error NAME_MAX too small
125 # define STDIN_FILENO 0
127 #ifndef STDOUT_FILENO
128 # define STDOUT_FILENO 1
130 #ifndef STDERR_FILENO
131 # define STDERR_FILENO 2
136 # define NSIG NSIG_MAX
138 # define NSIG ((sizeof(sigset_t) * 8) - 1)
142 # define _O_CLOEXEC O_CLOEXEC
143 # define _CLOEXEC_SET(FD) do {;} while(0)
145 # define _O_CLOEXEC 0
146 # define _CLOEXEC_SET(FD) \
147 do { (void)fcntl((FD), F_SETFD, FD_CLOEXEC); } while (0)
152 #if BUFSIZ + 0 > 2560 /* TODO simply use BUFSIZ? */
153 # define LINESIZE BUFSIZ /* max readable line width */
155 # define LINESIZE 2560
157 #define BUFFER_SIZE (BUFSIZ >= (1u << 13) ? BUFSIZ : (1u << 14))
159 /* Network protocol newline */
160 #define NETNL "\015\012"
161 #define NETLINE(X) X NETNL
163 /* Number of Not-Yet-Dead calls that are remembered */
164 #if defined HAVE_DEBUG || defined HAVE_DEVEL || defined HAVE_NYD2
166 # define NYD_CALLS_MAX (25 * 84)
167 # elif defined HAVE_DEVEL
168 # define NYD_CALLS_MAX (25 * 42)
170 # define NYD_CALLS_MAX (25 * 10)
174 #define APPEND /* New mail goes to end of mailbox */
175 #define CBAD (-15555)
176 #define DOTLOCK_TRIES 5 /* Number of open(2) calls for dotlock */
177 #define FILE_LOCK_TRIES 10 /* Maximum tries before file_lock() fails */
178 #define ERRORS_MAX 1000 /* Maximum error ring entries TODO configable*/
179 #define ESCAPE '~' /* Default escape for sending */
180 #define FIO_STACK_SIZE 20 /* Maximum recursion for sourcing */
181 #define HIST_SIZE 242 /* tty.c: history list default size */
182 #define HSHSIZE 23 /* Hash prime TODO make dynamic, obsolete */
183 #define MAXARGC 1024 /* Maximum list of raw strings */
184 #define MAXEXP 25 /* Maximum expansion of aliases */
185 #define PROMPT_BUFFER_SIZE 80 /* getprompt() bufsize (> 3!) */
186 #define REFERENCES_MAX 20 /* Maximum entries in References: */
187 #define FTMP_OPEN_TRIES 10 /* Maximum number of Ftmp() open(2) tries */
189 #define ACCOUNT_NULL "null" /* Name of "null" account */
190 #define MAILRC "~/.mailrc"
191 #define NETRC "~/.netrc"
192 #define TMPDIR_FALLBACK "/tmp"
194 /* Some environment variables for pipe hooks */
195 #define AGENT_USER "NAIL_USER"
196 #define AGENT_USER_ENC "NAIL_USER_ENC"
197 #define AGENT_HOST "NAIL_HOST"
198 #define AGENT_HOST_PORT "NAIL_HOST_PORT"
206 #define COLOUR_MSGINFO "fg=green"
207 #define COLOUR_PARTINFO "fg=brown"
208 #define COLOUR_FROM_ "fg=brown"
209 #define COLOUR_HEADER "fg=red"
210 #define COLOUR_UHEADER "ft=bold,fg=red"
211 #define COLOUR_TERMS \
212 "cons25,linux,rxvt,rxvt-unicode,screen,sun,vt100,vt220,wsvt25,xterm"
213 #define COLOUR_USER_HEADERS "from,subject"
215 /* Special FD requests for run_command() / start_command() */
216 #define COMMAND_FD_PASS -1
217 #define COMMAND_FD_NULL -2
220 #define FROM_DATEBUF 64 /* Size of RFC 4155 From_ line date */
221 #define DATE_DAYSYEAR 365L
222 #define DATE_SECSMIN 60L
223 #define DATE_MINSHOUR 60L
224 #define DATE_HOURSDAY 24L
225 #define DATE_SECSDAY (DATE_SECSMIN * DATE_MINSHOUR * DATE_HOURSDAY)
227 /* *indentprefix* default as of POSIX */
228 #define INDENT_DEFAULT "\t"
230 /* Default *encoding* as enum mime_enc below */
231 #define MIME_DEFAULT_ENCODING MIMEE_QP
233 /* Maximum allowed line length in a mail before QP folding is necessary), and
234 * the real limit we go for */
235 #define MIME_LINELEN_MAX 998 /* Plus CRLF */
236 #define MIME_LINELEN_LIMIT (MIME_LINELEN_MAX - 48)
239 #define MIME_LINELEN 78 /* Plus CRLF */
241 /* And in headers which contain an encoded word according to RFC 2047 there is
242 * yet another limit; also RFC 2045: 6.7, (5). */
243 #define MIME_LINELEN_RFC2047 76
245 /* Locations of mime.types(5) */
246 #define MIME_TYPES_USR "~/.mime.types"
247 #define MIME_TYPES_SYS "/etc/mime.types"
249 /* Fallback MIME charsets, if *charset-7bit* and *charset-8bit* or not set.
250 * (Keep in SYNC: ./nail.1:"Character sets", ./nail.h:CHARSET_*!) */
251 #define CHARSET_7BIT "US-ASCII"
253 # define CHARSET_8BIT "UTF-8"
254 # define CHARSET_8BIT_OKEY charset_8bit
256 # define CHARSET_8BIT "ISO-8859-1"
257 # define CHARSET_8BIT_OKEY ttycharset
260 /* Some environment variables for pipe hooks etc. */
261 #define NAILENV_TMPDIR "NAIL_TMPDIR"
262 #define NAILENV_FILENAME "NAIL_FILENAME"
263 #define NAILENV_FILENAME_GENERATED "NAIL_FILENAME_GENERATED"
264 #define NAILENV_FILENAME_TEMPORARY "NAIL_FILENAME_TEMPORARY"
265 #define NAILENV_CONTENT "NAIL_CONTENT"
266 #define NAILENV_CONTENT_EVIDENCE "NAIL_CONTENT_EVIDENCE"
268 /* Is *W* a quoting (ASCII only) character? */
270 ((W) == L'>' || (W) == L'|' || (W) == L'}' || (W) == L':')
272 /* Maximum number of quote characters (not bytes!) that'll be used on
273 * follow lines when compressing leading quote characters */
276 /* How much spaces should a <tab> count when *quote-fold*ing? (power-of-two!) */
277 #define QUOTE_TAB_SPACES 8
279 /* Maximum size of a message that is passed through to the spam system */
280 #define SPAM_MAXSIZE 420000
282 /* String dope: dynamic buffer size, and size of the single builtin one that's
283 * used first; note that these value include the size of the structure */
284 #define SBUFFER_SIZE ((0x10000u >> 1u) - 0x400)
285 #define SBUFFER_BUILTIN (0x10000u >> 1u)
287 /* These come from the configuration (named Xxy to not clash with sh(1)..) */
289 # define XSHELL "/bin/sh"
292 # define XLISTER "ls"
295 # define XPAGER "more"
299 * OS, CC support, generic macros etc.
302 /* OS: we're not a library, only set what needs special treatment somewhere */
303 #define OS_DRAGONFLY 0
309 # define OS_DRAGONFLY 1
310 #elif defined __solaris__ || defined __sun
311 # if defined __SVR4 || defined __svr4__
313 # define OS_SOLARIS 1
322 #define PREREQ_CLANG(X,Y) 0
324 #define PREREQ_GCC(X,Y) 0
326 #define PREREQ_TCC(X,Y) 0
332 # define PREREQ_CLANG(X,Y) \
333 (__clang_major__ + 0 > (X) || \
334 (__clang_major__ + 0 == (X) && __clang_minor__ + 0 >= (Y)))
335 # define __EXTEN __extension__
337 #elif defined __GNUC__
341 # define PREREQ_GCC(X,Y) \
342 (__GNUC__ + 0 > (X) || (__GNUC__ + 0 == (X) && __GNUC_MINOR__ + 0 >= (Y)))
343 # define __EXTEN __extension__
345 #elif defined __TINYC__
354 /* Suppress some technical warnings via #pragma's unless developing.
355 * XXX Wild guesses: clang(1) 1.7 and (OpenBSD) gcc(1) 4.2.1 don't work */
357 # if PREREQ_CLANG(3, 4)
358 # pragma clang diagnostic ignored "-Wunused-result"
359 # pragma clang diagnostic ignored "-Wformat"
360 # elif PREREQ_GCC(4, 7)
361 # pragma GCC diagnostic ignored "-Wunused-local-typedefs"
362 # pragma GCC diagnostic ignored "-Wunused-result"
363 # pragma GCC diagnostic ignored "-Wformat"
367 /* For injection macros like DBG(), NATCH_CHAR() */
370 #define EMPTY_FILE() typedef int CONCAT(avoid_empty_file__, n_FILE);
372 /* Pointer to size_t */
373 #define PTR2SIZE(X) ((size_t)(uintptr_t)(X))
375 /* Pointer comparison (types from below) */
376 #define PTRCMP(A,C,B) ((uintptr_t)(A) C (uintptr_t)(B))
378 /* Ditto, compare (maybe mixed-signed) integers cases to T bits, unsigned;
379 * Note: doesn't sign-extend correctly, that's still up to the caller */
380 #define UICMP(T,A,C,B) ((ui ## T ## _t)(A) C (ui ## T ## _t)(B))
382 /* Align something to a size/boundary that cannot cause just any problem */
383 #define n_ALIGN(X) (((X) + 2*sizeof(void*)) & ~((2*sizeof(void*)) - 1))
385 /* Members in constant array */
387 # define NELEM(A) (sizeof(A) / sizeof(A[0]))
390 /* sizeof() for member fields */
391 #define SIZEOF_FIELD(T,F) sizeof(((T *)NULL)->F)
393 /* Casts-away (*NOT* cast-away) */
394 #define UNUSED(X) ((void)(X))
395 #define UNCONST(P) ((void*)(uintptr_t)(void const*)(P))
396 #define UNVOLATILE(P) ((void*)(uintptr_t)(void volatile*)(P))
397 #define UNXXX(T,C,P) ((T)(uintptr_t)(C)(P))
399 /* __STDC_VERSION__ is ISO C99, so also use __STDC__, which should work */
400 #if defined __STDC__ || defined __STDC_VERSION__ /*|| defined __cplusplus*/
401 # define STRING(X) #X
402 # define XSTRING(X) STRING(X)
403 # define CONCAT(S1,S2) _CONCAT(S1, S2)
404 # define _CONCAT(S1,S2) S1 ## S2
406 # define STRING(X) "X"
407 # define XSTRING STRING
408 # define CONCAT(S1,S2) S1/**/S2
411 #if defined __STDC_VERSION__ && __STDC_VERSION__ + 0 >= 199901L
412 # define n_FIELD_INITN(N) CONCAT(., N) =
413 # define n_FIELD_INITI(I) [I] =
415 # define n_FIELD_INITN(N)
416 # define n_FIELD_INITI(N)
419 #if defined __STDC_VERSION__ && __STDC_VERSION__ + 0 >= 199901L
420 # define VFIELD_SIZE(X)
421 # define VFIELD_SIZEOF(T,F) (0)
423 # define VFIELD_SIZE(X) \
424 ((X) == 0 ? sizeof(size_t) \
425 : ((ssize_t)(X) < 0 ? sizeof(size_t) - ABS(X) : (size_t)(X)))
426 # define VFIELD_SIZEOF(T,F) SIZEOF_FIELD(T, F)
429 #if defined __STDC_VERSION__ && __STDC_VERSION__ + 0 >= 199901L
431 # define INLINE inline
432 # define SINLINE static inline
433 #elif CC_CLANG || PREREQ_GCC(2, 9)
435 # define INLINE static __inline
436 # define SINLINE static __inline
439 # define SINLINE static
443 #if defined __STDC_VERSION__ && __STDC_VERSION__ + 0 >= 199901L
444 # define __FUN__ __func__
445 #elif CC_CLANG || PREREQ_GCC(3, 4)
446 # define __FUN__ __extension__ __FUNCTION__
448 # define __FUN__ uagent /* Something that is not a literal */
451 #if defined __predict_true && defined __predict_false
452 # define LIKELY(X) __predict_true(X)
453 # define UNLIKELY(X) __predict_false(X)
454 #elif CC_CLANG || PREREQ_GCC(2, 96)
455 # define LIKELY(X) __builtin_expect(X, 1)
456 # define UNLIKELY(X) __builtin_expect(X, 0)
458 # define LIKELY(X) (X)
459 # define UNLIKELY(X) (X)
462 #undef HAVE_NATCH_CHAR
464 #if defined HAVE_SETLOCALE && defined HAVE_C90AMEND1 && defined HAVE_WCWIDTH
465 # define HAVE_NATCH_CHAR
466 # define NATCH_CHAR(X) X
468 # define NATCH_CHAR(X)
471 /* Compile-Time-Assert
472 * Problem is that some compilers warn on unused local typedefs, so add
473 * a special local CTA to overcome this */
474 #define CTA(TEST) _CTA_1(TEST, n_FILE, __LINE__)
475 #define LCTA(TEST) _LCTA_1(TEST, n_FILE, __LINE__)
477 #if defined __STDC_VERSION__ && __STDC_VERSION__ + 0 >= 201112L
478 # define n_CTA(T,M) _Static_assert(T, M)
479 # define n_LCTA(T,M) _Static_assert(T, M)
481 # define n_CTA(T,M) _CTA_1(T, n_FILE, __LINE__)
482 # define n_LCTA(T,M) _LCTA_1(T, n_FILE, __LINE__)
486 # define n_MCTA(T,M) n_CTA(T, M);
491 #define _CTA_1(T,F,L) _CTA_2(T, F, L)
492 #define _CTA_2(T,F,L) \
493 typedef char ASSERTION_failed_in_file_## F ## _at_line_ ## L[(T) ? 1 : -1]
494 #define _LCTA_1(T,F,L) _LCTA_2(T, F, L)
495 #define _LCTA_2(T,F,L) \
497 typedef char ASSERTION_failed_in_file_## F ## _at_line_ ## L[(T) ? 1 : -1];\
498 ASSERTION_failed_in_file_## F ## _at_line_ ## L __i_am_unused__;\
499 UNUSED(__i_am_unused__);\
502 #define UNINIT(N,V) N = V
505 #define ISPOW2(X) ((((X) - 1) & (X)) == 0)
507 #define MIN(A, B) ((A) < (B) ? (A) : (B))
509 #define MAX(A, B) ((A) < (B) ? (B) : (A))
511 #define ABS(A) ((A) < 0 ? -(A) : (A))
517 # define assert(X) UNUSED(0)
520 # define DBGOR(X,Y) Y
524 # define DBGOR(X,Y) X
527 /* Translation (init in main.c) */
540 # define UI8_MAX UINT8_MAX
541 # define SI8_MIN INT8_MIN
542 # define SI8_MAX INT8_MAX
543 typedef uint8_t ui8_t
;
544 typedef int8_t si8_t
;
545 #elif UCHAR_MAX != 255
546 # error UCHAR_MAX must be 255
548 # define UI8_MAX UCHAR_MAX
549 # define SI8_MIN CHAR_MIN
550 # define SI8_MAX CHAR_MAX
551 typedef unsigned char ui8_t
;
552 typedef signed char si8_t
;
555 #if !defined PRIu8 || !defined PRId8
563 # define UI16_MAX UINT16_MAX
564 # define SI16_MIN INT16_MIN
565 # define SI16_MAX INT16_MAX
566 typedef uint16_t ui16_t
;
567 typedef int16_t si16_t
;
568 #elif USHRT_MAX != 0xFFFFu
569 # error USHRT_MAX must be 0xFFFF
571 # define UI16_MAX USHRT_MAX
572 # define SI16_MIN SHRT_MIN
573 # define SI16_MAX SHRT_MAX
574 typedef unsigned short ui16_t
;
575 typedef signed short si16_t
;
578 #if !defined PRIu16 || !defined PRId16
581 # if UI16_MAX == UINT_MAX
591 # define UI32_MAX UINT32_MAX
592 # define SI32_MIN INT32_MIN
593 # define SI32_MAX INT32_MAX
594 typedef uint32_t ui32_t
;
595 typedef int32_t si32_t
;
596 #elif ULONG_MAX == 0xFFFFFFFFu
597 # define UI32_MAX ULONG_MAX
598 # define SI32_MIN LONG_MIN
599 # define SI32_MAX LONG_MAX
600 typedef unsigned long int ui32_t
;
601 typedef signed long int si32_t
;
602 #elif UINT_MAX != 0xFFFFFFFFu
603 # error UINT_MAX must be 0xFFFFFFFF
605 # define UI32_MAX UINT_MAX
606 # define SI32_MIN INT_MIN
607 # define SI32_MAX INT_MAX
608 typedef unsigned int ui32_t
;
609 typedef signed int si32_t
;
612 #if !defined PRIu32 || !defined PRId32
615 # if UI32_MAX == ULONG_MAX
625 # define UI64_MAX UINT64_MAX
626 # define SI64_MIN INT64_MIN
627 # define SI64_MAX INT64_MAX
628 typedef uint64_t ui64_t
;
629 typedef int64_t si64_t
;
630 #elif ULONG_MAX <= 0xFFFFFFFFu
631 # if !defined ULLONG_MAX || (ULLONG_MAX >> 31) < 0xFFFFFFFFu
632 # error We need a 64 bit integer
634 # define UI64_MAX ULLONG_MAX
635 # define SI64_MIN LLONG_MIN
636 # define SI64_MAX LLONG_MAX
637 __EXTEN
typedef unsigned long long ui64_t
;
638 __EXTEN
typedef signed long long si64_t
;
641 # define UI64_MAX ULONG_MAX
642 # define SI64_MIN LONG_MIN
643 # define SI64_MAX LONG_MAX
644 typedef unsigned long ui64_t
;
645 typedef signed long si64_t
;
648 #if !defined PRIu64 || !defined PRId64 || !defined PRIX64
652 # if defined ULLONG_MAX && UI64_MAX == ULLONG_MAX
653 # define PRIu64 "llu"
654 # define PRId64 "lld"
655 # define PRIX64 "llX"
663 /* (So that we can use UICMP() for size_t comparison, too) */
664 typedef size_t uiz_t
;
665 typedef ssize_t siz_t
;
669 #if defined __STDC_VERSION__ && __STDC_VERSION__ + 0 >= 199901L
672 # define UIZ_MAX SIZE_MAX
673 #elif defined SIZE_MAX
674 /* UnixWare has size_t as unsigned as required but uses a signed limit
675 * constant (which is thus false!) */
676 # if SIZE_MAX == UI64_MAX || SIZE_MAX == SI64_MAX
677 # define PRIuZ PRIu64
678 # define PRIdZ PRId64
679 n_MCTA(sizeof(size_t) == sizeof(ui64_t
),
680 "Format string mismatch, compile with ISO C99 compiler (-std=c99)!")
681 # elif SIZE_MAX == UI32_MAX || SIZE_MAX == SI32_MAX
682 # define PRIuZ PRIu32
683 # define PRIdZ PRId32
684 n_MCTA(sizeof(size_t) == sizeof(ui32_t
),
685 "Format string mismatch, compile with ISO C99 compiler (-std=c99)!")
687 # error SIZE_MAX is neither UI64_MAX nor UI32_MAX (please report this)
689 # define UIZ_MAX SIZE_MAX
694 n_MCTA(sizeof(size_t) == sizeof(unsigned long),
695 "Format string mismatch, compile with ISO C99 compiler (-std=c99)!")
696 # define UIZ_MAX ULONG_MAX
701 # define uintptr_t size_t
702 # define UINTPTR_MAX SIZE_MAX
704 # define uintptr_t unsigned long
705 # define UINTPTR_MAX ULONG_MAX
709 #if !defined PRIuPTR || !defined PRIXPTR
712 # if UINTPTR_MAX == ULONG_MAX
713 # define PRIuPTR "lu"
714 # define PRIXPTR "lX"
721 enum {FAL0
, TRU1
, TRUM1
= -1};
722 typedef si8_t bool_t
;
724 /* Add shorter aliases for "normal" integers */
725 typedef unsigned long ul_i
;
726 typedef unsigned int ui_i
;
727 typedef unsigned short us_i
;
728 typedef unsigned char uc_i
;
730 typedef signed long sl_i
;
731 typedef signed int si_i
;
732 typedef signed short ss_i
;
733 typedef signed char sc_i
;
735 typedef void ( *sighandler_type
)(int);
738 AUTHTYPE_NONE
= 1<<0,
739 AUTHTYPE_PLAIN
= 1<<1, /* POP3: APOP is covered by this */
740 AUTHTYPE_LOGIN
= 1<<2,
741 AUTHTYPE_CRAM_MD5
= 1<<3,
742 AUTHTYPE_GSSAPI
= 1<<4
745 enum expand_addr_flags
{
746 EAF_NONE
= 0, /* -> EAF_NOFILE | EAF_NOPIPE */
747 EAF_RESTRICT
= 1<<0, /* "restrict" (do unless interaktive / -[~#]) */
748 EAF_FAIL
= 1<<1, /* "fail" */
749 /* Bits reused by enum expand_addr_check_mode! */
750 EAF_FILE
= 1<<3, /* +"file" targets */
751 EAF_PIPE
= 1<<4, /* +"pipe" command pipe targets */
752 EAF_NAME
= 1<<5, /* +"name"s (non-address) names / MTA aliases */
753 EAF_ADDR
= 1<<6, /* +"addr" network address (contain "@") */
755 EAF_TARGET_MASK
= EAF_FILE
| EAF_PIPE
| EAF_NAME
| EAF_ADDR
,
756 EAF_RESTRICT_TARGETS
= EAF_NAME
| EAF_ADDR
/* (default set if not set) */
759 enum expand_addr_check_mode
{
760 EACM_NONE
= 0, /* Don't care about *expandaddr* */
761 EACM_NORMAL
= 1<<0, /* Use our normal *expandaddr* checking */
762 EACM_STRICT
= 1<<1, /* Never allow any file or pipe addresse */
763 EACM_MODE_MASK
= 0x3, /* _NORMAL and _STRICT are mutual! */
765 EACM_NOLOG
= 1<<2, /* Don't log check errors */
767 /* Some special overwrites of EAF_TARGETs.
768 * May NOT clash with EAF_* bits which may be ORd to these here! */
783 CONV_NONE
, /* no conversion */
784 CONV_7BIT
, /* no conversion, is 7bit */
785 CONV_FROMQP
, /* convert from quoted-printable */
786 CONV_TOQP
, /* convert to quoted-printable */
787 CONV_8BIT
, /* convert to 8bit (iconv) */
788 CONV_FROMB64
, /* convert from base64 */
789 CONV_FROMB64_T
, /* convert from base64/text */
790 CONV_TOB64
, /* convert to base64 */
791 CONV_FROMHDR
, /* convert from RFC1522 format */
792 CONV_TOHDR
, /* convert to RFC1522 format */
793 CONV_TOHDR_A
/* convert addresses for header */
804 DLS_CANT_CHDIR
, /* Failed to chdir(2) into desired path */
805 DLS_NAMETOOLONG
, /* Lock file name would be too long */
806 DLS_ROFS
, /* Read-only filesystem (no error, mailbox RO) */
807 DLS_NOPERM
, /* No permission to creat lock file */
808 DLS_NOEXEC
, /* Privilege separated dotlocker not found */
809 DLS_PRIVFAILED
, /* Rising privileges failed in dotlocker */
810 DLS_EXIST
, /* Lock file already exists, stale lock? */
811 DLS_FISHY
, /* Something makes us think bad of situation */
812 DLS_DUNNO
, /* Catch-all error */
813 DLS_PING
, /* Not an error, but have to wait for lock */
814 DLS_ABANDON
= 1<<7 /* ORd to any but _NONE: give up, don't retry */
818 EXIT_OK
= EXIT_SUCCESS
,
819 EXIT_ERR
= EXIT_FAILURE
,
820 EXIT_USE
= 64, /* sysexits.h:EX_USAGE */
821 EXIT_NOUSER
= 67, /* :EX_NOUSER */
822 EXIT_COLL_ABORT
= 1<<1, /* Message collection was aborted */
823 EXIT_SEND_ERROR
= 1<<2 /* Unspecified send error occurred */
828 FEDIT_SYSBOX
= 1<<0, /* %: prefix */
829 FEDIT_RDONLY
= 1<<1, /* Readonly (per-box, OPT_R_FLAG is global) */
830 FEDIT_NEWMAIL
= 1<<2 /* `newmail' operation TODO OBSOLETE THIS! */
834 FEXP_FULL
, /* Full expansion */
835 FEXP_LOCAL
= 1<<0, /* Result must be local file/maildir */
836 FEXP_SHELL
= 1<<1, /* No folder %,#,&,+ stuff, yet sh(1) */
837 FEXP_NSHORTCUT
= 1<<2, /* Don't expand shortcuts */
838 FEXP_SILENT
= 1<<3, /* Don't print but only return errors */
839 FEXP_MULTIOK
= 1<<4, /* Expansion to many entries is ok */
840 FEXP_NSHELL
= 1<<5 /* Don't do shell word exp. (but ~/, $VAR) */
843 enum file_lock_type
{
849 MIME_UNKNOWN
, /* unknown content */
850 MIME_SUBHDR
, /* inside a multipart subheader */
851 MIME_822
, /* message/rfc822 content */
852 MIME_MESSAGE
, /* other message/ content */
853 MIME_TEXT_PLAIN
, /* text/plain content */
854 MIME_TEXT_HTML
, /* text/html content */
855 MIME_TEXT
, /* other text/ content */
856 MIME_ALTERNATIVE
, /* multipart/alternative content */
857 MIME_RELATED
, /* mime/related (RFC 2387) */
858 MIME_DIGEST
, /* multipart/digest content */
859 MIME_MULTI
, /* other multipart/ content */
860 MIME_PKCS7
, /* PKCS7 content */
861 MIME_DISCARD
/* content is discarded */
864 enum mime_counter_evidence
{
866 MIMECE_SET
= 1<<0, /* *mime-counter-evidence* was set */
867 MIMECE_BIN_OVWR
= 1<<1, /* appli../octet-stream: check, ovw if possible */
868 MIMECE_ALL_OVWR
= 1<<2, /* all: check, ovw if possible */
869 MIMECE_BIN_PARSE
= 1<<3 /* appli../octet-stream: classify contents last */
872 /* Content-Transfer-Encodings as defined in RFC 2045:
873 * - Quoted-Printable, section 6.7
874 * - Base64, section 6.8 */
875 #define QP_LINESIZE (4 * 19) /* Max. compliant QP linesize */
877 #define B64_LINESIZE (4 * 19) /* Max. compliant Base64 linesize */
878 #define B64_ENCODE_INPUT_PER_LINE 57 /* Max. input for Base64 encode/line */
881 MIMEE_NONE
, /* message is not in MIME format */
882 MIMEE_BIN
, /* message is in binary encoding */
883 MIMEE_8B
, /* message is in 8bit encoding */
884 MIMEE_7B
, /* message is in 7bit encoding */
885 MIMEE_QP
, /* message is quoted-printable */
886 MIMEE_B64
/* message is in base64 encoding */
889 /* xxx QP came later, maybe rewrite all to use mime_enc_flags directly? */
890 enum mime_enc_flags
{
892 MIMEEF_SALLOC
= 1<<0, /* Use salloc(), not srealloc().. */
893 /* ..result .s,.l point to user buffer of *_LINESIZE+[+[+]] bytes instead */
895 MIMEEF_CRLF
= 1<<2, /* (encode) Append "\r\n" to lines */
896 MIMEEF_LF
= 1<<3, /* (encode) Append "\n" to lines */
897 /* (encode) If one of _CRLF/_LF is set, honour *_LINESIZE+[+[+]] and
898 * inject the desired line-ending whenever a linewrap is desired */
899 MIMEEF_MULTILINE
= 1<<4,
900 /* (encode) Quote with header rules, do not generate soft NL breaks?
901 * For mustquote(), specifies wether special RFC 2047 header rules
902 * should be used instead */
903 MIMEEF_ISHEAD
= 1<<5,
904 /* (encode) Ditto; for mustquote() this furtherly fine-tunes behaviour in
905 * that characters which would not be reported as "must-quote" when
906 * detecting wether quoting is necessary at all will be reported as
907 * "must-quote" if they have to be encoded in an encoded word */
908 MIMEEF_ISENCWORD
= 1<<6,
913 QP_NONE
= MIMEEF_NONE
,
914 QP_SALLOC
= MIMEEF_SALLOC
,
916 QP_ISHEAD
= MIMEEF_ISHEAD
,
917 QP_ISENCWORD
= MIMEEF_ISENCWORD
921 B64_NONE
= MIMEEF_NONE
,
922 B64_SALLOC
= MIMEEF_SALLOC
,
923 B64_BUF
= MIMEEF_BUF
,
924 B64_CRLF
= MIMEEF_CRLF
,
926 B64_MULTILINE
= MIMEEF_MULTILINE
,
927 /* Not used, but for clarity only */
928 B64_ISHEAD
= MIMEEF_ISHEAD
,
929 B64_ISENCWORD
= MIMEEF_ISENCWORD
,
930 /* Special version of Base64, "Base64URL", according to RFC 4648.
931 * Only supported for encoding! */
932 B64_RFC4648URL
= 1<<(__MIMEEF_LAST
+1),
933 /* Don't use any ("=") padding;
934 * may NOT be used with any of _CRLF, _LF or _MULTILINE */
935 B64_NOPAD
= 1<<(__MIMEEF_LAST
+2)
938 enum mime_parse_flags
{
940 MIME_PARSE_DECRYPT
= 1<<0,
941 MIME_PARSE_PARTS
= 1<<1
944 enum mime_handler_flags
{
945 MIME_HDL_NULL
, /* No pipe- mimetype handler, go away */
946 MIME_HDL_CMD
, /* Normal command */
947 MIME_HDL_TEXT
, /* @ special cmd to force treatment as text */
948 MIME_HDL_PTF
, /* A special pointer-to-function handler */
949 MIME_HDL_MSG
, /* Display msg (returned as command string) */
950 MIME_HDL_TYPE_MASK
= 7,
951 MIME_HDL_ISQUOTE
= 1<<4, /* Is quote action (we have info, keep it!) */
952 MIME_HDL_NOQUOTE
= 1<<5, /* No MIME for quoting */
953 MIME_HDL_ALWAYS
= 1<<6, /* Handler shall run for multi-msg actions */
954 MIME_HDL_ASYNC
= 1<<7, /* Should run asynchronously */
955 MIME_HDL_NEEDSTERM
= 1<<8, /* Takes over terminal */
956 MIME_HDL_TMPF
= 1<<9, /* Create temporary file (zero-sized) */
957 MIME_HDL_TMPF_FILL
= 1<<10, /* Fill in the msg body content */
958 MIME_HDL_TMPF_UNLINK
= 1<<11 /* Delete it later again */
962 MLIST_OTHER
= 0, /* Normal address */
963 MLIST_KNOWN
= 1, /* A known `mlist' */
964 MLIST_SUBSCRIBED
= -1 /* A `mlsubscribe'd list */
975 OF_CLOEXEC
= 1<<7, /* TODO not used, always implied! CHANGE!! */
976 OF_UNLINK
= 1<<8, /* Only for Ftmp(): unlink(2) after creation */
977 OF_HOLDSIGS
= 1<<9, /* Mutual with OF_UNLINK - await Ftmp_free() */
978 OF_REGISTER
= 1<<10, /* Register file in our file table */
979 OF_REGISTER_UNLINK
= 1<<11, /* unlink(2) upon unreg.; _REGISTER asserted! */
980 OF_SUFFIX
= 1<<12 /* Ftmp() name hint is mandatory! extension! */
988 enum okey_xlook_mode
{
989 OXM_PLAIN
= 1<<0, /* Plain key always tested */
990 OXM_H_P
= 1<<1, /* Check PLAIN-.url_h_p */
991 OXM_U_H_P
= 1<<2, /* Check PLAIN-.url_u_h_p */
995 /* <0 means "stop" unless *prompt* extensions are enabled. */
997 PROMPT_STOP
= -1, /* \c */
998 /* *prompt* extensions: \$, \@ etc. */
1004 PROTO_FILE
, /* refers to a local file */
1005 PROTO_POP3
, /* is a pop3 server string */
1006 PROTO_IMAP
, /* is an imap server string */
1007 PROTO_MAILDIR
, /* refers to a maildir folder */
1008 PROTO_UNKNOWN
/* unknown protocol */
1012 SEND_MBOX
, /* no conversion to perform */
1013 SEND_RFC822
, /* no conversion, no From_ line */
1014 SEND_TODISP
, /* convert to displayable form */
1015 SEND_TODISP_ALL
, /* same, include all MIME parts */
1016 SEND_SHOW
, /* convert to 'show' command form */
1017 SEND_TOSRCH
, /* convert for IMAP SEARCH */
1018 SEND_TOFILE
, /* convert for saving body to a file */
1019 SEND_TOPIPE
, /* convert for pipe-content/subc. */
1020 SEND_QUOTE
, /* convert for quoting */
1021 SEND_QUOTE_ALL
, /* same, include all MIME parts */
1022 SEND_DECRYPT
/* decrypt */
1026 enum ssl_verify_level
{
1035 TD_NONE
, /* no display conversion */
1036 TD_ISPR
= 1<<0, /* use isprint() checks */
1037 TD_ICONV
= 1<<1, /* use iconv() */
1038 TD_DELCTRL
= 1<<2, /* delete control characters */
1041 * NOTE: _TD_EOF and _TD_BUFCOPY may be ORd with enum conversion and
1042 * enum sendaction, and may thus NOT clash with their bit range!
1044 _TD_EOF
= 1<<14, /* EOF seen, last round! */
1045 _TD_BUFCOPY
= 1<<15 /* Buffer may be constant, copy it */
1050 OPT_DEBUG
= 1u<< 0, /* -d / *debug* */
1051 OPT_VERB
= 1u<< 1, /* -v / *verbose* */
1052 OPT_VERBVERB
= 1u<< 2, /* .. even more verbosity */
1053 OPT_EXISTONLY
= 1u<< 3, /* -e */
1054 OPT_HEADERSONLY
= 1u<<4, /* -H */
1055 OPT_HEADERLIST
= 1u<< 5, /* -L */
1056 OPT_QUICKRUN_MASK
= OPT_EXISTONLY
| OPT_HEADERSONLY
| OPT_HEADERLIST
,
1057 OPT_NOSRC
= 1u<< 6, /* -n */
1058 OPT_E_FLAG
= 1u<< 7, /* -E / *skipemptybody* */
1059 OPT_F_FLAG
= 1u<< 8, /* -F */
1060 OPT_N_FLAG
= 1u<< 9, /* -N / *header* */
1061 OPT_R_FLAG
= 1u<<10, /* -R */
1062 OPT_r_FLAG
= 1u<<11, /* -r (plus option_r_arg) */
1063 OPT_t_FLAG
= 1u<<12, /* -t */
1064 OPT_u_FLAG
= 1u<<13, /* -u / $USER and pw->pw_uid != getuid(2) */
1065 OPT_TILDE_FLAG
= 1u<<14, /* -~ */
1066 OPT_BATCH_FLAG
= 1u<<15, /* -# */
1069 OPT_MEMDEBUG
= 1<<16, /* *memdebug* */
1072 OPT_SENDMODE
= 1u<<17, /* Usage case forces send mode */
1073 OPT_INTERACTIVE
= 1u<<18, /* isatty(0) */
1074 OPT_TTYIN
= OPT_INTERACTIVE
,
1075 OPT_TTYOUT
= 1u<<19,
1076 OPT_UNICODE
= 1u<<20, /* We're in an UTF-8 environment */
1077 OPT_ENC_MBSTATE
= 1u<<21, /* Multibyte environment with shift states */
1079 /* Some easy-access shortcuts */
1080 OPT_D_V
= OPT_DEBUG
| OPT_VERB
,
1081 OPT_D_VV
= OPT_DEBUG
| OPT_VERBVERB
,
1082 OPT_D_V_VV
= OPT_DEBUG
| OPT_VERB
| OPT_VERBVERB
1085 #define IS_TTY_SESSION() \
1086 ((options & (OPT_TTYIN | OPT_TTYOUT)) == (OPT_TTYIN | OPT_TTYOUT))
1088 #define OBSOLETE(X) \
1090 if (options & OPT_D_V_VV)\
1091 n_err("%s: %s\n", _("Obsoletion warning"), X);\
1093 #define OBSOLETE2(X,Y) \
1095 if (options & OPT_D_V_VV)\
1096 n_err("%s: %s: %s\n", _("Obsoletion warning"), X, Y);\
1099 enum program_state
{
1100 PS_STARTED
= 1<< 0, /* main.c startup code passed, functional */
1102 PS_LOADING
= 1<< 1, /* Loading user resource files, startup */
1103 PS_SOURCING
= 1<< 2, /* Sourcing a resource file */
1104 PS_IN_LOAD
= PS_LOADING
| PS_SOURCING
,
1106 PS_EVAL_ERROR
= 1<< 4, /* Last evaluate() command failed */
1108 PS_HOOK_NEWMAIL
= 1<< 6,
1110 PS_HOOK_MASK
= PS_HOOK_NEWMAIL
| PS_HOOK
,
1112 PS_EDIT
= 1<< 8, /* Current mailbox not a "system mailbox" */
1113 PS_SAW_COMMAND
= 1<< 9, /* ..after mailbox switch */
1115 PS_DID_PRINT_DOT
= 1<<16, /* Current message has been printed */
1117 PS_MSGLIST_SAW_NO
= 1<<17, /* Last *LIST saw numerics */
1118 PS_MSGLIST_DIRECT
= 1<<18, /* One msg was directly chosen by number */
1119 PS_MSGLIST_MASK
= PS_MSGLIST_SAW_NO
| PS_MSGLIST_DIRECT
,
1121 PS_HEADER_NEEDED_MIME
= 1<<20, /* mime_write_tohdr() needed x TODO HACK! */
1123 /* Various first-time-init switches */
1124 PS_ERRORS_NOTED
= 1<<24, /* Ring of `errors' content, print msg */
1125 PS_ATTACHMENTS_NOTED
= 1<<25, /* Attachment filename quoting noted */
1126 PS_t_FLAG
= 1<<26 /* OPT_t_FLAG made persistant */
1129 /* A large enum with all the boolean and value options a.k.a their keys.
1130 * Only the constant keys are in here, to be looked up via ok_[bv]look(),
1131 * ok_[bv]set() and ok_[bv]clear().
1132 * Note: see the comments in accmacvar.c before changing *anything* in here! */
1134 ok_b_add_file_recipients
,
1135 ok_v_agent_shell_lookup
,
1145 ok_b_attachment_ask_content_description
,
1146 ok_b_attachment_ask_content_disposition
,
1147 ok_b_attachment_ask_content_id
,
1148 ok_b_attachment_ask_content_type
,
1158 ok_b_batch_exit_on_error
,
1169 ok_v_charset_unknown_8bit
,
1171 ok_b_colour_disable
,
1172 ok_v_colour_from_
, /* {name=colour-from_} */
1174 ok_v_colour_msginfo
,
1176 ok_v_colour_partinfo
,
1178 ok_v_colour_uheader
,
1179 ok_v_colour_user_headers
,
1184 ok_v_datefield_markout_older
,
1185 ok_b_debug
, /* {special=1} */
1187 ok_b_disposition_notification_send
,
1189 ok_b_dotlock_ignore_error
,
1201 ok_v_features
, /* {rdonly=1,virtual=_features} */
1203 ok_v_folder
, /* {special=1} */
1206 ok_v_followup_to_honour
,
1207 ok_b_forward_as_attachment
,
1212 ok_b_header
, /* {special=1} */
1217 ok_b_history_gabby_persist
,
1228 ok_v_imap_keepalive
,
1229 ok_v_imap_list_depth
,
1230 ok_b_imap_use_starttls
,
1233 ok_b_keep_content_length
,
1237 ok_v_line_editor_cursor_right
, /* {special=1} */
1238 ok_b_line_editor_disable
,
1244 ok_b_memdebug
, /* {special=1} */
1245 ok_b_message_id_disable
,
1246 ok_v_message_inject_head
,
1247 ok_v_message_inject_tail
,
1249 ok_b_mime_allow_text_controls
,
1250 ok_b_mime_alternative_favour_rich
,
1251 ok_v_mime_counter_evidence
,
1252 ok_v_mimetypes_load_control
,
1254 ok_v_NAIL_EXTRA_RC
, /* {name=NAIL_EXTRA_RC} */
1255 ok_v_NAIL_HEAD
, /* {name=NAIL_HEAD} */
1256 ok_v_NAIL_HISTFILE
, /* {name=NAIL_HISTFILE} */
1257 ok_v_NAIL_HISTSIZE
, /* {name=NAIL_HISTSIZE} */
1258 ok_v_NAIL_TAIL
, /* {name=NAIL_TAIL} */
1271 ok_b_pop3_bulk_load
,
1272 ok_v_pop3_keepalive
,
1274 ok_b_pop3_use_starttls
,
1275 ok_b_print_all_chars
,
1276 ok_b_print_alternatives
,
1281 ok_b_quote_as_attachment
,
1284 ok_b_recipients_in_cc
,
1287 ok_b_reply_in_same_charset
,
1290 ok_v_reply_to_honour
,
1291 ok_b_rfc822_body_from_
, /* {name=rfc822-body-from_} */
1298 ok_b_sendcharsets_else_ttycharset
,
1301 ok_v_sendmail_arguments
,
1302 ok_b_sendmail_no_default_arguments
,
1303 ok_v_sendmail_progname
,
1311 ok_b_skipemptybody
, /* {special=1} */
1316 ok_v_smime_crl_file
,
1317 /* smime-encrypt-USER@HOST */
1318 ok_b_smime_force_encryption
,
1319 ok_b_smime_no_default_ca
,
1321 ok_v_smime_sign_cert
,
1322 ok_v_smime_sign_include_certs
,
1323 ok_v_smime_sign_message_digest
,
1326 ok_v_smtp_auth_password
,
1327 ok_v_smtp_auth_user
,
1329 ok_b_smtp_use_starttls
,
1330 ok_v_spam_interface
,
1333 ok_v_spamc_arguments
,
1337 ok_v_spamfilter_ham
,
1338 ok_v_spamfilter_noham
,
1339 ok_v_spamfilter_nospam
,
1340 ok_v_spamfilter_rate
,
1341 ok_v_spamfilter_rate_scanscore
,
1342 ok_v_spamfilter_spam
,
1346 ok_v_ssl_cipher_list
,
1347 ok_v_ssl_config_file
,
1352 ok_b_ssl_no_default_ca
,
1367 ok_b_verbose
, /* {special=1} */
1368 ok_v_version
, /* {rdonly=1,virtual=VERSION} */
1369 ok_v_version_major
, /* {rdonly=1,virtual=VERSION_MAJOR} */
1370 ok_v_version_minor
, /* {rdonly=1,virtual=VERSION_MINOR} */
1371 ok_v_version_update
, /* {rdonly=1,virtual=VERSION_UPDATE} */
1373 ok_b_writebackedited
1376 /* Locale-independent character classes */
1390 char *s
; /* the string's content */
1391 size_t l
; /* the stings's length */
1394 struct colour_table
{
1395 /* Plus a copy of *colour-user-headers* */
1396 struct str ct_csinfo
[COLOURSPEC_RESET
+1 + 1];
1400 struct str bi_start
; /* Start of (possibly) bidirectional text */
1401 struct str bi_end
; /* End of ... */
1402 size_t bi_pad
; /* No of visual columns to reserve for BIDI pad */
1406 char const *url_input
; /* Input as given (really) */
1407 enum cproto url_cproto
; /* Communication protocol as given */
1408 bool_t url_needs_tls
; /* Wether the protocol uses SSL/TLS */
1409 bool_t url_had_user
; /* Wether .url_user was part of the URL */
1410 ui16_t url_portno
; /* atoi .url_port or default, host endian */
1411 char const *url_port
; /* Port (if given) or NULL */
1412 char url_proto
[14]; /* Communication protocol as 'xy\0//' */
1413 ui8_t url_proto_len
; /* Length of .url_proto ('\0' index) */
1414 ui8_t url_proto_xlen
; /* .. if '\0' is replaced with ':' */
1415 struct str url_user
; /* User, exactly as given / looked up */
1416 struct str url_user_enc
; /* User, urlxenc()oded */
1417 struct str url_pass
; /* Pass (urlxdec()oded) or NULL */
1418 struct str url_host
; /* Service hostname */
1419 struct str url_path
; /* CPROTO_IMAP: path suffix or NULL */
1420 /* TODO: url_get_component(url *, enum COMPONENT, str *store) */
1421 struct str url_h_p
; /* .url_host[:.url_port] */
1422 /* .url_user@.url_host
1423 * Note: for CPROTO_SMTP this may resolve HOST via *smtp-hostname* (->
1424 * *hostname*)! (And may later be overwritten according to *from*!) */
1426 struct str url_u_h_p
; /* .url_user@.url_host[:.url_port] */
1427 struct str url_eu_h_p
; /* .url_user_enc@.url_host[:.url_port] */
1428 char const *url_p_u_h_p
; /* .url_proto://.url_u_h_p */
1429 char const *url_p_eu_h_p
; /* .url_proto://.url_eu_h_p */
1430 char const *url_p_eu_h_p_p
; /* .url_proto://.url_eu_h_p[/.url_path] */
1434 enum cproto cc_cproto
; /* Communication protocol */
1435 enum authtype cc_authtype
; /* Desired authentication */
1436 char const *cc_auth
; /* Authentication type as string */
1437 struct str cc_user
; /* User (urlxdec()oded) or NULL */
1438 struct str cc_pass
; /* Password (urlxdec()oded) or NULL */
1442 struct dotlock_info
{
1443 char const *di_file_name
; /* Mailbox to lock */
1444 char const *di_lock_name
; /* .di_file_name + .lock */
1445 char const *di_hostname
; /* ..filled in parent (due resolver delays) */
1446 char const *di_randstr
; /* ..ditto, random string */
1447 size_t di_pollmsecs
; /* Delay in between locking attempts */
1448 struct stat
*di_stb
;
1452 struct mime_handler
{
1453 enum mime_handler_flags mh_flags
;
1454 struct str mh_msg
; /* Message describing this command */
1455 /* XXX union{} the following? */
1456 char const *mh_shell_cmd
; /* For MIME_HDL_CMD */
1457 int (*mh_ptf
)(void); /* PTF main() for MIME_HDL_PTF */
1460 struct time_current
{
1468 FILE *qf_os
; /* Output stream */
1469 char const *qf_pfix
;
1470 ui32_t qf_pfix_len
; /* Length of prefix: 0: bypass */
1471 ui32_t qf_qfold_min
; /* Simple way: wrote prefix? */
1472 #ifdef HAVE_QUOTE_FOLD
1473 ui32_t qf_qfold_max
; /* Otherwise: line lengths */
1474 ui8_t qf_state
; /* *quote-fold* state machine */
1475 bool_t qf_brk_isws
; /* Breakpoint is at WS */
1477 ui32_t qf_wscnt
; /* Whitespace count */
1478 ui32_t qf_brkl
; /* Breakpoint */
1479 ui32_t qf_brkw
; /* Visual width, breakpoint */
1480 ui32_t qf_datw
; /* Current visual output line width */
1481 struct str qf_dat
; /* Current visual output line */
1482 struct str qf_currq
; /* Current quote, compressed */
1483 mbstate_t qf_mbps
[2];
1487 #ifdef HAVE_FILTER_HTML_TAGSOUP
1489 FILE *hf_os
; /* Output stream */
1491 ui32_t hf_lmax
; /* Maximum byte +1 in .hf_line/4 */
1492 ui32_t hf_len
; /* Current bytes in .hf_line */
1493 ui32_t hf_last_ws
; /* Last whitespace on line (fold purposes) */
1494 ui32_t hf_mboff
; /* Last offset for "mbtowc" */
1495 ui32_t hf_mbwidth
; /* We count characters not bytes if possible */
1496 char *hf_line
; /* Output line buffer - MUST be last field! */
1497 si32_t hf_href_dist
; /* Count of lines since last HREF flush */
1498 ui32_t hf_href_no
; /* HREF sequence number */
1499 struct htmlflt_href
*hf_hrefs
;
1500 struct htmlflt_tag
const *hf_ign_tag
; /* Tag that will end ignore mode */
1501 char *hf_curr
; /* Current cursor into .hf_bdat */
1502 char *hf_bmax
; /* Maximum byte in .hf_bdat +1 */
1503 char *hf_bdat
; /* (Temporary) Tag content data storage */
1507 struct search_expr
{
1508 char const *ss_where
; /* ..to search for the expr. (not always used) */
1509 char const *ss_sexpr
; /* String search expr.; NULL: use .ss_regex */
1516 struct str ev_line
; /* The terminated data to evaluate */
1517 ui32_t ev_line_size
; /* May be used to store line memory size */
1518 bool_t ev_is_recursive
; /* Evaluation in evaluation? (collect ~:) */
1520 bool_t ev_add_history
; /* Enter (final) command in history? */
1521 char const *ev_new_content
; /* History: reenter line, start with this */
1524 struct termios_state
{
1525 struct termios ts_tios
;
1528 bool_t ts_needs_reset
;
1531 #define termios_state_reset() \
1533 if (termios_state.ts_needs_reset) {\
1534 tcsetattr(0, TCSADRAIN, &termios_state.ts_tios);\
1535 termios_state.ts_needs_reset = FAL0;\
1539 struct sock
{ /* data associated with a socket */
1540 int s_fd
; /* file descriptor */
1542 int s_use_ssl
; /* SSL is used */
1543 # ifdef HAVE_OPENSSL
1544 void *s_ssl
; /* SSL object */
1547 char *s_wbuf
; /* for buffered writes */
1548 int s_wbufsize
; /* allocated size of s_buf */
1549 int s_wbufpos
; /* position of first empty data byte */
1550 char *s_rbufptr
; /* read pointer to s_rbuf */
1551 int s_rsz
; /* size of last read in s_rbuf */
1552 char const *s_desc
; /* description of error messages */
1553 void (*s_onclose
)(void); /* execute on close */
1554 char s_rbuf
[LINESIZE
+ 1]; /* for buffered reads */
1559 struct ccred sc_cred
;
1560 struct sock sc_sock
;
1565 MB_NONE
= 000, /* no reply expected */
1566 MB_COMD
= 001, /* command reply expected */
1567 MB_MULT
= 002, /* multiline reply expected */
1568 MB_PREAUTH
= 004, /* not in authenticated state */
1569 MB_BYE
= 010 /* may accept a BYE state */
1571 FILE *mb_itf
; /* temp file with messages, read open */
1572 FILE *mb_otf
; /* same, write open */
1573 char *mb_sorted
; /* sort method */
1575 MB_VOID
, /* no type (e. g. connection failed) */
1576 MB_FILE
, /* local file */
1577 MB_POP3
, /* POP3 mailbox */
1578 MB_IMAP
, /* IMAP mailbox */
1579 MB_MAILDIR
, /* maildir folder */
1580 MB_CACHE
/* cached mailbox */
1581 } mb_type
; /* type of mailbox */
1583 MB_DELE
= 01, /* may delete messages in mailbox */
1584 MB_EDIT
= 02 /* may edit messages in mailbox */
1586 int mb_threaded
; /* mailbox has been threaded */
1590 MB_UIDPLUS
= 001 /* supports IMAP UIDPLUS */
1592 unsigned long mb_uidvalidity
; /* IMAP unique identifier validity */
1593 char *mb_imap_account
; /* name of current IMAP account */
1594 char *mb_imap_pass
; /* xxx v15-compat URL workaround */
1595 char *mb_imap_mailbox
; /* name of current IMAP mailbox */
1596 char *mb_cache_directory
; /* name of cache directory */
1598 struct sock mb_sock
; /* socket structure */
1602 NEED_UNSPEC
, /* unspecified need, don't fetch */
1603 NEED_HEADER
, /* need the header of a message */
1604 NEED_BODY
/* need header and body of a message */
1608 HAVE_NOTHING
, /* nothing downloaded yet */
1609 HAVE_HEADER
= 01, /* header is downloaded */
1610 HAVE_BODY
= 02 /* entire message is downloaded */
1613 /* flag bits. Attention: Flags that are used in cache.c may not change */
1615 MUSED
= (1<< 0), /* entry is used, but this bit isn't */
1616 MDELETED
= (1<< 1), /* entry has been deleted */
1617 MSAVED
= (1<< 2), /* entry has been saved */
1618 MTOUCH
= (1<< 3), /* entry has been noticed */
1619 MPRESERVE
= (1<< 4), /* keep entry in sys mailbox */
1620 MMARK
= (1<< 5), /* message is marked! */
1621 MODIFY
= (1<< 6), /* message has been modified */
1622 MNEW
= (1<< 7), /* message has never been seen */
1623 MREAD
= (1<< 8), /* message has been read sometime. */
1624 MSTATUS
= (1<< 9), /* message status has changed */
1625 MBOX
= (1<<10), /* Send this to mbox, regardless */
1626 MNOFROM
= (1<<11), /* no From line */
1627 MHIDDEN
= (1<<12), /* message is hidden to user */
1628 MFULLYCACHED
= (1<<13), /* message is completely cached */
1629 MBOXED
= (1<<14), /* message has been sent to mbox */
1630 MUNLINKED
= (1<<15), /* message was unlinked from cache */
1631 MNEWEST
= (1<<16), /* message is very new (newmail) */
1632 MFLAG
= (1<<17), /* message has been flagged recently */
1633 MUNFLAG
= (1<<18), /* message has been unflagged */
1634 MFLAGGED
= (1<<19), /* message is `flagged' */
1635 MANSWER
= (1<<20), /* message has been answered recently */
1636 MUNANSWER
= (1<<21), /* message has been unanswered */
1637 MANSWERED
= (1<<22), /* message is `answered' */
1638 MDRAFT
= (1<<23), /* message has been drafted recently */
1639 MUNDRAFT
= (1<<24), /* message has been undrafted */
1640 MDRAFTED
= (1<<25), /* message is marked as `draft' */
1641 MOLDMARK
= (1<<26), /* messages was marked previously */
1642 MSPAM
= (1<<27), /* message is classified as spam */
1643 MSPAMUNSURE
= (1<<28) /* message may be spam, but it is unsure */
1645 #define MMNORM (MDELETED | MSAVED | MHIDDEN)
1646 #define MMNDEL (MDELETED | MHIDDEN)
1648 #define visible(mp) (((mp)->m_flag & MMNDEL) == 0)
1651 enum mflag m_flag
; /* flags */
1652 enum havespec m_have
; /* downloaded parts of the part */
1654 ui32_t m_spamscore
; /* Spam score as int, 24:8 bits */
1656 int m_block
; /* block number of this part */
1657 size_t m_offset
; /* offset in block of part */
1658 size_t m_size
; /* Bytes in the part */
1659 size_t m_xsize
; /* Bytes in the full part */
1660 long m_lines
; /* Lines in the message */
1661 long m_xlines
; /* Lines in the full message */
1662 time_t m_time
; /* time the message was sent */
1663 char const *m_from
; /* message sender */
1664 struct mimepart
*m_nextpart
; /* next part at same level */
1665 struct mimepart
*m_multipart
; /* parts of multipart */
1666 struct mimepart
*m_parent
; /* enclosing multipart part */
1667 char const *m_ct_type
; /* content-type */
1668 char const *m_ct_type_plain
; /* content-type without specs */
1669 char const *m_ct_type_usr_ovwr
; /* Forcefully overwritten one */
1670 enum mimecontent m_mimecontent
; /* same in enum */
1671 char const *m_charset
; /* charset */
1672 char const *m_ct_enc
; /* content-transfer-encoding */
1673 enum mime_enc m_mime_enc
; /* same in enum */
1674 char *m_partstring
; /* part level string */
1675 char *m_filename
; /* attachment filename */
1679 enum mflag m_flag
; /* flags */
1680 enum havespec m_have
; /* downloaded parts of the message */
1682 ui32_t m_spamscore
; /* Spam score as int, 24:8 bits */
1684 int m_block
; /* block number of this message */
1685 size_t m_offset
; /* offset in block of message */
1686 size_t m_size
; /* Bytes in the message */
1687 size_t m_xsize
; /* Bytes in the full message */
1688 long m_lines
; /* Lines in the message */
1689 long m_xlines
; /* Lines in the full message */
1690 time_t m_time
; /* time the message was sent */
1691 time_t m_date
; /* time in the 'Date' field */
1692 unsigned m_idhash
; /* hash on Message-ID for threads */
1693 struct message
*m_child
; /* first child of this message */
1694 struct message
*m_younger
; /* younger brother of this message */
1695 struct message
*m_elder
; /* elder brother of this message */
1696 struct message
*m_parent
; /* parent of this message */
1697 unsigned m_level
; /* thread level of message */
1698 long m_threadpos
; /* position in threaded display */
1700 unsigned long m_uid
; /* IMAP unique identifier */
1702 char *m_maildir_file
; /* original maildir file of msg */
1703 ui32_t m_maildir_hash
; /* hash of file name in maildir sub */
1704 int m_collapsed
; /* collapsed thread information */
1707 /* Given a file address, determine the block number it represents */
1708 #define mailx_blockof(off) ((int) ((off) / 4096))
1709 #define mailx_offsetof(off) ((int) ((off) % 4096))
1710 #define mailx_positionof(block, offset) ((off_t)(block) * 4096 + (offset))
1712 /* Argument types */
1714 ARG_MSGLIST
= 0, /* Message list type */
1715 ARG_STRLIST
= 1, /* A pure string */
1716 ARG_RAWLIST
= 2, /* Shell string list */
1717 ARG_NOLIST
= 3, /* Just plain 0 */
1718 ARG_NDMLIST
= 4, /* Message list, no defaults */
1719 ARG_ECHOLIST
= 5, /* Like raw list, but keep quote chars */
1720 ARG_ARGMASK
= 7, /* Mask of the above */
1722 ARG_A
= 1u<< 4, /* Needs an active mailbox */
1723 ARG_F
= 1u<< 5, /* Is a conditional command */
1724 ARG_H
= 1u<< 6, /* Never place in history */
1725 ARG_I
= 1u<< 7, /* Interactive command bit */
1726 ARG_M
= 1u<< 8, /* Legal from send mode bit */
1727 ARG_P
= 1u<< 9, /* Autoprint dot after command */
1728 ARG_R
= 1u<<10, /* Cannot be called from collect / recursion */
1729 ARG_T
= 1u<<11, /* Is a transparent command */
1730 ARG_V
= 1u<<12, /* Places data in temporary_arg_v_store */
1731 ARG_W
= 1u<<13, /* Invalid when read only bit */
1732 ARG_O
= 1u<<14 /* OBSOLETE()d command */
1736 GTO
= 1<< 0, /* Grab To: line */
1737 GSUBJECT
= 1<< 1, /* Likewise, Subject: line */
1738 GCC
= 1<< 2, /* And the Cc: line */
1739 GBCC
= 1<< 3, /* And also the Bcc: line */
1741 GNL
= 1<< 4, /* Print blank line after */
1742 GDEL
= 1<< 5, /* Entity removed from list */
1743 GCOMMA
= 1<< 6, /* detract puts in commas */
1744 GUA
= 1<< 7, /* User-Agent field */
1745 GMIME
= 1<< 8, /* MIME 1.0 fields */
1746 GMSGID
= 1<< 9, /* a Message-ID */
1748 GIDENT
= 1<<11, /* From:, Reply-To:, Organization:, MFT: */
1749 GREF
= 1<<12, /* References:, In-Reply-To:, (Message-Id:) */
1750 GDATE
= 1<<13, /* Date: field */
1751 GFULL
= 1<<14, /* Include full names, comments etc. */
1752 GSKIN
= 1<<15, /* Skin names */
1753 GEXTRA
= 1<<16, /* Extra fields (mostly like GIDENT XXX) */
1754 GFILES
= 1<<17, /* Include filename and pipe addresses */
1755 GFULLEXTRA
= 1<<18 /* Only with GFULL: GFULL less address */
1757 #define GMASK (GTO | GSUBJECT | GCC | GBCC)
1761 HF_LIST_REPLY
= 1<< 0,
1762 HF_MFT_SENDER
= 1<< 1, /* Add ourselves to Mail-Followup-To: */
1763 HF_RECIPIENT_RECORD
= 1<<10, /* Save message in file named after rec. */
1767 /* Structure used to pass about the current state of a message (header) */
1769 ui32_t h_flags
; /* enum header_flags bits */
1771 struct name
*h_to
; /* Dynamic "To:" string */
1772 char *h_subject
; /* Subject string */
1773 struct name
*h_cc
; /* Carbon copies string */
1774 struct name
*h_bcc
; /* Blind carbon copies */
1775 struct name
*h_ref
; /* References (possibly overridden) */
1776 struct attachment
*h_attach
; /* MIME attachments */
1777 char *h_charset
; /* preferred charset */
1778 struct name
*h_from
; /* overridden "From:" field */
1779 struct name
*h_sender
; /* overridden "Sender:" field */
1780 struct name
*h_replyto
; /* overridden "Reply-To:" field */
1781 struct name
*h_message_id
; /* overridden "Message-ID:" field */
1782 struct name
*h_in_reply_to
;/* overridden "In-Reply-To:" field */
1783 struct name
*h_mft
; /* Mail-Followup-To */
1784 char const *h_list_post
; /* Address from List-Post:, for `Lreply' */
1785 char *h_organization
; /* overridden "Organization:" field */
1788 /* Handling of namelist nodes used in processing the recipients of mail and
1789 * aliases, inspection of mail-addresses and all that kind of stuff */
1791 NAME_NAME_SALLOC
= 1<< 0, /* .n_name is doped */
1792 NAME_FULLNAME_SALLOC
= 1<< 1, /* .n_fullname is doped */
1793 NAME_SKINNED
= 1<< 2, /* Is actually skin()ned */
1794 NAME_IDNA
= 1<< 3, /* IDNA was applied */
1796 NAME_ADDRSPEC_CHECKED
= 1<< 4, /* Address has been .. and */
1797 NAME_ADDRSPEC_ISFILE
= 1<< 5, /* ..is a file path */
1798 NAME_ADDRSPEC_ISPIPE
= 1<< 6, /* ..is a command for piping */
1799 NAME_ADDRSPEC_ISFILEORPIPE
= NAME_ADDRSPEC_ISFILE
| NAME_ADDRSPEC_ISPIPE
,
1800 NAME_ADDRSPEC_ISNAME
= 1<< 7, /* ..is a valid mail network address */
1801 NAME_ADDRSPEC_ISADDR
= 1<< 8, /* ..is a valid mail network address */
1803 NAME_ADDRSPEC_ERR_EMPTY
= 1<< 9, /* An empty string (or NULL) */
1804 NAME_ADDRSPEC_ERR_ATSEQ
= 1<<10, /* Weird @ sequence */
1805 NAME_ADDRSPEC_ERR_CHAR
= 1<<11, /* Invalid character */
1806 NAME_ADDRSPEC_ERR_IDNA
= 1<<12, /* IDNA convertion failed */
1807 NAME_ADDRSPEC_INVALID
= NAME_ADDRSPEC_ERR_EMPTY
|
1808 NAME_ADDRSPEC_ERR_ATSEQ
| NAME_ADDRSPEC_ERR_CHAR
|
1809 NAME_ADDRSPEC_ERR_IDNA
,
1811 /* Error storage (we must fit in 31-bit) */
1813 _NAME_MAXWC
= 0x3FFFF,
1814 _NAME_MASKWC
= _NAME_MAXWC
<< _NAME_SHIFTWC
1817 /* In the !_ERR_EMPTY case, the failing character can be queried */
1818 #define NAME_ADDRSPEC_ERR_GETWC(F) \
1819 ((((unsigned int)(F) & _NAME_MASKWC) >> _NAME_SHIFTWC) & _NAME_MAXWC)
1820 #define NAME_ADDRSPEC_ERR_SET(F, E, WC) \
1822 (F) = ((F) & ~(NAME_ADDRSPEC_INVALID | _NAME_MASKWC)) |\
1823 (E) | (((unsigned int)(WC) & _NAME_MAXWC) << _NAME_SHIFTWC);\
1827 struct name
*n_flink
; /* Forward link in list. */
1828 struct name
*n_blink
; /* Backward list link */
1829 enum gfield n_type
; /* From which list it came */
1830 enum nameflags n_flags
; /* enum nameflags */
1831 char *n_name
; /* This fella's address */
1832 char *n_fullname
; /* Ditto, unless GFULL including comment */
1833 char *n_fullextra
; /* GFULL, without address */
1837 char const *ag_input
; /* Input string as given */
1838 size_t ag_ilen
; /* strlen() of input */
1839 size_t ag_iaddr_start
; /* Start of *addr-spec* in .ag_input */
1840 size_t ag_iaddr_aend
; /* ..and one past its end */
1841 char *ag_skinned
; /* Output (alloced if !=.ag_input) */
1842 size_t ag_slen
; /* strlen() of .ag_skinned */
1843 size_t ag_sdom_start
; /* Start of domain in .ag_skinned, */
1844 enum nameflags ag_n_flags
; /* enum nameflags of .ag_skinned */
1847 /* MIME attachments */
1849 AC_DEFAULT
, /* _get_lc() -> _iter_*() */
1850 AC_FIX_OUTCS
, /* _get_lc() -> "charset=" .a_charset */
1851 AC_FIX_INCS
, /* "charset=".a_input_charset (nocnv) */
1852 AC_TMPFILE
/* attachment.a_tmpf is converted */
1856 struct attachment
*a_flink
; /* Forward link in list. */
1857 struct attachment
*a_blink
; /* Backward list link */
1858 char const *a_name
; /* file name */
1859 char const *a_content_type
; /* content type */
1860 char const *a_content_disposition
; /* content disposition */
1861 char const *a_content_id
; /* content id */
1862 char const *a_content_description
; /* content description */
1863 char const *a_input_charset
; /* Interpretation depends on .a_conv */
1864 char const *a_charset
; /* ... */
1865 FILE *a_tmpf
; /* If AC_TMPFILE */
1866 enum attach_conv a_conv
; /* User chosen conversion */
1867 int a_msgno
; /* message number */
1871 struct header
*sb_hp
;
1874 struct str sb_signer
; /* USER@HOST for signing+ */
1876 struct ccred sb_ccred
;
1879 /* Structure of the hash table of ignored header fields */
1881 int i_count
; /* Number of entries */
1883 struct ignored
*i_link
; /* Next ignored field in bucket */
1884 char *i_field
; /* This ignored field */
1888 /* For saving the current directory and later returning */
1893 char cw_wd
[PATH_MAX
];
1898 * Global variable declarations
1900 * These become instantiated in main.c.
1904 #ifdef n_MAIN_SOURCE
1905 # ifndef HAVE_AMALGAMATION
1914 VL
int mb_cur_max
; /* Value of MB_CUR_MAX */
1915 VL
int realscreenheight
; /* The real screen height */
1916 VL
int scrnwidth
; /* Screen width, or best guess */
1917 VL
int scrnheight
; /* Screen height/guess (4 header) */
1919 VL
char const *homedir
; /* Path name of home directory */
1920 VL
char const *myname
; /* My login name */
1921 VL
char const *progname
; /* Our name */
1922 VL
char const *tempdir
; /* The temporary directory */
1924 VL gid_t group_id
; /* getgid() and getuid() */
1927 VL
int exit_status
; /* Exit status */
1928 VL ui32_t options
; /* Bits of enum user_options */
1929 VL
struct name
*option_r_arg
; /* Argument to -r option */
1930 VL
char const **smopts
; /* sendmail(1) opts from commline */
1931 VL
size_t smopts_count
; /* Entries in smopts */
1933 VL ui32_t pstate
; /* Bits of enum program_state */
1934 VL
size_t noreset
; /* String resets suspended (recursive) */
1936 /* XXX stylish sorting */
1937 VL
int msgCount
; /* Count of messages read in */
1938 VL
struct mailbox mb
; /* Current mailbox */
1939 VL
int image
; /* File descriptor for msg image */
1940 VL
char mailname
[PATH_MAX
]; /* Name of current file TODO URL/object*/
1941 VL
char displayname
[80 - 40]; /* Prettyfied for display TODO URL/obj*/
1942 VL
char prevfile
[PATH_MAX
]; /* Name of previous file TODO URL/obj */
1943 VL
char const *account_name
; /* Current account name or NULL */
1944 VL off_t mailsize
; /* Size of system mailbox */
1945 VL
struct message
*dot
; /* Pointer to current message */
1946 VL
struct message
*prevdot
; /* Previous current message */
1947 VL
struct message
*message
; /* The actual message structure */
1948 VL
struct message
*threadroot
; /* first threaded message */
1949 VL
int imap_created_mailbox
; /* hack to get feedback from imap */
1951 VL
struct ignoretab ignore
[2]; /* ignored and retained fields
1952 * 0 is ignore, 1 is retain */
1953 VL
struct ignoretab saveignore
[2]; /* ignored and retained fields
1954 * on save to folder */
1955 VL
struct ignoretab allignore
[2]; /* special, ignore all headers */
1956 VL
struct ignoretab fwdignore
[2]; /* fields to ignore for forwarding */
1958 VL
struct time_current time_current
; /* time(3); send: mail1() XXXcarrier */
1959 VL
struct termios_state termios_state
; /* getpassword(); see commands().. */
1962 VL
struct colour_table
*colour_table
;
1966 VL
enum ssl_verify_level ssl_verify_level
; /* SSL verification level */
1973 VL sigjmp_buf srbuf
;
1975 VL sighandler_type dflpipe
;
1976 VL sighandler_type handlerstacktop
;
1977 #define handlerpush(f) (savedtop = handlerstacktop, handlerstacktop = (f))
1978 #define handlerpop() (handlerstacktop = savedtop)
1980 /* TODO Temporary hacks unless the codebase doesn't jump and uses pass-by-value
1981 * TODO carrier structs instead of locals */
1982 VL
char *temporary_arg_v_store
;
1983 VL
void *temporary_localopts_store
;
1984 /* TODO temporary storage to overcome which_protocol() mess (for PROTO_FILE) */
1985 VL
char const *temporary_protocol_ext
;
1987 /* The remaining variables need initialization */
1989 #ifndef HAVE_AMALGAMATION
1990 VL
char const month_names
[12 + 1][4];
1991 VL
char const weekday_names
[7 + 1][4];
1993 VL
char const uagent
[sizeof UAGENT
];
1995 VL uc_i
const class_char
[1 + 0x7F];
1999 * Finally, let's include the function prototypes XXX embed
2002 #ifndef n_PRIVSEP_SOURCE
2003 # include "nailfuns.h"