xref: /netbsd-src/external/bsd/elftosb/dist/elftosb2/ConversionController.h (revision 993229b6fea628ff8b1fa09146c80b0cfb2768eb)

/*
 * File:	ConversionController.h
 *
 * Copyright (c) Freescale Semiconductor, Inc. All rights reserved.
 * See included license file for license details.
 */
#if !defined(_ConversionController_h_)
#define _ConversionController_h_

#include <iostream>
#include <fstream>
#include <string>
#include <stdexcept>
#include <smart_ptr.h>
#include <ElftosbLexer.h>
#include <ElftosbAST.h>
#include "EvalContext.h"
#include "Value.h"
#include "SourceFile.h"
#include "Operation.h"
#include "DataSource.h"
#include "DataTarget.h"
#include "OutputSection.h"
#include "BootImage.h"
#include "OptionDictionary.h"
#include "BootImageGenerator.h"

namespace elftosb
{

/*!
 * \brief Manages the entire elftosb file conversion process.
 *
 * Instances of this class are intended to be used only once. There is no
 * way to reset an instance once it has started or completed a conversion.
 * Thus the run() method is not reentrant. State information is stored in
 * the object during the conversion process.
 *
 * Two things need to be done before the conversion can be started. The
 * command file path has to be set with the setCommandFilePath() method,
 * and the paths of any externally provided (i.e., from the command line)
 * files need to be added with addExternalFilePath(). Once these tasks
 * are completed, the run() method can be called to parse and execute the
 * command file. After run() returns, pass an instance of
 * BootImageGenerator to the generateOutput() method in order to get
 * an instance of BootImage that can be written to the output file.
 */
class ConversionController : public OptionDictionary, public EvalContext::SourceFileManager
{
public:
	//! \brief Default constructor.
	ConversionController();

	//! \brief Destructor.
	virtual ~ConversionController();

	//! \name Paths
	//@{
	//! \brief Specify the command file that controls the conversion process.
	void setCommandFilePath(const std::string & path);

	//! \brief Specify the path of a file provided by the user from outside the command file.
	void addExternalFilePath(const std::string & path);
	//@}

	//! \name Conversion
	//@{
	//! \brief Process input files.
	void run();

	//! \brief Uses a BootImageGenerator object to create the final output boot image.
	BootImage * generateOutput(BootImageGenerator * generator);
	//@}

	//! \name SourceFileManager interface
	//@{
	//! \brief Returns true if a source file with the name \a name exists.
	virtual bool hasSourceFile(const std::string & name);

	//! \brief Gets the requested source file.
	virtual SourceFile * getSourceFile(const std::string & name);

	//! \brief Returns the default source file, or NULL if none is set.
	virtual SourceFile * getDefaultSourceFile();
	//@}

	//! \brief Returns a reference to the context used for expression evaluation.
	inline EvalContext & getEvalContext() { return m_context; }

protected:
	//! \name AST processing
	//@{
	void parseCommandFile();
	void processOptions(ListASTNode * options);
	void processConstants(ListASTNode * constants);
	void processSources(ListASTNode * sources);
	void processSections(ListASTNode * sections);
	OutputSection * convertDataSection(DataSectionContentsASTNode * dataSection, uint32_t sectionID, OptionDictionary * optionsDict);
	//@}

	//! \name Statement conversion
	//@{
	OperationSequence * convertStatementList(ListASTNode * statements);
	OperationSequence * convertOneStatement(StatementASTNode * statement);
	OperationSequence * convertLoadStatement(LoadStatementASTNode * statement);
	OperationSequence * convertCallStatement(CallStatementASTNode * statement);
	OperationSequence * convertFromStatement(FromStatementASTNode * statement);
	OperationSequence * convertModeStatement(ModeStatementASTNode * statement);
	OperationSequence * convertIfStatement(IfStatementASTNode * statement);
	void handleMessageStatement(MessageStatementASTNode * statement);
	//@}

	//! \name Utilities
	//@{
	Value * convertAssignmentNodeToValue(ASTNode * node, std::string & ident);
	SourceFile * getSourceFromName(std::string * sourceName, int line);
	DataSource * createSourceFromNode(ASTNode * dataNode);
	DataTarget * createTargetFromNode(ASTNode * targetNode);
	std::string * substituteVariables(const std::string * message);
    DataSource * createIVTDataSource(IVTConstASTNode * ivtNode);
	//@}

	//! \name Debugging
	//@{
	void testLexer(ElftosbLexer & lexer);
	void printIntConstExpr(const std::string & ident, IntConstExprASTNode * expr);
	//@}

protected:
	typedef std::map<std::string, SourceFile*> source_map_t;	//!< Map from source name to object.
	typedef std::vector<std::string> path_vector_t;	//!< List of file paths.
	typedef std::vector<OutputSection*> section_vector_t;	//!< List of output sections.
	typedef std::vector<std::string> source_name_vector_t;	//!< List of source names.

	smart_ptr<std::string> m_commandFilePath;	//!< Path to command file.
	smart_ptr<CommandFileASTNode> m_ast;	//!< Root of the abstract syntax tree.
	EvalContext m_context;	//!< Evaluation context for expressions.
	source_map_t m_sources;	//!< Map of source names to file objects.
	path_vector_t m_externPaths;	//!< Paths provided on the command line by the user.
	SourceFile * m_defaultSource;	//!< Source to use when one isn't provided.
	section_vector_t m_outputSections;	//!< List of output sections the user wants.
	source_name_vector_t m_failedSources;	//!< List of sources that failed to open successfully.
};

//! \brief Whether to support HAB keywords during parsing.
//!
//! This is a standalone global solely so that the bison-generated parser code can get to it
//! as simply as possible.
extern bool g_enableHABSupport;

}; // namespace elftosb

#endif // _ConversionController_h_