bin.c File Reference

#include <rz_bin.h>
#include <rz_demangler.h>
#include <rz_util.h>
#include <rz_lib.h>
#include <rz_io.h>
#include <config.h>
#include "i/private.h"

Go to the source code of this file.

Macros
#define	DB   a->sdb;
#define	RBINLISTFREE(x)
#define	ARCHS_KEY   "archs"

Functions
	RZ_LIB_VERSION (rz_bin)
static ut64	__getoffset (RzBin *bin, int type, int idx)
static char *	__getname (RzBin *bin, int type, int idx)
RZ_API RzBinXtrData *	rz_bin_xtrdata_new (RzBuffer *buf, ut64 offset, ut64 size, ut32 file_count, RzBinXtrMetadata *metadata)
RZ_API void	rz_bin_xtrdata_free (void *data_)
RZ_API void	rz_bin_options_init (RzBinOptions *opt, int fd, ut64 baseaddr, ut64 loadaddr, bool patch_relocs)
RZ_API void	rz_bin_arch_options_init (RzBinArchOptions *opt, const char *arch, int bits)
RZ_API void	rz_bin_file_hash_free (RzBinFileHash *fhash)
RZ_API void	rz_bin_info_free (RzBinInfo *rb)
RZ_API RzBinImport *	rz_bin_import_clone (RzBinImport *o)
RZ_API void	rz_bin_import_free (RzBinImport *imp)
RZ_API void	rz_bin_resource_free (RzBinResource *res)
RZ_API const char *	rz_bin_symbol_name (RzBinSymbol *s)
RZ_API RzBinSymbol *	rz_bin_symbol_new (const char *name, ut64 paddr, ut64 vaddr)
RZ_API void	rz_bin_symbol_free (RzBinSymbol *sym)
RZ_API void	rz_bin_reloc_free (RzBinReloc *reloc)
RZ_API void	rz_bin_string_free (void *_str)
RZ_API RzBinFile *	rz_bin_open (RzBin *bin, const char *file, RzBinOptions *opt)
RZ_API RzBinFile *	rz_bin_reload (RzBin *bin, RzBinFile *bf, ut64 baseaddr)
RZ_API RzBinFile *	rz_bin_open_buf (RzBin *bin, RzBuffer *buf, RzBinOptions *opt)
RZ_API RzBinFile *	rz_bin_open_io (RzBin *bin, RzBinOptions *opt)
RZ_IPI RzBinPlugin *	rz_bin_get_binplugin_by_name (RzBin *bin, const char *name)
RZ_API RzBinPlugin *	rz_bin_get_binplugin_by_buffer (RzBin *bin, RzBuffer *buf)
RZ_IPI RzBinPlugin *	rz_bin_get_binplugin_by_filename (RzBin *bin)
RZ_IPI RzBinXtrPlugin *	rz_bin_get_xtrplugin_by_name (RzBin *bin, const char *name)
static void	rz_bin_plugin_free (RzBinPlugin *p)
RZ_API bool	rz_bin_plugin_add (RzBin *bin, RzBinPlugin *foo)
RZ_API bool	rz_bin_xtr_add (RzBin *bin, RzBinXtrPlugin *foo)
RZ_API void	rz_bin_free (RzBin *bin)
static bool	rz_bin_print_plugin_details (RzBin *bin, RzBinPlugin *bp, PJ *pj, int json)
static void	__printXtrPluginDetails (RzBin *bin, RzBinXtrPlugin *bx, int json)
RZ_API bool	rz_bin_list_plugin (RzBin *bin, const char *name, PJ *pj, int json)
RZ_API ut64	rz_bin_get_baddr (RzBin *bin)
RZ_API ut64	rz_bin_get_laddr (RzBin *bin)
RZ_API void	rz_bin_set_baddr (RzBin *bin, ut64 baddr)
RZ_DEPRECATE RZ_API RZ_BORROW RzList *	rz_bin_get_entries (RZ_NONNULL RzBin *bin)
RZ_DEPRECATE RZ_API RZ_BORROW RzList *	rz_bin_get_fields (RZ_NONNULL RzBin *bin)
RZ_DEPRECATE RZ_API RZ_BORROW RzList *	rz_bin_get_imports (RZ_NONNULL RzBin *bin)
RZ_DEPRECATE RZ_API RZ_BORROW RzBinInfo *	rz_bin_get_info (RzBin *bin)
RZ_DEPRECATE RZ_API RZ_BORROW RzList *	rz_bin_get_libs (RZ_NONNULL RzBin *bin)
RZ_DEPRECATE RZ_API RZ_BORROW RzList *	rz_bin_get_sections (RZ_NONNULL RzBin *bin)
RZ_API RZ_BORROW RzBinSection *	rz_bin_get_section_at (RzBinObject *o, ut64 off, int va)
	Find the binary section at offset off. More...
RZ_API RZ_BORROW RzBinMap *	rz_bin_object_get_map_at (RZ_NONNULL RzBinObject *o, ut64 off, bool va)
	Find the last binary map at offset off . More...
RZ_API RZ_OWN RzPVector *	rz_bin_object_get_maps_at (RzBinObject *o, ut64 off, bool va)
	Find all binary maps at offset off . More...
RZ_DEPRECATE RZ_API RZ_BORROW RzList *	rz_bin_get_strings (RZ_NONNULL RzBin *bin)
RZ_DEPRECATE RZ_API RZ_BORROW RzList *	rz_bin_get_symbols (RZ_NONNULL RzBin *bin)
RZ_DEPRECATE RZ_API RZ_BORROW RzList *	rz_bin_get_mem (RZ_NONNULL RzBin *bin)
RZ_DEPRECATE RZ_API int	rz_bin_is_static (RZ_NONNULL RzBin *bin)
RZ_IPI void	rz_bin_file_free (void *_bf)
RZ_API RzBin *	rz_bin_new (void)
RZ_API bool	rz_bin_use_arch (RzBin *bin, const char *arch, int bits, const char *name)
RZ_API bool	rz_bin_select (RzBin *bin, const char *arch, int bits, const char *name)
RZ_API int	rz_bin_select_object (RzBinFile *binfile, const char *arch, int bits, const char *name)
RZ_API bool	rz_bin_select_bfid (RzBin *bin, ut32 bf_id)
RZ_API void	rz_bin_set_user_ptr (RzBin *bin, void *user)
static RzBinSection *	__get_vsection_at (RzBin *bin, ut64 vaddr)
RZ_API void	rz_bin_bind (RzBin *bin, RzBinBind *b)
RZ_API RzBuffer *	rz_bin_create (RzBin *bin, const char *p, const ut8 *code, int codelen, const ut8 *data, int datalen, RzBinArchOptions *opt)
RZ_DEPRECATE RZ_API RZ_BORROW RzList *	rz_bin_get_classes (RZ_NONNULL RzBin *bin)
RZ_API ut64	rz_bin_get_size (RzBin *bin)
RZ_API RzBinFile *	rz_bin_cur (RzBin *bin)
RZ_API RzBinObject *	rz_bin_cur_object (RzBin *bin)
RZ_API void	rz_bin_force_plugin (RzBin *bin, const char *name)
RZ_API const char *	rz_bin_entry_type_string (int etype)
RZ_API void	rz_bin_load_filter (RzBin *bin, ut64 rules)
RZ_API RzBinField *	rz_bin_field_new (ut64 paddr, ut64 vaddr, int size, const char *name, const char *comment, const char *format, bool format_named)
RZ_API void	rz_bin_field_free (RzBinField *field)
RZ_API const char *	rz_bin_get_meth_flag_string (ut64 flag, bool compact)
RZ_API void	rz_bin_virtual_file_free (RzBinVirtualFile *vfile)
RZ_API void	rz_bin_map_free (RzBinMap *map)
RZ_API RZ_OWN RzList *	rz_bin_maps_of_file_sections (RZ_NONNULL RzBinFile *binfile)
	Create a list of RzBinMap from RzBinSections queried from the given file. More...
RZ_API RzList *	rz_bin_sections_of_maps (RzList *maps)
	Create a list of RzBinSection from RzBinMaps. More...
RZ_API RzBinSection *	rz_bin_section_new (const char *name)
RZ_API void	rz_bin_section_free (RzBinSection *bs)
RZ_API RZ_OWN char *	rz_bin_section_type_to_string (RzBin *bin, int type)
	Converts the RzBinSection type to the string representation. More...
RZ_API RZ_OWN RzList *	rz_bin_section_flag_to_list (RzBin *bin, ut64 flag)
	Converts the RzBinSection flags to a list of string representations. More...
RZ_API RzBinFile *	rz_bin_file_at (RzBin *bin, ut64 at)
RZ_API RzBinTrycatch *	rz_bin_trycatch_new (ut64 source, ut64 from, ut64 to, ut64 handler, ut64 filter)
RZ_API void	rz_bin_trycatch_free (RzBinTrycatch *tc)
RZ_API const RzBinPlugin *	rz_bin_plugin_get (RZ_NONNULL RzBin *bin, RZ_NONNULL const char *name)
	Get a RzBinPlugin by name. More...
RZ_API const RzBinXtrPlugin *	rz_bin_xtrplugin_get (RZ_NONNULL RzBin *bin, RZ_NONNULL const char *name)
	Get a RzBinXtrPlugin by name. More...
RZ_API RZ_OWN char *	rz_bin_demangle (RZ_NULLABLE RzBinFile *bf, RZ_NULLABLE const char *language, RZ_NULLABLE const char *symbol, ut64 vaddr, bool libs)
	Demangles a symbol based on the language or the RzBinFile data. More...

Variables
static RzBinPlugin *	bin_static_plugins [] = { RZ_BIN_STATIC_PLUGINS }
static RzBinXtrPlugin *	bin_xtr_static_plugins [] = { RZ_BIN_XTR_STATIC_PLUGINS }

Macro Definition Documentation

ARCHS_KEY

#define ARCHS_KEY   "archs"

Definition at line 23 of file bin.c.

DB

#define DB   a->sdb;

Definition at line 16 of file bin.c.

RBINLISTFREE

#define RBINLISTFREE

(

x

)

Value:

    if (x) { \
        rz_list_free(x); \
        (x) = NULL; \
    }

Definition at line 17 of file bin.c.

Function Documentation

__get_vsection_at()

static RzBinSection* __get_vsection_at ( RzBin *  bin, ut64  vaddr  )

static

Definition at line 843 of file bin.c.

                                                               {
    rz_return_val_if_fail(bin, NULL);
    if (!bin->cur) {
        return NULL;
    }
    return rz_bin_get_section_at(bin->cur->o, vaddr, true);
}

References NULL, rz_bin_get_section_at(), and rz_return_val_if_fail.

Referenced by rz_bin_bind().

__getname()

static char* __getname ( RzBin *  bin, int  type, int  idx  )

static

Definition at line 37 of file bin.c.

                                                      {
    RzBinFile *a = rz_bin_cur(bin);
    RzBinPlugin *plugin = rz_bin_file_cur_plugin(a);
    if (plugin && plugin->get_name) {
        return plugin->get_name(a, type, idx);
    }
    return NULL;
}

References a, rz_bin_plugin_t::get_name, setup::idx, NULL, rz_bin_cur(), rz_bin_file_cur_plugin(), and type.

Referenced by rz_bin_bind().

__getoffset()

static ut64 __getoffset ( RzBin *  bin, int  type, int  idx  )

static

Definition at line 28 of file bin.c.

                                                       {
    RzBinFile *a = rz_bin_cur(bin);
    RzBinPlugin *plugin = rz_bin_file_cur_plugin(a);
    if (plugin && plugin->get_offset) {
        return plugin->get_offset(a, type, idx);
    }
    return UT64_MAX;
}

References a, rz_bin_plugin_t::get_offset, setup::idx, rz_bin_cur(), rz_bin_file_cur_plugin(), type, and UT64_MAX.

