This file is indexed.

/usr/include/linbox/blackbox/toeplitz.h is in liblinbox-dev 1.1.6~rc0-4.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
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
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
/* -*- mode: C++; tab-width: 4; indent-tabs-mode: t; c-basic-offset: 4 -*- */

/* *******************************************************************
 *    ntl-toeplitz.h 
 *    Copyright (C) 2002 Austin Lobo, B. David Saunders
 *
 *    Template for Toeplitz specification for ntl Arithmetic
 *    Linbox version 2001 and 2002 from a version 
 *    Designed by A.Lobo and B.D. Saunders in 4/98
 *-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+*/

#ifndef TOEPLITZ_H
#define TOEPLITZ_H
#include <iostream>
#include <vector>
#include "linbox/vector/vector-traits.h"
#include "linbox/solutions/methods.h"  // for shape
#include "linbox/linbox-config.h"
#include <linbox/blackbox/blackbox-interface.h>

#ifdef __LINBOX_HAVE_NTL
#include <linbox/field/ntl-ZZ_pX.h>
#endif

//#define DBGMSGS 1

/*-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 *   Partial Specialization of Toeplitz for Dense vectors from 
 *   an FFT based on Shoup's NTL library.
 *   this file is included at the end of the template specification
 *   for Toeplitz.h
 *-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+*/

namespace LinBox
{
	template <class _Field, class _PField>
	class ToeplitzBase : public  BlackboxInterface 
	{
	protected: // Constructors etc. are protected because instances of this
	           // class should not be instantiated; use Toeplitz instead.
		typedef _PField PField;
		typedef typename _PField::Element Poly;

		typedef typename _PField::CoeffField Field;

		typedef typename _PField::Coeff Element;
		
		//------- CONSTRUCTORS AND DESTRUCTORS
		
		virtual ~ToeplitzBase();                // Destructor
		ToeplitzBase();                 // Zero Param Constructor
		ToeplitzBase( const Field& F);// Field only cstr. JGD 30.09.2003
		ToeplitzBase( const PField& PF );
		// Constructor using a polynomial field, a polynomial in that
		// field representing the matrix, and the matrix dimensions
		// If no n is given, it will default to the same as m.
		ToeplitzBase( const PField& PF, const Poly& p,
		              size_t m, size_t n=0 );
            
		
	public: 
		//------- READ-ONLY ACCESSOR, and OBSERVER METHODS 

            template<typename _Tp1, typename _Tp2>
            struct rebind
            { typedef ToeplitzBase<_Tp1,_Tp2> other; };


		
		inline size_t rowdim() const { return rowDim; }// Number of Rows
		inline size_t coldim() const { return colDim; }// Number of Cols
		inline size_t sysdim() const { return sysDim; }
			// Max of rows & columns; 
		const Field& field() const {return K;}
		//------- MUTATOR METHODS
		
		void setToUniModUT() ;      // Convert to UTriang matrix with det 1
		void setToUniModLT() ;      // Convert to LTriang matrix with det 1
		
		//------ SERVICE METHODS

		//      void convert(NTL::ZZ_pX &pout, const std::vector<Element> &vin);
    protected:
		PField P; 	  // Polynomial field
		Field K;           // Field parameter (coefficient field)
		
		size_t rowDim;             // row dimension 
		size_t colDim;             // col dimension 
		size_t sysDim;             // max{row,col} dimension
		
		Poly  pdata;         // Poly rep of the toeplitz matrix
		Poly  rpdata;        // reverse polynomial
		
		static const int UnimodUT=1;
		static const int UnimodLT=2;
		BlackboxSpecifier shape; // Helps us deduce what our shape is
		//std::vector<NTL::ZZ_p> data;    // The vector of coeffs of the polynomial

		/* These were only used by the XML stuff and are more or less
		 * obsolete with the presence of polynomial fields.
		 
		void convert(Poly &pout, const std::vector<Element> &vin);
		// CONVERTS the input vector of field Elements to a ZZ_pX
		
		void convert( std::vector<Element> &vout, const Poly &pin);
		// Converts from polynomial rep to a vector rep
		// inverse of the convert from Element to ZZ_pX
		*/
		
	}; //  class ToeplitzBase

	/** \brief This is the blackbox representation of a Toeplitz matrix.

\ingroup blackbox
	 * It stores the 2n-1 values of the first row and column.
	 * The apply is a call to polynomial multiplication and for large n
	 * will be FFT based, running in O(lg(n)) time.
	 * The _PField template parameter should be a polynomial field;
	 * computations on the matrix will be performed using this polynomial.
	 */
#ifdef __LINBOX_HAVE_NTL
	template< class _CField, class _PField = NTL_ZZ_pX >
#else
	template< class _CField, class _PField >
#endif
	class Toeplitz :public ToeplitzBase<_CField,_PField> {
	protected: 
		typedef ToeplitzBase<_CField,_PField> TBase;
	public:
		typedef typename TBase::PField PField;
		typedef typename TBase::Poly Poly;

		typedef typename TBase::Field Field;

		typedef typename TBase::Element Element;

		Toeplitz() :TBase() {}
		Toeplitz(const Field& F) :TBase(F) {}
		Toeplitz( const PField& PF ) :TBase(PF) {}
		Toeplitz( const PField& PF, const Poly& p,
		              size_t m, size_t n=0 )
			:TBase(PF,p,m,n) {}
		
	}; // end of class Toeplitz
	
	/** Specialization for when the field of matrix elements is the same
	  * as the coefficient field of the polynomial field.
	  */
	template< class _PField >
	class Toeplitz< typename _PField::CoeffField, _PField >
		:public ToeplitzBase< typename _PField::CoeffField, _PField >
	{
	protected:
		typedef ToeplitzBase< typename _PField::CoeffField, _PField > TBase;
		using TBase::P;
		using TBase::rowDim;
		using TBase::colDim;
		using TBase::sysDim;
		using TBase::shape;
		using TBase::pdata;
		using TBase::rpdata;
		using TBase::K;
	public:
		using TBase::rowdim;
		using TBase::coldim;
		typedef typename TBase::PField PField;
		typedef typename TBase::Poly Poly;

		typedef typename TBase::Field Field;

		typedef typename TBase::Element Element;
		
		//------- CONSTRUCTORS AND DESTRUCTORS
		Toeplitz() :TBase() {}
		Toeplitz(const Field& F) :TBase(F) {}
		Toeplitz( const PField& PF ) :TBase(PF) {}
		Toeplitz( const PField& PF, const Poly& p,
		              size_t m, size_t n=0 )
			:TBase(PF,p,m,n) {}
		
		Toeplitz( const Field& F,    // Cnstr. with Field and STL vec. of elems
				  const std::vector<Element>& v) :TBase(F) 
		{ init_vector(v); }
		

		void   print( std::ostream& os = std::cout) const;        // Print the contents to the screen

		void   print( char *outFileName) const; 
		// Print the contents to a file
		
		template<class OutVector, class InVector>
		OutVector& apply( OutVector &v_out, const InVector& v_in) const;

		template<class OutVector, class InVector>
		OutVector& applyTranspose( OutVector &v_out, const InVector& v_in) const;

		// Get the determinant of the matrix
		Element& det( Element& res ) const;
	protected: 
                // initialization via a vector. Usually called by a constructor
                // Moved in a separate protected function to enable easier
                // inherited constructor calls. JGD 30.09.2003
		void init_vector( const std::vector<Element>& v );
	}; //  Toeplitz specialization

} // namespace LinBox

#include <linbox/blackbox/toeplitz.inl>     
// Hide the implementation; include it here because
// older compilers want everything in one template file

#endif