This file is indexed.

/usr/include/libdap/RCReader.h is in libdap-dev 3.19.1-2build1.

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
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
// -*- mode: c++; c-basic-offset:4 -*-

// This file is part of libdap, A C++ implementation of the OPeNDAP Data
// Access Protocol.

// Copyright (c) 2002,2003 OPeNDAP, Inc.
// Author: Jose Garcia <jgarcia@ucar.edu>
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
//
// This library 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
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
//
// You can contact OPeNDAP, Inc. at PO Box 112, Saunderstown, RI. 02874-0112.

// (c) COPYRIGHT URI/MIT 2001-2002
// Please read the full copyright statement in the file COPYRIGHT_URI.
//
// Authors:
//         jose  Jose Garcia <jgarcia@ucar.edu>

#ifndef _rc_reader_h_
#define _rc_reader_h_

#include <iostream>
#include <string>

#include "Error.h"
#include "util.h"

using namespace std;

namespace libdap
{

/** Read the .dodsrc file. By default the file ~/.dodsrc is read. If the
    environment variable DODS_CONF is set, use that value as the pathname to
    the configuration file. Else, if the environment variable DODS_CACHE_INIT
    is set, use that value.

    NB: DODS_CACHE_INIT is deprecated and may be removed in the future.

    @author Jose Garcia <jgarcia@ucar.edu> */
class RCReader
{
private:
    string d_rc_file_path;
    string d_cache_root;

    bool _dods_use_cache; // 0- Disabled 1- Enabled
    unsigned int _dods_cache_max; // Max cache size in Mbytes
    unsigned int _dods_cached_obj; // Max cache entry size in Mbytes
    int _dods_ign_expires; // 0- Honor expires 1- Ignore them

    // NB: NEVER_DEFLATE: I added this (12/1/99 jhrg) because libwww 5.2.9
    // cannot process compressed (i.e., deflated) documents in the cache.
    // Users must be able to choose whether they want compressed data that
    // will always be refreshed or uncompressed data that will be cached.
    // When set this flag overrides the value passed into the Connect
    // object's constructor. This gives users control over the value.
    // Previously, this could only be set by the program that called
    // Connect(...). Note that I've now (4/6/2000 jhrg) fixed libwww so this
    // parameter is no longer needed.111
    //
    // Added back in, but with a better name (removed double negative).
    // 6/27/2002 jhrg
    bool _dods_deflate;  // 1- request comp responses, 0- don't

    int _dods_default_expires; // 24 hours in seconds
    int _dods_always_validate; // Let libwww decide by default so set to 0

    // flags for PROXY_SERVER=<protocol>,<host url>
    string d_dods_proxy_server_protocol;
    string d_dods_proxy_server_host;
    int d_dods_proxy_server_port;
    string d_dods_proxy_server_userpw;

    // Should libcurl validate SSL hosts/certificates"
    int d_validate_ssl;

    string _dods_proxy_server_host_url; // deprecated

    // The proxy-for stuff is all deprecated. 06/17/04 jhrg
    // flags for PROXY_FOR=<regex>,<proxy host url>,<flags>
    bool _dods_proxy_for; // true if proxy_for is used.
    string _dods_proxy_for_regexp;
    string _dods_proxy_for_proxy_host_url;
    int _dods_proxy_for_regexp_flags; // not used w/libcurl. 6/27/2002 jhrg

    //flags for NO_PROXY_FOR=<protocol>,<host>,<port>
    bool d_dods_no_proxy_for; // true if no_proxy_for is used.
    string d_dods_no_proxy_for_protocol;
    string d_dods_no_proxy_for_host;
    int _dods_no_proxy_for_port; // not used w/libcurl. 6/27/2002 jhrg

    // Make this a vector of strings or support a PATH-style list. 02/26/03
    // jhrg
    string d_ais_database;

    string d_cookie_jar;

    static RCReader* _instance;

    RCReader();
    ~RCReader();

    // File I/O methods
    bool write_rc_file(const string &pathname);
    bool read_rc_file(const string &pathname);

    // Look for the RC file
    string check_env_var(const string &variable_name);
    string check_string(string env_var);

    static void initialize_instance();
    static void delete_instance();

    friend class RCReaderTest;
    friend class HTTPConnectTest;

public:
    static RCReader* instance();
#if 0
    static RCReader* instance(const string &rc_file_path);
#endif
    // GET METHODS
    string get_dods_cache_root() const throw()
    {
        return d_cache_root;
    }
    bool get_use_cache() const throw()
    {
        return _dods_use_cache;
    }
    int get_max_cache_size()  const throw()
    {
        return _dods_cache_max;
    }
    unsigned int get_max_cached_obj() const throw()
    {
        return _dods_cached_obj;
    }
    int get_ignore_expires() const throw()
    {
        return _dods_ign_expires;
    }
    int get_default_expires() const throw()
    {
        return _dods_default_expires;
    }
    int get_always_validate() const throw()
    {
        return _dods_always_validate;
    }
    int get_validate_ssl() const throw()
    {
        return d_validate_ssl;
    }

