src/basic/btrfs-util.h

   1 /* SPDX-License-Identifier: LGPL-2.1+ */
   2 #pragma once
   3
   4 #include <stdbool.h>
   5 #include <stdint.h>
   6 #include <sys/types.h>
   7
   8 #include "sd-id128.h"
   9
  10 #include "copy.h"
  11 #include "time-util.h"
  12
  13 typedef struct BtrfsSubvolInfo {
  14         uint64_t subvol_id;
  15         usec_t otime;
  16
  17         sd_id128_t uuid;
  18         sd_id128_t parent_uuid;
  19
  20         bool read_only;
  21 } BtrfsSubvolInfo;
  22
  23 typedef struct BtrfsQuotaInfo {
  24         uint64_t referenced;
  25         uint64_t exclusive;
  26         uint64_t referenced_max;
  27         uint64_t exclusive_max;
  28 } BtrfsQuotaInfo;
  29
  30 typedef enum BtrfsSnapshotFlags {
  31         BTRFS_SNAPSHOT_FALLBACK_COPY = 1,        /* If the source isn't a subvolume, reflink everything */
  32         BTRFS_SNAPSHOT_READ_ONLY = 2,
  33         BTRFS_SNAPSHOT_RECURSIVE = 4,
  34         BTRFS_SNAPSHOT_QUOTA = 8,
  35         BTRFS_SNAPSHOT_FALLBACK_DIRECTORY = 16,  /* If the destination doesn't support subvolumes, reflink/copy instead */
  36         BTRFS_SNAPSHOT_FALLBACK_IMMUTABLE = 32,  /* When we can't create a subvolume, use the FS_IMMUTABLE attribute for indicating read-only */
  37 } BtrfsSnapshotFlags;
  38
  39 typedef enum BtrfsRemoveFlags {
  40         BTRFS_REMOVE_RECURSIVE = 1,
  41         BTRFS_REMOVE_QUOTA = 2,
  42 } BtrfsRemoveFlags;
  43
  44 int btrfs_is_filesystem(int fd);
  45
  46 int btrfs_is_subvol_fd(int fd);
  47 int btrfs_is_subvol(const char *path);
  48
  49 int btrfs_reflink(int infd, int outfd);
  50 int btrfs_clone_range(int infd, uint64_t in_offset, int ofd, uint64_t out_offset, uint64_t sz);
  51
  52 int btrfs_get_block_device_fd(int fd, dev_t *dev);
  53 int btrfs_get_block_device(const char *path, dev_t *dev);
  54
  55 int btrfs_defrag_fd(int fd);
  56 int btrfs_defrag(const char *p);
  57
  58 int btrfs_quota_enable_fd(int fd, bool b);
  59 int btrfs_quota_enable(const char *path, bool b);
  60
  61 int btrfs_quota_scan_start(int fd);
  62 int btrfs_quota_scan_wait(int fd);
  63 int btrfs_quota_scan_ongoing(int fd);
  64
  65 int btrfs_subvol_make(const char *path);
  66 int btrfs_subvol_make_fd(int fd, const char *subvolume);
  67
  68 int btrfs_subvol_snapshot_fd_full(int old_fd, const char *new_path, BtrfsSnapshotFlags flags, copy_progress_path_t progress_path, copy_progress_bytes_t progress_bytes, void *userdata);
  69 static inline int btrfs_subvol_snapshot_fd(int old_fd, const char *new_path, BtrfsSnapshotFlags flags) {
  70         return btrfs_subvol_snapshot_fd_full(old_fd, new_path, flags, NULL, NULL, NULL);
  71 }
  72
  73 int btrfs_subvol_snapshot_full(const char *old_path, const char *new_path, BtrfsSnapshotFlags flags, copy_progress_path_t progress_path, copy_progress_bytes_t progress_bytes, void *userdata);
  74 static inline int btrfs_subvol_snapshot(const char *old_path, const char *new_path, BtrfsSnapshotFlags flags) {
  75         return btrfs_subvol_snapshot_full(old_path, new_path, flags, NULL, NULL, NULL);
  76 }
  77
  78 int btrfs_subvol_remove(const char *path, BtrfsRemoveFlags flags);
  79 int btrfs_subvol_remove_fd(int fd, const char *subvolume, BtrfsRemoveFlags flags);
  80
  81 int btrfs_subvol_set_read_only_fd(int fd, bool b);
  82 int btrfs_subvol_set_read_only(const char *path, bool b);
  83 int btrfs_subvol_get_read_only_fd(int fd);
  84
  85 int btrfs_subvol_get_id(int fd, const char *subvolume, uint64_t *ret);
  86 int btrfs_subvol_get_id_fd(int fd, uint64_t *ret);
  87 int btrfs_subvol_get_parent(int fd, uint64_t subvol_id, uint64_t *ret);
  88
  89 int btrfs_subvol_get_info_fd(int fd, uint64_t subvol_id, BtrfsSubvolInfo *info);
  90
  91 int btrfs_subvol_find_subtree_qgroup(int fd, uint64_t subvol_id, uint64_t *ret);
  92
  93 int btrfs_subvol_get_subtree_quota(const char *path, uint64_t subvol_id, BtrfsQuotaInfo *quota);
  94 int btrfs_subvol_get_subtree_quota_fd(int fd, uint64_t subvol_id, BtrfsQuotaInfo *quota);
  95
  96 int btrfs_subvol_set_subtree_quota_limit(const char *path, uint64_t subvol_id, uint64_t referenced_max);
  97 int btrfs_subvol_set_subtree_quota_limit_fd(int fd, uint64_t subvol_id, uint64_t referenced_max);
  98
  99 int btrfs_subvol_auto_qgroup_fd(int fd, uint64_t subvol_id, bool new_qgroup);
 100 int btrfs_subvol_auto_qgroup(const char *path, uint64_t subvol_id, bool create_intermediary_qgroup);
 101
 102 int btrfs_qgroupid_make(uint64_t level, uint64_t id, uint64_t *ret);
 103 int btrfs_qgroupid_split(uint64_t qgroupid, uint64_t *level, uint64_t *id);
 104
 105 int btrfs_qgroup_create(int fd, uint64_t qgroupid);
 106 int btrfs_qgroup_destroy(int fd, uint64_t qgroupid);
 107 int btrfs_qgroup_destroy_recursive(int fd, uint64_t qgroupid);
 108
 109 int btrfs_qgroup_set_limit_fd(int fd, uint64_t qgroupid, uint64_t referenced_max);
 110 int btrfs_qgroup_set_limit(const char *path, uint64_t qgroupid, uint64_t referenced_max);
 111
 112 int btrfs_qgroup_copy_limits(int fd, uint64_t old_qgroupid, uint64_t new_qgroupid);
 113
 114 int btrfs_qgroup_assign(int fd, uint64_t child, uint64_t parent);
 115 int btrfs_qgroup_unassign(int fd, uint64_t child, uint64_t parent);
 116
 117 int btrfs_qgroup_find_parents(int fd, uint64_t qgroupid, uint64_t **ret);
 118
 119 int btrfs_qgroup_get_quota_fd(int fd, uint64_t qgroupid, BtrfsQuotaInfo *quota);
 120 int btrfs_qgroup_get_quota(const char *path, uint64_t qgroupid, BtrfsQuotaInfo *quota);