// Copyright (c) 2020-2026 Vector 35 Inc
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to
// deal in the Software without restriction, including without limitation the
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
// sell copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
// IN THE SOFTWARE.
#include "binaryninjaapi.h"
using namespace std;
using namespace BinaryNinja;
BNLinearDisassemblyLine LinearDisassemblyLine::GetAPIObject() const
{
BNLinearDisassemblyLine result;
result.type = this->type;
Ref binaryView = this->view;
if (!binaryView && this->function)
binaryView = this->function->GetView();
result.view = binaryView ? BNNewViewReference(binaryView->GetObject()) : nullptr;
result.function = this->function ? BNNewFunctionReference(this->function->GetObject()) : nullptr;
result.block = this->block ? BNNewBasicBlockReference(this->block->GetObject()) : nullptr;
result.contents = this->contents.GetAPIObject();
return result;
}
LinearDisassemblyLine LinearDisassemblyLine::FromAPIObject(const BNLinearDisassemblyLine* line)
{
LinearDisassemblyLine result;
result.type = line->type;
result.view = line->view ? new BinaryView(BNNewViewReference(line->view)) : nullptr;
result.function = line->function ? new Function(BNNewFunctionReference(line->function)) : nullptr;
result.block = line->block ? new BasicBlock(BNNewBasicBlockReference(line->block)) : nullptr;
result.contents = DisassemblyTextLine::FromAPIObject(&line->contents);
return result;
}
void LinearDisassemblyLine::FreeAPIObject(BNLinearDisassemblyLine* line)
{
if (line->view)
BNFreeBinaryView(line->view);
if (line->function)
BNFreeFunction(line->function);
if (line->block)
BNFreeBasicBlock(line->block);
DisassemblyTextLine::FreeAPIObject(&line->contents);
}
LinearViewObjectIdentifier::LinearViewObjectIdentifier() : type(SingleLinearViewObject), start(0), end(0) {}
LinearViewObjectIdentifier::LinearViewObjectIdentifier(const string& _name) :
name(_name), type(SingleLinearViewObject), start(0), end(0)
{}
LinearViewObjectIdentifier::LinearViewObjectIdentifier(const string& _name, uint64_t addr) :
name(_name), type(AddressLinearViewObject), start(addr), end(addr)
{}
LinearViewObjectIdentifier::LinearViewObjectIdentifier(const string& _name, uint64_t _start, uint64_t _end) :
name(_name), type(AddressRangeLinearViewObject), start(_start), end(_end)
{}
LinearViewObjectIdentifier::LinearViewObjectIdentifier(const LinearViewObjectIdentifier& other) :
name(other.name), type(other.type), start(other.start), end(other.end)
{}
LinearViewObject::LinearViewObject(BNLinearViewObject* obj)
{
m_object = obj;
}
Ref LinearViewObject::GetFirstChild()
{
BNLinearViewObject* result = BNGetFirstLinearViewObjectChild(m_object);
if (result)
return new LinearViewObject(result);
return nullptr;
}
Ref LinearViewObject::GetLastChild()
{
BNLinearViewObject* result = BNGetLastLinearViewObjectChild(m_object);
if (result)
return new LinearViewObject(result);
return nullptr;
}
Ref LinearViewObject::GetPreviousChild(LinearViewObject* obj)
{
BNLinearViewObject* result = BNGetPreviousLinearViewObjectChild(m_object, obj->GetObject());
if (result)
return new LinearViewObject(result);
return nullptr;
}
Ref LinearViewObject::GetNextChild(LinearViewObject* obj)
{
BNLinearViewObject* result = BNGetNextLinearViewObjectChild(m_object, obj->GetObject());
if (result)
return new LinearViewObject(result);
return nullptr;
}
Ref LinearViewObject::GetChildForAddress(uint64_t addr)
{
BNLinearViewObject* result = BNGetLinearViewObjectChildForAddress(m_object, addr);
if (result)
return new LinearViewObject(result);
return nullptr;
}
Ref LinearViewObject::GetChildForIdentifier(const LinearViewObjectIdentifier& id)
{
BNLinearViewObjectIdentifier lvid;
lvid.name = BNAllocString(id.name.c_str());
lvid.type = id.type;
lvid.start = id.start;
lvid.end = id.end;
BNLinearViewObject* result = BNGetLinearViewObjectChildForIdentifier(m_object, &lvid);
BNFreeString(lvid.name);
if (result)
return new LinearViewObject(result);
return nullptr;
}
int LinearViewObject::CompareChildren(LinearViewObject* a, LinearViewObject* b)
{
return BNCompareLinearViewObjectChildren(m_object, a->GetObject(), b->GetObject());
}
vector LinearViewObject::GetLines(LinearViewObject* prev, LinearViewObject* next)
{
size_t count;
BNLinearDisassemblyLine* lines = BNGetLinearViewObjectLines(
m_object, prev ? prev->GetObject() : nullptr, next ? next->GetObject() : nullptr, &count);
vector result;
result.reserve(count);
for (size_t i = 0; i < count; i++)
result.push_back(LinearDisassemblyLine::FromAPIObject(&lines[i]));
BNFreeLinearDisassemblyLines(lines, count);
return result;
}
uint64_t LinearViewObject::GetStart() const
{
return BNGetLinearViewObjectStart(m_object);
}
uint64_t LinearViewObject::GetEnd() const
{
return BNGetLinearViewObjectEnd(m_object);
}
LinearViewObjectIdentifier LinearViewObject::GetIdentifier() const
{
BNLinearViewObjectIdentifier id = BNGetLinearViewObjectIdentifier(m_object);
LinearViewObjectIdentifier result;
result.name = id.name;
result.type = id.type;
result.start = id.start;
result.end = id.end;
BNFreeLinearViewObjectIdentifier(&id);
return result;
}
uint64_t LinearViewObject::GetOrderingIndexTotal() const
{
return BNGetLinearViewObjectOrderingIndexTotal(m_object);
}
uint64_t LinearViewObject::GetOrderingIndexForChild(LinearViewObject* obj) const
{
return BNGetLinearViewObjectOrderingIndexForChild(m_object, obj->GetObject());
}
Ref LinearViewObject::GetChildForOrderingIndex(uint64_t idx)
{
BNLinearViewObject* result = BNGetLinearViewObjectChildForOrderingIndex(m_object, idx);
if (result)
return new LinearViewObject(result);
return nullptr;
}
Ref LinearViewObject::CreateDisassembly(BinaryView* view, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewDisassembly(view->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateLiftedIL(BinaryView* view, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewLiftedIL(view->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateLowLevelIL(BinaryView* view, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewLowLevelIL(view->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateLowLevelILSSAForm(BinaryView* view, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewLowLevelILSSAForm(view->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateMediumLevelIL(BinaryView* view, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewMediumLevelIL(view->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateMediumLevelILSSAForm(BinaryView* view, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewMediumLevelILSSAForm(view->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateMappedMediumLevelIL(BinaryView* view, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewMappedMediumLevelIL(view->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateMappedMediumLevelILSSAForm(
BinaryView* view, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewMappedMediumLevelILSSAForm(view->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateHighLevelIL(BinaryView* view, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewHighLevelIL(view->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateHighLevelILSSAForm(BinaryView* view, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewHighLevelILSSAForm(view->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateLanguageRepresentation(BinaryView* view, DisassemblySettings* settings,
const string& language)
{
return new LinearViewObject(
BNCreateLinearViewLanguageRepresentation(view->GetObject(), settings ? settings->GetObject() : nullptr, language.c_str()));
}
Ref LinearViewObject::CreateDataOnly(BinaryView* view, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewDataOnly(view->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateSingleFunctionDisassembly(Function* func, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewSingleFunctionDisassembly(func->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateSingleFunctionLiftedIL(Function* func, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewSingleFunctionLiftedIL(func->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateSingleFunctionLowLevelIL(Function* func, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewSingleFunctionLowLevelIL(func->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateSingleFunctionLowLevelILSSAForm(
Function* func, DisassemblySettings* settings)
{
return new LinearViewObject(BNCreateLinearViewSingleFunctionLowLevelILSSAForm(
func->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateSingleFunctionMediumLevelIL(Function* func, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewSingleFunctionMediumLevelIL(func->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateSingleFunctionMediumLevelILSSAForm(
Function* func, DisassemblySettings* settings)
{
return new LinearViewObject(BNCreateLinearViewSingleFunctionMediumLevelILSSAForm(
func->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateSingleFunctionMappedMediumLevelIL(
Function* func, DisassemblySettings* settings)
{
return new LinearViewObject(BNCreateLinearViewSingleFunctionMappedMediumLevelIL(
func->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateSingleFunctionMappedMediumLevelILSSAForm(
Function* func, DisassemblySettings* settings)
{
return new LinearViewObject(BNCreateLinearViewSingleFunctionMappedMediumLevelILSSAForm(
func->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateSingleFunctionHighLevelIL(Function* func, DisassemblySettings* settings)
{
return new LinearViewObject(
BNCreateLinearViewSingleFunctionHighLevelIL(func->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateSingleFunctionHighLevelILSSAForm(
Function* func, DisassemblySettings* settings)
{
return new LinearViewObject(BNCreateLinearViewSingleFunctionHighLevelILSSAForm(
func->GetObject(), settings ? settings->GetObject() : nullptr));
}
Ref LinearViewObject::CreateSingleFunctionLanguageRepresentation(
Function* func, DisassemblySettings* settings, const string& language)
{
return new LinearViewObject(BNCreateLinearViewSingleFunctionLanguageRepresentation(
func->GetObject(), settings ? settings->GetObject() : nullptr, language.c_str()));
}