This file is indexed.

/usr/include/simavr/avr_flash.h is in libsimavr-dev 1.5+dfsg1-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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
/*
	avr_flash.h

	Copyright 2008, 2009 Michel Pollet <buserror@gmail.com>

 	This file is part of simavr.

	simavr 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.

	simavr 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 simavr.  If not, see <http://www.gnu.org/licenses/>.
 */


#ifndef __AVR_FLASH_H___
#define __AVR_FLASH_H___

#ifdef __cplusplus
extern "C" {
#endif

#include "sim_avr.h"

/*
 * Handles self-programming subsystem if the core
 * supports it.
 */
typedef struct avr_flash_t {
	avr_io_t	io;

	uint16_t	flags;
	uint16_t	*tmppage;
	uint8_t	*tmppage_used;
	uint16_t	spm_pagesize;
	uint8_t r_spm;
	avr_regbit_t selfprgen;
	avr_regbit_t pgers;		// page erase
	avr_regbit_t pgwrt;		// page write
	avr_regbit_t blbset;	// lock bit set
	avr_regbit_t rwwsre;    // read while write section read enable
	avr_regbit_t rwwsb;		// read while write section busy

	avr_int_vector_t flash;	// Interrupt vector
} avr_flash_t;

/* Set if the flash supports a Read While Write section */
#define AVR_SELFPROG_HAVE_RWW (1 << 0)

void avr_flash_init(avr_t * avr, avr_flash_t * p);


#define AVR_IOCTL_FLASH_SPM		AVR_IOCTL_DEF('f','s','p','m')

#define AVR_SELFPROG_DECLARE_INTERNAL(_spmr, _spen, _vector) \
		.r_spm = _spmr,\
		.spm_pagesize = SPM_PAGESIZE,\
		.selfprgen = AVR_IO_REGBIT(_spmr, _spen),\
		.pgers = AVR_IO_REGBIT(_spmr, PGERS),\
		.pgwrt = AVR_IO_REGBIT(_spmr, PGWRT),\
		.blbset = AVR_IO_REGBIT(_spmr, BLBSET),\
		.flash = {\
			.enable = AVR_IO_REGBIT(_spmr, SPMIE),\
			.vector = _vector,\
		}\

#define AVR_SELFPROG_DECLARE_NORWW(_spmr, _spen, _vector) \
	.selfprog = {\
		.flags = 0,\
		AVR_SELFPROG_DECLARE_INTERNAL(_spmr, _spen, _vector),\
	}

#define AVR_SELFPROG_DECLARE(_spmr, _spen, _vector) \
	.selfprog = {\
		.flags = AVR_SELFPROG_HAVE_RWW,\
		AVR_SELFPROG_DECLARE_INTERNAL(_spmr, _spen, _vector),\
		.rwwsre = AVR_IO_REGBIT(_spmr, RWWSRE),\
		.rwwsb = AVR_IO_REGBIT(_spmr, RWWSB),\
	}

#ifdef __cplusplus
};
#endif

#endif /* __AVR_FLASH_H___ */