4 * This file and its contents are supplied under the terms of the
5 * Common Development and Distribution License ("CDDL"), version 1.0.
6 * You may only use this file in accordance with the terms of version
9 * A full copy of the text of the CDDL should have accompanied this
10 * source. A copy of the CDDL is also available via the Internet at
11 * http://www.illumos.org/license/CDDL.
17 * Copyright (c) 2016, 2017 by Delphix. All rights reserved.
26 #include <sys/dsl_prop.h>
27 #include <sys/dsl_synctask.h>
28 #include <sys/dsl_dataset.h>
29 #include <sys/dsl_dir.h>
30 #include <sys/dmu_objset.h>
31 #include <sys/mntent.h>
32 #include <sys/sunddi.h>
35 #include <sys/zcp_iter.h>
36 #include <sys/zcp_global.h>
37 #include <sys/zfs_ioctl.h>
38 #include <sys/zfs_znode.h>
42 #include <sys/zfs_vfsops.h>
46 get_objset_type(dsl_dataset_t
*ds
, zfs_type_t
*type
)
50 error
= dmu_objset_from_ds(ds
, &os
);
53 if (ds
->ds_is_snapshot
) {
54 *type
= ZFS_TYPE_SNAPSHOT
;
56 switch (os
->os_phys
->os_type
) {
58 *type
= ZFS_TYPE_FILESYSTEM
;
61 *type
= ZFS_TYPE_VOLUME
;
71 * Returns the string name of ds's type in str (a buffer which should be
72 * at least 12 bytes long).
75 get_objset_type_name(dsl_dataset_t
*ds
, char *str
)
79 error
= get_objset_type(ds
, &type
);
83 case ZFS_TYPE_SNAPSHOT
:
84 (void) strcpy(str
, "snapshot");
86 case ZFS_TYPE_FILESYSTEM
:
87 (void) strcpy(str
, "filesystem");
90 (void) strcpy(str
, "volume");
99 * Determines the source of a property given its setpoint and
100 * property type. It pushes the source to the lua stack.
103 get_prop_src(lua_State
*state
, const char *setpoint
, zfs_prop_t prop
)
105 if (zfs_prop_readonly(prop
) || (prop
== ZFS_PROP_VERSION
)) {
109 if (strcmp("", setpoint
) == 0) {
114 (void) lua_pushstring(state
, src
);
119 * Given an error encountered while getting properties, either longjmp's for
120 * a fatal error or pushes nothing to the stack for a non fatal one.
123 zcp_handle_error(lua_State
*state
, const char *dataset_name
,
124 const char *property_name
, int error
)
126 ASSERT3S(error
, !=, 0);
127 if (error
== ENOENT
) {
129 } else if (error
== EINVAL
) {
130 return (luaL_error(state
,
131 "property '%s' is not a valid property on dataset '%s'",
132 property_name
, dataset_name
));
133 } else if (error
== EIO
) {
134 return (luaL_error(state
,
135 "I/O error while retrieving property '%s' on dataset '%s'",
136 property_name
, dataset_name
));
138 return (luaL_error(state
, "unexpected error %d while "
139 "retrieving property '%s' on dataset '%s'",
140 error
, property_name
, dataset_name
));
145 * Look up a user defined property in the zap object. If it exists, push it
146 * and the setpoint onto the stack, otherwise don't push anything.
149 zcp_get_user_prop(lua_State
*state
, dsl_pool_t
*dp
, const char *dataset_name
,
150 const char *property_name
)
154 char setpoint
[ZFS_MAX_DATASET_NAME_LEN
];
156 * zcp_dataset_hold will either successfully return the requested
157 * dataset or throw a lua error and longjmp out of the zfs.get_prop call
160 dsl_dataset_t
*ds
= zcp_dataset_hold(state
, dp
, dataset_name
, FTAG
);
162 return (1); /* not reached; zcp_dataset_hold() longjmp'd */
164 buf
= kmem_alloc(ZAP_MAXVALUELEN
, KM_SLEEP
);
165 error
= dsl_prop_get_ds(ds
, property_name
, 1, ZAP_MAXVALUELEN
,
167 dsl_dataset_rele(ds
, FTAG
);
170 kmem_free(buf
, ZAP_MAXVALUELEN
);
171 return (zcp_handle_error(state
, dataset_name
, property_name
,
174 (void) lua_pushstring(state
, buf
);
175 (void) lua_pushstring(state
, setpoint
);
176 kmem_free(buf
, ZAP_MAXVALUELEN
);
181 * Check if the property we're looking for is stored in the ds_dir. If so,
182 * return it in the 'val' argument. Return 0 on success and ENOENT and if
183 * the property is not present.
186 get_dsl_dir_prop(dsl_dataset_t
*ds
, zfs_prop_t zfs_prop
,
189 dsl_dir_t
*dd
= ds
->ds_dir
;
190 mutex_enter(&dd
->dd_lock
);
192 case ZFS_PROP_USEDSNAP
:
193 *val
= dsl_dir_get_usedsnap(dd
);
195 case ZFS_PROP_USEDCHILD
:
196 *val
= dsl_dir_get_usedchild(dd
);
198 case ZFS_PROP_USEDDS
:
199 *val
= dsl_dir_get_usedds(dd
);
201 case ZFS_PROP_USEDREFRESERV
:
202 *val
= dsl_dir_get_usedrefreserv(dd
);
204 case ZFS_PROP_LOGICALUSED
:
205 *val
= dsl_dir_get_logicalused(dd
);
208 mutex_exit(&dd
->dd_lock
);
211 mutex_exit(&dd
->dd_lock
);
216 * Takes a dataset, a property, a value and that value's setpoint as
217 * found in the ZAP. Checks if the property has been changed in the vfs.
218 * If so, val and setpoint will be overwritten with updated content.
219 * Otherwise, they are left unchanged.
222 get_temporary_prop(dsl_dataset_t
*ds
, zfs_prop_t zfs_prop
, uint64_t *val
,
234 error
= dmu_objset_from_ds(ds
, &os
);
238 error
= getzfsvfs_impl(os
, &zfvp
);
246 if (vfs_optionisset(vfsp
, MNTOPT_NOATIME
, NULL
))
248 if (vfs_optionisset(vfsp
, MNTOPT_ATIME
, NULL
))
251 case ZFS_PROP_DEVICES
:
252 if (vfs_optionisset(vfsp
, MNTOPT_NODEVICES
, NULL
))
254 if (vfs_optionisset(vfsp
, MNTOPT_DEVICES
, NULL
))
258 if (vfs_optionisset(vfsp
, MNTOPT_NOEXEC
, NULL
))
260 if (vfs_optionisset(vfsp
, MNTOPT_EXEC
, NULL
))
263 case ZFS_PROP_SETUID
:
264 if (vfs_optionisset(vfsp
, MNTOPT_NOSETUID
, NULL
))
266 if (vfs_optionisset(vfsp
, MNTOPT_SETUID
, NULL
))
269 case ZFS_PROP_READONLY
:
270 if (vfs_optionisset(vfsp
, MNTOPT_RW
, NULL
))
272 if (vfs_optionisset(vfsp
, MNTOPT_RO
, NULL
))
276 if (vfs_optionisset(vfsp
, MNTOPT_NOXATTR
, NULL
))
278 if (vfs_optionisset(vfsp
, MNTOPT_XATTR
, NULL
))
281 case ZFS_PROP_NBMAND
:
282 if (vfs_optionisset(vfsp
, MNTOPT_NONBMAND
, NULL
))
284 if (vfs_optionisset(vfsp
, MNTOPT_NBMAND
, NULL
))
294 (void) strcpy(setpoint
, "temporary");
302 * Check if the property we're looking for is stored at the dsl_dataset or
303 * dsl_dir level. If so, push the property value and source onto the lua stack
304 * and return 0. If it is not present or a failure occurs in lookup, return a
305 * non-zero error value.
308 get_special_prop(lua_State
*state
, dsl_dataset_t
*ds
, const char *dsname
,
314 char *strval
= kmem_alloc(ZAP_MAXVALUELEN
, KM_SLEEP
);
315 char setpoint
[ZFS_MAX_DATASET_NAME_LEN
] =
316 "Internal error - setpoint not determined";
318 zprop_type_t prop_type
= zfs_prop_get_type(zfs_prop
);
319 (void) get_objset_type(ds
, &ds_type
);
322 case ZFS_PROP_REFRATIO
:
323 numval
= dsl_get_refratio(ds
);
326 numval
= dsl_get_used(ds
);
328 case ZFS_PROP_CLONES
: {
329 nvlist_t
*clones
= fnvlist_alloc();
330 error
= get_clones_stat_impl(ds
, clones
);
332 /* push list to lua stack */
333 VERIFY0(zcp_nvlist_to_lua(state
, clones
, NULL
,
336 (void) lua_pushnil(state
);
339 kmem_free(strval
, ZAP_MAXVALUELEN
);
342 case ZFS_PROP_COMPRESSRATIO
:
343 numval
= dsl_get_compressratio(ds
);
345 case ZFS_PROP_CREATION
:
346 numval
= dsl_get_creation(ds
);
348 case ZFS_PROP_REFERENCED
:
349 numval
= dsl_get_referenced(ds
);
351 case ZFS_PROP_AVAILABLE
:
352 numval
= dsl_get_available(ds
);
354 case ZFS_PROP_LOGICALREFERENCED
:
355 numval
= dsl_get_logicalreferenced(ds
);
357 case ZFS_PROP_CREATETXG
:
358 numval
= dsl_get_creationtxg(ds
);
361 numval
= dsl_get_guid(ds
);
363 case ZFS_PROP_UNIQUE
:
364 numval
= dsl_get_unique(ds
);
366 case ZFS_PROP_OBJSETID
:
367 numval
= dsl_get_objsetid(ds
);
369 case ZFS_PROP_ORIGIN
:
370 dsl_dir_get_origin(ds
->ds_dir
, strval
);
372 case ZFS_PROP_USERACCOUNTING
:
373 error
= dmu_objset_from_ds(ds
, &os
);
375 numval
= dmu_objset_userspace_present(os
);
377 case ZFS_PROP_WRITTEN
:
378 error
= dsl_get_written(ds
, &numval
);
381 error
= get_objset_type_name(ds
, strval
);
383 case ZFS_PROP_PREV_SNAP
:
384 error
= dsl_get_prev_snap(ds
, strval
);
387 dsl_dataset_name(ds
, strval
);
389 case ZFS_PROP_MOUNTPOINT
:
390 error
= dsl_get_mountpoint(ds
, dsname
, strval
, setpoint
);
392 case ZFS_PROP_VERSION
:
393 /* should be a snapshot or filesystem */
394 ASSERT(ds_type
!= ZFS_TYPE_VOLUME
);
395 error
= dmu_objset_from_ds(ds
, &os
);
396 /* look in the master node for the version */
398 error
= zap_lookup(os
, MASTER_NODE_OBJ
, ZPL_VERSION_STR
,
399 sizeof (numval
), 1, &numval
);
402 case ZFS_PROP_DEFER_DESTROY
:
403 numval
= dsl_get_defer_destroy(ds
);
405 case ZFS_PROP_USERREFS
:
406 numval
= dsl_get_userrefs(ds
);
408 case ZFS_PROP_FILESYSTEM_COUNT
:
409 error
= dsl_dir_get_filesystem_count(ds
->ds_dir
, &numval
);
410 (void) strcpy(setpoint
, "");
412 case ZFS_PROP_SNAPSHOT_COUNT
:
413 error
= dsl_dir_get_snapshot_count(ds
->ds_dir
, &numval
);
414 (void) strcpy(setpoint
, "");
416 case ZFS_PROP_REMAPTXG
:
417 error
= dsl_dir_get_remaptxg(ds
->ds_dir
, &numval
);
419 case ZFS_PROP_NUMCLONES
:
420 numval
= dsl_get_numclones(ds
);
422 case ZFS_PROP_INCONSISTENT
:
423 numval
= dsl_get_inconsistent(ds
);
425 case ZFS_PROP_RECEIVE_RESUME_TOKEN
: {
426 char *token
= get_receive_resume_stats_impl(ds
);
427 VERIFY3U(strlcpy(strval
, token
, ZAP_MAXVALUELEN
), <,
430 if (strcmp(strval
, "") == 0) {
431 token
= get_child_receive_stats(ds
);
432 VERIFY3U(strlcpy(strval
, token
, ZAP_MAXVALUELEN
), <,
435 if (strcmp(strval
, "") == 0)
440 case ZFS_PROP_VOLSIZE
:
441 ASSERT(ds_type
== ZFS_TYPE_VOLUME
);
442 error
= dmu_objset_from_ds(ds
, &os
);
444 error
= zap_lookup(os
, ZVOL_ZAP_OBJ
, "size",
445 sizeof (numval
), 1, &numval
);
448 (void) strcpy(setpoint
, dsname
);
451 case ZFS_PROP_VOLBLOCKSIZE
: {
452 ASSERT(ds_type
== ZFS_TYPE_VOLUME
);
453 dmu_object_info_t doi
;
454 error
= dmu_objset_from_ds(ds
, &os
);
456 error
= dmu_object_info(os
, ZVOL_OBJ
, &doi
);
458 numval
= doi
.doi_data_block_size
;
463 /* Did not match these props, check in the dsl_dir */
464 error
= get_dsl_dir_prop(ds
, zfs_prop
, &numval
);
467 kmem_free(strval
, ZAP_MAXVALUELEN
);
472 case PROP_TYPE_NUMBER
: {
473 (void) lua_pushnumber(state
, numval
);
476 case PROP_TYPE_STRING
: {
477 (void) lua_pushstring(state
, strval
);
480 case PROP_TYPE_INDEX
: {
482 error
= zfs_prop_index_to_string(zfs_prop
, numval
, &propval
);
484 kmem_free(strval
, ZAP_MAXVALUELEN
);
487 (void) lua_pushstring(state
, propval
);
491 kmem_free(strval
, ZAP_MAXVALUELEN
);
493 /* Push the source to the stack */
494 get_prop_src(state
, setpoint
, zfs_prop
);
499 * Look up a property and its source in the zap object. If the value is
500 * present and successfully retrieved, push the value and source on the
501 * lua stack and return 0. On failure, return a non-zero error value.
504 get_zap_prop(lua_State
*state
, dsl_dataset_t
*ds
, zfs_prop_t zfs_prop
)
507 char setpoint
[ZFS_MAX_DATASET_NAME_LEN
];
508 char *strval
= kmem_alloc(ZAP_MAXVALUELEN
, KM_SLEEP
);
510 const char *prop_name
= zfs_prop_to_name(zfs_prop
);
511 zprop_type_t prop_type
= zfs_prop_get_type(zfs_prop
);
513 if (prop_type
== PROP_TYPE_STRING
) {
514 /* Push value to lua stack */
515 error
= dsl_prop_get_ds(ds
, prop_name
, 1,
516 ZAP_MAXVALUELEN
, strval
, setpoint
);
518 (void) lua_pushstring(state
, strval
);
520 error
= dsl_prop_get_ds(ds
, prop_name
, sizeof (numval
),
521 1, &numval
, setpoint
);
523 /* Fill in temorary value for prop, if applicable */
524 (void) get_temporary_prop(ds
, zfs_prop
, &numval
, setpoint
);
526 /* Push value to lua stack */
527 if (prop_type
== PROP_TYPE_INDEX
) {
529 error
= zfs_prop_index_to_string(zfs_prop
, numval
,
532 (void) lua_pushstring(state
, propval
);
535 (void) lua_pushnumber(state
, numval
);
538 kmem_free(strval
, ZAP_MAXVALUELEN
);
540 get_prop_src(state
, setpoint
, zfs_prop
);
545 * Determine whether property is valid for a given dataset
548 prop_valid_for_ds(dsl_dataset_t
*ds
, zfs_prop_t zfs_prop
)
553 /* properties not supported */
554 if ((zfs_prop
== ZFS_PROP_ISCSIOPTIONS
) ||
555 (zfs_prop
== ZFS_PROP_MOUNTED
))
558 /* if we want the origin prop, ds must be a clone */
559 if ((zfs_prop
== ZFS_PROP_ORIGIN
) && (!dsl_dir_is_clone(ds
->ds_dir
)))
562 error
= get_objset_type(ds
, &zfs_type
);
565 return (zfs_prop_valid_for_type(zfs_prop
, zfs_type
));
569 * Look up a given dataset property. On success return 2, the number of
570 * values pushed to the lua stack (property value and source). On a fatal
571 * error, longjmp. On a non fatal error push nothing.
574 zcp_get_system_prop(lua_State
*state
, dsl_pool_t
*dp
, const char *dataset_name
,
579 * zcp_dataset_hold will either successfully return the requested
580 * dataset or throw a lua error and longjmp out of the zfs.get_prop call
583 dsl_dataset_t
*ds
= zcp_dataset_hold(state
, dp
, dataset_name
, FTAG
);
585 return (1); /* not reached; zcp_dataset_hold() longjmp'd */
587 /* Check that the property is valid for the given dataset */
588 const char *prop_name
= zfs_prop_to_name(zfs_prop
);
589 if (!prop_valid_for_ds(ds
, zfs_prop
)) {
590 dsl_dataset_rele(ds
, FTAG
);
594 /* Check if the property can be accessed directly */
595 error
= get_special_prop(state
, ds
, dataset_name
, zfs_prop
);
597 dsl_dataset_rele(ds
, FTAG
);
598 /* The value and source have been pushed by get_special_prop */
601 if (error
!= ENOENT
) {
602 dsl_dataset_rele(ds
, FTAG
);
603 return (zcp_handle_error(state
, dataset_name
,
607 /* If we were unable to find it, look in the zap object */
608 error
= get_zap_prop(state
, ds
, zfs_prop
);
609 dsl_dataset_rele(ds
, FTAG
);
611 return (zcp_handle_error(state
, dataset_name
,
614 /* The value and source have been pushed by get_zap_prop */
618 static zfs_userquota_prop_t
619 get_userquota_prop(const char *prop_name
)
621 zfs_userquota_prop_t type
;
622 /* Figure out the property type ({user|group}{quota|used}) */
623 for (type
= 0; type
< ZFS_NUM_USERQUOTA_PROPS
; type
++) {
624 if (strncmp(prop_name
, zfs_userquota_prop_prefixes
[type
],
625 strlen(zfs_userquota_prop_prefixes
[type
])) == 0)
633 * Given the name of a zfs_userquota_prop, this function determines the
634 * prop type as well as the numeric group/user ids based on the string
635 * following the '@' in the property name. On success, returns 0. On failure,
636 * returns a non-zero error.
637 * 'domain' must be free'd by caller using strfree()
640 parse_userquota_prop(const char *prop_name
, zfs_userquota_prop_t
*type
,
641 char **domain
, uint64_t *rid
)
643 char *cp
, *end
, *domain_val
;
645 *type
= get_userquota_prop(prop_name
);
646 if (*type
>= ZFS_NUM_USERQUOTA_PROPS
)
650 cp
= strchr(prop_name
, '@') + 1;
651 if (strncmp(cp
, "S-1-", 4) == 0) {
653 * It's a numeric SID (eg "S-1-234-567-89") and we want to
654 * seperate the domain id and the rid
656 int domain_len
= strrchr(cp
, '-') - cp
;
657 domain_val
= kmem_alloc(domain_len
+ 1, KM_SLEEP
);
658 (void) strncpy(domain_val
, cp
, domain_len
);
659 domain_val
[domain_len
] = '\0';
660 cp
+= domain_len
+ 1;
662 (void) ddi_strtoll(cp
, &end
, 10, (longlong_t
*)rid
);
668 /* It's only a user/group ID (eg "12345"), just get the rid */
670 (void) ddi_strtoll(cp
, &end
, 10, (longlong_t
*)rid
);
674 *domain
= domain_val
;
679 * Look up {user|group}{quota|used} property for given dataset. On success
680 * push the value (quota or used amount) and the setpoint. On failure, push
684 zcp_get_userquota_prop(lua_State
*state
, dsl_pool_t
*dp
,
685 const char *dataset_name
, const char *prop_name
)
690 zfs_userquota_prop_t type
;
695 dsl_dataset_t
*ds
= zcp_dataset_hold(state
, dp
, dataset_name
, FTAG
);
697 return (1); /* not reached; zcp_dataset_hold() longjmp'd */
699 error
= parse_userquota_prop(prop_name
, &type
, &domain
, &rid
);
701 error
= dmu_objset_from_ds(ds
, &os
);
703 zfsvfs
= kmem_zalloc(sizeof (zfsvfs_t
), KM_SLEEP
);
704 error
= zfsvfs_create_impl(&zfvp
, zfsvfs
, os
);
706 error
= zfs_userspace_one(zfvp
, type
, domain
,
714 dsl_dataset_rele(ds
, FTAG
);
716 if ((value
== 0) && ((type
== ZFS_PROP_USERQUOTA
) ||
717 (type
== ZFS_PROP_GROUPQUOTA
)))
720 return (zcp_handle_error(state
, dataset_name
,
724 (void) lua_pushnumber(state
, value
);
725 (void) lua_pushstring(state
, dataset_name
);
731 * Determines the name of the snapshot referenced in the written property
732 * name. Returns snapshot name in snap_name, a buffer that must be at least
733 * as large as ZFS_MAX_DATASET_NAME_LEN
736 parse_written_prop(const char *dataset_name
, const char *prop_name
,
739 ASSERT(zfs_prop_written(prop_name
));
740 const char *name
= prop_name
+ ZFS_WRITTEN_PROP_PREFIX_LEN
;
741 if (strchr(name
, '@') == NULL
) {
742 (void) sprintf(snap_name
, "%s@%s", dataset_name
, name
);
744 (void) strcpy(snap_name
, name
);
749 * Look up written@ property for given dataset. On success
750 * push the value and the setpoint. If error is fatal, we will
751 * longjmp, otherwise push nothing.
754 zcp_get_written_prop(lua_State
*state
, dsl_pool_t
*dp
,
755 const char *dataset_name
, const char *prop_name
)
757 char snap_name
[ZFS_MAX_DATASET_NAME_LEN
];
758 uint64_t used
, comp
, uncomp
;
762 parse_written_prop(dataset_name
, prop_name
, snap_name
);
763 dsl_dataset_t
*new = zcp_dataset_hold(state
, dp
, dataset_name
, FTAG
);
765 return (1); /* not reached; zcp_dataset_hold() longjmp'd */
767 error
= dsl_dataset_hold(dp
, snap_name
, FTAG
, &old
);
769 dsl_dataset_rele(new, FTAG
);
770 return (zcp_dataset_hold_error(state
, dp
, snap_name
,
773 error
= dsl_dataset_space_written(old
, new,
774 &used
, &comp
, &uncomp
);
776 dsl_dataset_rele(old
, FTAG
);
777 dsl_dataset_rele(new, FTAG
);
780 return (zcp_handle_error(state
, dataset_name
,
783 (void) lua_pushnumber(state
, used
);
784 (void) lua_pushstring(state
, dataset_name
);
788 static int zcp_get_prop(lua_State
*state
);
789 static zcp_lib_info_t zcp_get_prop_info
= {
791 .func
= zcp_get_prop
,
793 { .za_name
= "dataset", .za_lua_type
= LUA_TSTRING
},
794 { .za_name
= "property", .za_lua_type
= LUA_TSTRING
},
803 zcp_get_prop(lua_State
*state
)
805 const char *dataset_name
;
806 const char *property_name
;
807 dsl_pool_t
*dp
= zcp_run_info(state
)->zri_pool
;
808 zcp_lib_info_t
*libinfo
= &zcp_get_prop_info
;
810 zcp_parse_args(state
, libinfo
->name
, libinfo
->pargs
, libinfo
->kwargs
);
812 dataset_name
= lua_tostring(state
, 1);
813 property_name
= lua_tostring(state
, 2);
815 /* User defined property */
816 if (zfs_prop_user(property_name
)) {
817 return (zcp_get_user_prop(state
, dp
,
818 dataset_name
, property_name
));
820 /* userspace property */
821 if (zfs_prop_userquota(property_name
)) {
823 return (zcp_get_userquota_prop(state
, dp
,
824 dataset_name
, property_name
));
826 return (luaL_error(state
,
827 "user quota properties only supported in kernel mode",
831 /* written@ property */
832 if (zfs_prop_written(property_name
)) {
833 return (zcp_get_written_prop(state
, dp
,
834 dataset_name
, property_name
));
837 zfs_prop_t zfs_prop
= zfs_name_to_prop(property_name
);
838 /* Valid system property */
839 if (zfs_prop
!= ZPROP_INVAL
) {
840 return (zcp_get_system_prop(state
, dp
, dataset_name
,
844 /* Invalid property name */
845 return (luaL_error(state
,
846 "'%s' is not a valid property", property_name
));
850 zcp_load_get_lib(lua_State
*state
)
852 lua_pushcclosure(state
, zcp_get_prop_info
.func
, 0);
853 lua_setfield(state
, -2, zcp_get_prop_info
.name
);