This file is indexed.

/usr/include/pion/http/response_writer.hpp is in libpion-dev 5.0.4+dfsg-2.

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
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
// ---------------------------------------------------------------------
// pion:  a Boost C++ framework for building lightweight HTTP interfaces
// ---------------------------------------------------------------------
// Copyright (C) 2007-2012 Cloudmeter, Inc.  (http://www.cloudmeter.com)
//
// Distributed under the Boost Software License, Version 1.0.
// See http://www.boost.org/LICENSE_1_0.txt
//

#ifndef __PION_HTTP_RESPONSE_WRITER_HEADER__
#define __PION_HTTP_RESPONSE_WRITER_HEADER__

#include <boost/asio.hpp>
#include <boost/bind.hpp>
#include <boost/noncopyable.hpp>
#include <boost/shared_ptr.hpp>
#include <boost/enable_shared_from_this.hpp>
#include <pion/config.hpp>
#include <pion/http/writer.hpp>
#include <pion/http/request.hpp>
#include <pion/http/response.hpp>


namespace pion {    // begin namespace pion
namespace http {    // begin namespace http


///
/// response_writer: used to asynchronously send HTTP responses
/// 
class PION_API response_writer :
    public http::writer,
    public boost::enable_shared_from_this<response_writer>
{
public:
    
    /// default destructor
    virtual ~response_writer() {}

    /**
     * creates new response_writer objects
     * 
     * @param tcp_conn TCP connection used to send the response
     * @param http_response pointer to the response that will be sent
     * @param handler function called after the response has been sent
     * 
     * @return boost::shared_ptr<response_writer> shared pointer to
     *         the new writer object that was created
     */
    static inline boost::shared_ptr<response_writer> create(tcp::connection_ptr& tcp_conn,
                                                               http::response_ptr& http_response_ptr,
                                                               finished_handler_t handler = finished_handler_t())
    {
        return boost::shared_ptr<response_writer>(new response_writer(tcp_conn, http_response_ptr, handler));
    }

    /**
     * creates new response_writer objects
     * 
     * @param tcp_conn TCP connection used to send the response
     * @param http_request the request we are responding to
     * @param handler function called after the request has been sent
     * 
     * @return boost::shared_ptr<response_writer> shared pointer to
     *         the new writer object that was created
     */
    static inline boost::shared_ptr<response_writer> create(tcp::connection_ptr& tcp_conn,
                                                               const http::request& http_request,
                                                               finished_handler_t handler = finished_handler_t())
    {
        return boost::shared_ptr<response_writer>(new response_writer(tcp_conn, http_request, handler));
    }
    
    /// returns a non-const reference to the response that will be sent
    inline http::response& get_response(void) { return *m_http_response; }
    
    
protected:
    
    /**
     * protected constructor restricts creation of objects (use create())
     * 
     * @param tcp_conn TCP connection used to send the response
     * @param http_response pointer to the response that will be sent
     * @param handler function called after the request has been sent
     */
    response_writer(tcp::connection_ptr& tcp_conn, http::response_ptr& http_response_ptr,
                       finished_handler_t handler)
        : http::writer(tcp_conn, handler), m_http_response(http_response_ptr)
    {
        set_logger(PION_GET_LOGGER("pion.http.response_writer"));
        // tell the http::writer base class whether or not the client supports chunks
        supports_chunked_messages(m_http_response->get_chunks_supported());
        // check if we should initialize the payload content using
        // the response's content buffer
        if (m_http_response->get_content_length() > 0
            && m_http_response->get_content() != NULL
            && m_http_response->get_content()[0] != '\0')
        {
            write_no_copy(m_http_response->get_content(), m_http_response->get_content_length());
        }
    }
    
    /**
     * protected constructor restricts creation of objects (use create())
     * 
     * @param tcp_conn TCP connection used to send the response
     * @param http_request the request we are responding to
     * @param handler function called after the request has been sent
     */
    response_writer(tcp::connection_ptr& tcp_conn, const http::request& http_request,
                       finished_handler_t handler)
        : http::writer(tcp_conn, handler), m_http_response(new http::response(http_request))
    {
        set_logger(PION_GET_LOGGER("pion.http.response_writer"));
        // tell the http::writer base class whether or not the client supports chunks
        supports_chunked_messages(m_http_response->get_chunks_supported());
    }
    
    
    /**
     * initializes a vector of write buffers with the HTTP message information
     *
     * @param write_buffers vector of write buffers to initialize
     */
    virtual void prepare_buffers_for_send(http::message::write_buffers_t& write_buffers) {
        if (get_content_length() > 0)
            m_http_response->set_content_length(get_content_length());
        m_http_response->prepare_buffers_for_send(write_buffers,
                                               get_connection()->get_keep_alive(),
                                               sending_chunked_message());
    }   

    /// returns a function bound to http::writer::handle_write()
    virtual write_handler_t bind_to_write_handler(void) {
        return boost::bind(&response_writer::handle_write, shared_from_this(),
                           boost::asio::placeholders::error,
                           boost::asio::placeholders::bytes_transferred);
    }

    /**
     * called after the response is sent
     * 
     * @param write_error error status from the last write operation
     * @param bytes_written number of bytes sent by the last write operation
     */
    virtual void handle_write(const boost::system::error_code& write_error,
                             std::size_t bytes_written)
    {
        logger log_ptr(get_logger());
        if (!write_error) {
            // response sent OK
            if (sending_chunked_message()) {
                PION_LOG_DEBUG(log_ptr, "Sent HTTP response chunk of " << bytes_written << " bytes");
            } else {
                PION_LOG_DEBUG(log_ptr, "Sent HTTP response of " << bytes_written << " bytes ("
                               << (get_connection()->get_keep_alive() ? "keeping alive)" : "closing)"));
            }
        }
        finished_writing(write_error);
    }

    
private:
    
    /// the response that will be sent
    http::response_ptr      m_http_response;
    
    /// the initial HTTP response header line
    std::string             m_response_line;
};


/// data type for a response_writer pointer
typedef boost::shared_ptr<response_writer>   response_writer_ptr;


/// override operator<< for convenience
template <typename T>
const response_writer_ptr& operator<<(const response_writer_ptr& writer, const T& data) {
    writer->write(data);
    return writer;
}

inline response_writer_ptr& operator<<(response_writer_ptr& writer, std::ostream& (*iomanip)(std::ostream&)) {
    writer->write(iomanip);
    return writer;
}

}   // end namespace http
}   // end namespace pion

#endif