Referenced by rz_bin_bind().

__printXtrPluginDetails()

static void __printXtrPluginDetails ( RzBin *  bin, RzBinXtrPlugin *  bx, int  json  )

static

Definition at line 486 of file bin.c.

                                                                              {
    if (json == 'q') {
        bin->cb_printf("%s\n", bx->name);
    } else if (json) {
        PJ *pj = pj_new();
        if (!pj) {
            return;
        }
        pj_o(pj);
        pj_ks(pj, "name", bx->name);
        pj_ks(pj, "description", bx->desc);
        pj_ks(pj, "license", bx->license ? bx->license : "???");
        pj_end(pj);
        bin->cb_printf("%s\n", pj_string(pj));
        pj_free(pj);
    } else {
        bin->cb_printf("Name: %s\n", bx->name);
        bin->cb_printf("Description: %s\n", bx->desc);
        if (bx->license) {
            bin->cb_printf("License: %s\n", bx->license);
        }
    }
}

References rz_bin_xtr_plugin_t::desc, rz_bin_xtr_plugin_t::license, rz_bin_xtr_plugin_t::name, pj_end(), pj_free(), pj_ks(), pj_new(), pj_o(), and pj_string().

Referenced by rz_bin_list_plugin().

rz_bin_arch_options_init()

RZ_API void rz_bin_arch_options_init	(	RzBinArchOptions *	opt,
		const char *	arch,
		int	bits
	)

Definition at line 84 of file bin.c.

                                                                                        {
    opt->arch = arch ? arch : RZ_SYS_ARCH;
    opt->bits = bits ? bits : RZ_SYS_BITS;
}

References rz_bin_arch_options_t::arch, arch, rz_bin_arch_options_t::bits, bits(), RZ_SYS_ARCH, and RZ_SYS_BITS.

Referenced by create(), and rz_main_rz_bin().

rz_bin_bind()

RZ_API void rz_bin_bind	(	RzBin *	bin,
		RzBinBind *	b
	)

Definition at line 851 of file bin.c.

                                                  {
    if (b) {
        b->bin = bin;
        b->get_offset = __getoffset;
        b->get_name = __getname;
        b->get_sections = rz_bin_get_sections;
        b->get_vsect_at = __get_vsection_at;
        b->demangle = rz_bin_demangle;
    }
}

References __get_vsection_at(), __getname(), __getoffset(), b, rz_bin_demangle(), and rz_bin_get_sections().

Referenced by rz_core_init().

rz_bin_create()

RZ_API RzBuffer* rz_bin_create	(	RzBin *	bin,
		const char *	p,
		const ut8 *	code,
		int	codelen,
		const ut8 *	data,
		int	datalen,
		RzBinArchOptions *	opt
	)

Definition at line 862 of file bin.c.

                           {
 
    rz_return_val_if_fail(bin && p && opt, NULL);
 
    RzBinPlugin *plugin = rz_bin_get_binplugin_by_name(bin, p);
    if (!plugin) {
        RZ_LOG_WARN("Cannot find RzBin plugin named '%s'.\n", p);
        return NULL;
    }
    if (!plugin->create) {
        RZ_LOG_WARN("RzBin plugin '%s' does not implement \"create\" method.\n", p);
        return NULL;
    }
    codelen = RZ_MAX(codelen, 0);
    datalen = RZ_MAX(datalen, 0);
    return plugin->create(bin, code, codelen, data, datalen, opt);
}

References rz_bin_plugin_t::create, NULL, p, rz_bin_get_binplugin_by_name(), RZ_LOG_WARN, RZ_MAX, and rz_return_val_if_fail.

Referenced by create(), and rz_main_rz_bin().

rz_bin_cur()

RZ_API RzBinFile* rz_bin_cur

(

RzBin *

bin

)

Definition at line 895 of file bin.c.

                                         {
    rz_return_val_if_fail(bin, NULL);
    return bin->cur;
}

References NULL, and rz_return_val_if_fail.

Referenced by __getname(), __getoffset(), add_new_bin_string(), add_new_func_symbol(), basefind_create_array_of_addresses(), bin_class_print_rizin(), bin_trycatch(), cb_binmaxstr(), cb_binmaxstrbuf(), cb_binminstr(), cb_binstrenc(), classes_as_source_print(), get_bin_info(), get_va_symbol(), getFunctionName(), GetHeapGlobalsOffset(), meta_string_guess_add(), print_cmd_analysis_after_traps_print(), rabin_do_operation(), rabin_extract(), rebase_helper(), rz_bin_cur_object(), rz_bin_section_flag_to_list(), rz_bin_section_type_to_string(), rz_bin_select(), rz_bin_set_baddr(), rz_cmd_debug_dmi(), rz_cmd_info_handler(), rz_cmd_info_whole_strings_handler(), rz_core_analysis_calls(), rz_core_bin_archs_print(), rz_core_bin_export_info(), rz_core_bin_headers_print(), rz_core_bin_load(), rz_core_bin_raise(), rz_core_bin_set_arch_bits(), rz_core_bin_set_by_fd(), rz_core_bin_set_by_name(), rz_core_bin_signatures_print(), rz_core_bin_update_arch_bits(), rz_core_get_reloc_to(), rz_core_getreloc(), rz_core_io_file_open(), rz_core_meta_pascal_string_add(), rz_main_rizin(), and rz_open_binary_rebase_handler().

rz_bin_cur_object()

RZ_API RzBinObject* rz_bin_cur_object

(

RzBin *

bin

)

Definition at line 900 of file bin.c.

                                                  {
    rz_return_val_if_fail(bin, NULL);
    RzBinFile *binfile = rz_bin_cur(bin);
    return binfile ? binfile->o : NULL;
}

References NULL, rz_bin_file_t::o, rz_bin_cur(), and rz_return_val_if_fail.

Referenced by core_file_do_load_for_debug(), core_file_do_load_for_io_plugin(), do_iter_sections(), ds_print_ptr(), is_apple_target(), meta_string_guess_add(), num_callback(), prompt_add_section(), recover_string_at(), rz_analysis_set_stringrefs(), rz_analyze_symbols_entries_handler(), rz_bin_get_classes(), rz_bin_get_entries(), rz_bin_get_fields(), rz_bin_get_imports(), rz_bin_get_info(), rz_bin_get_laddr(), rz_bin_get_libs(), rz_bin_get_mem(), rz_bin_get_sections(), rz_bin_get_size(), rz_bin_get_strings(), rz_bin_get_symbols(), rz_bin_is_static(), rz_bin_set_baddr(), rz_cmd_debug_step_prog_handler(), rz_cmd_info_kuery(), rz_cmd_info_section_bars_handler(), rz_core_analysis_datarefs(), rz_core_analysis_hasrefs_to_depth(), rz_core_analysis_importxrefs(), rz_core_analysis_sigdb_apply(), rz_core_arch_bits_at(), rz_core_bin_load(), rz_core_cmd_foreach3(), rz_core_get_boundaries_prot(), rz_core_get_section_name(), rz_core_visual_cmd(), rz_main_rizin(), strings_print(), and update_sdb().

rz_bin_demangle()

RZ_API RZ_OWN char* rz_bin_demangle	(	RZ_NULLABLE RzBinFile *	bf,
		RZ_NULLABLE const char *	language,
		RZ_NULLABLE const char *	symbol,
		ut64	vaddr,
		bool	libs
	)

Demangles a symbol based on the language or the RzBinFile data.

This function demangles a symbol based on the language or the RzBinFile data When C++ or rust is selected as the language, it will add methods into the RzBinFile structure based on the demangled symbol. When libs is set to true, the demangled symbol will be appended to the library name <libname>_<demangled symbol>.

Parameters

bf	RzBinFile data to be used for demangling
language	Language to be used for demanglind
symbol	Symbol to be demangled
vaddr	vaddr of the symbol to be demangled
libs	Append the library name to the demangled symbol, if set to true

Returns

char* Demangled name of the symbol

Definition at line 1295 of file bin.c.

                                                                                                                                                        {
    if (RZ_STR_ISEMPTY(symbol)) {
        return NULL;
    }
 
    RzBinLanguage type = RZ_BIN_LANGUAGE_UNKNOWN;
    RzBin *bin = bf ? bf->rbin : NULL;
    RzBinObject *o = bf ? bf->o : NULL;
 
    if (!language && o && o->info && o->info->lang) {
        language = o->info->lang;
    }
 
    RzListIter *iter;
    const char *lib = NULL;
    if (!strncmp(symbol, "reloc.", 6)) {
        symbol += 6;
    }
    if (!strncmp(symbol, "sym.", 4)) {
        symbol += 4;
    }
    if (!strncmp(symbol, "imp.", 4)) {
        symbol += 4;
    }
    if (!strncmp(symbol, "target.", 7)) {
        symbol += 7;
    }
    if (o) {
        bool found = false;
        rz_list_foreach (o->libs, iter, lib) {
            size_t len = strlen(lib);
            if (!rz_str_ncasecmp(symbol, lib, len)) {
                symbol += len;
                if (*symbol == '_') {
                    symbol++;
                }
                found = true;
                break;
            }
        }
        if (!found) {
            lib = NULL;
        }
        size_t len = strlen(bin->file);
        if (!rz_str_ncasecmp(symbol, bin->file, len)) {
            lib = bin->file;
            symbol += len;
            if (*symbol == '_') {
                symbol++;
            }
        }
    }
 
    if (RZ_STR_ISEMPTY(symbol)) {
        return NULL;
    }
 
    if (!strncmp(symbol, "__", 2)) {
        if (symbol[2] == 'T') {
            type = RZ_BIN_LANGUAGE_SWIFT;
        } else {
            type = RZ_BIN_LANGUAGE_CXX;
        }
    }
 
    if (type == RZ_BIN_LANGUAGE_UNKNOWN) {
        type = rz_bin_language_to_id(language);
        // ignore "with blocks"
        type = RZ_BIN_LANGUAGE_MASK(type);
        language = rz_bin_language_to_string(type);
    }
    if (!language) {
        return NULL;
    }
    char *demangled = NULL;
    switch (type) {
    case RZ_BIN_LANGUAGE_UNKNOWN: return NULL;
    case RZ_BIN_LANGUAGE_KOTLIN:
        /* fall-thru */
    case RZ_BIN_LANGUAGE_GROOVY:
        /* fall-thru */
    case RZ_BIN_LANGUAGE_DART:
        /* fall-thru */
    case RZ_BIN_LANGUAGE_JAVA: demangled = rz_demangler_java(symbol); break;
    case RZ_BIN_LANGUAGE_OBJC: demangled = rz_demangler_objc(symbol); break;
    case RZ_BIN_LANGUAGE_MSVC: demangled = rz_demangler_msvc(symbol); break;
#if WITH_GPL
    case RZ_BIN_LANGUAGE_RUST: demangled = bin_demangle_rust(bf, symbol, vaddr); break;
    case RZ_BIN_LANGUAGE_CXX: demangled = bin_demangle_cxx(bf, symbol, vaddr); break;
#else
    case RZ_BIN_LANGUAGE_RUST: demangled = NULL; break;
    case RZ_BIN_LANGUAGE_CXX: demangled = NULL; break;
#endif
    default: rz_demangler_resolve(bin->demangler, symbol, language, &demangled);
    }
    if (libs && demangled && lib) {
        char *d = rz_str_newf("%s_%s", lib, demangled);
        free(demangled);
        demangled = d;
    }
    return demangled;
}

