btrfs-{send, receive}: add page (#24602)

* added btrfs-send-receive page

* btrfs-receive references btrfs-send

* remove excess lines

* simpler btrfs-send

* Update pages/linux/btrfs-send.md

Co-authored-by: Managor <42655600+Managor@users.noreply.github.com>

---------

Co-authored-by: Managor <42655600+Managor@users.noreply.github.com>
This commit is contained in:
PaoloJr
2026-10-06 18:42:28 +02:00
committed by GitHub
co-authored by Managor
parent 9b983d921b
commit 9ea019641e
2 changed files with 41 additions and 0 deletions
+7
View File
@@ -0,0 +1,7 @@
# btrfs receive
> The examples for this command have been moved together with `btrfs send`.
- View documentation for `btrfs receive`:
`tldr btrfs send`
+34
View File
@@ -0,0 +1,34 @@
# btrfs send
> Transfer data (subvolume/snapshot) from one filesystem to another in a streamable format.
> Note: `send` requires the snapshot be read-only.
> See also: `btrfs-subvolume`, `btrfs-property`.
> More information: <https://btrfs.readthedocs.io/en/latest/Send-receive.html>.
- Send a subvolume snapshot to a file instead of `stdout`:
`sudo btrfs send -f {{path/to/file.btrfs}} {{path/to/source_snapshot}}`
- Restore a subvolume snapshot from a file instead of `stdin`:
`sudo btrfs receive -f {{path/to/file.btrfs}} {{path/to/destination_directory}}`
- Send a subvolume snapshot stream and pipe it to a receiving destination:
`sudo btrfs send {{path/to/source_snapshot}} | sudo btrfs receive {{path/to/destination_directory}}`
- Send an incremental update (differences between parent and new snapshot) to a file:
`sudo btrfs send -p {{path/to/parent_snapshot}} -f {{path/to/incremental.btrfs}} {{path/to/new_snapshot}}`
- Send an incremental update stream and pipe it to a receiving destination:
`sudo btrfs send -p {{path/to/parent_snapshot}} {{path/to/new_snapshot}} | sudo btrfs receive {{path/to/destination_directory}}`
- Send a subvolume snapshot over SSH (the receiving `sudo` must be configured for passwordless execution):
`sudo btrfs send {{path/to/source_snapshot}} | ssh {{user}}@{{host}} "sudo btrfs receive {{path/to/destination_directory}}"`
- Dump stream metadata from a file without modifying the filesystem:
`sudo btrfs receive --dump -f {{path/to/file.btrfs}}`