sympath.cpp File Reference

.sympath command More...

#include "pch.h"

Functions
VOID	CommandSympathHelp ()
	help of the .sympath command
VOID	CommandSympath (vector< CommandToken > CommandTokens, string Command)
	.sympath command handler

Detailed Description

.sympath command

Author

Sina Karvandi (sina@.nosp@m.hype.nosp@m.rdbg..nosp@m.org)

Version

0.1

Date

2021-05-27

Copyright

This project is released under the GNU Public License v3.

Function Documentation

CommandSympath()

VOID CommandSympath	(	vector< CommandToken >	CommandTokens,
		string	Command )

.sympath command handler

Parameters

CommandTokens
Command

Returns

VOID

{
    string SymbolServer = "";
    string Token;
 
    if (CommandTokens.size() == 1)
    {
        //
        // Show the current symbol path
        //
        if (!CommandSettingsGetValueFromConfigFile("SymbolServer", SymbolServer))
        {
            ShowMessages("symbol server is not configured, please use '.help .sympath'\n");
        }
        else
        {
            ShowMessages("current symbol server is : %s\n", SymbolServer.c_str());
        }
    }
    else
    {
        //
        // Save the symbol path
        //
 
        //
        // Because technically, the "https://" is containing characters that resemble the command token,
        // it's better to use the symbol server in quotes, but due to the fact that for compatibility reasons,
        // with the previous versions, we should support the old syntax, we should check if the symbol server
        // is in quotes or not to support both syntaxes
        //
 
        //
        // Trim the command
        //
        Trim(Command);
 
        //
        // Remove .sympath from it
        //
        Command.erase(0, GetCaseSensitiveStringFromCommandToken(CommandTokens.at(0)).size());
 
        //
        // Trim it again
        //
        Trim(Command);
 
        //
        // Check if the symbol server starts with quotes
        //
        if (Command.at(0) == '\"')
        {
            //
            // Means that the symbol server is in quotes
            //
            Command = GetCaseSensitiveStringFromCommandToken(CommandTokens.at(1));
        }
 
        //
        // *** validate the symbols ***
        //
 
        //
        // Check if the string contains '*'
        //
        CHAR Delimiter = '*';
        if (Command.find(Delimiter) != std::string::npos)
        {
            //
            // Found
            //
            Token = Command.substr(0, Command.find(Delimiter));
            // using transform() function and ::tolower in STL
            transform(Token.begin(), Token.end(), Token.begin(), ::tolower);
 
            //
            // Check if it starts with srv
            //
            if (!Token.compare("srv"))
            {
                //
                // Save the config
                //
                CommandSettingsSetValueFromConfigFile("SymbolServer", Command);
 
                //
                // Show the message
                //
                ShowMessages("symbol server/path is configured successfully\n");
                ShowMessages("use '.sym load', '.sym reload', or '.sym download' to load pdb files\n");
            }
            else
            {
                ShowMessages("symbol path is invalid\n\n");
                CommandSympathHelp();
                return;
            }
        }
        else
        {
            ShowMessages("symbol path is invalid\n\n");
            CommandSympathHelp();
            return;
        }
    }
}

CommandSympathHelp()

VOID CommandSympathHelp

(

)

help of the .sympath command

Returns

VOID

{
    ShowMessages(".sympath : shows and sets the symbol server and path.\n\n");
 
    ShowMessages("syntax : \t.sympath\n");
    ShowMessages("syntax : \t.sympath [SymServer (string)]\n");
 
    ShowMessages("\n");
    ShowMessages("\t\te.g : .sympath\n");
    ShowMessages("\t\te.g : .sympath \"SRV*c:\\Symbols*https://msdl.microsoft.com/download/symbols\" \n");
}