References d, found, free(), rz_bin_object_t::info, rz_bin_info_t::lang, len, libs(), rz_bin_object_t::libs, NULL, RZ_BIN_LANGUAGE_CXX, RZ_BIN_LANGUAGE_DART, RZ_BIN_LANGUAGE_GROOVY, RZ_BIN_LANGUAGE_JAVA, RZ_BIN_LANGUAGE_KOTLIN, RZ_BIN_LANGUAGE_MASK, RZ_BIN_LANGUAGE_MSVC, RZ_BIN_LANGUAGE_OBJC, RZ_BIN_LANGUAGE_RUST, RZ_BIN_LANGUAGE_SWIFT, rz_bin_language_to_id(), rz_bin_language_to_string(), RZ_BIN_LANGUAGE_UNKNOWN, rz_demangler_java(), rz_demangler_msvc(), rz_demangler_objc(), rz_demangler_resolve(), RZ_STR_ISEMPTY, rz_str_ncasecmp(), rz_str_newf(), and type.

Referenced by ds_print_relocs(), ds_show_flags(), ds_show_functions(), reloc_set_flag(), rz_bin_bind(), rz_bin_filter_sym(), rz_core_analysis_fcn_name(), rz_core_bin_imports_print(), rz_core_bin_relocs_print(), rz_core_sym_name_init(), symbols(), and symbols_from_mach0().

rz_bin_entry_type_string()

RZ_API const char* rz_bin_entry_type_string

(

int

etype

)

Definition at line 912 of file bin.c.

                                                       {
    switch (etype) {
    case RZ_BIN_ENTRY_TYPE_PROGRAM:
        return "program";
    case RZ_BIN_ENTRY_TYPE_MAIN:
        return "main";
    case RZ_BIN_ENTRY_TYPE_INIT:
        return "init";
    case RZ_BIN_ENTRY_TYPE_FINI:
        return "fini";
    case RZ_BIN_ENTRY_TYPE_TLS:
        return "tls";
    case RZ_BIN_ENTRY_TYPE_PREINIT:
        return "preinit";
    }
    return NULL;
}

References NULL, RZ_BIN_ENTRY_TYPE_FINI, RZ_BIN_ENTRY_TYPE_INIT, RZ_BIN_ENTRY_TYPE_MAIN, RZ_BIN_ENTRY_TYPE_PREINIT, RZ_BIN_ENTRY_TYPE_PROGRAM, and RZ_BIN_ENTRY_TYPE_TLS.

Referenced by entries_initfini_print(), and rz_core_bin_apply_entry().

rz_bin_field_free()

RZ_API void rz_bin_field_free

(

RzBinField *

field

)

Definition at line 950 of file bin.c.

                                                 {
    if (field) {
        free(field->name);
        free(field->visibility_str);
        free(field->type);
        free(field->comment);
        free(field->format);
        free(field);
    }
}

References rz_bin_field_t::comment, rz_bin_field_t::format, free(), rz_bin_field_t::name, rz_bin_field_t::type, and rz_bin_field_t::visibility_str.

Referenced by dex_resolve_fields_in_class(), fields(), get_ivar_list_t(), MACH0_(), rz_bin_dex_fields(), and rz_bin_java_class_fields_as_binfields().

rz_bin_field_new()

RZ_API RzBinField* rz_bin_field_new	(	ut64	paddr,
		ut64	vaddr,
		int	size,
		const char *	name,
		const char *	comment,
		const char *	format,
		bool	format_named
	)

Definition at line 935 of file bin.c.

                                                                                                                                                    {
    RzBinField *ptr = RZ_NEW0(RzBinField);
    if (ptr) {
        ptr->name = strdup(name);
        ptr->comment = (comment && *comment) ? strdup(comment) : NULL;
        ptr->format = (format && *format) ? strdup(format) : NULL;
        ptr->format_named = format_named;
        ptr->paddr = paddr;
        ptr->size = size;
        //  ptr->visibility = any default visibility?
        ptr->vaddr = vaddr;
    }
    return ptr;
}

References rz_bin_field_t::comment, rz_bin_field_t::format, rz_bin_field_t::format_named, rz_bin_field_t::name, NULL, rz_bin_field_t::paddr, RZ_NEW0, rz_bin_field_t::size, strdup(), and rz_bin_field_t::vaddr.

Referenced by classes_from_symbols(), fields(), MACH0_(), and rz_bin_java_class_fields_as_binfields().

rz_bin_file_at()

RZ_API RzBinFile* rz_bin_file_at	(	RzBin *	bin,
		ut64	at
	)

Definition at line 1160 of file bin.c.

                                                      {
    RzListIter *it;
    RzBinFile *bf;
    rz_list_foreach (bin->binfiles, it, bf) {
        if (!bf->o) {
            continue;
        }
        RzBinMap *map = rz_bin_object_get_map_at(bf->o, at, true);
        if (map) {
            return bf;
        }
        if (at >= bf->o->opts.baseaddr && at < (bf->o->opts.baseaddr + bf->size)) {
            return bf;
        }
    }
    return NULL;
}

References rz_bin_file_load_options_t::baseaddr, map(), NULL, rz_bin_file_t::o, rz_bin_object_t::opts, rz_bin_object_get_map_at(), and rz_bin_file_t::size.

Referenced by rz_core_binfiles_delete(), rz_core_seek(), and rz_open_binary_show_handler().

rz_bin_file_free()

RZ_IPI void rz_bin_file_free

(

void *

_bf

)

Definition at line 44 of file bfile.c.

                                          {
    if (!_bf) {
        return;
    }
    RzBinFile *bf = _bf;
    if (bf->rbin->cur == bf) {
        bf->rbin->cur = NULL;
    }
    RzBinPlugin *plugin = rz_bin_file_cur_plugin(bf);
    // Binary format objects are connected to the
    // RzBinObject, so the plugin must destroy the
    // format data first
    if (plugin && plugin->destroy) {
        plugin->destroy(bf);
    }
    rz_buf_free(bf->buf);
    if (bf->curxtr && bf->curxtr->destroy && bf->xtr_obj) {
        bf->curxtr->free_xtr((void *)(bf->xtr_obj));
    }
    free(bf->file);
    rz_bin_object_free(bf->o);
    rz_list_free(bf->xtr_data);
    sdb_free(bf->sdb);
    if (bf->id != -1) {
        // TODO: use rz_storage api
        rz_id_pool_kick_id(bf->rbin->ids->pool, bf->id);
    }
    free(bf);
}

References rz_bin_file_t::buf, rz_bin_t::cur, rz_bin_file_t::curxtr, rz_bin_xtr_plugin_t::destroy, rz_bin_plugin_t::destroy, rz_bin_file_t::file, free(), rz_bin_xtr_plugin_t::free_xtr, rz_bin_file_t::id, rz_bin_t::ids, NULL, rz_bin_file_t::o, rz_id_storage_t::pool, rz_bin_file_t::rbin, rz_bin_file_cur_plugin(), rz_bin_object_free(), rz_buf_free(), rz_id_pool_kick_id(), rz_list_free(), rz_bin_file_t::sdb, sdb_free(), rz_bin_file_t::xtr_data, and rz_bin_file_t::xtr_obj.

Referenced by rz_bin_file_close(), and rz_bin_new().

rz_bin_file_hash_free()

RZ_API void rz_bin_file_hash_free

(

RzBinFileHash *

fhash

)

Definition at line 89 of file bin.c.

                                                        {
    if (fhash) {
        RZ_FREE(fhash->type);
        RZ_FREE(fhash->hex);
        free(fhash);
    }
}

References free(), rz_bin_file_hash_t::hex, RZ_FREE, and rz_bin_file_hash_t::type.

Referenced by rz_bin_file_compute_hashes().

rz_bin_force_plugin()

RZ_API void rz_bin_force_plugin	(	RzBin *	bin,
		const char *	name
	)

Definition at line 906 of file bin.c.

                                                              {
    rz_return_if_fail(bin);
    free(bin->force);
    bin->force = (name && *name) ? strdup(name) : NULL;
}

References free(), name, NULL, rz_return_if_fail, and strdup().

Referenced by cb_binforce(), rz_main_rizin(), and rz_main_rz_bin().

rz_bin_free()

RZ_API void rz_bin_free

(

RzBin *

bin

)

Definition at line 440 of file bin.c.

                                    {
    if (!bin) {
        return;
    }
    bin->file = NULL;
    free(bin->force);
    free(bin->srcdir);
    free(bin->strenc);
    // rz_bin_free_bin_files (bin);
    rz_list_free(bin->binfiles);
    rz_list_free(bin->binxtrs);
    rz_list_free(bin->plugins);
    sdb_free(bin->sdb);
    rz_id_storage_free(bin->ids);
    rz_hash_free(bin->hash);
    rz_event_free(bin->event);
    rz_str_constpool_fini(&bin->constpool);
    rz_demangler_free(bin->demangler);
    free(bin);
}

References free(), NULL, rz_demangler_free(), rz_event_free(), rz_hash_free(), rz_id_storage_free(), rz_list_free(), rz_str_constpool_fini(), and sdb_free().

Referenced by create(), download_pdb(), rz_core_fini(), rz_diff_file_close(), rz_diff_file_open(), and rzfind_open_file().

rz_bin_get_baddr()

RZ_API ut64 rz_bin_get_baddr

(

RzBin *

bin

)

Definition at line 536 of file bin.c.

                                         {
    rz_return_val_if_fail(bin, UT64_MAX);
    return rz_bin_file_get_baddr(bin->cur);
}

References rz_bin_file_get_baddr(), rz_return_val_if_fail, and UT64_MAX.

Referenced by entries_initfini_print(), rz_core_bin_apply_all_info(), rz_core_bin_info_print(), rz_core_file_reopen_remote_debug(), and rz_core_pdb_load_info().

rz_bin_get_binplugin_by_buffer()

RZ_API RzBinPlugin* rz_bin_get_binplugin_by_buffer	(	RzBin *	bin,
		RzBuffer *	buf
	)

Definition at line 349 of file bin.c.

                                                                              {
    RzBinPlugin *plugin;
    RzListIter *it;
 
    rz_return_val_if_fail(bin && buf, NULL);
 
    rz_list_foreach (bin->plugins, it, plugin) {
        if (plugin->check_buffer) {
            if (plugin->check_buffer(buf)) {
                return plugin;
            }
        }
    }
    return NULL;
}

References rz_bin_plugin_t::check_buffer, NULL, and rz_return_val_if_fail.

Referenced by cmd_search_bin(), and get_plugin_from_buffer().

rz_bin_get_binplugin_by_filename()

RZ_IPI RzBinPlugin* rz_bin_get_binplugin_by_filename

(

RzBin *

bin

)

Definition at line 365 of file bin.c.

                                                                 {
    RzBinPlugin *plugin;
    RzListIter *it;
 
    rz_return_val_if_fail(bin, NULL);
 
    const char *filename = strrchr(bin->file, RZ_SYS_DIR[0]);
    filename = filename ? filename + 1 : bin->file;
    rz_list_foreach (bin->plugins, it, plugin) {
        if (plugin->check_filename) {
            if (plugin->check_filename(filename)) {
                return plugin;
            }
        }
    }
    return NULL;
}

References rz_bin_plugin_t::check_filename, NULL, rz_return_val_if_fail, and RZ_SYS_DIR.

Referenced by get_plugin_from_buffer().

rz_bin_get_binplugin_by_name()

RZ_IPI RzBinPlugin* rz_bin_get_binplugin_by_name	(	RzBin *	bin,
		const char *	name
	)

Definition at line 335 of file bin.c.

                                                                               {
    RzBinPlugin *plugin;
    RzListIter *it;
 
    rz_return_val_if_fail(bin && name, NULL);
 
    rz_list_foreach (bin->plugins, it, plugin) {
        if (!strcmp(plugin->name, name)) {
            return plugin;
        }
    }
    return NULL;
}

References rz_bin_plugin_t::name, NULL, and rz_return_val_if_fail.

Referenced by get_plugin_from_buffer(), and rz_bin_create().

rz_bin_get_classes()

RZ_DEPRECATE RZ_API RZ_BORROW RzList* rz_bin_get_classes

