btrfs-receive - Linux

Overview

btrfs-receive is a Btrfs command-line utility used to receive and import data into a Btrfs filesystem. It allows you to transfer data from a remote or local source and add it to the current filesystem.

Syntax

btrfs-receive [options] <device|path> <transport> <address>

Options/Flags

• -r, –read-only: Mount the filesystem read-only after receiving data.
• -c, –clear-cache: Clear the Btrfs cache after receiving data.
• -f, –force: Ignore any errors while receiving data.
• -p, –progress: Display a progress bar while receiving data.
• -v, –verbose: Output debugging information.
• -h, –help: Display help and usage information.

Examples

Receive data from a remote host over SSH

btrfs-receive /mnt/target ssh://user@example.com:/mnt/source

Receive data from a local file

btrfs-receive /mnt/target file:/path/to/source.img

Clear Btrfs cache after receiving

btrfs-receive -c /mnt/target file:/path/to/source.img

Common Issues

• Permission denied: Ensure that the user has read and write permissions for the target device or file.
• Incorrect transport or address: Verify that the provided transport (e.g., ssh, file) and address are correct.
• Filesystem not available: Check that the target filesystem is mounted and available.

Integration

btrfs-receive can be used with other commands to automate data transfer and management tasks. For instance:

ssh example.com "btrfs send /mnt/source" | btrfs-receive /mnt/target

Related Commands

• btrfs-send: Transfer data from a Btrfs filesystem to a remote host or local file.
• btrfs: Manage, create, and inspect Btrfs filesystems.
• rsync: A general-purpose command for data synchronization and backup.