This file is indexed.

/usr/include/octave-4.2.2/octave/oct-env.h is in liboctave-dev 4.2.2-1ubuntu1.

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
/*

Copyright (C) 1996-2017 John W. Eaton

This file is part of Octave.

Octave 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 3 of the License, or (at your
option) any later version.

Octave 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 more details.

You should have received a copy of the GNU General Public License
along with Octave; see the file COPYING.  If not, see
<http://www.gnu.org/licenses/>.

*/

#if ! defined (octave_oct_env_h)
#define octave_oct_env_h 1

#include "octave-config.h"

#include <string>

namespace octave
{
  namespace sys
  {
    class
    OCTAVE_API
    env
    {
    protected:

      env (void);

    public:

      static std::string polite_directory_format (const std::string& name);

      static bool absolute_pathname (const std::string& s);

      static bool rooted_relative_pathname (const std::string& s);

      static std::string base_pathname (const std::string& s);

      static std::string
      make_absolute (const std::string& s,
                     const std::string& dot_path = get_current_directory ());

      static std::string get_current_directory (void);

      static std::string get_home_directory (void);

      static std::string get_temp_directory (void);

      static std::string get_program_name (void);

      static std::string get_program_invocation_name (void);

      static std::string get_user_name (void);

      static std::string get_host_name (void);

      static std::string getenv (const std::string& name);

      static void putenv (const std::string& name, const std::string& value);

      static bool have_x11_display (void);

      static bool chdir (const std::string& newdir);

      static void set_program_name (const std::string& s);

    private:

      static bool instance_ok (void);

      std::string do_polite_directory_format (const std::string& name) const;

      bool do_absolute_pathname (const std::string& s) const;

      bool do_rooted_relative_pathname (const std::string& s) const;

      std::string do_base_pathname (const std::string& s) const;

      std::string do_make_absolute (const std::string& s,
                                    const std::string& dot_path) const;

      std::string do_getcwd (void) const;

      std::string do_get_home_directory (void) const;

      std::string do_get_temp_directory (void) const;

      std::string do_get_user_name (void) const;

      std::string do_get_host_name (void) const;

      std::string do_getenv (const std::string& name) const;

      void do_putenv (const std::string& name, const std::string& value) const;

      bool do_chdir (const std::string& newdir);

      void do_set_program_name (const std::string& s) const;

      void pathname_backup (std::string& path, int n) const;

      void error (int) const;

      void error (const std::string&) const;

      // No copying!

      env (const env&);

      env& operator = (const env&);

      // The real thing.
      static env *instance;

      static void cleanup_instance (void) { delete instance; instance = 0; }

      // TRUE means follow symbolic links that point to directories just
      // as if they are real directories.
      bool follow_symbolic_links;

      // TRUE means that pwd always give verbatim directory, regardless
      // of symbolic link following.
      bool verbatim_pwd;

      // Where are we?
      mutable std::string current_directory;

      // Etc.
      mutable std::string prog_name;

      mutable std::string prog_invocation_name;

      mutable std::string user_name;

      mutable std::string host_name;
    };
  }
}

#if defined (OCTAVE_USE_DEPRECATED_FUNCTIONS)

OCTAVE_DEPRECATED ("use 'octave::sys::env' instead")
typedef octave::sys::env octave_env;

#endif

#endif