(

RZ_NONNULL RzBin *

bin

)

Definition at line 883 of file bin.c.

                                                                                  {
    rz_return_val_if_fail(bin, NULL);
    RzBinObject *o = rz_bin_cur_object(bin);
    return o ? o->classes : NULL;
}

References rz_bin_object_t::classes, NULL, rz_bin_cur_object(), and rz_return_val_if_fail.

Referenced by findClassBounds(), rz_analysis_class_recover_from_rzbin(), rz_core_visual_classes(), and rz_core_visual_hudclasses().

rz_bin_get_entries()

RZ_DEPRECATE RZ_API RZ_BORROW RzList* rz_bin_get_entries

(

RZ_NONNULL RzBin *

bin

)

Definition at line 567 of file bin.c.

                                                                                  {
    rz_return_val_if_fail(bin, NULL);
    RzBinObject *o = rz_bin_cur_object(bin);
    return o ? (RzList *)rz_bin_object_get_entries(o) : NULL;
}

References NULL, rz_bin_cur_object(), rz_bin_object_get_entries(), and rz_return_val_if_fail.

Referenced by initializeEsil(), and rz_core_analysis_all().

rz_bin_get_fields()

RZ_DEPRECATE RZ_API RZ_BORROW RzList* rz_bin_get_fields

(

RZ_NONNULL RzBin *

bin

)

Definition at line 573 of file bin.c.

                                                                                 {
    rz_return_val_if_fail(bin, NULL);
    RzBinObject *o = rz_bin_cur_object(bin);
    return o ? (RzList *)rz_bin_object_get_fields(o) : NULL;
}

References NULL, rz_bin_cur_object(), rz_bin_object_get_fields(), and rz_return_val_if_fail.

rz_bin_get_imports()

RZ_DEPRECATE RZ_API RZ_BORROW RzList* rz_bin_get_imports

(

RZ_NONNULL RzBin *

bin

)

Definition at line 579 of file bin.c.

                                                                                  {
    rz_return_val_if_fail(bin, NULL);
    RzBinObject *o = rz_bin_cur_object(bin);
    return o ? (RzList *)rz_bin_object_get_imports(o) : NULL;
}

References NULL, rz_bin_cur_object(), rz_bin_object_get_imports(), and rz_return_val_if_fail.

Referenced by rz_core_bin_load(), and rz_core_cmd_foreach3().

rz_bin_get_info()

RZ_DEPRECATE RZ_API RZ_BORROW RzBinInfo* rz_bin_get_info

(

RzBin *

bin

)

Definition at line 585 of file bin.c.

                                                                     {
    rz_return_val_if_fail(bin, NULL);
    RzBinObject *o = rz_bin_cur_object(bin);
    return o ? (RzBinInfo *)rz_bin_object_get_info(o) : NULL;
}

References NULL, rz_bin_cur_object(), rz_bin_object_get_info(), and rz_return_val_if_fail.

Referenced by bin_versioninfo(), core_bin_file_print(), get_main_arena_with_symbol(), GetHeapGlobalsOffset(), initializeEsil(), rz_bin_pdb_download(), rz_cmd_info_hashes_handler(), rz_core_bin_info_print(), rz_core_bin_pdb_get_filename(), and rz_core_file_info_print().

rz_bin_get_laddr()

RZ_API ut64 rz_bin_get_laddr

(

RzBin *

bin

)

Definition at line 542 of file bin.c.

                                         {
    rz_return_val_if_fail(bin, UT64_MAX);
    RzBinObject *o = rz_bin_cur_object(bin);
    return o ? o->opts.loadaddr : UT64_MAX;
}

References rz_bin_file_load_options_t::loadaddr, rz_bin_object_t::opts, rz_bin_cur_object(), rz_return_val_if_fail, and UT64_MAX.

Referenced by entries_initfini_print(), rabin_do_operation(), rz_bin_use_arch(), and rz_core_bin_info_print().

rz_bin_get_libs()

RZ_DEPRECATE RZ_API RZ_BORROW RzList* rz_bin_get_libs

(

RZ_NONNULL RzBin *

bin

)

Definition at line 591 of file bin.c.

                                                                               {
    rz_return_val_if_fail(bin, NULL);
    RzBinObject *o = rz_bin_cur_object(bin);
    return o ? (RzList *)rz_bin_object_get_libs(o) : NULL;
}

References NULL, rz_bin_cur_object(), rz_bin_object_get_libs(), and rz_return_val_if_fail.

Referenced by rz_core_bin_load().

rz_bin_get_mem()

RZ_DEPRECATE RZ_API RZ_BORROW RzList* rz_bin_get_mem

(

RZ_NONNULL RzBin *

bin

)

Definition at line 702 of file bin.c.

                                                                              {
    rz_return_val_if_fail(bin, NULL);
    RzBinObject *o = rz_bin_cur_object(bin);
    return o ? (RzList *)rz_bin_object_get_mem(o) : NULL;
}

References NULL, rz_bin_cur_object(), rz_bin_object_get_mem(), and rz_return_val_if_fail.

rz_bin_get_meth_flag_string()

RZ_API const char* rz_bin_get_meth_flag_string	(	ut64	flag,
		bool	compact
	)

Definition at line 961 of file bin.c.

                                                                        {
    switch (flag) {
    case RZ_BIN_METH_CLASS:
        return compact ? "c" : "class";
    case RZ_BIN_METH_STATIC:
        return compact ? "s" : "static";
    case RZ_BIN_METH_PUBLIC:
        return compact ? "p" : "public";
    case RZ_BIN_METH_PRIVATE:
        return compact ? "P" : "private";
    case RZ_BIN_METH_PROTECTED:
        return compact ? "r" : "protected";
    case RZ_BIN_METH_INTERNAL:
        return compact ? "i" : "internal";
    case RZ_BIN_METH_OPEN:
        return compact ? "o" : "open";
    case RZ_BIN_METH_FILEPRIVATE:
        return compact ? "e" : "fileprivate";
    case RZ_BIN_METH_FINAL:
        return compact ? "f" : "final";
    case RZ_BIN_METH_VIRTUAL:
        return compact ? "v" : "virtual";
    case RZ_BIN_METH_CONST:
        return compact ? "k" : "const";
    case RZ_BIN_METH_MUTATING:
        return compact ? "m" : "mutating";
    case RZ_BIN_METH_ABSTRACT:
        return compact ? "a" : "abstract";
    case RZ_BIN_METH_SYNCHRONIZED:
        return compact ? "y" : "synchronized";
    case RZ_BIN_METH_NATIVE:
        return compact ? "n" : "native";
    case RZ_BIN_METH_BRIDGE:
        return compact ? "b" : "bridge";
    case RZ_BIN_METH_VARARGS:
        return compact ? "g" : "varargs";
    case RZ_BIN_METH_SYNTHETIC:
        return compact ? "h" : "synthetic";
    case RZ_BIN_METH_STRICT:
        return compact ? "t" : "strict";
    case RZ_BIN_METH_MIRANDA:
        return compact ? "A" : "miranda";
    case RZ_BIN_METH_CONSTRUCTOR:
        return compact ? "C" : "constructor";
    case RZ_BIN_METH_DECLARED_SYNCHRONIZED:
        return compact ? "Y" : "declared_synchronized";
    default:
        return NULL;
    }
}

References NULL, RZ_BIN_METH_ABSTRACT, RZ_BIN_METH_BRIDGE, RZ_BIN_METH_CLASS, RZ_BIN_METH_CONST, RZ_BIN_METH_CONSTRUCTOR, RZ_BIN_METH_DECLARED_SYNCHRONIZED, RZ_BIN_METH_FILEPRIVATE, RZ_BIN_METH_FINAL, RZ_BIN_METH_INTERNAL, RZ_BIN_METH_MIRANDA, RZ_BIN_METH_MUTATING, RZ_BIN_METH_NATIVE, RZ_BIN_METH_OPEN, RZ_BIN_METH_PRIVATE, RZ_BIN_METH_PROTECTED, RZ_BIN_METH_PUBLIC, RZ_BIN_METH_STATIC, RZ_BIN_METH_STRICT, RZ_BIN_METH_SYNCHRONIZED, RZ_BIN_METH_SYNTHETIC, RZ_BIN_METH_VARARGS, and RZ_BIN_METH_VIRTUAL.

Referenced by flags_to_json(), resolve_method_flags(), and rz_core_bin_method_flags_str().

rz_bin_get_section_at()

RZ_API RZ_BORROW RzBinSection* rz_bin_get_section_at	(	RzBinObject *	o,
		ut64	off,
		int	va
	)

Find the binary section at offset off.

Parameters

o	Reference to the RzBinObject instance
off	Address to search
va	When 0 the offset off is considered a physical address, otherwise a virtual address

Returns

Pointer to a RzBinSection containing the address

Definition at line 611 of file bin.c.

                                                                                       {
    RzBinSection *section;
    RzListIter *iter;
    ut64 from, to;
 
    rz_return_val_if_fail(o, NULL);
    // TODO: must be O(1) .. use sdb here
    rz_list_foreach (o->sections, iter, section) {
        if (section->is_segment) {
            continue;
        }
        from = va ? rz_bin_object_addr_with_base(o, section->vaddr) : section->paddr;
        to = from + (va ? section->vsize : section->size);
        if (off >= from && off < to) {
            return section;
        }
    }
    return NULL;
}

References from, NULL, off, rz_bin_object_addr_with_base(), rz_return_val_if_fail, rz_bin_object_t::sections, section::size, to, and ut64().

Referenced by __get_vsection_at(), ds_print_lines_left(), ds_print_ptr(), num_callback(), print_bin_string(), print_string(), prompt_add_section(), recover_string_at(), rz_bin_object_get_vaddr(), rz_cmd_debug_step_prog_handler(), rz_core_analysis_datarefs(), rz_core_analysis_hasrefs_to_depth(), rz_core_arch_bits_at(), rz_core_get_section_name(), rz_core_visual_cmd(), and strings_print().

rz_bin_get_sections()

RZ_DEPRECATE RZ_API RZ_BORROW RzList* rz_bin_get_sections

(

RZ_NONNULL RzBin *

bin

)

Definition at line 597 of file bin.c.

                                                                                   {
    rz_return_val_if_fail(bin, NULL);
    RzBinObject *o = rz_bin_cur_object(bin);
    return o ? (RzList *)rz_bin_object_get_sections_all(o) : NULL;
}

References NULL, rz_bin_cur_object(), rz_bin_object_get_sections_all(), and rz_return_val_if_fail.

Referenced by __dumpSections(), __save_old_sections(), cb_iova(), core_objc_new(), rz_bin_bind(), rz_core_analysis_recover_golang_functions(), and rz_main_rizin().

rz_bin_get_size()

RZ_API ut64 rz_bin_get_size

(

RzBin *

bin

)

Definition at line 889 of file bin.c.

                                        {
    rz_return_val_if_fail(bin, UT64_MAX);
    RzBinObject *o = rz_bin_cur_object(bin);
    return o ? o->size : 0;
}

References rz_bin_cur_object(), rz_return_val_if_fail, rz_bin_object_t::size, and UT64_MAX.

Referenced by rz_core_bin_info_print(), and rz_core_bin_size_print().

rz_bin_get_strings()

RZ_DEPRECATE RZ_API RZ_BORROW RzList* rz_bin_get_strings

(

RZ_NONNULL RzBin *

bin

)

Definition at line 690 of file bin.c.

                                                                                  {
    rz_return_val_if_fail(bin, NULL);
    RzBinObject *o = rz_bin_cur_object(bin);
    return o ? (RzList *)rz_bin_object_get_strings(o) : NULL;
}

References NULL, rz_bin_cur_object(), rz_bin_object_get_strings(), and rz_return_val_if_fail.

Referenced by core_bin_strings(), DEFINE_HANDLE_TS_FCN_AND_SYMBOL(), and rz_core_cmd_foreach3().

