GeezerVison is showing github.com — mruby/include/mruby/dump.h at stable · mruby/mruby

Expand file tree

dump.h

Copy path

More file actions

Latest commit

History

159 lines (131 loc) · 3.9 KB

dump.h

Copy path

File metadata and controls

159 lines (131 loc) · 3.9 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

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

/**

** @file mruby/dump.h - mruby binary dumper (mrbc binary format)

** See Copyright Notice in mruby.h

#ifndef MRUBY_DUMP_H

#define MRUBY_DUMP_H

#include <mruby.h>

#include <mruby/irep.h>

#include "common.h"

/**

* Dumping compiled mruby script.

MRB_BEGIN_DECL

/* flags for mrb_dump_irep and mrb_dump_irep_binary */

#define MRB_DUMP_DEBUG_INFO 1

#define MRB_DUMP_STATIC 2

#define MRB_DUMP_NO_LVAR 4

#ifndef MRB_NO_STDIO

MRB_API mrb_value mrb_load_irep_file(mrb_state*,FILE*);

MRB_API mrb_value mrb_load_irep_file_cxt(mrb_state*, FILE*, mrb_ccontext*);

mrb_irep *mrb_read_irep_file(mrb_state*, FILE*);

int mrb_dump_irep_binary(mrb_state*, const mrb_irep*, uint8_t, FILE*);

#endif

/* avoid mrb_read_irep(); use mrb_read_irep_buf() instead (may cause buffer overflow) */

MRB_API mrb_irep *mrb_read_irep(mrb_state*, const uint8_t*);

MRB_API mrb_irep *mrb_read_irep_buf(mrb_state*, const void*, size_t);

/* dump/load error code

* NOTE: MRB_DUMP_GENERAL_FAILURE is caused by

* unspecified issues like malloc failed.

#define MRB_DUMP_OK 0

#define MRB_DUMP_GENERAL_FAILURE (-1)

#define MRB_DUMP_WRITE_FAULT (-2)

#define MRB_DUMP_READ_FAULT (-3)

#define MRB_DUMP_INVALID_FILE_HEADER (-4)

#define MRB_DUMP_INVALID_IREP (-5)

#define MRB_DUMP_INVALID_ARGUMENT (-6)

/* null symbol length */

#define MRB_DUMP_NULL_SYM_LEN 0xFFFF

/* Rite Binary File header */

#define RITE_BINARY_IDENT "RITE"

/* Binary Format Version Major:Minor */

/* Major: Incompatible to prior versions */

/* Minor: Upper-compatible to prior versions */

#define RITE_BINARY_MAJOR_VER "04"

#define RITE_BINARY_MINOR_VER "00"

#define RITE_BINARY_FORMAT_VER RITE_BINARY_MAJOR_VER RITE_BINARY_MINOR_VER

#define RITE_COMPILER_NAME "MATZ"

#define RITE_COMPILER_VERSION "0000"

#define RITE_VM_VER "0400"

#define RITE_BINARY_EOF "END\0"

#define RITE_SECTION_IREP_IDENT "IREP"

#define RITE_SECTION_DEBUG_IDENT "DBG\0"

#define RITE_SECTION_LV_IDENT "LVAR"

#define MRB_DUMP_DEFAULT_STR_LEN 128

#define MRB_DUMP_ALIGNMENT sizeof(uint32_t)

/* binary header */

struct rite_binary_header {

uint8_t binary_ident[4]; /* Binary Identifier */

uint8_t major_version[2]; /* Binary Format Major Version */

uint8_t minor_version[2]; /* Binary Format Minor Version */

uint8_t binary_size[4]; /* Binary Size */

uint8_t compiler_name[4]; /* Compiler name */

uint8_t compiler_version[4];

};

/* section header */

#define RITE_SECTION_HEADER \

uint8_t section_ident[4]; \

uint8_t section_size[4]

struct rite_section_header {

RITE_SECTION_HEADER;

};

struct rite_section_irep_header {

RITE_SECTION_HEADER;

uint8_t rite_version[4]; /* Rite Instruction Specification Version */

};

struct rite_section_debug_header {

RITE_SECTION_HEADER;

};

struct rite_section_lv_header {

RITE_SECTION_HEADER;

};

#define RITE_LV_NULL_MARK UINT16_MAX

struct rite_binary_footer {

RITE_SECTION_HEADER;

};

static inline size_t

uint8_to_bin(uint8_t s, uint8_t *bin)

{

*bin = s;

return sizeof(uint8_t);

}

static inline size_t

uint16_to_bin(uint16_t s, uint8_t *bin)

{

*bin++ = (s >> 8) & 0xff;

*bin = s & 0xff;

return sizeof(uint16_t);

}

static inline size_t

uint32_to_bin(uint32_t l, uint8_t *bin)

{

*bin++ = (l >> 24) & 0xff;

*bin++ = (l >> 16) & 0xff;

*bin++ = (l >> 8) & 0xff;

*bin = l & 0xff;

return sizeof(uint32_t);

}

static inline uint32_t

bin_to_uint32(const uint8_t *bin)

{

return (uint32_t)bin[0] << 24 |

(uint32_t)bin[1] << 16 |

(uint32_t)bin[2] << 8 |

(uint32_t)bin[3];

}

static inline uint16_t

bin_to_uint16(const uint8_t *bin)

{

return (uint16_t)bin[0] << 8 |

(uint16_t)bin[1];

}

static inline uint8_t

bin_to_uint8(const uint8_t *bin)

{

return (uint8_t)bin[0];

}

MRB_END_DECL

#endif /* MRUBY_DUMP_H */