---
url: /zh/api/scripts/extension-modules/utils/binary.md
---
# utils.binary

二进制工具模块。

## utils.binary.deplibs

获取依赖库列表。

### 函数原型

::: tip API

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

:::

### 参数说明

| 参数 | 描述 |
|------|------|
| binaryfile | 必需。输入二进制文件路径 |
| opt | 可选。选项：- `plat`: 平台 - `arch`: 架构 - `recursive`: 递归获取所有依赖 (默认: false) - `resolve_path`: 解析完整路径 (默认: false) - `resolve_hint_paths`: 查找提示路径 - `resolve_search_paths`: 搜索库路径 (如 LD\_LIBRARY\_PATH) - `check_cycle`: 检测循环依赖 |

### 返回值说明

| 返回值 | 描述 |
|--------|------|
| `<table>` | 依赖库列表 |

## utils.binary.readsyms

读取对象文件符号。

### 函数原型

::: tip API

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

:::

### 参数说明

| 参数 | 描述 |
|------|------|
| binaryfile | 必需。输入对象文件路径 |

### 返回值说明

| 返回值 | 描述 |
|--------|------|
| `<table>` | 符号列表 |

## utils.binary.extractlib

解压静态库到目录。

### 函数原型

::: tip API

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

:::

### 参数说明

| 参数 | 描述 |
|------|------|
| libraryfile | 必需。输入静态库文件路径 |
| outputdir | 必需。输出目录路径 |
| opt | 可选。选项 |

## utils.binary.rpath.list

获取 rpath 列表。

### 函数原型

::: tip API

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

:::

### 参数说明

| 参数 | 描述 |
|------|------|
| binaryfile | 必需。输入二进制文件路径 |
| opt | 可选。选项 |

### 返回值说明

| 返回值 | 描述 |
|--------|------|
| `<table>` | rpath 列表 |

## utils.binary.rpath.insert

插入 rpath。

### 函数原型

::: tip API

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

:::

### 参数说明

| 参数 | 描述 |
|------|------|
| binaryfile | 必需。输入二进制文件路径 |
| rpath\_path | 必需。插入的 rpath 路径 |
| opt | 可选。选项 |

## utils.binary.rpath.change

修改 rpath。

### 函数原型

::: tip API

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

:::

### 参数说明

| 参数 | 描述 |
|------|------|
| binaryfile | 必需。输入二进制文件路径 |
| rpath\_old | 必需。旧的 rpath 路径 |
| rpath\_new | 必需。新的 rpath 路径 |
| opt | 可选。选项 |

## utils.binary.rpath.remove

删除 rpath。

### 函数原型

::: tip API

```lua
import("utils.binary.rpath")
import("utils.binary.rpath")
rpath.remove(binaryfile: <string>, rpath_path: <string>, opt: <table>)
```

:::

### 参数说明

| 参数 | 描述 |
|------|------|
| binaryfile | 必需。输入二进制文件路径 |
| rpath\_path | 必需。删除的 rpath 路径 |
| opt | 可选。选项 |

## utils.binary.rpath.clean

清除所有 rpath。

### 函数原型

::: tip API

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

:::

### 参数说明

| 参数 | 描述 |
|------|------|
| binaryfile | 必需。输入二进制文件路径 |
| opt | 可选。选项 |