rz_bin_get_symbols()

RZ_DEPRECATE RZ_API RZ_BORROW RzList* rz_bin_get_symbols

(

RZ_NONNULL RzBin *

bin

)

Definition at line 696 of file bin.c.

                                                                                  {
    rz_return_val_if_fail(bin, NULL);
    RzBinObject *o = rz_bin_cur_object(bin);
    return o ? (RzList *)rz_bin_object_get_symbols(o) : NULL;
}

References NULL, rz_bin_cur_object(), rz_bin_object_get_symbols(), and rz_return_val_if_fail.

Referenced by __core_analysis_fcn(), DEFINE_HANDLE_TS_FCN_AND_SYMBOL(), get_va_symbol(), rabin_dump_symbols(), rz_cmd_debug_dmi(), rz_core_analysis_get_stats(), rz_core_analysis_recover_golang_functions(), rz_core_bin_apply_symbols(), rz_core_cmd_foreach3(), and rz_core_debug_bp_add_noreturn_func().

rz_bin_get_xtrplugin_by_name()

RZ_IPI RzBinXtrPlugin* rz_bin_get_xtrplugin_by_name	(	RzBin *	bin,
		const char *	name
	)

Definition at line 383 of file bin.c.

                                                                                  {
    RzBinXtrPlugin *xtr;
    RzListIter *it;
 
    rz_return_val_if_fail(bin && name, NULL);
 
    // TODO: use a hashtable here
    rz_list_foreach (bin->binxtrs, it, xtr) {
        if (!strcmp(xtr->name, name)) {
            return xtr;
        }
        // must be set to null
        xtr = NULL;
    }
    return NULL;
}

References rz_bin_xtr_plugin_t::name, NULL, and rz_return_val_if_fail.

Referenced by rz_bin_file_new().

rz_bin_import_clone()

RZ_API RzBinImport* rz_bin_import_clone

(

RzBinImport *

o

)

Definition at line 125 of file bin.c.

                                                        {
    rz_return_val_if_fail(o, NULL);
 
    RzBinImport *res = rz_mem_dup(o, sizeof(*o));
    if (res) {
        res->name = RZ_STR_DUP(o->name);
        res->classname = RZ_STR_DUP(o->classname);
        res->descriptor = RZ_STR_DUP(o->descriptor);
    }
    return res;
}

References rz_bin_import_t::classname, rz_bin_import_t::descriptor, rz_bin_import_t::name, NULL, rz_mem_dup(), rz_return_val_if_fail, and RZ_STR_DUP.

rz_bin_import_free()

RZ_API void rz_bin_import_free

(

RzBinImport *

imp

)

Definition at line 137 of file bin.c.

                                                 {
    if (imp) {
        RZ_FREE(imp->name);
        RZ_FREE(imp->libname);
        RZ_FREE(imp->classname);
        RZ_FREE(imp->descriptor);
        free(imp);
    }
}

References rz_bin_import_t::classname, rz_bin_import_t::descriptor, free(), rz_bin_import_t::libname, rz_bin_import_t::name, and RZ_FREE.

Referenced by imports(), load_buffer(), rz_bin_dex_imports(), rz_bin_java_class_const_pool_as_imports(), rz_bin_le_get_imports(), rz_bin_le_get_relocs(), and rz_bin_ne_get_imports().

rz_bin_info_free()

RZ_API void rz_bin_info_free

(

RzBinInfo *

rb

)

Definition at line 97 of file bin.c.

                                            {
    if (!rb) {
        return;
    }
 
    rz_list_free(rb->file_hashes);
    free(rb->intrp);
    free(rb->file);
    free(rb->type);
    free(rb->bclass);
    free(rb->rclass);
    free(rb->arch);
    free(rb->cpu);
    free(rb->machine);
    free(rb->os);
    free(rb->features);
    free(rb->subsystem);
    free(rb->default_cc);
    free(rb->rpath);
    free(rb->guid);
    free(rb->debug_file_name);
    free(rb->actual_checksum);
    free(rb->claimed_checksum);
    free(rb->compiler);
    free(rb->head_flag);
    free(rb);
}

References rz_bin_info_t::actual_checksum, rz_bin_info_t::arch, rz_bin_info_t::bclass, rz_bin_info_t::claimed_checksum, rz_bin_info_t::compiler, rz_bin_info_t::cpu, rz_bin_info_t::debug_file_name, rz_bin_info_t::default_cc, rz_bin_info_t::features, rz_bin_info_t::file, rz_bin_info_t::file_hashes, free(), rz_bin_info_t::guid, rz_bin_info_t::head_flag, rz_bin_info_t::intrp, rz_bin_info_t::machine, rz_bin_info_t::os, rz_bin_info_t::rclass, rz_bin_info_t::rpath, rz_list_free(), rz_bin_info_t::subsystem, and rz_bin_info_t::type.

Referenced by load_buffer(), rz_bin_object_free(), and rz_core_bin_load().

rz_bin_is_static()

RZ_DEPRECATE RZ_API int rz_bin_is_static

(

RZ_NONNULL RzBin *

bin

)

Definition at line 708 of file bin.c.

                                                                {
    rz_return_val_if_fail(bin, false);
    RzBinObject *o = rz_bin_cur_object(bin);
    return o ? rz_bin_object_is_static(o) : false;
}

References rz_bin_cur_object(), rz_bin_object_is_static(), and rz_return_val_if_fail.

Referenced by rz_core_bin_info_print().

rz_bin_list_plugin()

RZ_API bool rz_bin_list_plugin	(	RzBin *	bin,
		const char *	name,
		PJ *	pj,
		int	json
	)

Definition at line 510 of file bin.c.

                                                                               {
    RzListIter *it;
    RzBinPlugin *bp;
    RzBinXtrPlugin *bx;
 
    rz_return_val_if_fail(bin && name, false);
 
    rz_list_foreach (bin->plugins, it, bp) {
        if (rz_str_cmp(name, bp->name, strlen(name))) {
            continue;
        }
        return rz_bin_print_plugin_details(bin, bp, pj, json);
    }
    rz_list_foreach (bin->binxtrs, it, bx) {
        if (rz_str_cmp(name, bx->name, strlen(name))) {
            continue;
        }
        __printXtrPluginDetails(bin, bx, json);
        return true;
    }
 
    RZ_LOG_ERROR("Cannot find plugin %s\n", name);
    return false;
}

References __printXtrPluginDetails(), rz_bin_xtr_plugin_t::name, rz_bin_plugin_t::name, rz_bin_print_plugin_details(), RZ_LOG_ERROR, rz_return_val_if_fail, and rz_str_cmp().

Referenced by __listPlugins().

rz_bin_load_filter()

RZ_API void rz_bin_load_filter	(	RzBin *	bin,
		ut64	rules
	)

Definition at line 930 of file bin.c.

                                                       {
    bin->filter_rules = rules;
}

Referenced by rz_main_rz_bin().

rz_bin_map_free()

RZ_API void rz_bin_map_free

(

RzBinMap *

map

)

Definition at line 1023 of file bin.c.

                                           {
    if (!map) {
        return;
    }
    free(map->vfile_name);
    free(map->name);
    free(map);
}

References free(), and map().

Referenced by get_maps_unpatched(), load_buffer(), maps(), and rz_bin_maps_of_file_sections().

rz_bin_maps_of_file_sections()

RZ_API RZ_OWN RzList* rz_bin_maps_of_file_sections

(

RZ_NONNULL RzBinFile *

binfile

)

Create a list of RzBinMap from RzBinSections queried from the given file.

Some binary formats have a 1:1 correspondence of mapping and their RzBinSections. This is not always the case (e.g. ELF) but if it is, plugins can use this function as their maps callback, which will generate mappings for sections.

Definition at line 1040 of file bin.c.

                                                                                    {
    rz_return_val_if_fail(binfile, NULL);
    if (!binfile->o || !binfile->o->plugin || !binfile->o->plugin->sections) {
        return NULL;
    }
    RzList *sections = binfile->o->plugin->sections(binfile);
    if (!sections) {
        return NULL;
    }
    RzList *r = rz_list_newf((RzListFree)rz_bin_map_free);
    if (!r) {
        goto hcf;
    }
    RzBinSection *sec;
    RzListIter *it;
    rz_list_foreach (sections, it, sec) {
        RzBinMap *map = RZ_NEW0(RzBinMap);
        if (!map) {
            goto hcf;
        }
        map->name = sec->name ? strdup(sec->name) : NULL;
        map->paddr = sec->paddr;
        map->psize = sec->size;
        map->vaddr = sec->vaddr;
        map->vsize = sec->vsize;
        map->perm = sec->perm;
        rz_list_push(r, map);
    }
hcf:
    rz_list_free(sections);
    return r;
}

References map(), rz_bin_section_t::name, NULL, rz_bin_section_t::paddr, rz_bin_section_t::perm, r, rz_bin_map_free(), rz_list_free(), rz_list_newf(), rz_list_push(), RZ_NEW0, rz_return_val_if_fail, sections(), rz_bin_section_t::size, strdup(), rz_bin_section_t::vaddr, and rz_bin_section_t::vsize.

Referenced by maps().

rz_bin_new()

RZ_API RzBin* rz_bin_new

(

void

)

Definition at line 716 of file bin.c.

                               {
    int i;
    RzBinXtrPlugin *static_xtr_plugin;
    RzBin *bin = RZ_NEW0(RzBin);
    if (!bin) {
        return NULL;
    }
    /* demanglers */
    bin->demangler = rz_demangler_new();
    if (!bin->demangler) {
        goto trashbin;
    }
    if (!rz_str_constpool_init(&bin->constpool)) {
        goto trashbin_demangler;
    }
    bin->event = rz_event_new(bin);
    if (!bin->event) {
        goto trashbin_constpool;
    }
    bin->force = NULL;
    bin->filter_rules = UT64_MAX;
    bin->sdb = sdb_new0();
    bin->cb_printf = (PrintfCallback)printf;
    bin->plugins = rz_list_newf((RzListFree)rz_bin_plugin_free);
    bin->minstrlen = 0;
    bin->strpurge = NULL;
    bin->strenc = NULL;
    bin->want_dbginfo = true;
    bin->cur = NULL;
    bin->hash = rz_hash_new();
    if (!bin->hash) {
        goto trashbin_event;
    }
 
    bin->ids = rz_id_storage_new(0, ST32_MAX);
 
    /* bin parsers */
    bin->binfiles = rz_list_newf((RzListFree)rz_bin_file_free);
    for (i = 0; i < RZ_ARRAY_SIZE(bin_static_plugins); i++) {
        rz_bin_plugin_add(bin, bin_static_plugins[i]);
    }
    /* extractors */
    bin->binxtrs = rz_list_new();
    bin->binxtrs->free = free;
    for (i = 0; i < RZ_ARRAY_SIZE(bin_xtr_static_plugins); i++) {
        static_xtr_plugin = RZ_NEW0(RzBinXtrPlugin);
        if (!static_xtr_plugin) {
            goto trashbin_binxtrs;
        }
        *static_xtr_plugin = *bin_xtr_static_plugins[i];
        if (!rz_bin_xtr_add(bin, static_xtr_plugin)) {
            free(static_xtr_plugin);
        }
    }
    return bin;
 
trashbin_binxtrs:
    rz_list_free(bin->binxtrs);
    rz_list_free(bin->binfiles);
    rz_id_storage_free(bin->ids);
trashbin_event:
    rz_event_free(bin->event);
trashbin_constpool:
    rz_str_constpool_fini(&bin->constpool);
trashbin_demangler:
    rz_demangler_free(bin->demangler);
trashbin:
    free(bin);
    return NULL;
}

