/usr/include/vmime/net/transport.hpp is in libvmime-dev 0.9.2-5build2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 | //
// VMime library (http://www.vmime.org)
// Copyright (C) 2002-2013 Vincent Richard <vincent@vmime.org>
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License as
// published by the Free Software Foundation; either version 3 of
// the License, or (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// General Public License for more details.
//
// You should have received a copy of the GNU General Public License along
// with this program; if not, write to the Free Software Foundation, Inc.,
// 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
//
// Linking this library statically or dynamically with other modules is making
// a combined work based on this library. Thus, the terms and conditions of
// the GNU General Public License cover the whole combination.
//
#ifndef VMIME_NET_TRANSPORT_HPP_INCLUDED
#define VMIME_NET_TRANSPORT_HPP_INCLUDED
#include "vmime/config.hpp"
#if VMIME_HAVE_MESSAGING_FEATURES
#include "vmime/net/service.hpp"
#include "vmime/utility/stream.hpp"
#include "vmime/mailboxList.hpp"
namespace vmime {
class header;
class headerField;
class message;
class mailbox;
class mailboxList;
namespace net {
/** A transport service.
* Encapsulate protocols that can send messages.
*/
class VMIME_EXPORT transport : public service
{
protected:
transport(shared_ptr <session> sess, const serviceInfos& infos, shared_ptr <security::authenticator> auth);
public:
/** Send a message over this transport service.
* The default implementation simply generates the whole message into
* a string buffer and "streams" it via a inputStreamStringAdapter.
*
* @param msg message to send
* @param progress progress listener, or NULL if not used
*/
virtual void send(shared_ptr <vmime::message> msg, utility::progressListener* progress = NULL);
/** Send a message over this transport service.
*
* @param expeditor expeditor mailbox
* @param recipients list of recipient mailboxes
* @param is input stream providing message data (header + body)
* @param size size of the message data
* @param progress progress listener, or NULL if not used
* @param sender envelope sender (if empty, expeditor will be used)
*/
virtual void send
(const mailbox& expeditor,
const mailboxList& recipients,
utility::inputStream& is,
const size_t size,
utility::progressListener* progress = NULL,
const mailbox& sender = mailbox()) = 0;
/** Send a message over this transport service.
* The default implementation simply generates the whole message into
* a string buffer and "streams" it via a inputStreamStringAdapter.
*
* @param msg message to send
* @param expeditor expeditor mailbox
* @param recipients list of recipient mailboxes
* @param progress progress listener, or NULL if not used
* @param sender envelope sender (if empty, expeditor will be used)
*/
virtual void send
(shared_ptr <vmime::message> msg,
const mailbox& expeditor,
const mailboxList& recipients,
utility::progressListener* progress = NULL,
const mailbox& sender = mailbox());
Type getType() const;
protected:
/** Called by processHeader().
* Decides what to do with the specified header field.
*
* @return NULL if the header should be removed, a reference to a new headerField
* if the field is to be replaced, or a reference to the same headerField
* that was passed if the field should be left as is
*/
shared_ptr <headerField> processHeaderField(shared_ptr <headerField> field);
/** Prepares the header before transmitting the message.
* Removes headers that should not be present (eg. "Bcc", "Return-Path"),
* or adds missing headers that are required/recommended by the RFCs.
* The header is modified inline.
*
* @param header headers to process
*/
void processHeader(shared_ptr <header> header);
};
} // net
} // vmime
#endif // VMIME_HAVE_MESSAGING_FEATURES
#endif // VMIME_NET_TRANSPORT_HPP_INCLUDED
|