This file is indexed.

/usr/include/wvstreams/xplc/ptr.h is in libwvstreams-dev 4.6.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
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 *
 * XPLC - Cross-Platform Lightweight Components
 * Copyright (C) 2002-2004, Pierre Phaneuf
 * Copyright (C) 2002-2004, Net Integration Technologies, Inc.
 *
 * 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307
 * USA
 *
 * As a special exception, you may use this file as part of a free
 * software library without restriction.  Specifically, if other files
 * instantiate templates or use macros or inline functions from this
 * file, or you compile this file and link it with other files to
 * produce an executable, this file does not by itself cause the
 * resulting executable to be covered by the GNU Lesser General Public
 * License.  This exception does not however invalidate any other
 * reasons why the executable file might be covered by the GNU Lesser
 * General Public License.
 */

#ifndef __XPLC_PTR_H__
#define __XPLC_PTR_H__

#if defined(__GNUC__) && __GNUC__ > 3
# pragma GCC system_header
#endif

/** \file
 *
 * Smart pointer for XPLC interfaces.
 */

#include <xplc/IObject.h>

#ifndef UNSTABLE
#error "xplc_ptr is experimental!"
#endif


/**
 * Smart pointer class for XPLC interfaces.
 */
template<class T>
class xplc_ptr {
private:
  T* ptr;

  class ProtectedPtr: public T {
  private:
    virtual unsigned int addRef() = 0;
    virtual unsigned int release() = 0;
#ifndef __XPLC_DELETE_H__
    void operator delete(void*);
#endif
  };

  xplc_ptr& operator=(const xplc_ptr&);

public:
  xplc_ptr():
    ptr(0) {
  }
  /**
   * Construct an xplc_ptr from a raw pointer. This is the only way
   * that an xplc_ptr will take ownership of an interface from its
   * previous owner.
   */
  explicit xplc_ptr(T* aObj):
    ptr(aObj) {
  }
  /**
   * Construct an xplc_ptr from another xplc_ptr. This will addRef the
   * interface, if the xplc_ptr is non-NULL.
   */
  template<class P>
  explicit xplc_ptr(const xplc_ptr<P>& aObj):
    ptr(aObj) {
    if(ptr)
      ptr->addRef();
  }
  ~xplc_ptr() {
    if(ptr)
      ptr->release();
  }
  /**
   * Provide an operator->. This allows you to invoke methods on the
   * interface pointed at by the xplc_ptr. As with a raw pointer, if
   * the xplc_ptr is NULL, this will cause a crash. The interface is
   * wrapped in some basic protection, to avoid accidental addRef or
   * release.
   */
  ProtectedPtr* operator->() const {
    return static_cast<ProtectedPtr*>(ptr);
  }
  /**
   * Provide an operator*. This is so you can use "*foo" with an
   * xplc_ptr like you could with the raw pointer. It also applies
   * some basic protection.
   */
  operator ProtectedPtr*() const {
    return static_cast<ProtectedPtr*>(ptr);
  }
  /**
   * Assign a raw pointer to an xplc_ptr. This will addRef the
   * interface, and release the interface previously pointed at by the
   * xplc_ptr, if any.
   */
  xplc_ptr& operator=(T* _ptr) {
    if(_ptr)
      _ptr->addRef();

    if(ptr)
      ptr->release();

    ptr = _ptr;

    return *this;
  }
};


/**
 * Used to addRef an object before passing it to something that would
 * otherwise "steal" the reference.
 */
template<class T>
T* do_addRef(T* obj) {
  if (obj)
    obj->addRef();

  return obj;
}


#endif /* __XPLC_PTR_H__ */