summaryrefslogtreecommitdiff
path: root/xmake/modules/utils/binary
diff options
context:
space:
mode:
Diffstat (limited to 'xmake/modules/utils/binary')
-rw-r--r--xmake/modules/utils/binary/bin2c.lua130
-rw-r--r--xmake/modules/utils/binary/bin2obj.lua170
2 files changed, 300 insertions, 0 deletions
diff --git a/xmake/modules/utils/binary/bin2c.lua b/xmake/modules/utils/binary/bin2c.lua
new file mode 100644
index 000000000..ce7336e36
--- /dev/null
+++ b/xmake/modules/utils/binary/bin2c.lua
@@ -0,0 +1,130 @@
+--!A cross-platform build utility based on Lua
+--
+-- Licensed under the Apache License, Version 2.0 (the "License");
+-- you may not use this file except in compliance with the License.
+-- You may obtain a copy of the License at
+--
+-- http://www.apache.org/licenses/LICENSE-2.0
+--
+-- Unless required by applicable law or agreed to in writing, software
+-- distributed under the License is distributed on an "AS IS" BASIS,
+-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+-- See the License for the specific language governing permissions and
+-- limitations under the License.
+--
+-- Copyright (C) 2015-present, Xmake Open Source Community.
+--
+-- @author ruki
+-- @file bin2c.lua
+--
+
+-- imports
+import("core.base.bytes")
+import("core.base.option")
+
+local options = {
+ {'w', "linewidth", "kv", nil, "Set the line width"},
+ {nil, "nozeroend", "k", false, "Disable to patch zero terminating character"},
+ {'i', "binarypath", "kv", nil, "Set the binary file path."},
+ {'o', "outputpath", "kv", nil, "Set the output file path."}
+}
+
+function _do_dump(binarydata, outputfile, opt)
+ local i = 0
+ local n = 147
+ local p = 0
+ local e = binarydata:size()
+ local line = nil
+ local linewidth = opt.linewidth or 32
+ local first = true
+ while p < e do
+ line = ""
+ if p + linewidth <= e then
+ for i = 0, linewidth - 1 do
+ if first then
+ first = false
+ line = line .. " "
+ else
+ line = line .. ","
+ end
+ line = line .. string.format(" 0x%02X", binarydata[p + i + 1])
+ end
+ outputfile:print(line)
+ p = p + linewidth
+ elseif p < e then
+ local left = e - p
+ for i = 0, left - 1 do
+ if first then
+ first = false
+ line = line .. " "
+ else
+ line = line .. ","
+ end
+ line = line .. string.format(" 0x%02X", binarydata[p + i + 1])
+ end
+ outputfile:print(line)
+ p = p + left
+ else
+ break
+ end
+ end
+end
+
+function _do_bin2c(binarypath, outputpath, opt)
+
+ -- init source directory and options
+ opt = opt or {}
+ binarypath = path.absolute(binarypath)
+ outputpath = path.absolute(outputpath)
+ assert(os.isfile(binarypath), "%s not found!", binarypath)
+
+ -- trace
+ print("generating code data file from %s ..", binarypath)
+
+ -- optimize the default linewidth for reading large file
+ if not opt.linewidth then
+ local filesize = os.filesize(binarypath)
+ if filesize > 1024 * 1024 * 1024 then
+ opt.linewidth = 512
+ elseif filesize > 100 * 1024 * 1024 then
+ opt.linewidth = 256
+ elseif filesize > 10 * 1024 * 1024 then
+ opt.linewidth = 128
+ elseif filesize > 1024 * 1024 then
+ opt.linewidth = 64
+ else
+ opt.linewidth = 32
+ end
+ end
+
+ -- do dump
+ if utils.bin2c then
+ utils.bin2c(binarypath, outputpath, opt)
+ else
+ local binarydata = bytes(io.readfile(binarypath, {encoding = "binary"}))
+ local outputfile = io.open(outputpath, 'w')
+ if outputfile then
+ if not opt.nozeroend then
+ binarydata = binarydata .. bytes('\0')
+ end
+ _do_dump(binarydata, outputfile, opt)
+ outputfile:close()
+ end
+ end
+
+ -- trace
+ cprint("${bright}%s generated!", outputpath)
+end
+
+function main(...)
+
+ -- parse arguments
+ local argv = {...}
+ local opt = option.parse(argv, options, "Print c/c++ code files from the given binary file."
+ , ""
+ , "Usage: xmake l utils.binary.bin2c [options]")
+
+ -- do bin2c
+ _do_bin2c(opt.binarypath, opt.outputpath, opt)
+end
+
diff --git a/xmake/modules/utils/binary/bin2obj.lua b/xmake/modules/utils/binary/bin2obj.lua
new file mode 100644
index 000000000..afb04dc3b
--- /dev/null
+++ b/xmake/modules/utils/binary/bin2obj.lua
@@ -0,0 +1,170 @@
+--!A cross-platform build utility based on Lua
+--
+-- Licensed under the Apache License, Version 2.0 (the "License");
+-- you may not use this file except in compliance with the License.
+-- You may obtain a copy of the License at
+--
+-- http://www.apache.org/licenses/LICENSE-2.0
+--
+-- Unless required by applicable law or agreed to in writing, software
+-- distributed under the License is distributed on an "AS IS" BASIS,
+-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+-- See the License for the specific language governing permissions and
+-- limitations under the License.
+--
+-- Copyright (C) 2015-present, Xmake Open Source Community.
+--
+-- @author ruki
+-- @file bin2obj.lua
+--
+
+-- imports
+import("core.base.option")
+
+local options = {
+ {'i', "binarypath", "kv", nil, "Set the binary file path."},
+ {'o', "outputpath", "kv", nil, "Set the output object file path."},
+ {'f', "format", "kv", nil, "Set the object file format (coff, elf, macho)."},
+ {nil, "symbol_prefix", "kv", nil, "Set the symbol prefix (default: _binary_)."},
+ {'a', "arch", "kv", nil, "Set the target architecture."},
+ {'p', "plat", "kv", nil, "Set the target platform (macosx, iphoneos, etc.)."},
+ {nil, "target_minver", "kv", nil, "Set the target minimum version (e.g., 10.0, 18.2)."},
+ {nil, "xcode_sdkver", "kv", nil, "Set the Xcode SDK version (e.g., 10.0, 18.2)."},
+ {nil, "zeroend", "k", nil, "Append a null terminator ('\\0') at the end of data."}
+}
+
+function _do_bin2obj_coff(binarypath, outputpath, opt)
+ -- get symbol prefix
+ local symbol_prefix = opt.symbol_prefix or "_binary_"
+
+ -- get architecture (default: x86_64)
+ local arch = opt.arch or "x86_64"
+
+ -- get zeroend (default: false)
+ local zeroend = opt.zeroend or false
+
+ -- get filename from binary path (with extension, dots replaced with underscores)
+ local filename = path.filename(binarypath)
+ -- replace dots with underscores for symbol name (e.g., data.bin -> data_bin)
+ local basename = filename:gsub("%.", "_")
+
+ -- trace
+ print("converting binary file %s to COFF object file %s ..", binarypath, outputpath)
+
+ -- do dump
+ if utils.bin2coff then
+ utils.bin2coff(binarypath, outputpath, symbol_prefix, arch, basename, zeroend)
+ else
+ raise("bin2obj: utils.bin2coff not available (C implementation not compiled)")
+ end
+
+ -- trace
+ cprint("${bright}%s generated!", outputpath)
+end
+
+function _do_bin2obj_elf(binarypath, outputpath, opt)
+ -- get symbol prefix
+ local symbol_prefix = opt.symbol_prefix or "_binary_"
+
+ -- get architecture (default: x86_64)
+ local arch = opt.arch or "x86_64"
+
+ -- get zeroend (default: false)
+ local zeroend = opt.zeroend or false
+
+ -- get filename from binary path (with extension, dots replaced with underscores)
+ local filename = path.filename(binarypath)
+ -- replace dots with underscores for symbol name (e.g., data.bin -> data_bin)
+ local basename = filename:gsub("%.", "_")
+
+ -- trace
+ print("converting binary file %s to ELF object file %s ..", binarypath, outputpath)
+
+ -- do dump
+ if utils.bin2elf then
+ utils.bin2elf(binarypath, outputpath, symbol_prefix, arch, basename, zeroend)
+ else
+ raise("bin2obj: utils.bin2elf not available (C implementation not compiled)")
+ end
+
+ -- trace
+ cprint("${bright}%s generated!", outputpath)
+end
+
+function _do_bin2obj_macho(binarypath, outputpath, opt)
+ -- get symbol prefix
+ local symbol_prefix = opt.symbol_prefix or "_binary_"
+
+ -- get platform (default: macosx)
+ local plat = opt.plat or "macosx"
+
+ -- get architecture (default: x86_64)
+ local arch = opt.arch or "x86_64"
+
+ -- get target minimum version (default: nil, will use default 10.0.0 in C)
+ local target_minver = opt.target_minver
+
+ -- get xcode sdk version (default: nil, will use default 10.0.0 in C)
+ local xcode_sdkver = opt.xcode_sdkver
+
+ -- get zeroend (default: false)
+ local zeroend = opt.zeroend or false
+
+ -- get filename from binary path (with extension, dots replaced with underscores)
+ local filename = path.filename(binarypath)
+ -- replace dots with underscores for symbol name (e.g., data.bin -> data_bin)
+ local basename = filename:gsub("%.", "_")
+
+ -- trace
+ print("converting binary file %s to Mach-O object file %s ..", binarypath, outputpath)
+
+ -- do dump
+ if utils.bin2macho then
+ utils.bin2macho(binarypath, outputpath, symbol_prefix, plat, arch, basename, target_minver, xcode_sdkver, zeroend)
+ else
+ raise("bin2obj: utils.bin2macho not available (C implementation not compiled)")
+ end
+
+ -- trace
+ cprint("${bright}%s generated!", outputpath)
+end
+
+function _do_bin2obj(binarypath, outputpath, opt)
+
+ -- init source directory and options
+ opt = opt or {}
+ binarypath = path.absolute(binarypath)
+ outputpath = path.absolute(outputpath)
+ assert(os.isfile(binarypath), "%s not found!", binarypath)
+
+ -- get format (default: coff)
+ local format = opt.format or "coff"
+ format = format:lower()
+
+ -- validate format
+ if format ~= "coff" and format ~= "elf" and format ~= "macho" then
+ raise("bin2obj: unsupported format '%s' (supported: coff, elf, macho)", format)
+ end
+
+ -- do conversion based on format
+ if format == "coff" then
+ _do_bin2obj_coff(binarypath, outputpath, opt)
+ elseif format == "elf" then
+ _do_bin2obj_elf(binarypath, outputpath, opt)
+ elseif format == "macho" then
+ _do_bin2obj_macho(binarypath, outputpath, opt)
+ end
+end
+
+function main(...)
+
+ -- parse arguments
+ local argv = {...}
+ local opt = option.parse(argv, options, "Convert binary file to object file for direct linking."
+ , ""
+ , "Usage: xmake l utils.binary.bin2obj [options]")
+
+ -- do bin2obj
+ _do_bin2obj(opt.binarypath, opt.outputpath, opt)
+end
+