This file is indexed.

/usr/include/astrometry/engine.h is in libastrometry-dev 0.70+dfsg-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
/*
# This file is part of the Astrometry.net suite.
# Licensed under a 3-clause BSD style license - see LICENSE
*/

#ifndef ENGINE_H
#define ENGINE_H

#include <stdio.h>

#include "astrometry/blind.h"
#include "astrometry/bl.h"
#include "astrometry/an-bool.h"
#include "astrometry/index.h"

struct engine {
    // search paths (directories)
	sl* index_paths;

    // contains "index_t" objects.
	// if "inparallel" is not set, they will be "metadata-only" until
	// they need to be loaded.
    pl* indexes;

	// indexes that need to be freed
    pl* free_indexes;
	// multiindexes that need to be freed
    pl* free_mindexes;

	il* ibiggest;
	il* ismallest;
    il* default_depths;
	double sizesmallest;
	double sizebiggest;
	anbool inparallel;
	double minwidth;
	double maxwidth;
    float cpulimit;
    char* cancelfn;
    char* solvedfn;
};
typedef struct engine engine_t;

struct job_t {
	dl* scales;
	il* depths;
    anbool include_default_scales;
    double ra_center;
    double dec_center;
    double search_radius;
    anbool use_radec_center;
    blind_t bp;
};
typedef struct job_t job_t;

engine_t* engine_new();
void engine_add_search_path(engine_t* engine, const char* path);
char* engine_find_index(engine_t*, const char* name);
// note that "path" must be a full path name.
int engine_add_index(engine_t* engine, char* path);
// look in all the search path directories for index files.
int engine_autoindex_search_paths(engine_t* engine);
int engine_parse_config_file_stream(engine_t* engine, FILE* fconf);
int engine_parse_config_file(engine_t* engine, const char* fn);
int engine_run_job(engine_t* engine, job_t* job);
void engine_free(engine_t* engine);

job_t* engine_read_job_file(engine_t* engine, const char* jobfn);
int job_set_base_dir(job_t* job, const char* dir);
int job_set_input_base_dir(job_t* job, const char* dir);
int job_set_output_base_dir(job_t* job, const char* dir);
void job_set_cancel_file(job_t* job, const char* fn);
void job_set_solved_file(job_t* job, const char* fn);
void job_free(job_t* job);


#endif