This file is indexed.

/usr/include/cpl_dfs.h is in libcpl-dev 6.6.1-1build1.

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
/* $Id: cpl_dfs.h,v 1.17 2011-04-01 09:57:38 llundin Exp $
 *
 * This file is part of the ESO Common Pipeline Library
 * Copyright (C) 2001-2008 European Southern Observatory
 *
 * This program 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 2 of the License, or
 * (at your option) any later version.
 *
 * This program 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 this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */

/*
 * $Author: llundin $
 * $Date: 2011-04-01 09:57:38 $
 * $Revision: 1.17 $
 * $Name: not supported by cvs2svn $
 */

#ifndef CPL_DFS_H
#define CPL_DFS_H

#include <cpl_imagelist.h>
#include <cpl_table.h>
#include <cpl_frameset.h>
#include <cpl_propertylist.h>
#include <cpl_parameterlist.h>
#include <cpl_error.h>

CPL_BEGIN_DECLS

/*-----------------------------------------------------------------------------
                                 Defines
 -----------------------------------------------------------------------------*/

#define CPL_DFS_FITS ".fits"
#define CPL_DFS_PAF ".paf"


/*----------------------------------------------------------------------------*/
/**
   @ingroup cpl_dfs
   @brief  The name of the Product Category key
   @see cpl_dfs_save_image()
   @note A pipeline product must contain a string property with this name
 */
/*----------------------------------------------------------------------------*/
#define CPL_DFS_PRO_CATG "ESO PRO CATG"

/*----------------------------------------------------------------------------*/
/**
   @ingroup cpl_dfs
   @brief  The name of the Product Type key
   @see cpl_dfs_save_image()
   @note A pipeline product should contain a string property with this name

 */
/*----------------------------------------------------------------------------*/
#define CPL_DFS_PRO_TYPE "ESO PRO TYPE"

/*----------------------------------------------------------------------------*/
/**
   @ingroup cpl_dfs
   @brief  The name of the Product Tech key
   @see cpl_dfs_save_image()
   @note A pipeline product should contain a string property with this name

 */
/*----------------------------------------------------------------------------*/
#define CPL_DFS_PRO_TECH "ESO PRO TECH"

/*----------------------------------------------------------------------------*/
/**
   @ingroup cpl_dfs
   @brief  The name of the Product Science key
   @see cpl_dfs_save_image()
   @note A pipeline product should contain a boolean property with this name
 */
/*----------------------------------------------------------------------------*/
#define CPL_DFS_PRO_SCIENCE "ESO PRO SCIENCE"


/**
 * @ingroup cpl_dfs
 *
 * @brief
 *  Pipeline products digital signature flags.
 *
 * Flags to select the different digital signatures to compute for pipeline
 * product files. The values may be combined using bitwise or.
 */

enum {

    /**
     * Do not compute any signatures
     * @hideinitializer
     */

    CPL_DFS_SIGNATURE_NONE     = 0,

    /**
     * Compute the DATAMD5 data hash
     * @hideinitializer
     */

    CPL_DFS_SIGNATURE_DATAMD5  = 1 << 0,

    /**
     * Compute FITS standard CHECKSUM and DATASUM
     * @hideinitializer
     */

    CPL_DFS_SIGNATURE_CHECKSUM = 1 << 1
};


/*-----------------------------------------------------------------------------
                              Function prototypes
 -----------------------------------------------------------------------------*/

cpl_error_code cpl_dfs_save_image(cpl_frameset *,
                                  cpl_propertylist *,
                                  const cpl_parameterlist *,
                                  const cpl_frameset *,
                                  const cpl_frame *,
                                  const cpl_image *,
                                  cpl_type,
                                  const char *,
                                  const cpl_propertylist *,
                                  const char *,
                                  const char *,
                                  const char *);

cpl_error_code cpl_dfs_save_propertylist(cpl_frameset *,
                                         cpl_propertylist *,
                                         const cpl_parameterlist *,
                                         const cpl_frameset *,
                                         const cpl_frame *,
                                         const char *,
                                         const cpl_propertylist *,
                                         const char *,
                                         const char *,
                                         const char *);

cpl_error_code cpl_dfs_save_imagelist(cpl_frameset *,
                                      cpl_propertylist *,
                                      const cpl_parameterlist *,
                                      const cpl_frameset *,
                                      const cpl_frame *,
                                      const cpl_imagelist *,
                                      cpl_type,
                                      const char *,
                                      const cpl_propertylist *,
                                      const char *,
                                      const char *,
                                      const char *);

cpl_error_code cpl_dfs_save_table(cpl_frameset *,
                                  cpl_propertylist *,
                                  const cpl_parameterlist *,
                                  const cpl_frameset *,
                                  const cpl_frame *,
                                  const cpl_table *,
                                  const cpl_propertylist *,
                                  const char *,
                                  const cpl_propertylist *,
                                  const char *,
                                  const char *,
                                  const char *);

cpl_error_code cpl_dfs_save_paf(const char *, const char *,
                                const cpl_propertylist *, const char *);

cpl_error_code cpl_dfs_setup_product_header(cpl_propertylist *, 
                                            const cpl_frame *, 
                                            const cpl_frameset *, 
                                            const cpl_parameterlist *, 
                                            const char *,
                                            const char *,
                                            const char *,
                                            const cpl_frame *);

cpl_error_code cpl_dfs_update_product_header(cpl_frameset *);

cpl_error_code cpl_dfs_sign_products(const cpl_frameset *set,
                                      unsigned int flags);

CPL_END_DECLS

#endif