hadris-cd 2.1.0

Hybrid ISO+UDF optical disc image creation (UDF Bridge format)
Documentation 
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

# hadris-cd

A Rust library for creating hybrid ISO+UDF optical disc images (UDF Bridge format).

## Overview

This crate creates images that contain both ISO 9660 and UDF filesystems sharing the same underlying file data. This provides maximum compatibility:

- Legacy systems read ISO 9660
- Modern systems read UDF
- Both filesystems point to the same file data on disk

## Quick Start

```rust,no_run
use hadris_cd::{OpticalImageWriter, OpticalImageOptions, FileTree, FileEntry};

let mut tree = FileTree::new();
tree.add_file(FileEntry::from_buffer("readme.txt", b"Hello, World!".to_vec()));

let options = OpticalImageOptions::default()
    .volume_id("MY_DISC")
    .joliet(hadris_cd::JolietLevel::Level3);

let file = std::fs::File::create("output.iso").unwrap();
OpticalImageWriter::new(file, options)
    .finish(tree)
    .unwrap();
```

## Disk Layout

The UDF Bridge format interleaves ISO 9660 and UDF structures:

```text
Sector 0-15:    System area (boot code, partition tables)
Sector 16-...:  ISO 9660 Volume Descriptors
Sector 17-19:   UDF Volume Recognition Sequence (BEA01, NSR02, TEA01)
Sector 256:     UDF Anchor Volume Descriptor Pointer
Sector 257+:    UDF Volume Descriptor Sequence
File data:      Shared between ISO and UDF (both point to same sectors)
```

## Features

- **ISO 9660** with Joliet (Windows long filenames) and Rock Ridge (POSIX)
- **Selectable mastered UDF revisions** from 1.02 through 2.60
- **El-Torito** bootable images (BIOS and UEFI)
- **Hybrid MBR+GPT** for USB booting

Hybrid image creation currently delegates to the synchronous ISO and UDF
writers. The crate therefore exposes a sync-only writer API. Its default features
select both `std` and `sync` explicitly.

Revision selection describes mastered Type-1 output; it does not add packet
writing, VAT, sparing, metadata partitions, or pseudo-overwrite.

## Documentation

- [Create UDF filesystems](https://hxyulin.github.io/hadris/creation/udf)
- [Create ISO 9660 images](https://hxyulin.github.io/hadris/creation/iso)
- [Validate generated images](https://hxyulin.github.io/hadris/guides/validate-images)
- [API reference](https://docs.rs/hadris-cd)

## License

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