File: program.h

package info (click to toggle)
brickos 0.9.0-1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 1,700 kB
  • ctags: 1,727
  • sloc: ansic: 9,139; cpp: 860; makefile: 717; asm: 693; sh: 123; perl: 61
file content (120 lines) | stat: -rw-r--r-- 3,430 bytes parent folder | download | duplicates (7)
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
/*! \file   include/sys/program.h
    \brief  Internal Interface: program data structures and functions
    \author Markus L. Noga <markus@noga.de>
 */

/*
 *  The contents of this file are subject to the Mozilla Public License
 *  Version 1.0 (the "License"); you may not use this file except in
 *  compliance with the License. You may obtain a copy of the License
 *  at http://www.mozilla.org/MPL/
 *
 *  Software distributed under the License is distributed on an "AS IS"
 *  basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 *  the License for the specific language governing rights and
 *  limitations under the License.
 *
 *  The Original Code is legOS code, released October 17, 1999.
 *
 *  The Initial Developer of the Original Code is Markus L. Noga.
 *  Portions created by Markus L. Noga are Copyright (C) 1999
 *  Markus L. Noga. All Rights Reserved.
 *
 *  Contributor(s): Markus L. Noga <markus@noga.de>
 */

#ifndef __program_h__
#define __program_h__

#ifdef  __cplusplus
extern "C" {
#endif

#include <config.h>

#ifdef CONF_PROGRAM

#include <tm.h>

///////////////////////////////////////////////////////////////////////
//
// Definitions
//
///////////////////////////////////////////////////////////////////////

#define PROG_MAX  8   	//!< maximum number of programs

#ifndef DOXYGEN_SHOULD_SKIP_INTERNALS
/**
 * The program control structure
 * @internal
 */
typedef struct {
  void *text; 	      	//!< origin of text segment
  void *data; 	      	//!< origin of data segment (imm. after text)
  void *bss;  	      	//!< origin of bss segment (imm. after data)
  void *data_orig;    	//!< origin of backup copy of data segment

  size_t text_size;     //!< text segment size in bytes
  size_t data_size;     //!< data segment size in bytes
  size_t bss_size;      //!< bss  segment size in bytes
  size_t stack_size;  	//!< stack segment size in bytes
  size_t start; 	//!< offset from text segment to start into.
  priority_t prio;    	//!< priority to run this program at

  size_t downloaded;  	//!< number of bytes downloaded so far.
} program_t;

/**
 * @internal
 */
typedef enum {
  CMDacknowledge,     	//!< 1:
  CMDdelete, 	      	//!< 1+ 1: b[nr]
  CMDcreate, 	      	//!< 1+12: b[nr] s[textsize] s[datasize]
			//               s[bsssize]  s[stacksize]
			//               s[start]    b[prio]
  CMDoffsets, 	      	//!< 1+ 7: b[nr] s[text] s[data] s[bss]
  CMDdata,   	      	//!< 1+>3: b[nr] s[offset] array[data]
  CMDrun,     	      	//!< 1+ 1: b[nr]
  CMDirmode,		//!< 1+ 1: b[0=near/1=far]
  CMDsethost,			//!< 1+ 1: b[hostaddr]
  CMDlast     	      	//!< ?
} packet_cmd_t;

#endif /* DOXYGEN_SHOULD_SKIP_INTERNALS */

///////////////////////////////////////////////////////////////////////
//
// Variables
//
///////////////////////////////////////////////////////////////////////

extern volatile unsigned cprog;   //!< the current program

///////////////////////////////////////////////////////////////////////
//
// Functions
//
///////////////////////////////////////////////////////////////////////

//! stop program
extern void program_stop(int flag);

//! check if a given program is valid.
/*! \return 0 if invalid */
extern int program_valid(unsigned nr);

//! initialize program support
extern void program_init();

//! shutdown program support
extern void program_shutdown();

#endif // CONF_PROGRAM

#ifdef  __cplusplus
}
#endif

#endif // __program_h__