section.h

Go to the documentation of this file.

#ifndef YASM_SECTION_H
#define YASM_SECTION_H

#ifndef YASM_LIB_DECL
#define YASM_LIB_DECL
#endif

typedef struct yasm_reloc yasm_reloc;

struct yasm_reloc {
    /*@reldef@*/ STAILQ_ENTRY(yasm_reloc) link; 
    yasm_intnum *addr;          
    /*@dependent@*/ yasm_symrec *sym;       
};

typedef struct yasm_overrides {
    int
    (*value_finalize)(yasm_value *value, yasm_bytecode *precbc);
} yasm_overrides;

struct yasm_object {
    /*@owned@*/ char *src_filename;     
    /*@owned@*/ char *obj_filename;     
    /*@owned@*/ yasm_symtab *symtab;    
    /*@owned@*/ yasm_arch *arch;        
    /*@owned@*/ yasm_objfmt *objfmt;    
    /*@owned@*/ yasm_dbgfmt *dbgfmt;    
    /*@owned@*/ yasm_overrides *overrides; 
    /*@dependent@*/ /*@null@*/ yasm_section *cur_section;

    /*@reldef@*/ STAILQ_HEAD(yasm_sectionhead, yasm_section) sections;

    /*@owned@*/ struct HAMT *directives;

    /*@owned@*/ char *global_prefix;

    /*@owned@*/ char *global_suffix;
};

YASM_LIB_DECL
/*@null@*/ /*@only@*/ yasm_object *yasm_object_create
    (const char *src_filename, const char *obj_filename,
     /*@kept@*/ yasm_arch *arch,
     const yasm_objfmt_module *objfmt_module,
     const yasm_dbgfmt_module *dbgfmt_module);

YASM_LIB_DECL
/*@dependent@*/ yasm_section *yasm_object_get_general
    (yasm_object *object, const char *name, unsigned long align, int code,
     int res_only, /*@out@*/ int *isnew, unsigned long line);

YASM_LIB_DECL
int yasm_object_directive(yasm_object *object, const char *name,
                          const char *parser, yasm_valparamhead *valparams,
                          yasm_valparamhead *objext_valparams,
                          unsigned long line);

YASM_LIB_DECL
void yasm_object_destroy(/*@only@*/ yasm_object *object);

YASM_LIB_DECL
void yasm_object_print(const yasm_object *object, FILE *f, int indent_level);

YASM_LIB_DECL
void yasm_object_finalize(yasm_object *object, yasm_errwarns *errwarns);

YASM_LIB_DECL
int yasm_object_sections_traverse
    (yasm_object *object, /*@null@*/ void *d,
     int (*func) (yasm_section *sect, /*@null@*/ void *d));

YASM_LIB_DECL
/*@dependent@*/ /*@null@*/ yasm_section *yasm_object_find_general
    (yasm_object *object, const char *name);

YASM_LIB_DECL
void yasm_object_set_source_fn(yasm_object *object, const char *src_filename);

YASM_LIB_DECL
void yasm_object_set_global_prefix(yasm_object *object, const char *prefix);

YASM_LIB_DECL
void yasm_object_set_global_suffix(yasm_object *object, const char *suffix);

YASM_LIB_DECL
void yasm_object_optimize(yasm_object *object, yasm_errwarns *errwarns);

YASM_LIB_DECL
int yasm_section_is_code(yasm_section *sect);

YASM_LIB_DECL
unsigned long yasm_section_get_opt_flags(const yasm_section *sect);

YASM_LIB_DECL
void yasm_section_set_opt_flags(yasm_section *sect, unsigned long opt_flags);

YASM_LIB_DECL
int yasm_section_is_default(const yasm_section *sect);

YASM_LIB_DECL
void yasm_section_set_default(yasm_section *sect, int def);

YASM_LIB_DECL
yasm_object *yasm_section_get_object(const yasm_section *sect);

YASM_LIB_DECL
/*@dependent@*/ /*@null@*/ void *yasm_section_get_data
    (yasm_section *sect, const yasm_assoc_data_callback *callback);

YASM_LIB_DECL
void yasm_section_add_data(yasm_section *sect,
                           const yasm_assoc_data_callback *callback,
                           /*@null@*/ /*@only@*/ void *data);

YASM_LIB_DECL
void yasm_section_add_reloc(yasm_section *sect, yasm_reloc *reloc,
    void (*destroy_func) (/*@only@*/ void *reloc));

YASM_LIB_DECL
/*@null@*/ yasm_reloc *yasm_section_relocs_first(yasm_section *sect);

/*@null@*/ yasm_reloc *yasm_section_reloc_next(yasm_reloc *reloc);
#ifndef YASM_DOXYGEN
#define yasm_section_reloc_next(x)      STAILQ_NEXT((x), link)
#endif

YASM_LIB_DECL
void yasm_reloc_get(yasm_reloc *reloc, yasm_intnum **addrp,
                    /*@dependent@*/ yasm_symrec **symp);

YASM_LIB_DECL
yasm_bytecode *yasm_section_bcs_first(yasm_section *sect);

YASM_LIB_DECL
yasm_bytecode *yasm_section_bcs_last(yasm_section *sect);

YASM_LIB_DECL
/*@only@*/ /*@null@*/ yasm_bytecode *yasm_section_bcs_append
    (yasm_section *sect,
     /*@returned@*/ /*@only@*/ /*@null@*/ yasm_bytecode *bc);

YASM_LIB_DECL
int yasm_section_bcs_traverse
    (yasm_section *sect, /*@null@*/ yasm_errwarns *errwarns,
     /*@null@*/ void *d, int (*func) (yasm_bytecode *bc, /*@null@*/ void *d));

YASM_LIB_DECL
/*@observer@*/ const char *yasm_section_get_name(const yasm_section *sect);

YASM_LIB_DECL
void yasm_section_set_align(yasm_section *sect, unsigned long align,
                            unsigned long line);

YASM_LIB_DECL
unsigned long yasm_section_get_align(const yasm_section *sect);

YASM_LIB_DECL
void yasm_section_print(/*@null@*/ const yasm_section *sect, FILE *f,
                        int indent_level, int print_bcs);

#endif