send-utils.h

   1 /*
   2  * Copyright (C) 2012 Alexander Block.  All rights reserved.
   3  *
   4  * This program is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU General Public
   6  * License v2 as published by the Free Software Foundation.
   7  *
   8  * This program is distributed in the hope that it will be useful,
   9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  11  * General Public License for more details.
  12  *
  13  * You should have received a copy of the GNU General Public
  14  * License along with this program; if not, write to the
  15  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  16  * Boston, MA 021110-1307, USA.
  17  */
  18
  19 #ifndef __BTRFS_SEND_UTILS_H__
  20 #define __BTRFS_SEND_UTILS_H__
  21
  22 #if BTRFS_FLAT_INCLUDES
  23 #include "kerncompat.h"
  24 #include "ctree.h"
  25 #include "rbtree.h"
  26 #else
  27 #include <btrfs/kerncompat.h>
  28 #include <btrfs/ctree.h>
  29 #include <btrfs/rbtree.h>
  30 #endif /* BTRFS_FLAT_INCLUDES */
  31
  32 #ifdef __cplusplus
  33 extern "C" {
  34 #endif
  35
  36 /*
  37  * Compatibility code for kernels < 3.12; the UUID tree is not available there
  38  * and we have to do the slow search. This should be deprecated someday.
  39  */
  40 #define BTRFS_COMPAT_SEND_NO_UUID_TREE 1
  41
  42 enum subvol_search_type {
  43         subvol_search_by_root_id,
  44         subvol_search_by_uuid,
  45         subvol_search_by_received_uuid,
  46         subvol_search_by_path,
  47 };
  48
  49 struct subvol_info {
  50 #ifdef BTRFS_COMPAT_SEND_NO_UUID_TREE
  51         struct rb_node rb_root_id_node;
  52         struct rb_node rb_local_node;
  53         struct rb_node rb_received_node;
  54         struct rb_node rb_path_node;
  55 #endif
  56
  57         u64 root_id;
  58         u8 uuid[BTRFS_UUID_SIZE];
  59         u8 parent_uuid[BTRFS_UUID_SIZE];
  60         u8 received_uuid[BTRFS_UUID_SIZE];
  61         u64 ctransid;
  62         u64 otransid;
  63         u64 stransid;
  64         u64 rtransid;
  65
  66         char *path;
  67 };
  68
  69 struct subvol_uuid_search {
  70         int mnt_fd;
  71 #ifdef BTRFS_COMPAT_SEND_NO_UUID_TREE
  72         int uuid_tree_existed;
  73
  74         struct rb_root root_id_subvols;
  75         struct rb_root local_subvols;
  76         struct rb_root received_subvols;
  77         struct rb_root path_subvols;
  78 #endif
  79 };
  80
  81 int subvol_uuid_search_init(int mnt_fd, struct subvol_uuid_search *s);
  82 void subvol_uuid_search_finit(struct subvol_uuid_search *s);
  83 struct subvol_info *subvol_uuid_search(struct subvol_uuid_search *s,
  84                                        u64 root_id, const u8 *uuid, u64 transid,
  85                                        const char *path,
  86                                        enum subvol_search_type type);
  87 void subvol_uuid_search_add(struct subvol_uuid_search *s,
  88                             struct subvol_info *si);
  89
  90 int btrfs_subvolid_resolve(int fd, char *path, size_t path_len, u64 subvol_id);
  91
  92 /*
  93  * DEPRECATED: the functions path_cat and path_cat3 are unsafe and should not
  94  * be used, use the _out variants and always check the return code.
  95  */
  96 __attribute__((deprecated))
  97 char *path_cat(const char *p1, const char *p2);
  98 __attribute__((deprecated))
  99 char *path_cat3(const char *p1, const char *p2, const char *p3);
 100
 101 int path_cat_out(char *out, const char *p1, const char *p2);
 102 int path_cat3_out(char *out, const char *p1, const char *p2, const char *p3);
 103
 104 #ifdef __cplusplus
 105 }
 106 #endif
 107
 108 #endif