This file is indexed.

/usr/include/saml/saml2/metadata/EndpointManager.h is in libsaml2-dev 2.5.3-2+deb8u2.

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
/**
 * Licensed to the University Corporation for Advanced Internet
 * Development, Inc. (UCAID) under one or more contributor license
 * agreements. See the NOTICE file distributed with this work for
 * additional information regarding copyright ownership.
 *
 * UCAID licenses this file to you under the Apache License,
 * Version 2.0 (the "License"); you may not use this file except
 * in compliance with the License. You may obtain a copy of the
 * License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
 * either express or implied. See the License for the specific
 * language governing permissions and limitations under the License.
 */

/**
 * @file saml/saml2/metadata/EndpointManager.h
 * 
 * Templates for processing endpoint information.
 */

#ifndef __saml_epmgr_h__
#define __saml_epmgr_h__

#include <saml/base.h>

#include <vector>
#include <xercesc/util/XMLString.hpp>

namespace opensaml {
    namespace saml2md {
        
        /**
         * Template for processing unindexed endpoint information.
         * 
         * @param _Tx   the endpoint type being managed
         */
        template <class _Tx>
        class EndpointManager
        {
        protected:
            /** Reference to endpoint array. */
            const typename std::vector<_Tx*>& m_endpoints;
            
        public:
            /**
             * Constructor.
             *
             * @param endpoints array of endpoints to manage
             */
            EndpointManager(const typename std::vector<_Tx*>& endpoints) : m_endpoints(endpoints) {
            }
            
            /**
             * Returns endpoint that supports a particular binding.
             * 
             * @param binding   binding to locate
             * @return a supporting endpoint, favoring the default, or nullptr
             */
            const _Tx* getByBinding(const XMLCh* binding) const {
                for (typename std::vector<_Tx*>::const_iterator i = m_endpoints.begin(); i!=m_endpoints.end(); ++i) {
                    if (xercesc::XMLString::equals(binding,(*i)->getBinding()))
                        return *i;
                }
                return nullptr;
            }
        };

        /**
         * Template for processing indexed endpoint information.
         * 
         * @param _Tx   the endpoint type being managed
         */
        template <class _Tx>
        class IndexedEndpointManager : public EndpointManager<_Tx>
        {
            const _Tx* m_default;
            
        public:
            /**
             * Constructor.
             *
             * @param endpoints array of endpoints to manage
             */
            IndexedEndpointManager(const typename std::vector<_Tx*>& endpoints) : EndpointManager<_Tx>(endpoints), m_default(nullptr) {
            }
            
            /**
             * Returns the default endpoint in the set.
             * 
             * @return the default endpoint 
             */
            const _Tx* getDefault() const {
                if (m_default)
                    return m_default;
                for (typename std::vector<_Tx*>::const_iterator i = EndpointManager<_Tx>::m_endpoints.begin(); i!=EndpointManager<_Tx>::m_endpoints.end(); ++i) {
                    if ((*i)->isDefault())
                        return m_default=*i;
                }
                return (EndpointManager<_Tx>::m_endpoints.empty()) ? m_default=nullptr : m_default=EndpointManager<_Tx>::m_endpoints.front();
            }
            
            /**
             * Returns indexed endpoint.
             * 
             * @param index index to locate
             * @return matching endpoint, or nullptr
             */
            const _Tx* getByIndex(unsigned short index) const {
                for (typename std::vector<_Tx*>::const_iterator i = EndpointManager<_Tx>::m_endpoints.begin(); i!=EndpointManager<_Tx>::m_endpoints.end(); ++i) {
                    std::pair<bool,int> comp = (*i)->getIndex();
                    if (comp.first && index == comp.second)
                        return *i;
                }
                return nullptr;
            }
            
            /**
             * Returns endpoint that supports a particular binding.
             * 
             * @param binding   binding to locate
             * @return a supporting endpoint, favoring the default, or nullptr
             */
            const _Tx* getByBinding(const XMLCh* binding) const {
                if (getDefault() && xercesc::XMLString::equals(binding,m_default->getBinding()))
                    return m_default;
                return EndpointManager<_Tx>::getByBinding(binding);
            }
        };
    };
};

#endif /* __saml_epmgr_h__ */