This file is indexed.

/usr/include/svxlink/EchoLinkStationData.h is in libecholib-dev 15.11-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
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
/**
@file	 EchoLinkStationData.h
@brief   Contains a class that represent station data
@author  Tobias Blomberg
@date	 2003-04-13

This file contains a class that is used to represent the data for a station.

\verbatim
EchoLib - A library for EchoLink communication
Copyright (C) 2003  Tobias Blomberg

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 2 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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
\endverbatim
*/


#ifndef ECHOLINK_STATION_DATA_INCLUDED
#define ECHOLINK_STATION_DATA_INCLUDED


/****************************************************************************
 *
 * System Includes
 *
 ****************************************************************************/

#include <netinet/in.h>

#include <string>


/****************************************************************************
 *
 * Project Includes
 *
 ****************************************************************************/

#include <AsyncIpAddress.h>


/****************************************************************************
 *
 * Local Includes
 *
 ****************************************************************************/



/****************************************************************************
 *
 * Forward declarations
 *
 ****************************************************************************/



/****************************************************************************
 *
 * Namespace
 *
 ****************************************************************************/

namespace EchoLink
{

/****************************************************************************
 *
 * Defines & typedefs
 *
 ****************************************************************************/



/****************************************************************************
 *
 * Exported Global Variables
 *
 ****************************************************************************/



/****************************************************************************
 *
 * Class definitions
 *
 ****************************************************************************/

/**
@brief	A class for representing data for a station
@author Tobias Blomberg
@date   2003-04-13

This class is used to represent data about a station.
*/
class StationData
{
  public:
    /**
     * The status of the station in the directory server
     */
    typedef enum
    {
      STAT_UNKNOWN, ///< The state is unknown
      STAT_OFFLINE, ///< The state is offline
      STAT_ONLINE,  ///< The state is online
      STAT_BUSY     ///< The state is busy
    } Status;
    
    static const int MAXCALL  = 15; ///< The maximum length of a callsign
    static const int MAXDATA  = 45; ///< The maximum length of the data field
    static const int MAXDESC  = 27; ///< The maximum length of a description
    static const int MAXID    = 7;  ///< The maximum length of the id field
    static const int MAXIP    = 20; ///< The maximum length of the ip address
    
    /**
     * @brief 	Translate a status code to a string
     * @param 	status The status code to translate
     * @return  Returns the string representation of the given status code
     */
    static std::string statusStr(Status status);
    
    /**
     * @brief Default constructor
     */
    StationData(void);
    
    /**
     * @brief Copy constructor
     */
    StationData(const StationData& rhs) { *this = rhs; }
    
    /**
     * @brief Clear the contents and reset to default values
     */
    void clear(void);

    /**
     * @brief 	Set the callsign
     * @param 	callsign The callsign to set
     */
    void setCallsign(const std::string& callsign);
    
    /**
     * @brief 	Get the callsign
     * @return	Returns the callsign
     */
    const std::string& callsign(void) const { return m_callsign; }
    
    /**
     * @brief Set station data from a string as represented in the directory
     *	      server
     * @param data The data to set
     *
     * This function is used to set status, time and description from a string
     * that have a representation like in the reply from the directory server.
     * The only use for this function is probably when parsing a reply from the
     * directory server. Use setStatus, setTime and setDescription for normal
     * use.
     */
    void setData(const char *data);
    
    /**
     * @brief 	Set the status
     * @param 	status The new status to set
     */
    void setStatus(Status status) { m_status = status; }
    
    /**
     * @brief 	Get the status
     * @return	Returns the status
     */
    Status status(void) const { return m_status; }
    
    /**
     * @brief 	Return the string representation of the status
     * @return	Returns a string representation of the status
     */
    std::string statusStr(void) const { return statusStr(m_status); }
    
    /**
     * @brief 	Set the time
     * @param 	time The time to set
     */
    void setTime(const std::string& time) { m_time = time; }
    
    /**
     * @brief 	Get the time
     * @return	Returns the time
     */
    const std::string& time(void) const { return m_time; }
    
    /**
     * @brief Set the description/location string
     * @param desc  The description string to set
     */
    void setDescription(const std::string& desc) { m_description = desc; }
    
    /**
     * @brief 	Get the description/location string
     * @return	Returns the description/location string
     */
    const std::string& description(void) const { return m_description; }
    
    /**
     * @brief Set the EchoLink ID number
     * @param id The new id
     */
    void setId(int id) { m_id = id; }
    
    /**
     * @brief 	Get the EchoLink ID number
     * @return	Returns the EchoLink ID number
     */
    int id(void) const { return m_id; }
    
    /**
     * @brief 	Set the IP address
     * @param 	ip The IP address to set
     */
    void setIp(const Async::IpAddress& ip) { m_ip = ip; }
    
    /**
     * @brief 	Get the IP address
     * @return	Returns the IP address
     */
    const Async::IpAddress ip(void) const { return m_ip; }
    
    /**
     * @brief 	Get the string representation of the IP address
     * @return	Returns the string representation of the IP address
     */
    std::string ipStr(void) const { return m_ip.toString(); }

    /**
     *
     * @brief	Get the code representation of the callsign
     * @return  Returns the code representation of the callsign
     *
     * The code representation is the callsign mapped to digits only.
     * The mapping is done using the "phone method".
     * ABC=2, DEF=3, GHI=4, JKL=5, MNO=6, PQRS=7, TUV=8, WXYZ=9.
     * Digits are mapped to its corresponding digit.
     * Star is ignored.
     * All other characters are mapped to digit 1.
     */
    std::string code(void) const { return m_code; }
    
    /**
     * @brief 	Assignment operator
     * @param 	rhs Right Hand Side expression
     * @return	Returns a reference to this object
     */
    StationData& operator=(const StationData& rhs);
    
    bool operator<(const StationData &rhs) const
    {
      return m_callsign < rhs.m_callsign;
    }

    /**
     * @brief Output stream operator
     * @param os The stream to output data to
     * @param station The station data to output to the stream
     */
    friend std::ostream& operator<<(std::ostream& os,
	const StationData& station);
    
    
  protected:
    
  private:
    std::string       m_callsign;
    Status    	      m_status;
    std::string       m_time;
    std::string       m_description;
    int       	      m_id;
    Async::IpAddress  m_ip;
    std::string       m_code;
  
    void removeTrailingSpaces(std::string& str);
    std::string callToCode(const std::string& call);

};  /* class StationData */


} /* namespace */

#endif /* ECHOLINK_STATION_DATA_INCLUDED */



/*
 * This file has not been truncated
 */