This file is indexed.

/usr/include/simgrid/s4u/Activity.hpp is in libsimgrid-dev 3.14.159-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
/* Copyright (c) 2006-2015. The SimGrid Team.
 * All rights reserved.                                                     */

/* This program is free software; you can redistribute it and/or modify it
 * under the terms of the license (GNU LGPL) which comes with this package. */

#ifndef SIMGRID_S4U_ACTIVITY_HPP
#define SIMGRID_S4U_ACTIVITY_HPP

#include <cstdlib>

#include <xbt/base.h>
#include <xbt/misc.h>

#include <simgrid/s4u/forward.hpp>
#include <simgrid/forward.h>

typedef enum {
  inited, started, finished
} e_s4u_activity_state_t;

namespace simgrid {
namespace s4u {

/** @brief Activities
 *
 * This class is the ancestor of every activities that an actor can undertake, that is, of the actions that do take time in the simulated world.
 */
XBT_PUBLIC_CLASS Activity {
  friend Comm;
protected:
  Activity();
  virtual ~Activity();

public:
  Activity(Activity const&) = delete;
  Activity& operator=(Activity const&) = delete;

  /** Starts a previously created activity.
   *
   * This function is optional: you can call wait() even if you didn't call start()
   */
  virtual void start()=0;
  /** Tests whether the given activity is terminated yet. This is a pure function. */
  //virtual bool test()=0;
  /** Blocks until the activity is terminated */
  virtual void wait()=0;
  /** Blocks until the activity is terminated, or until the timeout is elapsed
   *  Raises: timeout exception.*/
  virtual void wait(double timeout)=0;
  /** Cancel that activity */
  //virtual void cancel();
  /** Retrieve the current state of the activity */
  e_s4u_activity_state_t getState() {return state_;}

  /** Get the remaining amount of work that this Activity entails. When it's 0, it's done. */
  double getRemains();
  /** Set the [remaining] amount of work that this Activity will entail
   *
   * It is forbidden to change the amount of work once the Activity is started */
  void setRemains(double remains);

  /** Put some user data onto the Activity */
  void setUserData(void *data) {userData_=data;}
  /** Retrieve the user data of the Activity */
  void *getUserData() { return userData_; }

private:
  simgrid::kernel::activity::ActivityImpl *pimpl_ = nullptr;
  e_s4u_activity_state_t state_ = inited;
  double remains_ = 0;
  void *userData_ = nullptr;
}; // class

}}; // Namespace simgrid::s4u

#endif /* SIMGRID_S4U_ACTIVITY_HPP */