References bin_static_plugins, bin_xtr_static_plugins, free(), i, NULL, printf(), RZ_ARRAY_SIZE, rz_bin_file_free(), rz_bin_plugin_add(), rz_bin_plugin_free(), rz_bin_xtr_add(), rz_demangler_free(), rz_demangler_new(), rz_event_free(), rz_event_new(), rz_hash_new(), rz_id_storage_free(), rz_id_storage_new(), rz_list_free(), rz_list_new(), rz_list_newf(), RZ_NEW0, rz_str_constpool_fini(), rz_str_constpool_init(), sdb_new0(), ST32_MAX, and UT64_MAX.

Referenced by create(), download_pdb(), rz_core_init(), rz_diff_file_open(), and rzfind_open_file().

rz_bin_object_get_map_at()

RZ_API RZ_BORROW RzBinMap* rz_bin_object_get_map_at	(	RZ_NONNULL RzBinObject *	o,
		ut64	off,
		bool	va
	)

Find the last binary map at offset off .

This function returns the last binary map that contains offset off, because it assumes that maps are sorted by priority, thus the last one will be the most important one.

Parameters

o	Reference to the RzBinObject instance
off	Address to search
va	When false the offset off is considered a physical address, otherwise a virtual address

Returns

Pointer to a RzBinMap containing the address

Definition at line 643 of file bin.c.

                                                                                                  {
    rz_return_val_if_fail(o, NULL);
 
    RzBinMap *map;
    RzListIter *iter;
    ut64 from, to;
 
    rz_list_foreach_prev(o->maps, iter, map) {
        from = va ? rz_bin_object_addr_with_base(o, map->vaddr) : map->paddr;
        to = from + (va ? map->vsize : map->psize);
        if (off >= from && off < to) {
            return map;
        }
    }
    return NULL;
}

References from, map(), NULL, off, rz_bin_object_addr_with_base(), rz_return_val_if_fail, to, and ut64().

Referenced by rz_bin_file_at(), rz_bin_object_p2v(), and rz_bin_object_v2p().

rz_bin_object_get_maps_at()

RZ_API RZ_OWN RzPVector* rz_bin_object_get_maps_at	(	RzBinObject *	o,
		ut64	off,
		bool	va
	)

Find all binary maps at offset off .

Parameters

o	Reference to the RzBinObject instance
off	Address to search
va	When false the offset off is considered a physical address, otherwise a virtual address

Returns

Vector of RzBinMap pointers

Definition at line 668 of file bin.c.

                                                                                        {
    rz_return_val_if_fail(o, NULL);
 
    RzBinMap *map;
    RzListIter *iter;
    ut64 from, to;
 
    RzPVector *res = rz_pvector_new(NULL);
    if (!res) {
        return NULL;
    }
 
    rz_list_foreach (o->maps, iter, map) {
        from = va ? rz_bin_object_addr_with_base(o, map->vaddr) : map->paddr;
        to = from + (va ? map->vsize : map->psize);
        if (off >= from && off < to) {
            rz_pvector_push(res, map);
        }
    }
    return res;
}

References from, map(), rz_bin_object_t::maps, NULL, off, rz_bin_object_addr_with_base(), rz_pvector_new(), rz_pvector_push(), rz_return_val_if_fail, to, and ut64().

Referenced by rz_bin_object_p2v_all().

rz_bin_open()

RZ_API RzBinFile* rz_bin_open	(	RzBin *	bin,
		const char *	file,
		RzBinOptions *	opt
	)

Definition at line 200 of file bin.c.

                                                                               {
    rz_return_val_if_fail(bin && bin->iob.io && opt, NULL);
 
    RzIOBind *iob = &(bin->iob);
    if (!iob->desc_get(iob->io, opt->fd)) {
        opt->fd = iob->fd_open(iob->io, file, RZ_PERM_R, 0644);
    }
    if (opt->fd < 0) {
        RZ_LOG_ERROR("Couldn't open bin for file '%s'\n", file);
        return NULL;
    }
    opt->sz = 0;
    opt->pluginname = NULL;
    return rz_bin_open_io(bin, opt);
}

References rz_io_bind_t::desc_get, rz_io_bind_t::fd_open, rz_io_bind_t::io, NULL, rz_bin_open_io(), RZ_LOG_ERROR, RZ_PERM_R, and rz_return_val_if_fail.

Referenced by core_file_do_load_for_debug(), download_pdb(), get_va_symbol(), rz_core_bin_load_structs(), rz_debug_dmp_frames(), rz_main_rz_bin(), and rzfind_open_file().

rz_bin_open_buf()

RZ_API RzBinFile* rz_bin_open_buf	(	RzBin *	bin,
		RzBuffer *	buf,
		RzBinOptions *	opt
	)

Definition at line 238 of file bin.c.

                                                                                {
    rz_return_val_if_fail(bin && opt, NULL);
 
    RzListIter *it;
    RzBinXtrPlugin *xtr;
 
    bin->file = opt->filename;
    if (opt->obj_opts.loadaddr == UT64_MAX) {
        opt->obj_opts.loadaddr = 0;
    }
 
    RzBinFile *bf = NULL;
    if (bin->use_xtr && !opt->pluginname) {
        // XXX - for the time being this is fine, but we may want to
        // change the name to something like
        // <xtr_name>:<bin_type_name>
        rz_list_foreach (bin->binxtrs, it, xtr) {
            if (!xtr->check_buffer) {
                RZ_LOG_ERROR("Missing check_buffer callback for '%s'\n", xtr->name);
                continue;
            }
            if (xtr->check_buffer(buf)) {
                if (xtr->extract_from_buffer || xtr->extractall_from_buffer ||
                    xtr->extract_from_bytes || xtr->extractall_from_bytes) {
                    bf = rz_bin_file_xtr_load_buffer(bin, xtr,
                        bin->file, buf, &opt->obj_opts,
                        opt->xtr_idx, opt->fd);
                }
            }
        }
    }
    if (!bf) {
        // Uncomment for this speedup: 20s vs 22s
        // RzBuffer *buf = rz_buf_new_slurp (bin->file);
        bf = rz_bin_file_new_from_buffer(bin, bin->file, buf,
            &opt->obj_opts, opt->fd, opt->pluginname);
        if (!bf) {
            return NULL;
        }
    }
    rz_bin_file_set_cur_binfile(bin, bf);
    rz_id_storage_set(bin->ids, bin->cur, bf->id);
    return bf;
}

References rz_bin_xtr_plugin_t::check_buffer, rz_bin_xtr_plugin_t::extract_from_buffer, rz_bin_xtr_plugin_t::extract_from_bytes, rz_bin_xtr_plugin_t::extractall_from_buffer, rz_bin_xtr_plugin_t::extractall_from_bytes, bin::fd, rz_bin_file_t::id, rz_bin_xtr_plugin_t::name, NULL, rz_bin_file_new_from_buffer(), rz_bin_file_set_cur_binfile(), rz_bin_file_xtr_load_buffer(), rz_id_storage_set(), RZ_LOG_ERROR, rz_return_val_if_fail, and UT64_MAX.

Referenced by rz_bin_open_io(), and rz_bin_reload().

rz_bin_open_io()

RZ_API RzBinFile* rz_bin_open_io	(	RzBin *	bin,
		RzBinOptions *	opt
	)

Definition at line 283 of file bin.c.

                                                                {
    rz_return_val_if_fail(bin && opt && bin->iob.io, NULL);
    rz_return_val_if_fail(opt->fd >= 0 && (st64)opt->sz >= 0, NULL);
 
    RzIOBind *iob = &(bin->iob);
    RzIO *io = iob ? iob->io : NULL;
 
    bool is_debugger = iob->fd_is_dbg(io, opt->fd);
    const char *fname = iob->fd_get_name(io, opt->fd);
    if (opt->obj_opts.loadaddr == UT64_MAX) {
        opt->obj_opts.loadaddr = 0;
    }
 
    // Create RzBuffer from the opened file
    // When debugging something, we want to open the backed file because
    // not all binary info are mapped in the virtual space. If that is not
    // possible (e.g. remote file) just try to load bin info from the
    // debugee process.
    RzBuffer *buf = NULL;
    if (is_debugger) {
        buf = rz_buf_new_file(fname, O_RDONLY, 0);
        is_debugger = false;
    }
    if (!buf) {
        buf = rz_buf_new_with_io_fd(&bin->iob, opt->fd);
    }
    if (!buf) {
        return NULL;
    }
 
    if (!opt->sz) {
        opt->sz = rz_buf_size(buf);
    }
 
    // Slice buffer if necessary
    RzBuffer *slice = buf;
    if (!is_debugger && (opt->obj_opts.loadaddr != 0 || opt->sz != rz_buf_size(buf))) {
        slice = rz_buf_new_slice(buf, opt->obj_opts.loadaddr, opt->sz);
    } else if (is_debugger && opt->obj_opts.baseaddr != UT64_MAX && opt->obj_opts.baseaddr != 0) {
        slice = rz_buf_new_slice(buf, opt->obj_opts.baseaddr, opt->sz);
    }
    if (slice != buf) {
        rz_buf_free(buf);
        buf = slice;
    }
 
    opt->filename = fname;
    RzBinFile *bf = rz_bin_open_buf(bin, buf, opt);
    rz_buf_free(buf);
    return bf;
}

References bin::fd, rz_io_bind_t::fd_get_name, rz_io_bind_t::fd_is_dbg, create_tags_rz::fname, rz_io_bind_t::io, NULL, O_RDONLY, rz_bin_open_buf(), rz_buf_free(), rz_buf_new_file(), rz_buf_new_slice(), rz_buf_new_with_io_fd(), rz_buf_size(), rz_return_val_if_fail, st64, and UT64_MAX.

Referenced by cmd_search_bin(), core_file_do_load_for_io_plugin(), get_bin_info(), GetHeapGlobalsOffset(), map_multi_dex(), rz_bin_open(), rz_diff_file_open(), rz_main_rizin(), rz_open_binary_add_handler(), and rz_open_binary_file_handler().

rz_bin_options_init()

RZ_API void rz_bin_options_init	(	RzBinOptions *	opt,
		int	fd,
		ut64	baseaddr,
		ut64	loadaddr,
		bool	patch_relocs
	)

Definition at line 75 of file bin.c.

                                                                                                            {
    memset(opt, 0, sizeof(*opt));
    opt->obj_opts.baseaddr = baseaddr;
    opt->obj_opts.loadaddr = loadaddr;
    opt->obj_opts.patch_relocs = patch_relocs;
    opt->obj_opts.elf_load_sections = true;
    opt->fd = fd;
}

References baseaddr, fd, memset(), and patch_relocs().

Referenced by core_file_do_load_for_debug(), get_va_symbol(), rz_bin_reload(), rz_core_bin_options_init(), rz_diff_file_open(), rz_main_rz_bin(), and rzfind_open_file().

rz_bin_plugin_add()

RZ_API bool rz_bin_plugin_add	(	RzBin *	bin,
		RzBinPlugin *	foo
	)

Definition at line 404 of file bin.c.

                                                            {
    RzListIter *it;
    RzBinPlugin *plugin;
 
    rz_return_val_if_fail(bin && foo, false);
 
    rz_list_foreach (bin->plugins, it, plugin) {
        if (!strcmp(plugin->name, foo->name)) {
            return false;
        }
    }
    plugin = RZ_NEW0(RzBinPlugin);
    memcpy(plugin, foo, sizeof(RzBinPlugin));
    rz_list_append(bin->plugins, plugin);
    return true;
}

References foo, memcpy(), rz_bin_plugin_t::name, rz_main_t::name, rz_list_append(), RZ_NEW0, and rz_return_val_if_fail.

Referenced by __lib_bin_cb(), and rz_bin_new().

rz_bin_plugin_free()

static void rz_bin_plugin_free ( RzBinPlugin *  p )

static

Definition at line 400 of file bin.c.

                                               {
    RZ_FREE(p);
}

References p, and RZ_FREE.

