This file is indexed.

/usr/include/raul/Thread.hpp is in libraul-dev 0.8.0+dfsg0-0.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
/* This file is part of Raul.
 * Copyright (C) 2007-2009 David Robillard <http://drobilla.net>
 *
 * Raul 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.
 *
 * Raul 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 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.,
 * 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
 */

#ifndef RAUL_THREAD_HPP
#define RAUL_THREAD_HPP

#include <iostream>
#include <set>
#include <string>

#include <pthread.h>

#include <boost/utility.hpp>

namespace Raul {


/** Abstract base class for a thread.
 *
 * Extend this and override the _run method to easily create a thread
 * to perform some task.
 *
 * The current Thread can be accessed using the get() method.
 *
 * \ingroup raul
 */
class Thread : boost::noncopyable
{
public:
	virtual ~Thread() {
		stop();
	}

	static Thread* create(const std::string& name="")
		{ return new Thread(name); }

	/** Must be called from thread */
	static Thread* create_for_this_thread(const std::string& name="")
		{ return new Thread(pthread_self(), name); }

	static Thread& get();

	virtual void start();
	virtual void stop();

	virtual void join();

	void set_scheduling(int policy, unsigned int priority);

	const std::string& name() const { return _name; }
	void set_name(const std::string& name) { _name = name; }

	bool is_context(unsigned context) const { return _contexts.find(context) != _contexts.end(); }
	void set_context(unsigned context) { _contexts.insert(context); }

protected:
	explicit Thread(const std::string& name="");
	Thread(pthread_t thread, const std::string& name="");

	/** Thread function to execute.
	 *
	 * This is called once on start, and terminated on stop.
	 * Implementations likely want to put some infinite loop here.
	 *
	 * When _exit_flag becomes true (via a call to stop()) the loop
	 * should exit.
	 */
	virtual void _run() {}

	bool _exit_flag;

private:
	static void* _static_run(void* me);

	/** Allocate thread-specific data key */
	static void thread_key_alloc() {
		pthread_key_create(&_thread_key, NULL);
	}

	/* Key for the thread-specific buffer */
	static pthread_key_t _thread_key;

	/* Once-only initialisation of the key */
	static pthread_once_t _thread_key_once;

	std::set<unsigned> _contexts;
	std::string        _name;
	bool               _pthread_exists;
	bool               _own_thread;
	pthread_t          _pthread;
};


} // namespace Raul

#endif // RAUL_THREAD_HPP