dsl_prop.c revision 92241e0b80813d0b83c08e730a29b9d1831794fc
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2009 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#include <sys/zfs_context.h>
#include <sys/dmu_objset.h>
#include <sys/dsl_dataset.h>
#include <sys/dsl_prop.h>
#include <sys/dsl_synctask.h>
#include "zfs_prop.h"
#define ZPROP_INHERIT_SUFFIX "$inherit"
#define ZPROP_RECVD_SUFFIX "$recvd"
static int
{
/*
* The setonce properties are read-only, BUT they still
* have a default value that can be used as the initial
* value.
*/
return (ENOENT);
if (intsz != 1)
return (EOVERFLOW);
numints);
} else {
return (EOVERFLOW);
}
return (0);
}
int
{
char *inheritstr;
char *recvdstr;
if (setpoint)
setpoint[0] = '\0';
/*
* Note: dd may become NULL, therefore we shouldn't dereference it
* after this loop.
*/
if (!inheritable)
break;
inheriting = B_TRUE;
}
/* Check for a local value. */
break;
}
/*
* Skip the check for a received value if there is an explicit
* inheritance entry.
*/
break;
/* Check for a received value. */
if (inheriting) {
} else {
}
}
break;
}
}
/*
* If we found an explicit inheritance entry, err is zero even
* though we haven't yet found the value, so reinitializing err
* at the end of the loop (instead of at the beginning) ensures
* that err has a valid post-loop value.
*/
}
return (err);
}
int
{
if (zapobj != 0) {
int err;
/* Check for a local value. */
return (err);
}
/*
* Skip the check for a received value if there is an explicit
* inheritance entry.
*/
if (inheritable) {
return (err);
}
/* Check for a received value. */
return (err);
}
}
}
}
/*
* Register interest in the named property. We'll call the callback
* once to notify it of the current property value, and again each time
* the property changes, until this callback is unregistered.
*
* Return 0 on success, errno if the prop is not an integer value.
*/
int
{
int err;
int need_rwlock;
if (need_rwlock)
if (err != 0) {
if (need_rwlock)
return (err);
}
if (need_rwlock)
/* Leave dir open until this callback is unregistered */
return (0);
}
int
{
int err;
if (err)
return (err);
return (err);
}
/*
* Get the current property value. It may have changed by the time this
* function returns, so it is NOT safe to follow up with
* dsl_prop_register() and assume that the value has not changed in
* between.
*
* Return 0 on success, ENOENT if ddname is invalid.
*/
int
{
}
void
{
}
/*
* Predict the effective value of the given special property if it were set with
* the given value and source. This is not a general purpose function. It exists
* only to handle the special requirements of the quota and reservation
* properties. The fact that these properties are non-inheritable greatly
* simplifies the prediction logic.
*
* Returns 0 on success, a positive error code on failure, or -1 if called with
* a property not handled by this function.
*/
int
{
char *recvdstr;
int err = 0;
switch (prop) {
case ZFS_PROP_QUOTA:
case ZFS_PROP_RESERVATION:
case ZFS_PROP_REFQUOTA:
case ZFS_PROP_REFRESERVATION:
break;
default:
return (-1);
}
if (version < SPA_VERSION_RECVD_PROPS) {
if (source & ZPROP_SRC_NONE)
else if (source & ZPROP_SRC_RECEIVED)
}
switch (source) {
case ZPROP_SRC_NONE:
/* Revert to the received value, if any. */
psa->psa_effective_value = 0;
break;
case ZPROP_SRC_LOCAL:
break;
case ZPROP_SRC_RECEIVED:
/*
* If there's no local setting, then the new received value will
* be the effective value.
*/
break;
case (ZPROP_SRC_NONE | ZPROP_SRC_RECEIVED):
/*
* We're clearing the received value, so the local setting (if
* it exists) remains the effective value.
*/
psa->psa_effective_value = 0;
break;
default:
}
return (0);
return (err);
}
#ifdef ZFS_DEBUG
void
{
char setpoint[MAXNAMELEN];
int err;
if (version < SPA_VERSION_RECVD_PROPS) {
switch (prop) {
case ZFS_PROP_QUOTA:
case ZFS_PROP_RESERVATION:
return;
}
}
"predicted effective value: %llu, "
"actual effective value: %llu (setpoint: %s)",
(unsigned long long)psa->psa_effective_value,
}
}
#endif
/*
* Unregister this callback. Return 0 on success, ENOENT if ddname is
* invalid, ENOMSG if no matching callback registered.
*/
int
{
break;
}
return (ENOMSG);
}
/* Clean up from dsl_prop_register */
return (0);
}
/*
* Return the number of callbacks that are registered for this dataset.
*/
int
{
int num = 0;
num++;
}
return (num);
}
static void
{
int err;
if (err)
return;
if (!first) {
/*
* If the prop is set here, then this change is not
* being inherited here or below; stop the recursion.
*/
if (err == 0) {
return;
}
}
continue;
/*
* If the property is set on this ds, then it is not
* inherited here; don't call the callback.
*/
continue;
}
zap_cursor_advance(&zc)) {
}
}
void
{
int isint;
char valbuf[32];
char *inheritstr;
char *recvdstr;
int err;
}
} else {
}
if (version < SPA_VERSION_RECVD_PROPS) {
return;
if (source & ZPROP_SRC_NONE)
else if (source & ZPROP_SRC_RECEIVED)
}
switch (source) {
case ZPROP_SRC_NONE:
/*
* revert to received value, if any (inherit -S)
* - remove propname
* - remove propname$inherit
*/
break;
case ZPROP_SRC_LOCAL:
/*
* remove propname$inherit
* set propname -> value
*/
break;
case ZPROP_SRC_INHERITED:
/*
* explicitly inherit
* - remove propname
* - set propname$inherit
*/
if (version >= SPA_VERSION_RECVD_PROPS &&
dummy = 0;
}
break;
case ZPROP_SRC_RECEIVED:
/*
* set propname$recvd -> value
*/
break;
/*
* clear local and received settings
* - remove propname
* - remove propname$inherit
* - remove propname$recvd
*/
/* FALLTHRU */
case (ZPROP_SRC_NONE | ZPROP_SRC_RECEIVED):
/*
* remove propname$recvd
*/
break;
default:
}
if (isint) {
/*
* It's a snapshot; nothing can inherit this
* property, so just look for callbacks on this
* ds here.
*/
}
} else {
}
} else {
if (source == ZPROP_SRC_LOCAL) {
} else {
}
}
"%s=%s dataset = %llu", propname,
}
void
{
/*
* dsl_prop_get_all_impl() returns properties in this
* format.
*/
&pair) == 0);
}
} else {
}
}
}
void
{
}
int
{
int err;
/*
* We must do these checks before we get to the syncfunc, since
* it can't fail.
*/
return (ENAMETOOLONG);
if (err)
return (err);
return (E2BIG);
}
if (dsl_dataset_is_snapshot(ds) &&
return (ENOTSUP);
}
return (err);
}
int
{
int err;
return (err);
/*
* Do these checks before the syncfunc, since it can't fail.
*/
return (ENAMETOOLONG);
}
char *valstr;
return (E2BIG);
}
}
}
if (dsl_dataset_is_snapshot(ds) &&
return (ENOTSUP);
}
return (err);
}
typedef enum dsl_prop_getflags {
static int
{
int err = 0;
zap_cursor_advance(&zc)) {
char buf[ZAP_MAXNAMELEN];
char *valstr;
const char *suffix;
const char *propname;
const char *source;
/*
* Skip local properties if we only want received
* properties.
*/
if (flags & DSL_PROP_GET_RECEIVED)
continue;
/* Skip explicitly inherited entries. */
continue;
if (flags & DSL_PROP_GET_LOCAL)
continue;
if (!(flags & DSL_PROP_GET_RECEIVED)) {
/* Skip if locally overridden. */
if (err == 0)
continue;
break;
/* Skip if explicitly inherited. */
if (err == 0)
continue;
break;
}
} else {
/*
* For backward compatibility, skip suffixes we don't
* recognize.
*/
continue;
}
/* Skip non-inheritable properties. */
continue;
/* Skip properties not valid for this type. */
continue;
/* Skip properties already defined. */
continue;
/*
* String property
*/
KM_SLEEP);
if (err != 0) {
break;
}
tmp) == 0);
} else {
/*
* Integer property
*/
}
}
err = 0;
return (err);
}
/*
* Iterate over all properties for this dataset and return them in an nvlist.
*/
static int
{
int err = 0;
char setpoint[MAXNAMELEN];
if (dsl_dataset_is_snapshot(ds))
if (err)
goto out;
}
if (flags & (DSL_PROP_GET_LOCAL |
break;
}
if (err)
break;
}
out:
return (err);
}
{
int rc;
return (rc == 0);
}
static void
{
return;
}
/*
* Call after successfully receiving properties to ensure that only the first
* receive on or after SPA_VERSION_RECVD_PROPS blows away local properties.
*/
void
{
if (dsl_prop_get_hasrecvd(os)) {
return;
}
}
void
{
}
int
{
}
int
{
/*
* Received properties are not distinguishable from local properties
* until the dataset has received properties on or after
* SPA_VERSION_RECVD_PROPS.
*/
}
void
{
return;
}
/* Indicate the default source if we can. */
value == default_value) {
}
}
void
{
return;
}
}