This file is indexed.

/usr/include/dolfin/la/solve.h is in libdolfin-dev 1.4.0+dfsg-4.

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
// Copyright (C) 2007-2011 Anders Logg
//
// This file is part of DOLFIN.
//
// DOLFIN 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 3 of the License, or
// (at your option) any later version.
//
// DOLFIN 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 DOLFIN. If not, see <http://www.gnu.org/licenses/>.
//
// Modified by Ola Skavhaug 2008.
// Modified by Garth N. Wells 2011.
//
// First added:  2007-04-30
// Last changed: 2011-10-19

#ifndef __SOLVE_LA_H
#define __SOLVE_LA_H

#include <vector>
#include <string>

#include <dolfin/common/types.h>

namespace dolfin
{

  // Forward declarations
  class GenericLinearOperator;
  class GenericVector;

  /// Solve linear system Ax = b
  std::size_t solve(const GenericLinearOperator& A, GenericVector& x,
                    const GenericVector& b,
                    std::string method = "lu",
                    std::string preconditioner = "none");

  /// List available linear algebra backends
  void list_linear_algebra_backends();

  /// List available solver methods for current linear algebra backend
  void list_linear_solver_methods();

  /// List available LU methods for current linear algebra backend
  void list_lu_solver_methods();

  /// List available Krylov methods for current linear algebra backend
  void list_krylov_solver_methods();

  /// List available preconditioners for current linear algebra
  /// backend
  void list_krylov_solver_preconditioners();

  // Return true if a specific linear algebra backend is supported
  bool has_linear_algebra_backend(std::string backend);

  /// Return true if LU method for the current linear algebra backend is
  /// available
  bool has_lu_solver_method(std::string method);

  /// Return true if Krylov method for the current linear algebra
  /// backend is available
  bool has_krylov_solver_method(std::string method);

  /// Return true if Preconditioner for the current linear algebra
  /// backend is available
  bool has_krylov_solver_preconditioner(std::string preconditioner);

  /// Return available linear algebra backends
  std::vector<std::pair<std::string, std::string> > linear_algebra_backends();

  /// Return a list of available solver methods for current linear
  /// algebra backend
  std::vector<std::pair<std::string, std::string> > linear_solver_methods();

  /// Return a list of available LU methods for current linear algebra
  /// backend
  std::vector<std::pair<std::string, std::string> > lu_solver_methods();

  /// Return a list of available Krylov methods for current linear
  /// algebra backend
  std::vector<std::pair<std::string, std::string> > krylov_solver_methods();

  /// Return a list of available preconditioners for current linear
  /// algebra backend
  std::vector<std::pair<std::string, std::string> >
    krylov_solver_preconditioners();

  /// Compute residual ||Ax - b||
  double residual(const GenericLinearOperator& A, const GenericVector& x,
                  const GenericVector& b);

  /// Compute norm of vector. Valid norm types are "l2", "l1" and
  /// "linf".
  double norm(const GenericVector& x, std::string norm_type="l2");

  /// Normalize vector according to given normalization type
  double normalize(GenericVector& x,
                   std::string normalization_type = "average");

}

#endif