linuxutils-misc 0.1.0

Miscellaneous utilities from linuxutils
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

# copyfilerange

Copy byte ranges between files using copy_file_range(2).

## Synopsis

```
copyfilerange [options] source destination range...
```

## Operation

Copies byte ranges from a source file to a destination file using the
`copy_file_range(2)` syscall, which can perform server-side copies and
create reflinked files when the filesystem supports it.

### Range format

Each range is specified as `source_offset:destination_offset:length` (bytes).
- If `length` is 0 or omitted, copies as much data as available.
- Omitted offsets use the last-used file position, starting at 0.
- `::` means "copy everything" (full file reflink).

## Inputs

- `source` — source file path
- `destination` — destination file path (created if needed)
- `range...` — one or more range specs as positional arguments
- `-r <file>` — read range specs from a file (one per line)

## Outputs

- Destination file with copied byte ranges
- With `-v`: prints each range copied

## Syscalls

| Syscall | Description |
|---------|-------------|
| `copy_file_range(2)` | Copy bytes between files (kernel-space, supports reflinks) |

## Command-line options

| Option | Description |
|--------|-------------|
| `-r, --ranges <file>` | Read range specs from file (one per line) |
| `-v, --verbose` | Print each range as it's copied |
| `-h, --help` | Display help |
| `-V, --version` | Display version |

## Exit codes

| Code | Meaning |
|------|---------|
| 0 | Success |
| 1 | Failure |

## Notes

- Source and destination must use the same filesystem type.
- Some virtual filesystems (procfs, sysfs) are not supported.
- Reflinks require filesystem support (btrfs, XFS with reflink enabled).
- Range alignment to filesystem block size is needed for reflinks.