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
|
/*
\funcref{readheader}{BIN\_HEADER\_ $*$readheader (\params)}
{
{FILE} {*f} {binary makefile to read from}
{char} {v} {major version number of program}
}
{pointer to read header information}
{error()}
{}
{readhead.c}
{
Function {\em readheader()} attempts to read the header in a binary
makefile and checks the major version numbers of the makefile and the
program. When the header cannot be read or when the versions do not
match, an error is issued. {\em readheader()} expects to be called
prior to any reading from the binary file: the file pointer is not
repositioned before or after the header processing.
The return value points to a static {\em BIN\_HEADER\_} struct which is
filled with information. The fields of the return value are:
\begin{itemize}
\item {\em ret$\rightarrow$version} : a string of four characters
stating the version of the binary makefile. The string is {\bf not}
terminated by `$\backslash$0'.
\item {\em ret$\rightarrow$offset[0]} : an {\em INT32} value
stating the offset of the strings area.
\item {\em ret$\rightarrow$offset[1]} : an {\em INT32} value
stating the offset of the variables area.
\item {\em ret$\rightarrow$offset[2]} : an {\em INT32} value
stating the offset of the filenames area.
\end{itemize}
The strings area is present when the offset of this area is smaller
than the offset of the variables area. The strings are represented as
{\em ascii-z} strings.
The variables area is present when the offset of this area is smaller
than the offset of the filenames area. The variables are {\em VAR\_}
structs.
The filenames area is always present. The filenames are represented as
`$\backslash$n'-terminated strings.
}
*/
#include "icrssdef.h"
#include "../icm.h"
BIN_HEADER_ *readheader (FILE *f, unsigned v)
{
static BIN_HEADER_
header;
if (! fread (&header, sizeof (BIN_HEADER_), 1, f) )
error ("cannot read header from binary file, corrupted?");
if (header.version[0] < v)
error ("The binary file was created with an older version of icmake.\n"
"Remake the binary file.");
if (header.version[0] > v)
error ("This program does not support the version which is indicated"
" by the binary\n"
"file. Upgrade to a newer program.");
return (&header);
}
|
