This file is indexed.

/usr/include/sipxtapi/rtcp/IRTCPConnection.h is in libsipxtapi-dev 3.3.0~test17-1.

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
//
// Copyright (C) 2006-2013 SIPez LLC.  All rights reserved.
//
// Copyright (C) 2004-2006 SIPfoundry Inc.
// Licensed by SIPfoundry under the LGPL license.
//
// Copyright (C) 2004-2006 Pingtel Corp.  All rights reserved.
// Licensed to SIPfoundry under a Contributor Agreement.
//
// $$
///////////////////////////////////////////////////////////////////////////////


//  Border Guard
#ifndef _IRTCPConnection_h
#define _IRTCPConnection_h

#include "rtcp/RtcpConfig.h"

//  Includes
#include "IBaseClass.h"
#include "INetworkRender.h"
#include "IRTPDispatch.h"
#include "INetDispatch.h"
#include "ISetSenderStatistics.h"

// Pingtel extension
#ifdef PINGTEL_OSSOCKET
#include <os/OsSocket.h>
#endif

/**
 *
 * Interface Name:  IRTCPConnection
 *
 * Inheritance:     None
 *
 *
 * Description:     The IRTCPConnection interface shall provide services used
 *                  to access and control the generation and content of RTCP
 *                  reports carrying identification and performance information
 *                  regarding an associated RTP connection.
 *
 * Notes:
 *
 */


interface IRTCPConnection : public IBaseClass
 {

//  Public Methods
public:


/**
 *
 * Method Name:  GetDispatchInterfaces()
 *
 *
 * Inputs:   None
 *
 * Outputs:  INetDispatch         **ppiNetDispatch
 *             Interface used to route Network packets to the RTCP Source object
 *           IRTPDispatch         **ppRTPDispatch
 *             Interface used to route RTP Header packets to the RTPRender
 *             object's instance of an RTCP Receiver Report
 *           ISetSenderStatistics **piSenderStats
 *             Statistical Dispatch Interface
 *
 * Returns:  void
 *
 * Description: This method allow a consumer to obtain the dispatch interfaces
 *              that are crucial to routing inbound RTCP and RTP network
 *              packets.
 *
 *
 * Usage Notes:
 *
 */
    virtual void GetDispatchInterfaces(INetDispatch         **ppiNetDispatch,
                                       IRTPDispatch         **ppiRTPDispatch,
                                       ISetSenderStatistics **piSenderStats)=0;


/**
 *
 * Method Name:  GetRemoteSSRC()
 *
 *
 * Inputs:      None
 *
 * Outputs:     None
 *
 * Returns:     unsigned long   - SSRC of remote particant
 *
 * Description: This method returns the  remote SSRC ID associated with an
 *              RTCP Connection.
 *
 *
 * Usage Notes:
 *
 */
    virtual unsigned long GetRemoteSSRC(void)=0;


#ifdef PINGTEL_OSSOCKET
/**
 *
 * Method Name:  StartRenderer()
 *
 *
 * Inputs:      OsSocket& rRtcpSocket   - Reference to an RTCP Socket object
 *
 * Outputs:     None
 *
 * Returns:     bool                    - Result of Starting the Renderer
 *
 * Description: This method starts the RTCP Renderer allowing it to generate
 *              RTCP reports on regular intervals.
 *
 *
 * Usage Notes:
 *
 */
    virtual bool StartRenderer(OsSocket& rRtcpSocket) = 0;
#else
    virtual bool StartRenderer(INetworkRender *piNetworkRender) = 0;
#endif

/**
 *
 * Method Name:  StopRenderer
 *
 *
 * Inputs:       bool   bRelease
 *
 * Outputs:      None
 *
 * Returns:      bool
 *
 * Description:  Performs connection based shutdown related to the orderly
 *               deallocation of connection based filters.
 *
 * Usage Notes:
 *
 */
    virtual bool StopRenderer(void) = 0;

/**
 *
 * Method Name: GenerateRTCPReports
 *
 *
 * Inputs:   unsigned char *puchByeReason  - Reason for terminating Connection
 *           ssrc_t aulCSRC[]       - Array of contributing sources
 *           unsigned long ulCSRCs         - Number of contributing sources
 *
 * Outputs:  None
 *
 * Returns:  None
 *
 * Description: The GenerateRTCPReports() method is called when the RTCP Report
 *              Timer has expired.  This method will obtain the interface of
 *              the CRTCPRender object and instruct it to generate reports.
 *              The reports generate shall be returned and shall result in
 *              event delivery to the RTC Manager onto subscribing clients.
 *
 * Usage Notes:
 *
 *
 */
    virtual void GenerateRTCPReports(unsigned char *puchByeReason = NULL,
                                     ssrc_t aulCSRC[] = NULL,
                                     unsigned long ulCSRCs = 0)=0;

};

#endif