pdb_downloader.h File Reference

#include <rz_types.h>
#include <rz_bin.h>

Go to the source code of this file.

Classes
struct	SPDBOptions
struct	SPDBDownloaderOpt
struct	SPDBDownloader

Typedefs
typedef struct SPDBOptions	SPDBOptions
typedef struct SPDBDownloaderOpt	SPDBDownloaderOpt
typedef struct SPDBDownloader	SPDBDownloader

Functions
RZ_API int	rz_bin_pdb_download (RZ_NONNULL RzBin *bin, RZ_NULLABLE PJ *pj, int isradjson, RZ_NONNULL SPDBOptions *options)
	Download PDB file for currently opened RzBin file. More...
RZ_API RZ_OWN char *	rz_bin_symserver_download (RZ_NONNULL const SPDBDownloaderOpt *options)
	downloads file from symbol server More...

Typedef Documentation

SPDBDownloader

typedef struct SPDBDownloader SPDBDownloader

SPDBDownloaderOpt

typedef struct SPDBDownloaderOpt SPDBDownloaderOpt

SPDBOptions

typedef struct SPDBOptions SPDBOptions

Function Documentation

rz_bin_pdb_download()

RZ_API int rz_bin_pdb_download	(	RZ_NONNULL RzBin *	bin,
		RZ_NULLABLE PJ *	pj,
		int	isradjson,
		RZ_NONNULL SPDBOptions *	options
	)

Download PDB file for currently opened RzBin file.

Parameters

bin	RzBin instance
pj	Optional PJ instance for json output
isradjson	Use pj for json output
options	symbol server options for downloading the PDB file

Definition at line 171 of file pdb_downloader.c.

                                                                                                                          {
    rz_return_val_if_fail(bin && options, 1);
    SPDBDownloaderOpt opt;
    RzBinInfo *info = rz_bin_get_info(bin);
 
    if (!info || !info->debug_file_name) {
        RZ_LOG_ERROR("Can't find debug filename\n");
        return 1;
    }
 
    if (!is_valid_guid(info->guid)) {
        RZ_LOG_ERROR("Invalid GUID for file\n");
        return 1;
    }
 
    if (!options->symbol_server || !options->symbol_store_path) {
        RZ_LOG_ERROR("Can't retrieve pdb configurations\n");
        return 1;
    }
 
    opt.dbg_file = rz_file_dos_basename(info->debug_file_name);
    opt.guid = info->guid;
    opt.symbol_server = options->symbol_server;
    opt.symbol_store_path = options->symbol_store_path;
    opt.extract = options->extract;
 
    char *path = rz_bin_symserver_download(&opt);
 
    if (isradjson) {
        pj_ko(pj, "pdb");
        pj_ks(pj, "file", opt.dbg_file);
        pj_ks(pj, "guid", opt.guid);
        pj_ks(pj, "path", path);
        pj_kb(pj, "download", (bool)path);
        pj_end(pj);
    } else {
        rz_cons_printf("PDB \"%s\" download %s\n",
            opt.dbg_file, path ? "success" : "failed");
    }
    free(path);
    return !path;
}

References SPDBDownloaderOpt::dbg_file, rz_bin_info_t::debug_file_name, SPDBDownloaderOpt::extract, free(), SPDBDownloaderOpt::guid, rz_bin_info_t::guid, info(), is_valid_guid(), options, path, pj_end(), pj_kb(), pj_ko(), pj_ks(), rz_bin_get_info(), rz_bin_symserver_download(), rz_cons_printf(), rz_file_dos_basename(), RZ_LOG_ERROR, rz_return_val_if_fail, SPDBDownloaderOpt::symbol_server, and SPDBDownloaderOpt::symbol_store_path.

Referenced by download_pdb(), GetHeapGlobalsOffset(), rz_cmd_info_pdb_download_handler(), and rz_main_rz_bin().

rz_bin_symserver_download()

RZ_API RZ_OWN char* rz_bin_symserver_download

(

RZ_NONNULL const SPDBDownloaderOpt *

options

)

downloads file from symbol server

Parameters

options

options for downloading file

Returns

char* is the path that file was downloaded to or NULL in case of failure

Definition at line 219 of file pdb_downloader.c.

                                                                                           {
    rz_return_val_if_fail(options, NULL);
    SPDBDownloader downloader;
    SPDBDownloaderOpt opt = *options;
    char *path = NULL;
    char *symbol_server = strdup(options->symbol_server);
    char *server = strtok(symbol_server, ";");
    while (server && !path) {
        opt.symbol_server = server;
        init_pdb_downloader(&opt, &downloader);
        if (!downloader.download) {
            break;
        }
        path = downloader.download(&downloader);
        deinit_pdb_downloader(&downloader);
        server = strtok(NULL, ";");
    }
    free(symbol_server);
    return path;
}

References deinit_pdb_downloader(), SPDBDownloader::download, free(), init_pdb_downloader(), NULL, options, path, rz_return_val_if_fail, strdup(), and SPDBDownloaderOpt::symbol_server.

Referenced by rz_bin_pdb_download(), and winkd_download_module_and_pdb().