17cbb288fa
Given that other file systems (notably: xfs) support reflinks these days, let's extend the file system snapshotting logic to fall back to plan copies or reflinks when full btrfs subvolume snapshots are not available. This essentially makes "systemd-nspawn --ephemeral" and "systemd-nspawn --template=" available on non-btrfs subvolumes. Of course, both operations will still be slower on non-btrfs than on btrfs (simply because reflinking each file individually in a directory tree is still slower than doing this in one step for a whole subvolume), but it's probably good enough for many cases, and we should provide the users with the tools, they have to figure out what's good for them. Note that "machinectl clone" already had a fallback like this in place, this patch generalizes this, and adds similar support to our other cases.
134 lines
5 KiB
C
134 lines
5 KiB
C
#pragma once
|
|
|
|
/***
|
|
This file is part of systemd.
|
|
|
|
Copyright 2014 Lennart Poettering
|
|
|
|
systemd is free software; you can redistribute it and/or modify it
|
|
under the terms of the GNU Lesser General Public License as published by
|
|
the Free Software Foundation; either version 2.1 of the License, or
|
|
(at your option) any later version.
|
|
|
|
systemd is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public License
|
|
along with systemd; If not, see <http://www.gnu.org/licenses/>.
|
|
***/
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include <sys/types.h>
|
|
|
|
#include "sd-id128.h"
|
|
|
|
#include "time-util.h"
|
|
|
|
typedef struct BtrfsSubvolInfo {
|
|
uint64_t subvol_id;
|
|
usec_t otime;
|
|
|
|
sd_id128_t uuid;
|
|
sd_id128_t parent_uuid;
|
|
|
|
bool read_only;
|
|
} BtrfsSubvolInfo;
|
|
|
|
typedef struct BtrfsQuotaInfo {
|
|
uint64_t referenced;
|
|
uint64_t exclusive;
|
|
uint64_t referenced_max;
|
|
uint64_t exclusive_max;
|
|
} BtrfsQuotaInfo;
|
|
|
|
typedef enum BtrfsSnapshotFlags {
|
|
BTRFS_SNAPSHOT_FALLBACK_COPY = 1, /* If the source isn't a subvolume, reflink everything */
|
|
BTRFS_SNAPSHOT_READ_ONLY = 2,
|
|
BTRFS_SNAPSHOT_RECURSIVE = 4,
|
|
BTRFS_SNAPSHOT_QUOTA = 8,
|
|
BTRFS_SNAPSHOT_FALLBACK_DIRECTORY = 16, /* If the destination doesn't support subvolumes, reflink/copy instead */
|
|
BTRFS_SNAPSHOT_FALLBACK_IMMUTABLE = 32, /* When we can't create a subvolume, use the FS_IMMUTABLE attribute for indicating read-only */
|
|
} BtrfsSnapshotFlags;
|
|
|
|
typedef enum BtrfsRemoveFlags {
|
|
BTRFS_REMOVE_RECURSIVE = 1,
|
|
BTRFS_REMOVE_QUOTA = 2,
|
|
} BtrfsRemoveFlags;
|
|
|
|
int btrfs_is_filesystem(int fd);
|
|
|
|
int btrfs_is_subvol_fd(int fd);
|
|
int btrfs_is_subvol(const char *path);
|
|
|
|
int btrfs_reflink(int infd, int outfd);
|
|
int btrfs_clone_range(int infd, uint64_t in_offset, int ofd, uint64_t out_offset, uint64_t sz);
|
|
|
|
int btrfs_get_block_device_fd(int fd, dev_t *dev);
|
|
int btrfs_get_block_device(const char *path, dev_t *dev);
|
|
|
|
int btrfs_defrag_fd(int fd);
|
|
int btrfs_defrag(const char *p);
|
|
|
|
int btrfs_quota_enable_fd(int fd, bool b);
|
|
int btrfs_quota_enable(const char *path, bool b);
|
|
|
|
int btrfs_quota_scan_start(int fd);
|
|
int btrfs_quota_scan_wait(int fd);
|
|
int btrfs_quota_scan_ongoing(int fd);
|
|
|
|
int btrfs_resize_loopback_fd(int fd, uint64_t size, bool grow_only);
|
|
int btrfs_resize_loopback(const char *path, uint64_t size, bool grow_only);
|
|
|
|
int btrfs_subvol_make(const char *path);
|
|
int btrfs_subvol_make_label(const char *path);
|
|
|
|
int btrfs_subvol_snapshot_fd(int old_fd, const char *new_path, BtrfsSnapshotFlags flags);
|
|
int btrfs_subvol_snapshot(const char *old_path, const char *new_path, BtrfsSnapshotFlags flags);
|
|
|
|
int btrfs_subvol_remove(const char *path, BtrfsRemoveFlags flags);
|
|
int btrfs_subvol_remove_fd(int fd, const char *subvolume, BtrfsRemoveFlags flags);
|
|
|
|
int btrfs_subvol_set_read_only_fd(int fd, bool b);
|
|
int btrfs_subvol_set_read_only(const char *path, bool b);
|
|
int btrfs_subvol_get_read_only_fd(int fd);
|
|
|
|
int btrfs_subvol_get_id(int fd, const char *subvolume, uint64_t *ret);
|
|
int btrfs_subvol_get_id_fd(int fd, uint64_t *ret);
|
|
int btrfs_subvol_get_parent(int fd, uint64_t subvol_id, uint64_t *ret);
|
|
|
|
int btrfs_subvol_get_info_fd(int fd, uint64_t subvol_id, BtrfsSubvolInfo *info);
|
|
|
|
int btrfs_subvol_find_subtree_qgroup(int fd, uint64_t subvol_id, uint64_t *ret);
|
|
|
|
int btrfs_subvol_get_subtree_quota(const char *path, uint64_t subvol_id, BtrfsQuotaInfo *quota);
|
|
int btrfs_subvol_get_subtree_quota_fd(int fd, uint64_t subvol_id, BtrfsQuotaInfo *quota);
|
|
|
|
int btrfs_subvol_set_subtree_quota_limit(const char *path, uint64_t subvol_id, uint64_t referenced_max);
|
|
int btrfs_subvol_set_subtree_quota_limit_fd(int fd, uint64_t subvol_id, uint64_t referenced_max);
|
|
|
|
int btrfs_subvol_auto_qgroup_fd(int fd, uint64_t subvol_id, bool new_qgroup);
|
|
int btrfs_subvol_auto_qgroup(const char *path, uint64_t subvol_id, bool create_intermediary_qgroup);
|
|
|
|
int btrfs_qgroupid_make(uint64_t level, uint64_t id, uint64_t *ret);
|
|
int btrfs_qgroupid_split(uint64_t qgroupid, uint64_t *level, uint64_t *id);
|
|
|
|
int btrfs_qgroup_create(int fd, uint64_t qgroupid);
|
|
int btrfs_qgroup_destroy(int fd, uint64_t qgroupid);
|
|
int btrfs_qgroup_destroy_recursive(int fd, uint64_t qgroupid);
|
|
|
|
int btrfs_qgroup_set_limit_fd(int fd, uint64_t qgroupid, uint64_t referenced_max);
|
|
int btrfs_qgroup_set_limit(const char *path, uint64_t qgroupid, uint64_t referenced_max);
|
|
|
|
int btrfs_qgroup_copy_limits(int fd, uint64_t old_qgroupid, uint64_t new_qgroupid);
|
|
|
|
int btrfs_qgroup_assign(int fd, uint64_t child, uint64_t parent);
|
|
int btrfs_qgroup_unassign(int fd, uint64_t child, uint64_t parent);
|
|
|
|
int btrfs_qgroup_find_parents(int fd, uint64_t qgroupid, uint64_t **ret);
|
|
|
|
int btrfs_qgroup_get_quota_fd(int fd, uint64_t qgroupid, BtrfsQuotaInfo *quota);
|
|
int btrfs_qgroup_get_quota(const char *path, uint64_t qgroupid, BtrfsQuotaInfo *quota);
|