    bool get_deflate() const throw()
    {
        return _dods_deflate;
    }

    /// Get the proxy server protocol
    string get_proxy_server_protocol() const throw()
    {
        return d_dods_proxy_server_protocol;
    }
    /// Get the proxy host
    string get_proxy_server_host() const throw()
    {
        return d_dods_proxy_server_host;
    }
    /// Get the proxy port
    int get_proxy_server_port() const throw()
    {
        return d_dods_proxy_server_port;
    }
    /// Get the proxy username and password
    string get_proxy_server_userpw() const throw()
    {
        return d_dods_proxy_server_userpw;
    }
    /// @deprecated
    string get_proxy_server_host_url() const throw()
    {
        return (d_dods_proxy_server_userpw.empty() ? "" : d_dods_proxy_server_userpw + "@")
               + d_dods_proxy_server_host
               + ":" + long_to_string(d_dods_proxy_server_port);
    }

    // The whole regex/proxy-for implementation needs reworking. We really
    // need a vector of structs which hold the information on a set of regexes
    // and matching proxies. Then in the code that derefs a URL, we should
    // check to see if the URL matches any of the regexs, et cetera. I'm
    // going to disable the entire feature and see if anyone complains. If
    // they do, we can fix it. If not, one less thing to do... 06/17/04 jhrg
    /// @deprecated
    bool is_proxy_for_used() throw()
    {
        return _dods_proxy_for;
    }
    /// @deprecated
    string get_proxy_for_regexp() const throw()
    {
        return _dods_proxy_for_regexp;
    }
    /// @deprecated
    string get_proxy_for_proxy_host_url() const throw()
    {
        return _dods_proxy_for_proxy_host_url;
    }

    /// @deprecated
    int get_proxy_for_regexp_flags() const throw()
    {
        return _dods_proxy_for_regexp_flags;
    }

    // The whole no_proxy implementation also needs a rewrite. However, it is
    // useful as it is since the user can give a domain and there's often a
    // real need for suppressing proxy access for the local domain. The
    // ..._port() method is bogus, however, so it is deprecated. There's no
    // code that uses it. 06/17/04 jhrg
    bool is_no_proxy_for_used() throw()
    {
        return d_dods_no_proxy_for;
    }
    string get_no_proxy_for_protocol() const throw()
    {
        return d_dods_no_proxy_for_protocol;
    }
    string get_no_proxy_for_host() const throw()
    {
        return d_dods_no_proxy_for_host;
    }

    /// @deprecated
    int    get_no_proxy_for_port() const throw()
    {
        return _dods_no_proxy_for_port;
    }

    string get_ais_database() const throw()
    {
        return d_ais_database;
    }

    string get_cookie_jar() const throw()
    {
	return d_cookie_jar;
    }

    // SET METHODS
    void set_use_cache(bool b) throw()
    {
        _dods_use_cache = b;
    }
    void set_max_cache_size(int i) throw()
    {
        _dods_cache_max = i;
    }
    void set_max_cached_obj(int i) throw()
    {
        _dods_cached_obj = i;
    }
    void set_ignore_expires(int i) throw()
    {
        _dods_ign_expires = i;
    }
    void set_default_expires(int i) throw()
    {
        _dods_default_expires = i;
    }
    void set_always_validate(int i) throw()
    {
        _dods_always_validate = i;
    }
    void set_validate_ssl(int i) throw()
    {
        d_validate_ssl = i;
    }

    void set_deflate(bool b) throw()
    {
        _dods_deflate = b;
    }

    void set_proxy_server_protocol(const string &s) throw()
    {
        d_dods_proxy_server_protocol = s;
    }
    void set_proxy_server_host(const string &s) throw()
    {
        d_dods_proxy_server_host = s;
    }
    void set_proxy_server_port(int l) throw()
    {
        d_dods_proxy_server_port = l;
    }
    void set_proxy_server_userpw(const string &s) throw()
    {
        d_dods_proxy_server_userpw = s;
    }

    /// @deprecated
    void set_proxy_server_host_url(const string &s) throw()
    {
        _dods_proxy_server_host_url = s;
    }

    /// @deprecated
    void set_proxy_for_regexp(const string &s) throw()
    {
        _dods_proxy_for_regexp = s;
    }
    /// @deprecated
    void set_proxy_for_proxy_host_url(const string &s) throw()
    {
        _dods_proxy_for_proxy_host_url = s;
    }
    /// @deprecated
    void set_proxy_for_regexp_flags(int i) throw()
    {
        _dods_proxy_for_regexp_flags = i;
    }

    void set_no_proxy_for_protocol(const string &s) throw()
    {
        d_dods_no_proxy_for_protocol = s;
    }
    void set_no_proxy_for_host(const string &s) throw()
    {
        d_dods_no_proxy_for_host = s;
    }

    /// @deprecated
    void set_no_proxy_for_port(int i) throw()
    {
        _dods_no_proxy_for_port = i;
    }

    void set_ais_database(const string &db) throw()
    {
        d_ais_database = db;
    }
};

} // namespace libdap

#endif // _RCReader_h_