Print this page
    
2619 asynchronous destruction of ZFS file systems
2747 SPA versioning with zfs feature flags
Reviewed by: Matt Ahrens <mahrens@delphix.com>
Reviewed by: George Wilson <gwilson@delphix.com>
Reviewed by: Richard Lowe <richlowe@richlowe.net>
Reviewed by: Dan Kruchinin <dan.kruchinin@gmail.com>
Approved by: Dan McDonald <danmcd@nexenta.com>
    
      
        | Split | 
	Close | 
      
      | Expand all | 
      | Collapse all | 
    
    
          --- old/usr/src/uts/common/sys/fs/zfs.h
          +++ new/usr/src/uts/common/sys/fs/zfs.h
   1    1  /*
   2    2   * CDDL HEADER START
   3    3   *
   4    4   * The contents of this file are subject to the terms of the
   5    5   * Common Development and Distribution License (the "License").
   6    6   * You may not use this file except in compliance with the License.
   7    7   *
   8    8   * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9    9   * or http://www.opensolaris.org/os/licensing.
  10   10   * See the License for the specific language governing permissions
  11   11   * and limitations under the License.
  12   12   *
  13   13   * When distributing Covered Code, include this CDDL HEADER in each
  14   14   * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15   15   * If applicable, add the following below this CDDL HEADER, with the
  16   16   * fields enclosed by brackets "[]" replaced with your own identifying
  17   17   * information: Portions Copyright [yyyy] [name of copyright owner]
  18   18   *
  19   19   * CDDL HEADER END
  20   20   */
  21   21  
  22   22  /*
  23   23   * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
  24   24   * Copyright (c) 2012 by Delphix. All rights reserved.
  25   25   * Copyright 2011 Nexenta Systems, Inc.  All rights reserved.
  26   26   * Copyright (c) 2012, Joyent, Inc. All rights reserved.
  27   27   */
  28   28  
  29   29  /* Portions Copyright 2010 Robert Milkowski */
  30   30  
  31   31  #ifndef _SYS_FS_ZFS_H
  32   32  #define _SYS_FS_ZFS_H
  33   33  
  34   34  #include <sys/time.h>
  35   35  
  36   36  #ifdef  __cplusplus
  37   37  extern "C" {
  38   38  #endif
  39   39  
  40   40  /*
  41   41   * Types and constants shared between userland and the kernel.
  42   42   */
  43   43  
  44   44  /*
  45   45   * Each dataset can be one of the following types.  These constants can be
  46   46   * combined into masks that can be passed to various functions.
  47   47   */
  48   48  typedef enum {
  49   49          ZFS_TYPE_FILESYSTEM     = 0x1,
  50   50          ZFS_TYPE_SNAPSHOT       = 0x2,
  51   51          ZFS_TYPE_VOLUME         = 0x4,
  52   52          ZFS_TYPE_POOL           = 0x8
  53   53  } zfs_type_t;
  54   54  
  55   55  #define ZFS_TYPE_DATASET        \
  56   56          (ZFS_TYPE_FILESYSTEM | ZFS_TYPE_VOLUME | ZFS_TYPE_SNAPSHOT)
  57   57  
  58   58  #define ZAP_MAXNAMELEN 256
  59   59  #define ZAP_MAXVALUELEN (1024 * 8)
  60   60  #define ZAP_OLDMAXVALUELEN 1024
  61   61  
  62   62  /*
  63   63   * Dataset properties are identified by these constants and must be added to
  64   64   * the end of this list to ensure that external consumers are not affected
  65   65   * by the change. If you make any changes to this list, be sure to update
  66   66   * the property table in usr/src/common/zfs/zfs_prop.c.
  67   67   */
  68   68  typedef enum {
  69   69          ZFS_PROP_TYPE,
  70   70          ZFS_PROP_CREATION,
  71   71          ZFS_PROP_USED,
  72   72          ZFS_PROP_AVAILABLE,
  73   73          ZFS_PROP_REFERENCED,
  74   74          ZFS_PROP_COMPRESSRATIO,
  75   75          ZFS_PROP_MOUNTED,
  76   76          ZFS_PROP_ORIGIN,
  77   77          ZFS_PROP_QUOTA,
  78   78          ZFS_PROP_RESERVATION,
  79   79          ZFS_PROP_VOLSIZE,
  80   80          ZFS_PROP_VOLBLOCKSIZE,
  81   81          ZFS_PROP_RECORDSIZE,
  82   82          ZFS_PROP_MOUNTPOINT,
  83   83          ZFS_PROP_SHARENFS,
  84   84          ZFS_PROP_CHECKSUM,
  85   85          ZFS_PROP_COMPRESSION,
  86   86          ZFS_PROP_ATIME,
  87   87          ZFS_PROP_DEVICES,
  88   88          ZFS_PROP_EXEC,
  89   89          ZFS_PROP_SETUID,
  90   90          ZFS_PROP_READONLY,
  91   91          ZFS_PROP_ZONED,
  92   92          ZFS_PROP_SNAPDIR,
  93   93          ZFS_PROP_ACLMODE,
  94   94          ZFS_PROP_ACLINHERIT,
  95   95          ZFS_PROP_CREATETXG,             /* not exposed to the user */
  96   96          ZFS_PROP_NAME,                  /* not exposed to the user */
  97   97          ZFS_PROP_CANMOUNT,
  98   98          ZFS_PROP_ISCSIOPTIONS,          /* not exposed to the user */
  99   99          ZFS_PROP_XATTR,
 100  100          ZFS_PROP_NUMCLONES,             /* not exposed to the user */
 101  101          ZFS_PROP_COPIES,
 102  102          ZFS_PROP_VERSION,
 103  103          ZFS_PROP_UTF8ONLY,
 104  104          ZFS_PROP_NORMALIZE,
 105  105          ZFS_PROP_CASE,
 106  106          ZFS_PROP_VSCAN,
 107  107          ZFS_PROP_NBMAND,
 108  108          ZFS_PROP_SHARESMB,
 109  109          ZFS_PROP_REFQUOTA,
 110  110          ZFS_PROP_REFRESERVATION,
 111  111          ZFS_PROP_GUID,
 112  112          ZFS_PROP_PRIMARYCACHE,
 113  113          ZFS_PROP_SECONDARYCACHE,
 114  114          ZFS_PROP_USEDSNAP,
 115  115          ZFS_PROP_USEDDS,
 116  116          ZFS_PROP_USEDCHILD,
 117  117          ZFS_PROP_USEDREFRESERV,
 118  118          ZFS_PROP_USERACCOUNTING,        /* not exposed to the user */
 119  119          ZFS_PROP_STMF_SHAREINFO,        /* not exposed to the user */
 120  120          ZFS_PROP_DEFER_DESTROY,
 121  121          ZFS_PROP_USERREFS,
 122  122          ZFS_PROP_LOGBIAS,
 123  123          ZFS_PROP_UNIQUE,                /* not exposed to the user */
 124  124          ZFS_PROP_OBJSETID,              /* not exposed to the user */
 125  125          ZFS_PROP_DEDUP,
 126  126          ZFS_PROP_MLSLABEL,
 127  127          ZFS_PROP_SYNC,
 128  128          ZFS_PROP_REFRATIO,
 129  129          ZFS_PROP_WRITTEN,
 130  130          ZFS_PROP_CLONES,
 131  131          ZFS_NUM_PROPS
 132  132  } zfs_prop_t;
 133  133  
 134  134  typedef enum {
 135  135          ZFS_PROP_USERUSED,
 136  136          ZFS_PROP_USERQUOTA,
 137  137          ZFS_PROP_GROUPUSED,
 138  138          ZFS_PROP_GROUPQUOTA,
 139  139          ZFS_NUM_USERQUOTA_PROPS
 140  140  } zfs_userquota_prop_t;
 141  141  
 142  142  extern const char *zfs_userquota_prop_prefixes[ZFS_NUM_USERQUOTA_PROPS];
 143  143  
 144  144  /*
 145  145   * Pool properties are identified by these constants and must be added to the
 146  146   * end of this list to ensure that external consumers are not affected
 147  147   * by the change. If you make any changes to this list, be sure to update
 148  148   * the property table in usr/src/common/zfs/zpool_prop.c.
 149  149   */
 150  150  typedef enum {
 151  151          ZPOOL_PROP_NAME,
 152  152          ZPOOL_PROP_SIZE,
 153  153          ZPOOL_PROP_CAPACITY,
 154  154          ZPOOL_PROP_ALTROOT,
 155  155          ZPOOL_PROP_HEALTH,
 156  156          ZPOOL_PROP_GUID,
 157  157          ZPOOL_PROP_VERSION,
 158  158          ZPOOL_PROP_BOOTFS,
 159  159          ZPOOL_PROP_DELEGATION,
 160  160          ZPOOL_PROP_AUTOREPLACE,
 161  161          ZPOOL_PROP_CACHEFILE,
  
    | 
      ↓ open down ↓ | 
    161 lines elided | 
    
      ↑ open up ↑ | 
  
 162  162          ZPOOL_PROP_FAILUREMODE,
 163  163          ZPOOL_PROP_LISTSNAPS,
 164  164          ZPOOL_PROP_AUTOEXPAND,
 165  165          ZPOOL_PROP_DEDUPDITTO,
 166  166          ZPOOL_PROP_DEDUPRATIO,
 167  167          ZPOOL_PROP_FREE,
 168  168          ZPOOL_PROP_ALLOCATED,
 169  169          ZPOOL_PROP_READONLY,
 170  170          ZPOOL_PROP_COMMENT,
 171  171          ZPOOL_PROP_EXPANDSZ,
      172 +        ZPOOL_PROP_FREEING,
 172  173          ZPOOL_NUM_PROPS
 173  174  } zpool_prop_t;
 174  175  
 175  176  /* Small enough to not hog a whole line of printout in zpool(1M). */
 176  177  #define ZPROP_MAX_COMMENT       32
 177  178  
 178  179  #define ZPROP_CONT              -2
 179  180  #define ZPROP_INVAL             -1
 180  181  
 181  182  #define ZPROP_VALUE             "value"
 182  183  #define ZPROP_SOURCE            "source"
 183  184  
 184  185  typedef enum {
 185  186          ZPROP_SRC_NONE = 0x1,
 186  187          ZPROP_SRC_DEFAULT = 0x2,
 187  188          ZPROP_SRC_TEMPORARY = 0x4,
 188  189          ZPROP_SRC_LOCAL = 0x8,
 189  190          ZPROP_SRC_INHERITED = 0x10,
 190  191          ZPROP_SRC_RECEIVED = 0x20
 191  192  } zprop_source_t;
 192  193  
 193  194  #define ZPROP_SRC_ALL   0x3f
 194  195  
 195  196  #define ZPROP_SOURCE_VAL_RECVD  "$recvd"
 196  197  #define ZPROP_N_MORE_ERRORS     "N_MORE_ERRORS"
 197  198  /*
 198  199   * Dataset flag implemented as a special entry in the props zap object
 199  200   * indicating that the dataset has received properties on or after
 200  201   * SPA_VERSION_RECVD_PROPS. The first such receive blows away local properties
 201  202   * just as it did in earlier versions, and thereafter, local properties are
 202  203   * preserved.
 203  204   */
 204  205  #define ZPROP_HAS_RECVD         "$hasrecvd"
 205  206  
 206  207  typedef enum {
 207  208          ZPROP_ERR_NOCLEAR = 0x1, /* failure to clear existing props */
 208  209          ZPROP_ERR_NORESTORE = 0x2 /* failure to restore props on error */
 209  210  } zprop_errflags_t;
 210  211  
 211  212  typedef int (*zprop_func)(int, void *);
 212  213  
 213  214  /*
 214  215   * Properties to be set on the root file system of a new pool
 215  216   * are stuffed into their own nvlist, which is then included in
 216  217   * the properties nvlist with the pool properties.
 217  218   */
 218  219  #define ZPOOL_ROOTFS_PROPS      "root-props-nvl"
 219  220  
 220  221  /*
 221  222   * Dataset property functions shared between libzfs and kernel.
 222  223   */
 223  224  const char *zfs_prop_default_string(zfs_prop_t);
 224  225  uint64_t zfs_prop_default_numeric(zfs_prop_t);
 225  226  boolean_t zfs_prop_readonly(zfs_prop_t);
 226  227  boolean_t zfs_prop_inheritable(zfs_prop_t);
 227  228  boolean_t zfs_prop_setonce(zfs_prop_t);
 228  229  const char *zfs_prop_to_name(zfs_prop_t);
 229  230  zfs_prop_t zfs_name_to_prop(const char *);
 230  231  boolean_t zfs_prop_user(const char *);
 231  232  boolean_t zfs_prop_userquota(const char *);
 232  233  boolean_t zfs_prop_written(const char *);
 233  234  int zfs_prop_index_to_string(zfs_prop_t, uint64_t, const char **);
 234  235  int zfs_prop_string_to_index(zfs_prop_t, const char *, uint64_t *);
 235  236  uint64_t zfs_prop_random_value(zfs_prop_t, uint64_t seed);
  
    | 
      ↓ open down ↓ | 
    54 lines elided | 
    
      ↑ open up ↑ | 
  
 236  237  boolean_t zfs_prop_valid_for_type(int, zfs_type_t);
 237  238  
 238  239  /*
 239  240   * Pool property functions shared between libzfs and kernel.
 240  241   */
 241  242  zpool_prop_t zpool_name_to_prop(const char *);
 242  243  const char *zpool_prop_to_name(zpool_prop_t);
 243  244  const char *zpool_prop_default_string(zpool_prop_t);
 244  245  uint64_t zpool_prop_default_numeric(zpool_prop_t);
 245  246  boolean_t zpool_prop_readonly(zpool_prop_t);
      247 +boolean_t zpool_prop_feature(const char *);
      248 +boolean_t zpool_prop_unsupported(const char *name);
 246  249  int zpool_prop_index_to_string(zpool_prop_t, uint64_t, const char **);
 247  250  int zpool_prop_string_to_index(zpool_prop_t, const char *, uint64_t *);
 248  251  uint64_t zpool_prop_random_value(zpool_prop_t, uint64_t seed);
 249  252  
 250  253  /*
 251  254   * Definitions for the Delegation.
 252  255   */
 253  256  typedef enum {
 254  257          ZFS_DELEG_WHO_UNKNOWN = 0,
 255  258          ZFS_DELEG_USER = 'u',
 256  259          ZFS_DELEG_USER_SETS = 'U',
 257  260          ZFS_DELEG_GROUP = 'g',
 258  261          ZFS_DELEG_GROUP_SETS = 'G',
 259  262          ZFS_DELEG_EVERYONE = 'e',
 260  263          ZFS_DELEG_EVERYONE_SETS = 'E',
 261  264          ZFS_DELEG_CREATE = 'c',
 262  265          ZFS_DELEG_CREATE_SETS = 'C',
 263  266          ZFS_DELEG_NAMED_SET = 's',
 264  267          ZFS_DELEG_NAMED_SET_SETS = 'S'
 265  268  } zfs_deleg_who_type_t;
 266  269  
 267  270  typedef enum {
 268  271          ZFS_DELEG_NONE = 0,
 269  272          ZFS_DELEG_PERM_LOCAL = 1,
 270  273          ZFS_DELEG_PERM_DESCENDENT = 2,
 271  274          ZFS_DELEG_PERM_LOCALDESCENDENT = 3,
 272  275          ZFS_DELEG_PERM_CREATE = 4
 273  276  } zfs_deleg_inherit_t;
 274  277  
 275  278  #define ZFS_DELEG_PERM_UID      "uid"
 276  279  #define ZFS_DELEG_PERM_GID      "gid"
 277  280  #define ZFS_DELEG_PERM_GROUPS   "groups"
 278  281  
 279  282  #define ZFS_MLSLABEL_DEFAULT    "none"
 280  283  
 281  284  #define ZFS_SMB_ACL_SRC         "src"
 282  285  #define ZFS_SMB_ACL_TARGET      "target"
 283  286  
 284  287  typedef enum {
 285  288          ZFS_CANMOUNT_OFF = 0,
 286  289          ZFS_CANMOUNT_ON = 1,
 287  290          ZFS_CANMOUNT_NOAUTO = 2
 288  291  } zfs_canmount_type_t;
 289  292  
 290  293  typedef enum {
 291  294          ZFS_LOGBIAS_LATENCY = 0,
 292  295          ZFS_LOGBIAS_THROUGHPUT = 1
 293  296  } zfs_logbias_op_t;
 294  297  
 295  298  typedef enum zfs_share_op {
 296  299          ZFS_SHARE_NFS = 0,
 297  300          ZFS_UNSHARE_NFS = 1,
 298  301          ZFS_SHARE_SMB = 2,
 299  302          ZFS_UNSHARE_SMB = 3
 300  303  } zfs_share_op_t;
 301  304  
 302  305  typedef enum zfs_smb_acl_op {
 303  306          ZFS_SMB_ACL_ADD,
 304  307          ZFS_SMB_ACL_REMOVE,
 305  308          ZFS_SMB_ACL_RENAME,
 306  309          ZFS_SMB_ACL_PURGE
 307  310  } zfs_smb_acl_op_t;
 308  311  
 309  312  typedef enum zfs_cache_type {
 310  313          ZFS_CACHE_NONE = 0,
 311  314          ZFS_CACHE_METADATA = 1,
 312  315          ZFS_CACHE_ALL = 2
 313  316  } zfs_cache_type_t;
 314  317  
 315  318  typedef enum {
 316  319          ZFS_SYNC_STANDARD = 0,
 317  320          ZFS_SYNC_ALWAYS = 1,
 318  321          ZFS_SYNC_DISABLED = 2
 319  322  } zfs_sync_type_t;
 320  323  
 321  324  
 322  325  /*
 323  326   * On-disk version number.
 324  327   */
 325  328  #define SPA_VERSION_1                   1ULL
 326  329  #define SPA_VERSION_2                   2ULL
 327  330  #define SPA_VERSION_3                   3ULL
 328  331  #define SPA_VERSION_4                   4ULL
 329  332  #define SPA_VERSION_5                   5ULL
 330  333  #define SPA_VERSION_6                   6ULL
 331  334  #define SPA_VERSION_7                   7ULL
 332  335  #define SPA_VERSION_8                   8ULL
 333  336  #define SPA_VERSION_9                   9ULL
 334  337  #define SPA_VERSION_10                  10ULL
 335  338  #define SPA_VERSION_11                  11ULL
 336  339  #define SPA_VERSION_12                  12ULL
 337  340  #define SPA_VERSION_13                  13ULL
 338  341  #define SPA_VERSION_14                  14ULL
 339  342  #define SPA_VERSION_15                  15ULL
 340  343  #define SPA_VERSION_16                  16ULL
 341  344  #define SPA_VERSION_17                  17ULL
 342  345  #define SPA_VERSION_18                  18ULL
  
    | 
      ↓ open down ↓ | 
    87 lines elided | 
    
      ↑ open up ↑ | 
  
 343  346  #define SPA_VERSION_19                  19ULL
 344  347  #define SPA_VERSION_20                  20ULL
 345  348  #define SPA_VERSION_21                  21ULL
 346  349  #define SPA_VERSION_22                  22ULL
 347  350  #define SPA_VERSION_23                  23ULL
 348  351  #define SPA_VERSION_24                  24ULL
 349  352  #define SPA_VERSION_25                  25ULL
 350  353  #define SPA_VERSION_26                  26ULL
 351  354  #define SPA_VERSION_27                  27ULL
 352  355  #define SPA_VERSION_28                  28ULL
      356 +#define SPA_VERSION_5000                5000ULL
 353  357  
 354  358  /*
 355  359   * When bumping up SPA_VERSION, make sure GRUB ZFS understands the on-disk
 356  360   * format change. Go to usr/src/grub/grub-0.97/stage2/{zfs-include/, fsys_zfs*},
 357  361   * and do the appropriate changes.  Also bump the version number in
 358  362   * usr/src/grub/capability.
 359  363   */
 360      -#define SPA_VERSION                     SPA_VERSION_28
 361      -#define SPA_VERSION_STRING              "28"
      364 +#define SPA_VERSION                     SPA_VERSION_5000
      365 +#define SPA_VERSION_STRING              "5000"
 362  366  
 363  367  /*
 364  368   * Symbolic names for the changes that caused a SPA_VERSION switch.
 365  369   * Used in the code when checking for presence or absence of a feature.
 366  370   * Feel free to define multiple symbolic names for each version if there
 367  371   * were multiple changes to on-disk structures during that version.
 368  372   *
 369  373   * NOTE: When checking the current SPA_VERSION in your code, be sure
 370  374   *       to use spa_version() since it reports the version of the
 371  375   *       last synced uberblock.  Checking the in-flight version can
 372  376   *       be dangerous in some cases.
 373  377   */
 374  378  #define SPA_VERSION_INITIAL             SPA_VERSION_1
 375  379  #define SPA_VERSION_DITTO_BLOCKS        SPA_VERSION_2
 376  380  #define SPA_VERSION_SPARES              SPA_VERSION_3
 377  381  #define SPA_VERSION_RAIDZ2              SPA_VERSION_3
 378  382  #define SPA_VERSION_BPOBJ_ACCOUNT       SPA_VERSION_3
 379  383  #define SPA_VERSION_RAIDZ_DEFLATE       SPA_VERSION_3
 380  384  #define SPA_VERSION_DNODE_BYTES         SPA_VERSION_3
 381  385  #define SPA_VERSION_ZPOOL_HISTORY       SPA_VERSION_4
 382  386  #define SPA_VERSION_GZIP_COMPRESSION    SPA_VERSION_5
 383  387  #define SPA_VERSION_BOOTFS              SPA_VERSION_6
 384  388  #define SPA_VERSION_SLOGS               SPA_VERSION_7
 385  389  #define SPA_VERSION_DELEGATED_PERMS     SPA_VERSION_8
 386  390  #define SPA_VERSION_FUID                SPA_VERSION_9
 387  391  #define SPA_VERSION_REFRESERVATION      SPA_VERSION_9
 388  392  #define SPA_VERSION_REFQUOTA            SPA_VERSION_9
 389  393  #define SPA_VERSION_UNIQUE_ACCURATE     SPA_VERSION_9
 390  394  #define SPA_VERSION_L2CACHE             SPA_VERSION_10
 391  395  #define SPA_VERSION_NEXT_CLONES         SPA_VERSION_11
 392  396  #define SPA_VERSION_ORIGIN              SPA_VERSION_11
 393  397  #define SPA_VERSION_DSL_SCRUB           SPA_VERSION_11
 394  398  #define SPA_VERSION_SNAP_PROPS          SPA_VERSION_12
 395  399  #define SPA_VERSION_USED_BREAKDOWN      SPA_VERSION_13
 396  400  #define SPA_VERSION_PASSTHROUGH_X       SPA_VERSION_14
 397  401  #define SPA_VERSION_USERSPACE           SPA_VERSION_15
 398  402  #define SPA_VERSION_STMF_PROP           SPA_VERSION_16
 399  403  #define SPA_VERSION_RAIDZ3              SPA_VERSION_17
 400  404  #define SPA_VERSION_USERREFS            SPA_VERSION_18
 401  405  #define SPA_VERSION_HOLES               SPA_VERSION_19
  
    | 
      ↓ open down ↓ | 
    30 lines elided | 
    
      ↑ open up ↑ | 
  
 402  406  #define SPA_VERSION_ZLE_COMPRESSION     SPA_VERSION_20
 403  407  #define SPA_VERSION_DEDUP               SPA_VERSION_21
 404  408  #define SPA_VERSION_RECVD_PROPS         SPA_VERSION_22
 405  409  #define SPA_VERSION_SLIM_ZIL            SPA_VERSION_23
 406  410  #define SPA_VERSION_SA                  SPA_VERSION_24
 407  411  #define SPA_VERSION_SCAN                SPA_VERSION_25
 408  412  #define SPA_VERSION_DIR_CLONES          SPA_VERSION_26
 409  413  #define SPA_VERSION_DEADLISTS           SPA_VERSION_26
 410  414  #define SPA_VERSION_FAST_SNAP           SPA_VERSION_27
 411  415  #define SPA_VERSION_MULTI_REPLACE       SPA_VERSION_28
      416 +#define SPA_VERSION_BEFORE_FEATURES     SPA_VERSION_28
      417 +#define SPA_VERSION_FEATURES            SPA_VERSION_5000
 412  418  
      419 +#define SPA_VERSION_IS_SUPPORTED(v) \
      420 +        (((v) >= SPA_VERSION_INITIAL && (v) <= SPA_VERSION_BEFORE_FEATURES) || \
      421 +        ((v) >= SPA_VERSION_FEATURES && (v) <= SPA_VERSION))
      422 +
 413  423  /*
 414  424   * ZPL version - rev'd whenever an incompatible on-disk format change
 415  425   * occurs.  This is independent of SPA/DMU/ZAP versioning.  You must
 416  426   * also update the version_table[] and help message in zfs_prop.c.
 417  427   *
 418  428   * When changing, be sure to teach GRUB how to read the new format!
 419  429   * See usr/src/grub/grub-0.97/stage2/{zfs-include/,fsys_zfs*}
 420  430   */
 421  431  #define ZPL_VERSION_1                   1ULL
 422  432  #define ZPL_VERSION_2                   2ULL
 423  433  #define ZPL_VERSION_3                   3ULL
 424  434  #define ZPL_VERSION_4                   4ULL
 425  435  #define ZPL_VERSION_5                   5ULL
 426  436  #define ZPL_VERSION                     ZPL_VERSION_5
 427  437  #define ZPL_VERSION_STRING              "5"
 428  438  
 429  439  #define ZPL_VERSION_INITIAL             ZPL_VERSION_1
 430  440  #define ZPL_VERSION_DIRENT_TYPE         ZPL_VERSION_2
 431  441  #define ZPL_VERSION_FUID                ZPL_VERSION_3
 432  442  #define ZPL_VERSION_NORMALIZATION       ZPL_VERSION_3
 433  443  #define ZPL_VERSION_SYSATTR             ZPL_VERSION_3
 434  444  #define ZPL_VERSION_USERSPACE           ZPL_VERSION_4
 435  445  #define ZPL_VERSION_SA                  ZPL_VERSION_5
 436  446  
 437  447  /* Rewind request information */
 438  448  #define ZPOOL_NO_REWIND         1  /* No policy - default behavior */
 439  449  #define ZPOOL_NEVER_REWIND      2  /* Do not search for best txg or rewind */
 440  450  #define ZPOOL_TRY_REWIND        4  /* Search for best txg, but do not rewind */
 441  451  #define ZPOOL_DO_REWIND         8  /* Rewind to best txg w/in deferred frees */
 442  452  #define ZPOOL_EXTREME_REWIND    16 /* Allow extreme measures to find best txg */
 443  453  #define ZPOOL_REWIND_MASK       28 /* All the possible rewind bits */
 444  454  #define ZPOOL_REWIND_POLICIES   31 /* All the possible policy bits */
 445  455  
 446  456  typedef struct zpool_rewind_policy {
 447  457          uint32_t        zrp_request;    /* rewind behavior requested */
 448  458          uint64_t        zrp_maxmeta;    /* max acceptable meta-data errors */
 449  459          uint64_t        zrp_maxdata;    /* max acceptable data errors */
 450  460          uint64_t        zrp_txg;        /* specific txg to load */
 451  461  } zpool_rewind_policy_t;
 452  462  
 453  463  /*
 454  464   * The following are configuration names used in the nvlist describing a pool's
 455  465   * configuration.
 456  466   */
 457  467  #define ZPOOL_CONFIG_VERSION            "version"
 458  468  #define ZPOOL_CONFIG_POOL_NAME          "name"
 459  469  #define ZPOOL_CONFIG_POOL_STATE         "state"
 460  470  #define ZPOOL_CONFIG_POOL_TXG           "txg"
 461  471  #define ZPOOL_CONFIG_POOL_GUID          "pool_guid"
 462  472  #define ZPOOL_CONFIG_CREATE_TXG         "create_txg"
 463  473  #define ZPOOL_CONFIG_TOP_GUID           "top_guid"
 464  474  #define ZPOOL_CONFIG_VDEV_TREE          "vdev_tree"
 465  475  #define ZPOOL_CONFIG_TYPE               "type"
 466  476  #define ZPOOL_CONFIG_CHILDREN           "children"
 467  477  #define ZPOOL_CONFIG_ID                 "id"
 468  478  #define ZPOOL_CONFIG_GUID               "guid"
 469  479  #define ZPOOL_CONFIG_PATH               "path"
 470  480  #define ZPOOL_CONFIG_DEVID              "devid"
 471  481  #define ZPOOL_CONFIG_METASLAB_ARRAY     "metaslab_array"
 472  482  #define ZPOOL_CONFIG_METASLAB_SHIFT     "metaslab_shift"
 473  483  #define ZPOOL_CONFIG_ASHIFT             "ashift"
 474  484  #define ZPOOL_CONFIG_ASIZE              "asize"
 475  485  #define ZPOOL_CONFIG_DTL                "DTL"
 476  486  #define ZPOOL_CONFIG_SCAN_STATS         "scan_stats"    /* not stored on disk */
 477  487  #define ZPOOL_CONFIG_VDEV_STATS         "vdev_stats"    /* not stored on disk */
 478  488  #define ZPOOL_CONFIG_WHOLE_DISK         "whole_disk"
 479  489  #define ZPOOL_CONFIG_ERRCOUNT           "error_count"
 480  490  #define ZPOOL_CONFIG_NOT_PRESENT        "not_present"
 481  491  #define ZPOOL_CONFIG_SPARES             "spares"
 482  492  #define ZPOOL_CONFIG_IS_SPARE           "is_spare"
 483  493  #define ZPOOL_CONFIG_NPARITY            "nparity"
 484  494  #define ZPOOL_CONFIG_HOSTID             "hostid"
 485  495  #define ZPOOL_CONFIG_HOSTNAME           "hostname"
 486  496  #define ZPOOL_CONFIG_LOADED_TIME        "initial_load_time"
 487  497  #define ZPOOL_CONFIG_UNSPARE            "unspare"
 488  498  #define ZPOOL_CONFIG_PHYS_PATH          "phys_path"
 489  499  #define ZPOOL_CONFIG_IS_LOG             "is_log"
 490  500  #define ZPOOL_CONFIG_L2CACHE            "l2cache"
 491  501  #define ZPOOL_CONFIG_HOLE_ARRAY         "hole_array"
 492  502  #define ZPOOL_CONFIG_VDEV_CHILDREN      "vdev_children"
 493  503  #define ZPOOL_CONFIG_IS_HOLE            "is_hole"
 494  504  #define ZPOOL_CONFIG_DDT_HISTOGRAM      "ddt_histogram"
 495  505  #define ZPOOL_CONFIG_DDT_OBJ_STATS      "ddt_object_stats"
 496  506  #define ZPOOL_CONFIG_DDT_STATS          "ddt_stats"
 497  507  #define ZPOOL_CONFIG_SPLIT              "splitcfg"
 498  508  #define ZPOOL_CONFIG_ORIG_GUID          "orig_guid"
  
    | 
      ↓ open down ↓ | 
    76 lines elided | 
    
      ↑ open up ↑ | 
  
 499  509  #define ZPOOL_CONFIG_SPLIT_GUID         "split_guid"
 500  510  #define ZPOOL_CONFIG_SPLIT_LIST         "guid_list"
 501  511  #define ZPOOL_CONFIG_REMOVING           "removing"
 502  512  #define ZPOOL_CONFIG_RESILVERING        "resilvering"
 503  513  #define ZPOOL_CONFIG_COMMENT            "comment"
 504  514  #define ZPOOL_CONFIG_SUSPENDED          "suspended"     /* not stored on disk */
 505  515  #define ZPOOL_CONFIG_TIMESTAMP          "timestamp"     /* not stored on disk */
 506  516  #define ZPOOL_CONFIG_BOOTFS             "bootfs"        /* not stored on disk */
 507  517  #define ZPOOL_CONFIG_MISSING_DEVICES    "missing_vdevs" /* not stored on disk */
 508  518  #define ZPOOL_CONFIG_LOAD_INFO          "load_info"     /* not stored on disk */
      519 +#define ZPOOL_CONFIG_REWIND_INFO        "rewind_info"   /* not stored on disk */
      520 +#define ZPOOL_CONFIG_UNSUP_FEAT         "unsup_feat"    /* not stored on disk */
      521 +#define ZPOOL_CONFIG_CAN_RDONLY         "can_rdonly"    /* not stored on disk */
      522 +#define ZPOOL_CONFIG_FEATURES_FOR_READ  "features_for_read"
      523 +#define ZPOOL_CONFIG_FEATURE_STATS      "feature_stats" /* not stored on disk */
 509  524  /*
 510  525   * The persistent vdev state is stored as separate values rather than a single
 511  526   * 'vdev_state' entry.  This is because a device can be in multiple states, such
 512  527   * as offline and degraded.
 513  528   */
 514  529  #define ZPOOL_CONFIG_OFFLINE            "offline"
 515  530  #define ZPOOL_CONFIG_FAULTED            "faulted"
 516  531  #define ZPOOL_CONFIG_DEGRADED           "degraded"
 517  532  #define ZPOOL_CONFIG_REMOVED            "removed"
 518  533  #define ZPOOL_CONFIG_FRU                "fru"
 519  534  #define ZPOOL_CONFIG_AUX_STATE          "aux_state"
 520  535  
 521  536  /* Rewind policy parameters */
 522  537  #define ZPOOL_REWIND_POLICY             "rewind-policy"
 523  538  #define ZPOOL_REWIND_REQUEST            "rewind-request"
 524  539  #define ZPOOL_REWIND_REQUEST_TXG        "rewind-request-txg"
 525  540  #define ZPOOL_REWIND_META_THRESH        "rewind-meta-thresh"
 526  541  #define ZPOOL_REWIND_DATA_THRESH        "rewind-data-thresh"
 527  542  
 528  543  /* Rewind data discovered */
 529  544  #define ZPOOL_CONFIG_LOAD_TIME          "rewind_txg_ts"
 530  545  #define ZPOOL_CONFIG_LOAD_DATA_ERRORS   "verify_data_errors"
 531  546  #define ZPOOL_CONFIG_REWIND_TIME        "seconds_of_rewind"
 532  547  
 533  548  #define VDEV_TYPE_ROOT                  "root"
 534  549  #define VDEV_TYPE_MIRROR                "mirror"
 535  550  #define VDEV_TYPE_REPLACING             "replacing"
 536  551  #define VDEV_TYPE_RAIDZ                 "raidz"
 537  552  #define VDEV_TYPE_DISK                  "disk"
 538  553  #define VDEV_TYPE_FILE                  "file"
 539  554  #define VDEV_TYPE_MISSING               "missing"
 540  555  #define VDEV_TYPE_HOLE                  "hole"
 541  556  #define VDEV_TYPE_SPARE                 "spare"
 542  557  #define VDEV_TYPE_LOG                   "log"
 543  558  #define VDEV_TYPE_L2CACHE               "l2cache"
 544  559  
 545  560  /*
 546  561   * This is needed in userland to report the minimum necessary device size.
 547  562   */
 548  563  #define SPA_MINDEVSIZE          (64ULL << 20)
 549  564  
 550  565  /*
 551  566   * The location of the pool configuration repository, shared between kernel and
 552  567   * userland.
 553  568   */
 554  569  #define ZPOOL_CACHE             "/etc/zfs/zpool.cache"
 555  570  
 556  571  /*
 557  572   * vdev states are ordered from least to most healthy.
 558  573   * A vdev that's CANT_OPEN or below is considered unusable.
 559  574   */
 560  575  typedef enum vdev_state {
 561  576          VDEV_STATE_UNKNOWN = 0, /* Uninitialized vdev                   */
 562  577          VDEV_STATE_CLOSED,      /* Not currently open                   */
 563  578          VDEV_STATE_OFFLINE,     /* Not allowed to open                  */
 564  579          VDEV_STATE_REMOVED,     /* Explicitly removed from system       */
 565  580          VDEV_STATE_CANT_OPEN,   /* Tried to open, but failed            */
 566  581          VDEV_STATE_FAULTED,     /* External request to fault device     */
 567  582          VDEV_STATE_DEGRADED,    /* Replicated vdev with unhealthy kids  */
 568  583          VDEV_STATE_HEALTHY      /* Presumed good                        */
 569  584  } vdev_state_t;
 570  585  
 571  586  #define VDEV_STATE_ONLINE       VDEV_STATE_HEALTHY
 572  587  
 573  588  /*
 574  589   * vdev aux states.  When a vdev is in the CANT_OPEN state, the aux field
 575  590   * of the vdev stats structure uses these constants to distinguish why.
 576  591   */
  
    | 
      ↓ open down ↓ | 
    58 lines elided | 
    
      ↑ open up ↑ | 
  
 577  592  typedef enum vdev_aux {
 578  593          VDEV_AUX_NONE,          /* no error                             */
 579  594          VDEV_AUX_OPEN_FAILED,   /* ldi_open_*() or vn_open() failed     */
 580  595          VDEV_AUX_CORRUPT_DATA,  /* bad label or disk contents           */
 581  596          VDEV_AUX_NO_REPLICAS,   /* insufficient number of replicas      */
 582  597          VDEV_AUX_BAD_GUID_SUM,  /* vdev guid sum doesn't match          */
 583  598          VDEV_AUX_TOO_SMALL,     /* vdev size is too small               */
 584  599          VDEV_AUX_BAD_LABEL,     /* the label is OK but invalid          */
 585  600          VDEV_AUX_VERSION_NEWER, /* on-disk version is too new           */
 586  601          VDEV_AUX_VERSION_OLDER, /* on-disk version is too old           */
      602 +        VDEV_AUX_UNSUP_FEAT,    /* unsupported features                 */
 587  603          VDEV_AUX_SPARED,        /* hot spare used in another pool       */
 588  604          VDEV_AUX_ERR_EXCEEDED,  /* too many errors                      */
 589  605          VDEV_AUX_IO_FAILURE,    /* experienced I/O failure              */
 590  606          VDEV_AUX_BAD_LOG,       /* cannot read log chain(s)             */
 591  607          VDEV_AUX_EXTERNAL,      /* external diagnosis                   */
 592  608          VDEV_AUX_SPLIT_POOL     /* vdev was split off into another pool */
 593  609  } vdev_aux_t;
 594  610  
 595  611  /*
 596  612   * pool state.  The following states are written to disk as part of the normal
 597  613   * SPA lifecycle: ACTIVE, EXPORTED, DESTROYED, SPARE, L2CACHE.  The remaining
 598  614   * states are software abstractions used at various levels to communicate
 599  615   * pool state.
 600  616   */
 601  617  typedef enum pool_state {
 602  618          POOL_STATE_ACTIVE = 0,          /* In active use                */
 603  619          POOL_STATE_EXPORTED,            /* Explicitly exported          */
 604  620          POOL_STATE_DESTROYED,           /* Explicitly destroyed         */
 605  621          POOL_STATE_SPARE,               /* Reserved for hot spare use   */
 606  622          POOL_STATE_L2CACHE,             /* Level 2 ARC device           */
 607  623          POOL_STATE_UNINITIALIZED,       /* Internal spa_t state         */
 608  624          POOL_STATE_UNAVAIL,             /* Internal libzfs state        */
 609  625          POOL_STATE_POTENTIALLY_ACTIVE   /* Internal libzfs state        */
 610  626  } pool_state_t;
 611  627  
 612  628  /*
 613  629   * Scan Functions.
 614  630   */
 615  631  typedef enum pool_scan_func {
 616  632          POOL_SCAN_NONE,
 617  633          POOL_SCAN_SCRUB,
 618  634          POOL_SCAN_RESILVER,
 619  635          POOL_SCAN_FUNCS
 620  636  } pool_scan_func_t;
 621  637  
 622  638  /*
 623  639   * ZIO types.  Needed to interpret vdev statistics below.
 624  640   */
 625  641  typedef enum zio_type {
 626  642          ZIO_TYPE_NULL = 0,
 627  643          ZIO_TYPE_READ,
 628  644          ZIO_TYPE_WRITE,
 629  645          ZIO_TYPE_FREE,
 630  646          ZIO_TYPE_CLAIM,
 631  647          ZIO_TYPE_IOCTL,
 632  648          ZIO_TYPES
 633  649  } zio_type_t;
 634  650  
 635  651  /*
 636  652   * Pool statistics.  Note: all fields should be 64-bit because this
 637  653   * is passed between kernel and userland as an nvlist uint64 array.
 638  654   */
 639  655  typedef struct pool_scan_stat {
 640  656          /* values stored on disk */
 641  657          uint64_t        pss_func;       /* pool_scan_func_t */
 642  658          uint64_t        pss_state;      /* dsl_scan_state_t */
 643  659          uint64_t        pss_start_time; /* scan start time */
 644  660          uint64_t        pss_end_time;   /* scan end time */
 645  661          uint64_t        pss_to_examine; /* total bytes to scan */
 646  662          uint64_t        pss_examined;   /* total examined bytes */
 647  663          uint64_t        pss_to_process; /* total bytes to process */
 648  664          uint64_t        pss_processed;  /* total processed bytes */
 649  665          uint64_t        pss_errors;     /* scan errors  */
 650  666  
 651  667          /* values not stored on disk */
 652  668          uint64_t        pss_pass_exam;  /* examined bytes per scan pass */
 653  669          uint64_t        pss_pass_start; /* start time of a scan pass */
 654  670  } pool_scan_stat_t;
 655  671  
 656  672  typedef enum dsl_scan_state {
 657  673          DSS_NONE,
 658  674          DSS_SCANNING,
 659  675          DSS_FINISHED,
 660  676          DSS_CANCELED,
 661  677          DSS_NUM_STATES
 662  678  } dsl_scan_state_t;
 663  679  
 664  680  
 665  681  /*
 666  682   * Vdev statistics.  Note: all fields should be 64-bit because this
 667  683   * is passed between kernel and userland as an nvlist uint64 array.
 668  684   */
 669  685  typedef struct vdev_stat {
 670  686          hrtime_t        vs_timestamp;           /* time since vdev load */
 671  687          uint64_t        vs_state;               /* vdev state           */
 672  688          uint64_t        vs_aux;                 /* see vdev_aux_t       */
 673  689          uint64_t        vs_alloc;               /* space allocated      */
 674  690          uint64_t        vs_space;               /* total capacity       */
 675  691          uint64_t        vs_dspace;              /* deflated capacity    */
 676  692          uint64_t        vs_rsize;               /* replaceable dev size */
 677  693          uint64_t        vs_esize;               /* expandable dev size */
 678  694          uint64_t        vs_ops[ZIO_TYPES];      /* operation count      */
 679  695          uint64_t        vs_bytes[ZIO_TYPES];    /* bytes read/written   */
 680  696          uint64_t        vs_read_errors;         /* read errors          */
 681  697          uint64_t        vs_write_errors;        /* write errors         */
 682  698          uint64_t        vs_checksum_errors;     /* checksum errors      */
 683  699          uint64_t        vs_self_healed;         /* self-healed bytes    */
 684  700          uint64_t        vs_scan_removing;       /* removing?    */
 685  701          uint64_t        vs_scan_processed;      /* scan processed bytes */
 686  702  } vdev_stat_t;
 687  703  
 688  704  /*
 689  705   * DDT statistics.  Note: all fields should be 64-bit because this
 690  706   * is passed between kernel and userland as an nvlist uint64 array.
 691  707   */
 692  708  typedef struct ddt_object {
 693  709          uint64_t        ddo_count;      /* number of elments in ddt     */
 694  710          uint64_t        ddo_dspace;     /* size of ddt on disk          */
 695  711          uint64_t        ddo_mspace;     /* size of ddt in-core          */
 696  712  } ddt_object_t;
 697  713  
 698  714  typedef struct ddt_stat {
 699  715          uint64_t        dds_blocks;     /* blocks                       */
 700  716          uint64_t        dds_lsize;      /* logical size                 */
 701  717          uint64_t        dds_psize;      /* physical size                */
 702  718          uint64_t        dds_dsize;      /* deflated allocated size      */
 703  719          uint64_t        dds_ref_blocks; /* referenced blocks            */
 704  720          uint64_t        dds_ref_lsize;  /* referenced lsize * refcnt    */
 705  721          uint64_t        dds_ref_psize;  /* referenced psize * refcnt    */
 706  722          uint64_t        dds_ref_dsize;  /* referenced dsize * refcnt    */
 707  723  } ddt_stat_t;
 708  724  
 709  725  typedef struct ddt_histogram {
 710  726          ddt_stat_t      ddh_stat[64];   /* power-of-two histogram buckets */
 711  727  } ddt_histogram_t;
 712  728  
 713  729  #define ZVOL_DRIVER     "zvol"
 714  730  #define ZFS_DRIVER      "zfs"
 715  731  #define ZFS_DEV         "/dev/zfs"
 716  732  
 717  733  /* general zvol path */
 718  734  #define ZVOL_DIR                "/dev/zvol"
 719  735  /* expansion */
 720  736  #define ZVOL_PSEUDO_DEV         "/devices/pseudo/zfs@0:"
 721  737  /* for dump and swap */
 722  738  #define ZVOL_FULL_DEV_DIR       ZVOL_DIR "/dsk/"
 723  739  #define ZVOL_FULL_RDEV_DIR      ZVOL_DIR "/rdsk/"
 724  740  
 725  741  #define ZVOL_PROP_NAME          "name"
 726  742  #define ZVOL_DEFAULT_BLOCKSIZE  8192
 727  743  
 728  744  /*
 729  745   * /dev/zfs ioctl numbers.
 730  746   */
 731  747  #define ZFS_IOC         ('Z' << 8)
 732  748  
 733  749  typedef enum zfs_ioc {
 734  750          ZFS_IOC_POOL_CREATE = ZFS_IOC,
 735  751          ZFS_IOC_POOL_DESTROY,
 736  752          ZFS_IOC_POOL_IMPORT,
 737  753          ZFS_IOC_POOL_EXPORT,
 738  754          ZFS_IOC_POOL_CONFIGS,
 739  755          ZFS_IOC_POOL_STATS,
 740  756          ZFS_IOC_POOL_TRYIMPORT,
 741  757          ZFS_IOC_POOL_SCAN,
 742  758          ZFS_IOC_POOL_FREEZE,
 743  759          ZFS_IOC_POOL_UPGRADE,
 744  760          ZFS_IOC_POOL_GET_HISTORY,
 745  761          ZFS_IOC_VDEV_ADD,
 746  762          ZFS_IOC_VDEV_REMOVE,
 747  763          ZFS_IOC_VDEV_SET_STATE,
 748  764          ZFS_IOC_VDEV_ATTACH,
 749  765          ZFS_IOC_VDEV_DETACH,
 750  766          ZFS_IOC_VDEV_SETPATH,
 751  767          ZFS_IOC_VDEV_SETFRU,
 752  768          ZFS_IOC_OBJSET_STATS,
 753  769          ZFS_IOC_OBJSET_ZPLPROPS,
 754  770          ZFS_IOC_DATASET_LIST_NEXT,
 755  771          ZFS_IOC_SNAPSHOT_LIST_NEXT,
 756  772          ZFS_IOC_SET_PROP,
 757  773          ZFS_IOC_CREATE,
 758  774          ZFS_IOC_DESTROY,
 759  775          ZFS_IOC_ROLLBACK,
 760  776          ZFS_IOC_RENAME,
 761  777          ZFS_IOC_RECV,
 762  778          ZFS_IOC_SEND,
 763  779          ZFS_IOC_INJECT_FAULT,
 764  780          ZFS_IOC_CLEAR_FAULT,
 765  781          ZFS_IOC_INJECT_LIST_NEXT,
 766  782          ZFS_IOC_ERROR_LOG,
 767  783          ZFS_IOC_CLEAR,
 768  784          ZFS_IOC_PROMOTE,
 769  785          ZFS_IOC_SNAPSHOT,
 770  786          ZFS_IOC_DSOBJ_TO_DSNAME,
 771  787          ZFS_IOC_OBJ_TO_PATH,
 772  788          ZFS_IOC_POOL_SET_PROPS,
 773  789          ZFS_IOC_POOL_GET_PROPS,
 774  790          ZFS_IOC_SET_FSACL,
 775  791          ZFS_IOC_GET_FSACL,
 776  792          ZFS_IOC_SHARE,
 777  793          ZFS_IOC_INHERIT_PROP,
 778  794          ZFS_IOC_SMB_ACL,
 779  795          ZFS_IOC_USERSPACE_ONE,
 780  796          ZFS_IOC_USERSPACE_MANY,
 781  797          ZFS_IOC_USERSPACE_UPGRADE,
 782  798          ZFS_IOC_HOLD,
 783  799          ZFS_IOC_RELEASE,
 784  800          ZFS_IOC_GET_HOLDS,
 785  801          ZFS_IOC_OBJSET_RECVD_PROPS,
 786  802          ZFS_IOC_VDEV_SPLIT,
 787  803          ZFS_IOC_NEXT_OBJ,
 788  804          ZFS_IOC_DIFF,
 789  805          ZFS_IOC_TMP_SNAPSHOT,
 790  806          ZFS_IOC_OBJ_TO_STATS,
 791  807          ZFS_IOC_SPACE_WRITTEN,
 792  808          ZFS_IOC_SPACE_SNAPS,
 793  809          ZFS_IOC_DESTROY_SNAPS_NVL,
 794  810          ZFS_IOC_POOL_REGUID,
 795  811          ZFS_IOC_POOL_REOPEN,
 796  812          ZFS_IOC_SEND_PROGRESS
 797  813  } zfs_ioc_t;
 798  814  
 799  815  /*
 800  816   * Internal SPA load state.  Used by FMA diagnosis engine.
 801  817   */
 802  818  typedef enum {
 803  819          SPA_LOAD_NONE,          /* no load in progress  */
 804  820          SPA_LOAD_OPEN,          /* normal open          */
 805  821          SPA_LOAD_IMPORT,        /* import in progress   */
 806  822          SPA_LOAD_TRYIMPORT,     /* tryimport in progress */
 807  823          SPA_LOAD_RECOVER,       /* recovery requested   */
 808  824          SPA_LOAD_ERROR          /* load failed          */
 809  825  } spa_load_state_t;
 810  826  
 811  827  /*
 812  828   * Bookmark name values.
 813  829   */
 814  830  #define ZPOOL_ERR_LIST          "error list"
 815  831  #define ZPOOL_ERR_DATASET       "dataset"
 816  832  #define ZPOOL_ERR_OBJECT        "object"
 817  833  
 818  834  #define HIS_MAX_RECORD_LEN      (MAXPATHLEN + MAXPATHLEN + 1)
 819  835  
 820  836  /*
 821  837   * The following are names used in the nvlist describing
 822  838   * the pool's history log.
 823  839   */
 824  840  #define ZPOOL_HIST_RECORD       "history record"
 825  841  #define ZPOOL_HIST_TIME         "history time"
 826  842  #define ZPOOL_HIST_CMD          "history command"
 827  843  #define ZPOOL_HIST_WHO          "history who"
 828  844  #define ZPOOL_HIST_ZONE         "history zone"
 829  845  #define ZPOOL_HIST_HOST         "history hostname"
 830  846  #define ZPOOL_HIST_TXG          "history txg"
 831  847  #define ZPOOL_HIST_INT_EVENT    "history internal event"
 832  848  #define ZPOOL_HIST_INT_STR      "history internal str"
 833  849  
 834  850  /*
 835  851   * Flags for ZFS_IOC_VDEV_SET_STATE
 836  852   */
 837  853  #define ZFS_ONLINE_CHECKREMOVE  0x1
 838  854  #define ZFS_ONLINE_UNSPARE      0x2
 839  855  #define ZFS_ONLINE_FORCEFAULT   0x4
 840  856  #define ZFS_ONLINE_EXPAND       0x8
 841  857  #define ZFS_OFFLINE_TEMPORARY   0x1
 842  858  
 843  859  /*
 844  860   * Flags for ZFS_IOC_POOL_IMPORT
 845  861   */
 846  862  #define ZFS_IMPORT_NORMAL       0x0
 847  863  #define ZFS_IMPORT_VERBATIM     0x1
 848  864  #define ZFS_IMPORT_ANY_HOST     0x2
 849  865  #define ZFS_IMPORT_MISSING_LOG  0x4
 850  866  #define ZFS_IMPORT_ONLY         0x8
 851  867  
 852  868  /*
 853  869   * Sysevent payload members.  ZFS will generate the following sysevents with the
 854  870   * given payloads:
 855  871   *
 856  872   *      ESC_ZFS_RESILVER_START
 857  873   *      ESC_ZFS_RESILVER_END
 858  874   *      ESC_ZFS_POOL_DESTROY
 859  875   *      ESC_ZFS_POOL_REGUID
 860  876   *
 861  877   *              ZFS_EV_POOL_NAME        DATA_TYPE_STRING
 862  878   *              ZFS_EV_POOL_GUID        DATA_TYPE_UINT64
 863  879   *
 864  880   *      ESC_ZFS_VDEV_REMOVE
 865  881   *      ESC_ZFS_VDEV_CLEAR
 866  882   *      ESC_ZFS_VDEV_CHECK
 867  883   *
 868  884   *              ZFS_EV_POOL_NAME        DATA_TYPE_STRING
 869  885   *              ZFS_EV_POOL_GUID        DATA_TYPE_UINT64
 870  886   *              ZFS_EV_VDEV_PATH        DATA_TYPE_STRING        (optional)
 871  887   *              ZFS_EV_VDEV_GUID        DATA_TYPE_UINT64
 872  888   */
 873  889  #define ZFS_EV_POOL_NAME        "pool_name"
 874  890  #define ZFS_EV_POOL_GUID        "pool_guid"
 875  891  #define ZFS_EV_VDEV_PATH        "vdev_path"
 876  892  #define ZFS_EV_VDEV_GUID        "vdev_guid"
 877  893  
 878  894  /*
 879  895   * Note: This is encoded on-disk, so new events must be added to the
 880  896   * end, and unused events can not be removed.  Be sure to edit
 881  897   * libzfs_pool.c: hist_event_table[].
 882  898   */
 883  899  typedef enum history_internal_events {
 884  900          LOG_NO_EVENT = 0,
 885  901          LOG_POOL_CREATE,
 886  902          LOG_POOL_VDEV_ADD,
 887  903          LOG_POOL_REMOVE,
 888  904          LOG_POOL_DESTROY,
 889  905          LOG_POOL_EXPORT,
 890  906          LOG_POOL_IMPORT,
 891  907          LOG_POOL_VDEV_ATTACH,
 892  908          LOG_POOL_VDEV_REPLACE,
 893  909          LOG_POOL_VDEV_DETACH,
 894  910          LOG_POOL_VDEV_ONLINE,
 895  911          LOG_POOL_VDEV_OFFLINE,
 896  912          LOG_POOL_UPGRADE,
 897  913          LOG_POOL_CLEAR,
 898  914          LOG_POOL_SCAN,
 899  915          LOG_POOL_PROPSET,
 900  916          LOG_DS_CREATE,
 901  917          LOG_DS_CLONE,
 902  918          LOG_DS_DESTROY,
 903  919          LOG_DS_DESTROY_BEGIN,
 904  920          LOG_DS_INHERIT,
 905  921          LOG_DS_PROPSET,
 906  922          LOG_DS_QUOTA,
 907  923          LOG_DS_PERM_UPDATE,
 908  924          LOG_DS_PERM_REMOVE,
 909  925          LOG_DS_PERM_WHO_REMOVE,
 910  926          LOG_DS_PROMOTE,
 911  927          LOG_DS_RECEIVE,
 912  928          LOG_DS_RENAME,
 913  929          LOG_DS_RESERVATION,
 914  930          LOG_DS_REPLAY_INC_SYNC,
 915  931          LOG_DS_REPLAY_FULL_SYNC,
 916  932          LOG_DS_ROLLBACK,
 917  933          LOG_DS_SNAPSHOT,
 918  934          LOG_DS_UPGRADE,
 919  935          LOG_DS_REFQUOTA,
 920  936          LOG_DS_REFRESERV,
 921  937          LOG_POOL_SCAN_DONE,
 922  938          LOG_DS_USER_HOLD,
 923  939          LOG_DS_USER_RELEASE,
 924  940          LOG_POOL_SPLIT,
 925  941          LOG_END
 926  942  } history_internal_events_t;
 927  943  
 928  944  #ifdef  __cplusplus
 929  945  }
 930  946  #endif
 931  947  
 932  948  #endif  /* _SYS_FS_ZFS_H */
  
    | 
      ↓ open down ↓ | 
    336 lines elided | 
    
      ↑ open up ↑ | 
  
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX