Skip to content

utils.binary

Binary utility modules.

utils.binary.deplibs

Get dependent libraries.

Function Prototype

API

lua
local deps = deplibs(binaryfile: <string>, opt: <table>)

Parameter Description

ParameterDescription
binaryfileRequired. Input binary file path
optOptional. Options:
- plat: Platform
- arch: Architecture
- recursive: Recursively get all sub-dependencies (default: false)
- resolve_path: Try to resolve the file full path (default: false)
- resolve_hint_paths: Resolve paths from hints
- resolve_search_paths: Search library paths (e.g. LD_LIBRARY_PATH)
- check_cycle: Check for circular dependencies

Return Value

Return ValueDescription
<table>Dependent libraries list

utils.binary.readsyms

Read symbols from object file.

Function Prototype

API

lua
local syms = readsyms(binaryfile: <string>)

Parameter Description

ParameterDescription
binaryfileRequired. Input object file path

Return Value

Return ValueDescription
<table>Symbols list

utils.binary.extractlib

Extract static library to directory.

Function Prototype

API

lua
extractlib(libraryfile: <string>, outputdir: <string>, opt: <table>)

Parameter Description

ParameterDescription
libraryfileRequired. Input static library file path
outputdirRequired. Output directory path
optOptional. Options

utils.binary.rpath.list

Get rpath list.

Function Prototype

API

lua
local rpaths = rpath.list(binaryfile: <string>, opt: <table>)

Parameter Description

ParameterDescription
binaryfileRequired. Input binary file path
optOptional. Options

Return Value

Return ValueDescription
<table>Rpath list

utils.binary.rpath.insert

Insert rpath.

Function Prototype

API

lua
rpath.insert(binaryfile: <string>, rpath_path: <string>, opt: <table>)

Parameter Description

ParameterDescription
binaryfileRequired. Input binary file path
rpath_pathRequired. Rpath path to insert
optOptional. Options

utils.binary.rpath.change

Change rpath.

Function Prototype

API

lua
rpath.change(binaryfile: <string>, rpath_old: <string>, rpath_new: <string>, opt: <table>)

Parameter Description

ParameterDescription
binaryfileRequired. Input binary file path
rpath_oldRequired. Old rpath path
rpath_newRequired. New rpath path
optOptional. Options

utils.binary.rpath.remove

Remove rpath.

Function Prototype

API

lua
rpath.remove(binaryfile: <string>, rpath_path: <string>, opt: <table>)

Parameter Description

ParameterDescription
binaryfileRequired. Input binary file path
rpath_pathRequired. Rpath path to remove
optOptional. Options

utils.binary.rpath.clean

Clean all rpaths.

Function Prototype

API

lua
rpath.clean(binaryfile: <string>, opt: <table>)

Parameter Description

ParameterDescription
binaryfileRequired. Input binary file path
optOptional. Options