hadris-udf-cli 2.0.0-rc.3

CLI utility for Universal Disk Format image operations
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

# Hadris UDF CLI

Command-line utility for UDF (Universal Disk Format) filesystem operations.
UDF is the filesystem used for DVD-ROM, DVD-Video, Blu-ray discs, and large USB drives.

## Installation

```bash
cargo install hadris-udf-cli
```

Or build from source:

```bash
cargo build --release -p hadris-udf-cli
# canonical binary: target/release/hadris-udf
```

The canonical binary is **`hadris-udf`**. The legacy **`hadris-udf-cli`**
executable remains available as a compatibility alias.

## Usage

```bash
# Display UDF image information
hadris-udf info image.udf

# List directory contents
hadris-udf ls image.udf
hadris-udf ls image.udf /subdir -l

# Display directory tree
hadris-udf tree image.udf
hadris-udf tree image.udf --depth 2

# Print a file to stdout
hadris-udf cat image.udf /readme.txt

# Extract files (default output directory: .)
hadris-udf extract image.udf -o ./out
hadris-udf extract image.udf -p /subdir -o ./out

# Create a new UDF image from a directory
hadris-udf create ./my-files --output image.udf
hadris-udf create ./my-files --output image.udf --volume-name MY_DISC --revision 2.50

# Verify UDF image integrity
hadris-udf verify image.udf
hadris-udf verify image.udf --verbose
```

## Commands

| Command  | Description                                      |
|----------|--------------------------------------------------|
| `info`   | Display volume information (ID, revision, size)  |
| `ls`     | List directory contents                          |
| `tree`   | Display directory tree structure                 |
| `cat`    | Print file contents to stdout                    |
| `extract`| Extract files from the image                     |
| `create` | Create a new UDF image from a local directory    |
| `verify` | Verify UDF image structural integrity            |

## Supported UDF Revisions

| Revision | Target Media          |
|----------|-----------------------|
| `1.02`   | DVD-ROM (default)     |
| `1.50`   | DVD-RAM, packet write |
| `2.01`   | DVD-RW streaming      |
| `2.50`   | Blu-ray               |
| `2.60`   | Blu-ray pseudo-OW     |

## License

Licensed under the [MIT license](../../LICENSE-MIT).