Home | History | Annotate | Line # | Download | only in zfs
zpool_prop.c revision 1.1.1.3
      1 /*
      2  * CDDL HEADER START
      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  * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
     23  * Copyright 2011 Nexenta Systems, Inc. All rights reserved.
     24  * Copyright (c) 2012, 2014 by Delphix. All rights reserved.
     25  * Copyright (c) 2014 Integros [integros.com]
     26  */
     27 
     28 #include <sys/zio.h>
     29 #include <sys/spa.h>
     30 #include <sys/zfs_acl.h>
     31 #include <sys/zfs_ioctl.h>
     32 #include <sys/fs/zfs.h>
     33 
     34 #include "zfs_prop.h"
     35 
     36 #if defined(_KERNEL)
     37 #include <sys/systm.h>
     38 #else
     39 #include <stdlib.h>
     40 #include <string.h>
     41 #include <ctype.h>
     42 #endif
     43 
     44 static zprop_desc_t zpool_prop_table[ZPOOL_NUM_PROPS];
     45 
     46 zprop_desc_t *
     47 zpool_prop_get_table(void)
     48 {
     49 	return (zpool_prop_table);
     50 }
     51 
     52 void
     53 zpool_prop_init(void)
     54 {
     55 	static zprop_index_t boolean_table[] = {
     56 		{ "off",	0},
     57 		{ "on",		1},
     58 		{ NULL }
     59 	};
     60 
     61 	static zprop_index_t failuremode_table[] = {
     62 		{ "wait",	ZIO_FAILURE_MODE_WAIT },
     63 		{ "continue",	ZIO_FAILURE_MODE_CONTINUE },
     64 		{ "panic",	ZIO_FAILURE_MODE_PANIC },
     65 		{ NULL }
     66 	};
     67 
     68 	/* string properties */
     69 	zprop_register_string(ZPOOL_PROP_ALTROOT, "altroot", NULL, PROP_DEFAULT,
     70 	    ZFS_TYPE_POOL, "<path>", "ALTROOT");
     71 	zprop_register_string(ZPOOL_PROP_BOOTFS, "bootfs", NULL, PROP_DEFAULT,
     72 	    ZFS_TYPE_POOL, "<filesystem>", "BOOTFS");
     73 	zprop_register_string(ZPOOL_PROP_CACHEFILE, "cachefile", NULL,
     74 	    PROP_DEFAULT, ZFS_TYPE_POOL, "<file> | none", "CACHEFILE");
     75 	zprop_register_string(ZPOOL_PROP_COMMENT, "comment", NULL,
     76 	    PROP_DEFAULT, ZFS_TYPE_POOL, "<comment-string>", "COMMENT");
     77 
     78 	/* readonly number properties */
     79 	zprop_register_number(ZPOOL_PROP_SIZE, "size", 0, PROP_READONLY,
     80 	    ZFS_TYPE_POOL, "<size>", "SIZE");
     81 	zprop_register_number(ZPOOL_PROP_FREE, "free", 0, PROP_READONLY,
     82 	    ZFS_TYPE_POOL, "<size>", "FREE");
     83 	zprop_register_number(ZPOOL_PROP_FREEING, "freeing", 0, PROP_READONLY,
     84 	    ZFS_TYPE_POOL, "<size>", "FREEING");
     85 	zprop_register_number(ZPOOL_PROP_LEAKED, "leaked", 0, PROP_READONLY,
     86 	    ZFS_TYPE_POOL, "<size>", "LEAKED");
     87 	zprop_register_number(ZPOOL_PROP_ALLOCATED, "allocated", 0,
     88 	    PROP_READONLY, ZFS_TYPE_POOL, "<size>", "ALLOC");
     89 	zprop_register_number(ZPOOL_PROP_EXPANDSZ, "expandsize", 0,
     90 	    PROP_READONLY, ZFS_TYPE_POOL, "<size>", "EXPANDSZ");
     91 	zprop_register_number(ZPOOL_PROP_FRAGMENTATION, "fragmentation", 0,
     92 	    PROP_READONLY, ZFS_TYPE_POOL, "<percent>", "FRAG");
     93 	zprop_register_number(ZPOOL_PROP_CAPACITY, "capacity", 0, PROP_READONLY,
     94 	    ZFS_TYPE_POOL, "<size>", "CAP");
     95 	zprop_register_number(ZPOOL_PROP_GUID, "guid", 0, PROP_READONLY,
     96 	    ZFS_TYPE_POOL, "<guid>", "GUID");
     97 	zprop_register_number(ZPOOL_PROP_HEALTH, "health", 0, PROP_READONLY,
     98 	    ZFS_TYPE_POOL, "<state>", "HEALTH");
     99 	zprop_register_number(ZPOOL_PROP_DEDUPRATIO, "dedupratio", 0,
    100 	    PROP_READONLY, ZFS_TYPE_POOL, "<1.00x or higher if deduped>",
    101 	    "DEDUP");
    102 
    103 	/* default number properties */
    104 	zprop_register_number(ZPOOL_PROP_VERSION, "version", SPA_VERSION,
    105 	    PROP_DEFAULT, ZFS_TYPE_POOL, "<version>", "VERSION");
    106 	zprop_register_number(ZPOOL_PROP_DEDUPDITTO, "dedupditto", 0,
    107 	    PROP_DEFAULT, ZFS_TYPE_POOL, "<threshold (min 100)>", "DEDUPDITTO");
    108 
    109 	/* default index (boolean) properties */
    110 	zprop_register_index(ZPOOL_PROP_DELEGATION, "delegation", 1,
    111 	    PROP_DEFAULT, ZFS_TYPE_POOL, "on | off", "DELEGATION",
    112 	    boolean_table);
    113 	zprop_register_index(ZPOOL_PROP_AUTOREPLACE, "autoreplace", 0,
    114 	    PROP_DEFAULT, ZFS_TYPE_POOL, "on | off", "REPLACE", boolean_table);
    115 	zprop_register_index(ZPOOL_PROP_LISTSNAPS, "listsnapshots", 0,
    116 	    PROP_DEFAULT, ZFS_TYPE_POOL, "on | off", "LISTSNAPS",
    117 	    boolean_table);
    118 	zprop_register_index(ZPOOL_PROP_AUTOEXPAND, "autoexpand", 0,
    119 	    PROP_DEFAULT, ZFS_TYPE_POOL, "on | off", "EXPAND", boolean_table);
    120 	zprop_register_index(ZPOOL_PROP_READONLY, "readonly", 0,
    121 	    PROP_DEFAULT, ZFS_TYPE_POOL, "on | off", "RDONLY", boolean_table);
    122 
    123 	/* default index properties */
    124 	zprop_register_index(ZPOOL_PROP_FAILUREMODE, "failmode",
    125 	    ZIO_FAILURE_MODE_WAIT, PROP_DEFAULT, ZFS_TYPE_POOL,
    126 	    "wait | continue | panic", "FAILMODE", failuremode_table);
    127 
    128 	/* hidden properties */
    129 	zprop_register_hidden(ZPOOL_PROP_NAME, "name", PROP_TYPE_STRING,
    130 	    PROP_READONLY, ZFS_TYPE_POOL, "NAME");
    131 	zprop_register_hidden(ZPOOL_PROP_MAXBLOCKSIZE, "maxblocksize",
    132 	    PROP_TYPE_NUMBER, PROP_READONLY, ZFS_TYPE_POOL, "MAXBLOCKSIZE");
    133 }
    134 
    135 /*
    136  * Given a property name and its type, returns the corresponding property ID.
    137  */
    138 zpool_prop_t
    139 zpool_name_to_prop(const char *propname)
    140 {
    141 	return (zprop_name_to_prop(propname, ZFS_TYPE_POOL));
    142 }
    143 
    144 /*
    145  * Given a pool property ID, returns the corresponding name.
    146  * Assuming the pool propety ID is valid.
    147  */
    148 const char *
    149 zpool_prop_to_name(zpool_prop_t prop)
    150 {
    151 	return (zpool_prop_table[prop].pd_name);
    152 }
    153 
    154 zprop_type_t
    155 zpool_prop_get_type(zpool_prop_t prop)
    156 {
    157 	return (zpool_prop_table[prop].pd_proptype);
    158 }
    159 
    160 boolean_t
    161 zpool_prop_readonly(zpool_prop_t prop)
    162 {
    163 	return (zpool_prop_table[prop].pd_attr == PROP_READONLY);
    164 }
    165 
    166 const char *
    167 zpool_prop_default_string(zpool_prop_t prop)
    168 {
    169 	return (zpool_prop_table[prop].pd_strdefault);
    170 }
    171 
    172 uint64_t
    173 zpool_prop_default_numeric(zpool_prop_t prop)
    174 {
    175 	return (zpool_prop_table[prop].pd_numdefault);
    176 }
    177 
    178 /*
    179  * Returns true if this is a valid feature@ property.
    180  */
    181 boolean_t
    182 zpool_prop_feature(const char *name)
    183 {
    184 	static const char *prefix = "feature@";
    185 	return (strncmp(name, prefix, strlen(prefix)) == 0);
    186 }
    187 
    188 /*
    189  * Returns true if this is a valid unsupported@ property.
    190  */
    191 boolean_t
    192 zpool_prop_unsupported(const char *name)
    193 {
    194 	static const char *prefix = "unsupported@";
    195 	return (strncmp(name, prefix, strlen(prefix)) == 0);
    196 }
    197 
    198 int
    199 zpool_prop_string_to_index(zpool_prop_t prop, const char *string,
    200     uint64_t *index)
    201 {
    202 	return (zprop_string_to_index(prop, string, index, ZFS_TYPE_POOL));
    203 }
    204 
    205 int
    206 zpool_prop_index_to_string(zpool_prop_t prop, uint64_t index,
    207     const char **string)
    208 {
    209 	return (zprop_index_to_string(prop, index, string, ZFS_TYPE_POOL));
    210 }
    211 
    212 uint64_t
    213 zpool_prop_random_value(zpool_prop_t prop, uint64_t seed)
    214 {
    215 	return (zprop_random_value(prop, seed, ZFS_TYPE_POOL));
    216 }
    217 
    218 #ifndef _KERNEL
    219 
    220 const char *
    221 zpool_prop_values(zpool_prop_t prop)
    222 {
    223 	return (zpool_prop_table[prop].pd_values);
    224 }
    225 
    226 const char *
    227 zpool_prop_column_name(zpool_prop_t prop)
    228 {
    229 	return (zpool_prop_table[prop].pd_colname);
    230 }
    231 
    232 boolean_t
    233 zpool_prop_align_right(zpool_prop_t prop)
    234 {
    235 	return (zpool_prop_table[prop].pd_rightalign);
    236 }
    237 #endif
    238