Referenced by rz_bin_new().

rz_bin_plugin_get()

RZ_API const RzBinPlugin* rz_bin_plugin_get	(	RZ_NONNULL RzBin *	bin,
		RZ_NONNULL const char *	name
	)

Get a RzBinPlugin by name.

Definition at line 1197 of file bin.c.

                                                                                                {
    rz_return_val_if_fail(bin && name, NULL);
 
    RzListIter *iter;
    RzBinPlugin *bp;
 
    rz_list_foreach (bin->plugins, iter, bp) {
        if (!strcmp(bp->name, name)) {
            return bp;
        }
    }
    return NULL;
}

References rz_bin_plugin_t::name, NULL, and rz_return_val_if_fail.

Referenced by rz_cmd_info_plugins_handler().

rz_bin_print_plugin_details()

static bool rz_bin_print_plugin_details ( RzBin *  bin, RzBinPlugin *  bp, PJ *  pj, int  json  )

static

Definition at line 461 of file bin.c.

                                                                                       {
    if (json == 'q') {
        bin->cb_printf("%s\n", bp->name);
    } else if (json) {
        pj_o(pj);
        pj_ks(pj, "name", bp->name);
        pj_ks(pj, "description", bp->desc);
        pj_ks(pj, "license", bp->license ? bp->license : "???");
        pj_end(pj);
    } else {
        bin->cb_printf("Name: %s\n", bp->name);
        bin->cb_printf("Description: %s\n", bp->desc);
        if (bp->license) {
            bin->cb_printf("License: %s\n", bp->license);
        }
        if (bp->version) {
            bin->cb_printf("Version: %s\n", bp->version);
        }
        if (bp->author) {
            bin->cb_printf("Author: %s\n", bp->author);
        }
    }
    return true;
}

References rz_bin_plugin_t::author, rz_bin_plugin_t::desc, rz_bin_plugin_t::license, rz_bin_plugin_t::name, pj_end(), pj_ks(), pj_o(), and rz_bin_plugin_t::version.

Referenced by rz_bin_list_plugin().

rz_bin_reload()

RZ_API RzBinFile* rz_bin_reload	(	RzBin *	bin,
		RzBinFile *	bf,
		ut64	baseaddr
	)

Definition at line 216 of file bin.c.

                                                                          {
    rz_return_val_if_fail(bin && bf, NULL);
 
    bool big_endian = bf->o ? bf->o->opts.big_endian : false;
    bool patch_relocs = bf->o ? bf->o->opts.patch_relocs : false;
    bool elf_load_sections = bf->o ? bf->o->opts.elf_load_sections : false;
    bool elf_checks_sections = bf->o ? bf->o->opts.elf_checks_sections : false;
    bool elf_checks_segments = bf->o ? bf->o->opts.elf_checks_segments : false;
 
    RzBinOptions opt;
    rz_bin_options_init(&opt, bf->fd, baseaddr, bf->loadaddr, patch_relocs);
    opt.obj_opts.elf_load_sections = elf_load_sections;
    opt.obj_opts.elf_checks_sections = elf_checks_sections;
    opt.obj_opts.elf_checks_segments = elf_checks_segments;
    opt.obj_opts.big_endian = big_endian;
    opt.filename = bf->file;
    rz_buf_seek(bf->buf, 0, RZ_BUF_SET);
    RzBinFile *nbf = rz_bin_open_buf(bin, bf->buf, &opt);
    rz_bin_file_delete(bin, bf);
    return nbf;
}

References baseaddr, rz_bin_file_load_options_t::big_endian, rz_bin_file_t::buf, rz_bin_file_load_options_t::elf_checks_sections, rz_bin_file_load_options_t::elf_checks_segments, rz_bin_file_load_options_t::elf_load_sections, rz_bin_file_t::fd, rz_bin_file_t::file, rz_bin_file_t::loadaddr, NULL, rz_bin_file_t::o, rz_bin_object_t::opts, patch_relocs(), rz_bin_file_load_options_t::patch_relocs, rz_bin_file_delete(), rz_bin_open_buf(), rz_bin_options_init(), rz_buf_seek(), RZ_BUF_SET, and rz_return_val_if_fail.

Referenced by core_bin_reload().

rz_bin_reloc_free()

RZ_API void rz_bin_reloc_free

(

RzBinReloc *

reloc

)

Definition at line 188 of file bin.c.

                                                 {
    free(reloc);
}

References free().

Referenced by rz_bin_le_get_relocs(), and rz_bin_reloc_storage_free().

rz_bin_resource_free()

RZ_API void rz_bin_resource_free

(

RzBinResource *

res

)

Definition at line 147 of file bin.c.

                                                     {
    if (!res) {
        return;
    }
    RZ_FREE(res->name);
    RZ_FREE(res->time);
    RZ_FREE(res->type);
    RZ_FREE(res->language);
    free(res);
}

References free(), rz_bin_resource_t::language, rz_bin_resource_t::name, RZ_FREE, rz_bin_resource_t::time, and rz_bin_resource_t::type.

rz_bin_section_flag_to_list()

RZ_API RZ_OWN RzList* rz_bin_section_flag_to_list	(	RzBin *	bin,
		ut64	flag
	)

Converts the RzBinSection flags to a list of string representations.

Some binary formats have a function interface called "section_flag_to_rzlist" The returned string flag names are different between formats

Parameters

bin	RzBin instance
flag	A flag field of the RzBinSection (differs between formats)

Definition at line 1151 of file bin.c.

                                                                           {
    RzBinFile *a = rz_bin_cur(bin);
    RzBinPlugin *plugin = rz_bin_file_cur_plugin(a);
    if (plugin && plugin->section_flag_to_rzlist) {
        return plugin->section_flag_to_rzlist(flag);
    }
    return NULL;
}

References a, NULL, rz_bin_cur(), rz_bin_file_cur_plugin(), and rz_bin_plugin_t::section_flag_to_rzlist.

Referenced by sections_print_json(), and sections_print_table().

rz_bin_section_free()

RZ_API void rz_bin_section_free

(

RzBinSection *

bs

)

Definition at line 1116 of file bin.c.

                                                  {
    if (bs) {
        free(bs->name);
        free(bs->format);
        free(bs);
    }
}

References rz_bin_section_t::format, free(), and rz_bin_section_t::name.

Referenced by get_segments(), load_buffer(), rz_bin_dex_sections(), rz_bin_le_get_sections(), rz_bin_mz_get_segments(), rz_bin_ne_get_segments(), rz_bin_sections_of_maps(), section_free(), and sections().

rz_bin_section_new()

RZ_API RzBinSection* rz_bin_section_new

(

const char *

name

)

Definition at line 1108 of file bin.c.

                                                          {
    RzBinSection *s = RZ_NEW0(RzBinSection);
    if (s) {
        s->name = name ? strdup(name) : NULL;
    }
    return s;
}

References NULL, RZ_NEW0, s, and strdup().

Referenced by get_segments().

rz_bin_section_type_to_string()

RZ_API RZ_OWN char* rz_bin_section_type_to_string	(	RzBin *	bin,
		int	type
	)

Converts the RzBinSection type to the string representation.

Some binary formats have a function interface called "section_type_to_string" The returned string type name is different between formats

Parameters

bin	RzBin instance
type	A type field of the RzBinSection (differs between formats)

Definition at line 1133 of file bin.c.

                                                                        {
    RzBinFile *a = rz_bin_cur(bin);
    RzBinPlugin *plugin = rz_bin_file_cur_plugin(a);
    if (plugin && plugin->section_type_to_string) {
        return plugin->section_type_to_string(type);
    }
    return NULL;
}

References a, NULL, rz_bin_cur(), rz_bin_file_cur_plugin(), rz_bin_plugin_t::section_type_to_string, and type.

Referenced by sections_print_json(), and sections_print_table().

rz_bin_sections_of_maps()

RZ_API RzList* rz_bin_sections_of_maps

(

RzList *

maps

)

Create a list of RzBinSection from RzBinMaps.

Some binary formats have a 1:1 correspondence of mapping and some of their RzBinSections, but also want to add some unmapped sections. In this case, they can implement their mapped sections in their maps callback, then in their sections callback use this function to create sections from them and add some additional ones. See also rz_bin_maps_of_file_sections() for the inverse, when no additional sections should be added.

Definition at line 1084 of file bin.c.

                                                         {
    rz_return_val_if_fail(maps, NULL);
    RzList *ret = rz_list_newf((RzListFree)rz_bin_section_free);
    if (!ret) {
        return NULL;
    }
    RzListIter *it;
    RzBinMap *map;
    rz_list_foreach (maps, it, map) {
        RzBinSection *sec = RZ_NEW0(RzBinSection);
        if (!sec) {
            break;
        }
        sec->name = map->name ? strdup(map->name) : NULL;
        sec->paddr = map->paddr;
        sec->size = map->psize;
        sec->vaddr = map->vaddr;
        sec->vsize = map->vsize;
        sec->perm = map->perm;
        rz_list_append(ret, sec);
    }
    return ret;
}

References map(), maps(), rz_bin_section_t::name, NULL, rz_bin_section_t::paddr, rz_bin_section_t::perm, rz_bin_section_free(), rz_list_append(), rz_list_newf(), RZ_NEW0, rz_return_val_if_fail, rz_bin_section_t::size, strdup(), rz_bin_section_t::vaddr, and rz_bin_section_t::vsize.

Referenced by sections().

rz_bin_select()

RZ_API bool rz_bin_select	(	RzBin *	bin,
		const char *	arch,
		int	bits,
		const char *	name
	)

Definition at line 813 of file bin.c.

                                                                                    {
    rz_return_val_if_fail(bin, false);
 
    RzBinFile *cur = rz_bin_cur(bin);
    RzBinObject *obj = NULL;
    name = !name && cur ? cur->file : name;
    RzBinFile *binfile = rz_bin_file_find_by_arch_bits(bin, arch, bits);
    if (binfile && name) {
        obj = rz_bin_object_find_by_arch_bits(binfile, arch, bits, name);
    }
    return rz_bin_file_set_obj(bin, binfile, obj);
}

References arch, bits(), rz_bin_file_t::file, name, NULL, rz_bin_cur(), rz_bin_file_find_by_arch_bits(), rz_bin_file_set_obj(), rz_bin_object_find_by_arch_bits(), and rz_return_val_if_fail.

Referenced by rz_main_rz_bin().

rz_bin_select_bfid()

RZ_API bool rz_bin_select_bfid	(	RzBin *	bin,
		ut32	bf_id
	)

Definition at line 833 of file bin.c.

                                                       {
    rz_return_val_if_fail(bin, false);
    RzBinFile *bf = rz_bin_file_find_by_id(bin, bf_id);
    return bf ? rz_bin_file_set_obj(bin, bf, NULL) : false;
}

References NULL, rz_bin_file_find_by_id(), rz_bin_file_set_obj(), and rz_return_val_if_fail.

Referenced by rz_core_bin_raise(), and rz_core_seek().

rz_bin_select_object()

RZ_API int rz_bin_select_object	(	RzBinFile *	binfile,
		const char *	arch,
		int	bits,
		const char *	name
	)

Definition at line 826 of file bin.c.

                                                                                                  {
    rz_return_val_if_fail(binfile, false);
    RzBinObject *obj = rz_bin_object_find_by_arch_bits(binfile, arch, bits, name);
    return rz_bin_file_set_obj(binfile->rbin, binfile, obj);
}

References arch, bits(), rz_bin_file_t::rbin, rz_bin_file_set_obj(), rz_bin_object_find_by_arch_bits(), and rz_return_val_if_fail.

rz_bin_set_baddr()

RZ_API void rz_bin_set_baddr	(	RzBin *	bin,
		ut64	baddr
	)

