libzfs_impl.h revision 209962
1/* 2 * CDDL HEADER SART 3 * 4 * The contents of this file are subject to the terms of the 5 * Common Development and Distribution License (the "License"). 6 * You may not use this file except in compliance with the License. 7 * 8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9 * or http://www.opensolaris.org/os/licensing. 10 * See the License for the specific language governing permissions 11 * and limitations under the License. 12 * 13 * When distributing Covered Code, include this CDDL HEADER in each 14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15 * If applicable, add the following below this CDDL HEADER, with the 16 * fields enclosed by brackets "[]" replaced with your own identifying 17 * information: Portions Copyright [yyyy] [name of copyright owner] 18 * 19 * CDDL HEADER END 20 */ 21 22/* 23 * Copyright 2009 Sun Microsystems, Inc. All rights reserved. 24 * Use is subject to license terms. 25 */ 26 27#ifndef _LIBFS_IMPL_H 28#define _LIBFS_IMPL_H 29 30#include <sys/dmu.h> 31#include <sys/fs/zfs.h> 32#include <sys/zfs_ioctl.h> 33#include <sys/zfs_acl.h> 34#include <sys/spa.h> 35#include <sys/nvpair.h> 36 37#include <libshare.h> 38#include <libuutil.h> 39#include <libzfs.h> 40 41#ifdef __cplusplus 42extern "C" { 43#endif 44 45#ifdef VERIFY 46#undef VERIFY 47#endif 48#define VERIFY verify 49 50struct libzfs_handle { 51 int libzfs_error; 52 int libzfs_fd; 53 FILE *libzfs_mnttab; 54 FILE *libzfs_sharetab; 55 zpool_handle_t *libzfs_pool_handles; 56 uu_avl_pool_t *libzfs_ns_avlpool; 57 uu_avl_t *libzfs_ns_avl; 58 uint64_t libzfs_ns_gen; 59 int libzfs_desc_active; 60 char libzfs_action[1024]; 61 char libzfs_desc[1024]; 62 char *libzfs_log_str; 63 int libzfs_printerr; 64 void *libzfs_sharehdl; /* libshare handle */ 65 uint_t libzfs_shareflags; 66 boolean_t libzfs_mnttab_enable; 67 avl_tree_t libzfs_mnttab_cache; 68}; 69#define ZFSSHARE_MISS 0x01 /* Didn't find entry in cache */ 70 71struct zfs_handle { 72 libzfs_handle_t *zfs_hdl; 73 zpool_handle_t *zpool_hdl; 74 char zfs_name[ZFS_MAXNAMELEN]; 75 zfs_type_t zfs_type; /* type including snapshot */ 76 zfs_type_t zfs_head_type; /* type excluding snapshot */ 77 dmu_objset_stats_t zfs_dmustats; 78 nvlist_t *zfs_props; 79 nvlist_t *zfs_user_props; 80 boolean_t zfs_mntcheck; 81 char *zfs_mntopts; 82 uint8_t *zfs_props_table; 83}; 84 85/* 86 * This is different from checking zfs_type, because it will also catch 87 * snapshots of volumes. 88 */ 89#define ZFS_IS_VOLUME(zhp) ((zhp)->zfs_head_type == ZFS_TYPE_VOLUME) 90 91struct zpool_handle { 92 libzfs_handle_t *zpool_hdl; 93 zpool_handle_t *zpool_next; 94 char zpool_name[ZPOOL_MAXNAMELEN]; 95 int zpool_state; 96 size_t zpool_config_size; 97 nvlist_t *zpool_config; 98 nvlist_t *zpool_old_config; 99 nvlist_t *zpool_props; 100 diskaddr_t zpool_start_block; 101}; 102 103typedef enum { 104 PROTO_NFS = 0, 105 PROTO_SMB = 1, 106 PROTO_END = 2 107} zfs_share_proto_t; 108 109/* 110 * The following can be used as a bitmask and any new values 111 * added must preserve that capability. 112 */ 113typedef enum { 114 SHARED_NOT_SHARED = 0x0, 115 SHARED_ISCSI = 0x1, 116 SHARED_NFS = 0x2, 117 SHARED_SMB = 0x4 118} zfs_share_type_t; 119 120int zfs_error(libzfs_handle_t *, int, const char *); 121int zfs_error_fmt(libzfs_handle_t *, int, const char *, ...); 122void zfs_error_aux(libzfs_handle_t *, const char *, ...); 123void *zfs_alloc(libzfs_handle_t *, size_t); 124void *zfs_realloc(libzfs_handle_t *, void *, size_t, size_t); 125char *zfs_strdup(libzfs_handle_t *, const char *); 126int no_memory(libzfs_handle_t *); 127 128int zfs_standard_error(libzfs_handle_t *, int, const char *); 129int zfs_standard_error_fmt(libzfs_handle_t *, int, const char *, ...); 130int zpool_standard_error(libzfs_handle_t *, int, const char *); 131int zpool_standard_error_fmt(libzfs_handle_t *, int, const char *, ...); 132 133int get_dependents(libzfs_handle_t *, boolean_t, const char *, char ***, 134 size_t *); 135 136 137int zprop_parse_value(libzfs_handle_t *, nvpair_t *, int, zfs_type_t, 138 nvlist_t *, char **, uint64_t *, const char *); 139int zprop_expand_list(libzfs_handle_t *hdl, zprop_list_t **plp, 140 zfs_type_t type); 141 142/* 143 * Use this changelist_gather() flag to force attempting mounts 144 * on each change node regardless of whether or not it is currently 145 * mounted. 146 */ 147#define CL_GATHER_MOUNT_ALWAYS 1 148 149typedef struct prop_changelist prop_changelist_t; 150 151int zcmd_alloc_dst_nvlist(libzfs_handle_t *, zfs_cmd_t *, size_t); 152int zcmd_write_src_nvlist(libzfs_handle_t *, zfs_cmd_t *, nvlist_t *); 153int zcmd_write_conf_nvlist(libzfs_handle_t *, zfs_cmd_t *, nvlist_t *); 154int zcmd_expand_dst_nvlist(libzfs_handle_t *, zfs_cmd_t *); 155int zcmd_read_dst_nvlist(libzfs_handle_t *, zfs_cmd_t *, nvlist_t **); 156void zcmd_free_nvlists(zfs_cmd_t *); 157 158int changelist_prefix(prop_changelist_t *); 159int changelist_postfix(prop_changelist_t *); 160void changelist_rename(prop_changelist_t *, const char *, const char *); 161void changelist_remove(prop_changelist_t *, const char *); 162void changelist_free(prop_changelist_t *); 163prop_changelist_t *changelist_gather(zfs_handle_t *, zfs_prop_t, int, int); 164int changelist_unshare(prop_changelist_t *, zfs_share_proto_t *); 165int changelist_haszonedchild(prop_changelist_t *); 166 167void remove_mountpoint(zfs_handle_t *); 168int create_parents(libzfs_handle_t *, char *, int); 169boolean_t isa_child_of(const char *dataset, const char *parent); 170 171zfs_handle_t *make_dataset_handle(libzfs_handle_t *, const char *); 172 173int zpool_open_silent(libzfs_handle_t *, const char *, zpool_handle_t **); 174 175int zvol_create_link(libzfs_handle_t *, const char *); 176int zvol_remove_link(libzfs_handle_t *, const char *); 177int zpool_iter_zvol(zpool_handle_t *, int (*)(const char *, void *), void *); 178boolean_t zpool_name_valid(libzfs_handle_t *, boolean_t, const char *); 179 180void namespace_clear(libzfs_handle_t *); 181 182/* 183 * libshare (sharemgr) interfaces used internally. 184 */ 185 186extern int zfs_init_libshare(libzfs_handle_t *, int); 187extern void zfs_uninit_libshare(libzfs_handle_t *); 188extern int zfs_parse_options(char *, zfs_share_proto_t); 189 190extern int zfs_unshare_proto(zfs_handle_t *, 191 const char *, zfs_share_proto_t *); 192 193#ifdef __FreeBSD__ 194 195/* 196 * This is FreeBSD version of ioctl, because Solaris' ioctl() updates 197 * zc_nvlist_dst_size even if an error is returned, on FreeBSD if an 198 * error is returned zc_nvlist_dst_size won't be updated. 199 */ 200static __inline int 201zcmd_ioctl(int fd, unsigned long cmd, zfs_cmd_t *zc) 202{ 203 size_t oldsize; 204 int ret; 205 206 oldsize = zc->zc_nvlist_dst_size; 207 ret = ioctl(fd, cmd, zc); 208 if (ret == 0 && oldsize < zc->zc_nvlist_dst_size) { 209 ret = -1; 210 errno = ENOMEM; 211 } 212 213 return (ret); 214} 215#define ioctl(fd, cmd, zc) zcmd_ioctl((fd), (cmd), (zc)) 216#endif 217 218#ifdef __cplusplus 219} 220#endif 221 222#endif /* _LIBFS_IMPL_H */ 223