NetBSD/usr.bin/mail/mime_detach.h

93 lines
3.3 KiB
C
Raw Normal View History

/* $NetBSD: mime_detach.h,v 1.2 2008/04/28 20:24:14 martin Exp $ */
From Anon Ymous: 1) Statification of modules. 2) Implement the 'detach' and 'Detach' commands for extracting mime parts from messages. 3) Teach mail to output "In-Reply-To" and "References" header fields when replying so others can thread us. 4) Implement threading, sorting, and tagging, supported by the following commands: 'flatten', 'reverse', 'sort', 'thread', 'unthread', 'down', 'tset', 'up', 'expose', 'hide', 'tag', 'untag', 'invtags', 'tagbelow', 'hidetags', 'showtags'. See the manpage for details (when available - soon). 5) Implement a 'deldups' command to delete duplicate messages based on their "Message-Id" field, e.g., in replies to a mailing list that are also CCed to a subscriber. (This can also be accomplished with the threading and tagging commands.) 6) Implement 'ifdef' and 'ifndef' commands, and make the conditionals nestable (i.e., implement a conditional stack). The if/else/endif commands existed before, but they were primitive and undocumented. The 'if' command currently recognizes the "receiving", "sending", and "headersonly" mode keywords. 7) Teach the message selecting routine to understand regular expressions if "regex-search" is defined. Otherwise only case insensitive substring matches are done (as in the past). 8) Teach the message selection routine to understand boolean expressions. Improved "colon-modifier" support. See the manpage for details (when available - soon). 9) Extend paging to all commands (where relevant). 10) Add shell like piping and redirection of (standard) output (if "enable-piping" is defined). Extend completion to these contexts. 11) The manpage should follow soon!!!!
2006-11-28 21:45:32 +03:00
/*-
* Copyright (c) 2006 The NetBSD Foundation, Inc.
* All rights reserved.
*
* This code is derived from software contributed to The NetBSD Foundation
* by Anon Ymous.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
#ifdef MIME_SUPPORT
#ifndef __MIME_DETACH_H__
#define __MIME_DETACH_H__
/*
* The fundametal data structure shared by mime_decode.c and mime_detach.c.
*/
struct mime_info {
struct mime_info *mi_blink;
struct mime_info *mi_flink;
/* sendmessage -> decoder -> filter -> pager */
FILE *mi_fo; /* output file handle pointing to PAGER */
FILE *mi_pipe_end; /* initial end of pipe */
FILE *mi_head_end; /* close to here at start of body */
int mi_ignore_body; /* suppress certain body parts */
/* stuff specific to mime_detach */
int mi_partnum; /* part number displayed (if nonzero) */
const char *mi_partstr; /* string to actually display */
const char *mi_msgstr; /* message number in string form */
/* strings extracted from MIME header fields */
const char *mi_version;
const char *mi_type;
const char *mi_subtype;
const char *mi_boundary; /* type parameter */
const char *mi_charset; /* type parameter */
const char *mi_encoding;
const char *mi_disposition;
const char *mi_filename; /* from type or disposition parameter */
struct message *mp; /* MP for this message regarded as a part. */
struct {
struct mime_info *mip; /* parent of part of multipart message */
struct message *mp; /* the original parent mp before being split! */
} mi_parent;
int mi_detachall; /* detach unnamed parts */
const char *mi_detachdir; /* directory for detaching attachments */
const char *mi_command_hook; /* alternate command used to process this message */
};
/*
* Routines shared by mime_decode.c and mime_detach.c
*/
/* exported from mime_detach.c */
FILE *mime_detach_parts(struct mime_info *);
/* These are exported from mime_decode.c */
FILE *pipe_end(struct mime_info *);
void run_decoder(struct mime_info *mip, void(*fn)(FILE*, FILE*, void *));
#endif /* __MIME_DETACH_H__ */
#endif /* MIME_SUPPORT */