Definition at line 549 of file bin.c.

                                                     {
    rz_return_if_fail(bin);
    RzBinFile *bf = rz_bin_cur(bin);
    RzBinObject *o = rz_bin_cur_object(bin);
    if (!o || !o->plugin || !o->plugin->baddr) {
        return;
    }
    ut64 file_baddr = o->plugin->baddr(bf);
    if (baddr == UT64_MAX) {
        o->opts.baseaddr = file_baddr;
        o->baddr_shift = 0; // o->baddr; // - file_baddr;
    } else if (file_baddr != UT64_MAX) {
        o->opts.baseaddr = baddr;
        o->baddr_shift = baddr - file_baddr;
    }
}

References baddr(), rz_bin_plugin_t::baddr, rz_bin_object_t::baddr_shift, rz_bin_file_load_options_t::baseaddr, rz_bin_object_t::opts, rz_bin_object_t::plugin, rz_bin_cur(), rz_bin_cur_object(), rz_return_if_fail, ut64(), and UT64_MAX.

Referenced by rebase_helper(), rz_bin_object_new(), rz_cmd_debug_dmi(), and rz_main_rz_bin().

rz_bin_set_user_ptr()

RZ_API void rz_bin_set_user_ptr	(	RzBin *	bin,
		void *	user
	)

Definition at line 839 of file bin.c.

                                                        {
    bin->user = user;
}

Referenced by rz_core_init().

rz_bin_string_free()

RZ_API void rz_bin_string_free

(

void *

_str

)

Definition at line 192 of file bin.c.

                                           {
    RzBinString *str = (RzBinString *)_str;
    if (str) {
        free(str->string);
        free(str);
    }
}

References free(), and cmd_descs_generate::str.

Referenced by add_new_bin_string(), create_string_search_thread(), rz_bin_dex_strings(), rz_bin_file_strings(), rz_bin_java_class_strings(), rz_bin_string_database_new(), and search_string_thread_runner().

rz_bin_symbol_free()

RZ_API void rz_bin_symbol_free

(

RzBinSymbol *

sym

)

Definition at line 175 of file bin.c.

                                                 {
    if (!sym) {
        return;
    }
 
    free(sym->name);
    free(sym->dname);
    free(sym->libname);
    free(sym->classname);
    free(sym->visibility_str);
    free(sym);
}

References rz_bin_symbol_t::classname, rz_bin_symbol_t::dname, free(), rz_bin_symbol_t::libname, rz_bin_symbol_t::name, and rz_bin_symbol_t::visibility_str.

Referenced by add_new_func_symbol(), dex_resolve_fields_in_class_as_symbols(), dex_resolve_methods_in_class(), get_symbols_list(), le_get_symbol(), le_get_symbols_at(), load_buffer(), luac_build_info(), resolve_mig_subsystem(), resolve_syscalls(), rz_bin_dex_symbols(), rz_bin_java_class_const_pool_as_symbols(), rz_bin_java_class_fields_as_symbols(), rz_bin_java_class_methods_as_symbols(), rz_bin_le_get_symbols(), rz_bin_ne_get_symbols(), rz_bin_pe_get_clr_symbols(), symbols(), and walkSymbols().

rz_bin_symbol_name()

RZ_API const char* rz_bin_symbol_name

(

RzBinSymbol *

s

)

Definition at line 158 of file bin.c.

                                                      {
    if (s->dup_count) {
        return sdb_fmt("%s_%d", s->name, s->dup_count);
    }
    return s->name;
}

References s, and sdb_fmt().

Referenced by rz_core_sym_name_init().

rz_bin_symbol_new()

RZ_API RzBinSymbol* rz_bin_symbol_new	(	const char *	name,
		ut64	paddr,
		ut64	vaddr
	)

Definition at line 165 of file bin.c.

                                                                                {
    RzBinSymbol *sym = RZ_NEW0(RzBinSymbol);
    if (sym) {
        sym->name = name ? strdup(name) : NULL;
        sym->paddr = paddr;
        sym->vaddr = vaddr;
    }
    return sym;
}

References rz_bin_symbol_t::name, NULL, rz_bin_symbol_t::paddr, RZ_NEW0, strdup(), and rz_bin_symbol_t::vaddr.

Referenced by add_new_func_symbol(), rz_bin_java_class_const_pool_as_symbols(), rz_bin_java_class_fields_as_symbols(), and rz_bin_java_class_methods_as_symbols().

rz_bin_trycatch_free()

RZ_API void rz_bin_trycatch_free

(

RzBinTrycatch *

tc

)

Definition at line 1190 of file bin.c.

                                                    {
    free(tc);
}

References free().

Referenced by trycatch().

rz_bin_trycatch_new()

RZ_API RzBinTrycatch* rz_bin_trycatch_new	(	ut64	source,
		ut64	from,
		ut64	to,
		ut64	handler,
		ut64	filter
	)

Definition at line 1178 of file bin.c.

                                                                                                      {
    RzBinTrycatch *tc = RZ_NEW0(RzBinTrycatch);
    if (tc) {
        tc->source = source;
        tc->from = from;
        tc->to = to;
        tc->handler = handler;
        tc->filter = filter;
    }
    return tc;
}

References rz_bin_trycatch_t::filter, filter(), rz_bin_trycatch_t::from, from, rz_bin_trycatch_t::handler, RZ_NEW0, rz_bin_trycatch_t::source, source, rz_bin_trycatch_t::to, and to.

Referenced by trycatch().

rz_bin_use_arch()

RZ_API bool rz_bin_use_arch	(	RzBin *	bin,
		const char *	arch,
		int	bits,
		const char *	name
	)

Definition at line 787 of file bin.c.

                                                                                      {
    rz_return_val_if_fail(bin && arch, false);
 
    RzBinFile *binfile = rz_bin_file_find_by_arch_bits(bin, arch, bits);
    if (!binfile) {
        RZ_LOG_WARN("Cannot find binfile with arch/bits %s/%d\n", arch, bits);
        return false;
    }
 
    RzBinObject *obj = rz_bin_object_find_by_arch_bits(binfile, arch, bits, name);
    if (!obj && binfile->xtr_data) {
        RzBinXtrData *xtr_data = rz_list_get_n(binfile->xtr_data, 0);
        if (xtr_data && !xtr_data->loaded) {
            RzBinObjectLoadOptions obj_opts = {
                .baseaddr = UT64_MAX,
                .loadaddr = rz_bin_get_laddr(bin)
            };
            if (!rz_bin_file_object_new_from_xtr_data(bin, binfile, &obj_opts, xtr_data)) {
                return false;
            }
        }
        obj = binfile->o;
    }
    return rz_bin_file_set_obj(bin, binfile, obj);
}

References arch, rz_bin_file_load_options_t::baseaddr, bits(), rz_bin_xtr_extract_t::loaded, rz_bin_file_t::o, rz_bin_file_find_by_arch_bits(), rz_bin_file_object_new_from_xtr_data(), rz_bin_file_set_obj(), rz_bin_get_laddr(), rz_bin_object_find_by_arch_bits(), rz_list_get_n(), RZ_LOG_WARN, rz_return_val_if_fail, UT64_MAX, and rz_bin_file_t::xtr_data.

Referenced by rz_core_bin_set_arch_bits().

rz_bin_virtual_file_free()

RZ_API void rz_bin_virtual_file_free

(

RzBinVirtualFile *

vfile

)

Definition at line 1012 of file bin.c.

                                                              {
    if (!vfile) {
        return;
    }
    if (vfile->buf_owned) {
        rz_buf_free(vfile->buf);
    }
    free(vfile->name);
    free(vfile);
}

References rz_bin_virtual_file_t::buf, rz_bin_virtual_file_t::buf_owned, free(), rz_bin_virtual_file_t::name, and rz_buf_free().

Referenced by get_virtual_files(), and virtual_files().

rz_bin_xtr_add()

RZ_API bool rz_bin_xtr_add	(	RzBin *	bin,
		RzBinXtrPlugin *	foo
	)

Definition at line 421 of file bin.c.

                                                            {
    RzListIter *it;
    RzBinXtrPlugin *xtr;
 
    rz_return_val_if_fail(bin && foo, false);
 
    if (foo->init) {
        foo->init(bin->user);
    }
    // avoid duplicates
    rz_list_foreach (bin->binxtrs, it, xtr) {
        if (!strcmp(xtr->name, foo->name)) {
            return false;
        }
    }
    rz_list_append(bin->binxtrs, foo);
    return true;
}

References foo, rz_bin_xtr_plugin_t::name, rz_main_t::name, rz_list_append(), and rz_return_val_if_fail.

Referenced by __lib_bin_xtr_cb(), and rz_bin_new().

rz_bin_xtrdata_free()

RZ_API void rz_bin_xtrdata_free

(

void *

data_

)

Definition at line 61 of file bin.c.

                                               {
    RzBinXtrData *data = data_;
    rz_return_if_fail(data);
    if (data->metadata) {
        free(data->metadata->libname);
        free(data->metadata->arch);
        free(data->metadata->machine);
        free(data->metadata);
    }
    free(data->file);
    rz_buf_free(data->buf);
    free(data);
}

References rz_bin_xtr_metadata_t::arch, rz_bin_xtr_extract_t::buf, rz_bin_xtr_extract_t::file, free(), rz_bin_xtr_metadata_t::libname, rz_bin_xtr_metadata_t::machine, rz_bin_xtr_extract_t::metadata, rz_buf_free(), and rz_return_if_fail.

Referenced by oneshotall(), oneshotall_buffer(), and rz_bin_file_new().

rz_bin_xtrdata_new()

RZ_API RzBinXtrData* rz_bin_xtrdata_new	(	RzBuffer *	buf,
		ut64	offset,
		ut64	size,
		ut32	file_count,
		RzBinXtrMetadata *	metadata
	)

Definition at line 47 of file bin.c.

                                                                                                                            {
    RzBinXtrData *data = RZ_NEW0(RzBinXtrData);
    if (data) {
        data->offset = offset;
        data->size = size;
        data->file_count = file_count;
        data->metadata = metadata;
        data->loaded = 0;
        // don't slice twice TODO. review this
        data->buf = rz_buf_ref(buf); // rz_buf_new_slice (buf, offset, size);
    }
    return data;
}

References rz_bin_xtr_extract_t::buf, rz_bin_xtr_extract_t::file_count, rz_bin_xtr_extract_t::loaded, rz_bin_xtr_extract_t::metadata, rz_bin_xtr_extract_t::offset, rz_buf_ref(), RZ_NEW0, and rz_bin_xtr_extract_t::size.

Referenced by extract(), oneshot(), and oneshot_buffer().

rz_bin_xtrplugin_get()

RZ_API const RzBinXtrPlugin* rz_bin_xtrplugin_get	(	RZ_NONNULL RzBin *	bin,
		RZ_NONNULL const char *	name
	)

Get a RzBinXtrPlugin by name.

Definition at line 1214 of file bin.c.

                                                                                                      {
    rz_return_val_if_fail(bin && name, NULL);
 
    RzListIter *iter;
    RzBinXtrPlugin *bp;
 
    rz_list_foreach (bin->binxtrs, iter, bp) {
        if (!strcmp(bp->name, name)) {
            return bp;
        }
    }
    return NULL;
}

References rz_bin_xtr_plugin_t::name, NULL, and rz_return_val_if_fail.

Referenced by rz_cmd_info_plugins_handler().

RZ_LIB_VERSION()

RZ_LIB_VERSION

(

rz_bin

)

Variable Documentation

bin_static_plugins

RzBinPlugin* bin_static_plugins[] = { RZ_BIN_STATIC_PLUGINS }

static

Definition at line 25 of file bin.c.

Referenced by rz_bin_new().

bin_xtr_static_plugins

RzBinXtrPlugin* bin_xtr_static_plugins[] = { RZ_BIN_XTR_STATIC_PLUGINS }

static

Definition at line 26 of file bin.c.

Referenced by rz_bin_new().