libdlmgmt.c revision f689bed18bbb72c93b14a451e959b18f7ccfb7d1
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * CDDL HEADER START
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * The contents of this file are subject to the terms of the
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Common Development and Distribution License (the "License").
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * You may not use this file except in compliance with the License.
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * See the License for the specific language governing permissions
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * and limitations under the License.
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * When distributing Covered Code, include this CDDL HEADER in each
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * If applicable, add the following below this CDDL HEADER, with the
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * fields enclosed by brackets "[]" replaced with your own identifying
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * information: Portions Copyright [yyyy] [name of copyright owner]
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * CDDL HEADER END
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Table of data type sizes indexed by dladm_datatype_t.
d62bc4badc1c1f1549c961cfb8b420e650e1272byz 0, /* DLADM_TYPE_STR, use strnlen() */
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_door_call(dladm_handle_t handle, void *arg, size_t asize, void *rbuf,
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey /* The door descriptor is opened if it isn't already */
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey if ((status = dladm_door_fd(handle, &door_fd)) != DLADM_STATUS_OK)
f689bed18bbb72c93b14a451e959b18f7ccfb7d1Rishi Srivatsavai * Stale door descriptor is possible if dlmgmtd was re-started
f689bed18bbb72c93b14a451e959b18f7ccfb7d1Rishi Srivatsavai * since last door_fd open so try re-opening door file.
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * The size of the input rbuf is not big enough so that
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou * the door allocate the rbuf itself. In this case, return
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou * the required size to the caller.
024b0a258461f282a92b1b1283c3b8b083f9f33fseb return (dladm_errno2status(((dlmgmt_retval_t *)rbuf)->lr_err));
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Allocate a new linkid with the given name. Return the new linkid.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_create_datalink_id(dladm_handle_t handle, const char *link,
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey datalink_class_t class, uint32_t media, uint32_t flags,
d62bc4badc1c1f1549c961cfb8b420e650e1272byz dlmgmt_flags = (flags & DLADM_OPT_ACTIVE) ? DLMGMT_ACTIVE : 0;
d62bc4badc1c1f1549c961cfb8b420e650e1272byz dlmgmt_flags |= (flags & DLADM_OPT_PERSIST) ? DLMGMT_PERSIST : 0;
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey if ((status = dladm_door_call(handle, &createid, sizeof (createid),
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Destroy the given link ID.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_destroy_datalink_id(dladm_handle_t handle, datalink_id_t linkid,
d62bc4badc1c1f1549c961cfb8b420e650e1272byz dlmgmt_flags = (flags & DLADM_OPT_ACTIVE) ? DLMGMT_ACTIVE : 0;
d62bc4badc1c1f1549c961cfb8b420e650e1272byz dlmgmt_flags |= ((flags & DLADM_OPT_PERSIST) ? DLMGMT_PERSIST : 0);
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou return (dladm_door_call(handle, &destroyid, sizeof (destroyid),
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Remap a given link ID to a new name.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_remap_datalink_id(dladm_handle_t handle, datalink_id_t linkid,
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou return (dladm_door_call(handle, &remapid, sizeof (remapid),
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Make a given link ID active.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_up_datalink_id(dladm_handle_t handle, datalink_id_t linkid)
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou return (dladm_door_call(handle, &upid, sizeof (upid), &retval, &sz));
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Create a new link with the given name. Return the new link's handle
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_create_conf(dladm_handle_t handle, const char *link, datalink_id_t linkid,
d62bc4badc1c1f1549c961cfb8b420e650e1272byz datalink_class_t class, uint32_t media, dladm_conf_t *confp)
d62bc4badc1c1f1549c961cfb8b420e650e1272byz (void) strlcpy(createconf.ld_link, link, MAXLINKNAMELEN);
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey if ((status = dladm_door_call(handle, &createconf, sizeof (createconf),
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * An active physical link reported by the dlmgmtd daemon might not be active
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * anymore as this link might be removed during system shutdown. Check its
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * real status by calling dladm_phys_info().
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeyi_dladm_phys_status(dladm_handle_t handle, datalink_id_t linkid,
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey status = dladm_phys_info(handle, linkid, &dpa, DLADM_OPT_ACTIVE);
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * No active status, this link was removed. Update its status
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * in the daemon and delete all active linkprops.
2d4eecfa187a743d7823497136e21cb0568eb77dCathy Zhou * Note that the operation could fail. If it does, return
2d4eecfa187a743d7823497136e21cb0568eb77dCathy Zhou * failure now since otherwise dladm_set_linkprop() might
2d4eecfa187a743d7823497136e21cb0568eb77dCathy Zhou * call back to i_dladm_phys_status() recursively.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey if ((status = dladm_destroy_datalink_id(handle, linkid,
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey (void) dladm_set_linkprop(handle, linkid, NULL, NULL, 0,
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Walk each entry in the data link configuration repository and
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * call fn on the linkid and arg.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_walk_datalink_id(int (*fn)(dladm_handle_t, datalink_id_t, void *),
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey dladm_handle_t handle, void *argp, datalink_class_t class,
d62bc4badc1c1f1549c961cfb8b420e650e1272byz dlmgmt_flags = (flags & DLADM_OPT_ACTIVE) ? DLMGMT_ACTIVE : 0;
d62bc4badc1c1f1549c961cfb8b420e650e1272byz dlmgmt_flags |= ((flags & DLADM_OPT_PERSIST) ? DLMGMT_PERSIST : 0);
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey if ((status = dladm_door_call(handle, &getnext,
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou sizeof (getnext), &retval, &sz)) != DLADM_STATUS_OK) {
7363c184fede3193ea9aaf8446644dfaefdad5cbCathy Zhou * Done with walking. If no next datalink is found,
7363c184fede3193ea9aaf8446644dfaefdad5cbCathy Zhou * return success.
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * An active physical link reported by the dlmgmtd
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * daemon might not be active anymore. Check its
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * real status.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey if (fn(handle, linkid, argp) == DLADM_WALK_TERMINATE)
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou * Get a handle of a copy of the link configuration (kept in the daemon)
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou * for the given link so it can be updated later by dladm_write_conf().
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhoudladm_open_conf(dladm_handle_t handle, datalink_id_t linkid,
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou if (linkid == DATALINK_INVALID_LINKID || confp == NULL)
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou sizeof (openconf), &retval, &sz)) == DLADM_STATUS_OK) {
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou * Get the handle of a local snapshot of the link configuration. Note that
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou * any operations with this handle are read-only, i.e., one can not update
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou * the configuration with this handle.
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhoudladm_getsnap_conf(dladm_handle_t handle, datalink_id_t linkid,
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou if ((status = dladm_door_call(handle, &snapshot, sizeof (snapshot),
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou nvlbuf = (char *)retvalp + sizeof (dlmgmt_getconfsnapshot_retval_t);
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou if ((err = nvlist_unpack(nvlbuf, retvalp->lr_nvlsz,
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Commit the given link to the data link configuration repository so
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * that it will persist across reboots.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_write_conf(dladm_handle_t handle, dladm_conf_t conf)
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou return (dladm_door_call(handle, &writeconf, sizeof (writeconf),
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou * Given a dladm_conf_t, get the specific configuration field
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou * If the specified dladm_conf_t is a read-only snapshot of the configuration,
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou * get a specific link propertie from that snapshot (nvl), otherwise, get
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou * the link protperty from the dlmgmtd daemon using the given confid.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_get_conf_field(dladm_handle_t handle, dladm_conf_t conf, const char *attr,
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou if (attrval == NULL || attrsz == 0 || attr == NULL)
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou if ((err = nvlist_lookup_byte_array(conf.ds_nvl, (char *)attr,
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou (void) strlcpy(getattr.ld_attr, attr, MAXLINKATTRLEN);
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou sizeof (getattr), &retval, &sz)) != DLADM_STATUS_OK) {
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou bcopy(retval.lr_attrval, attrval, retval.lr_attrsz);
62ee1d25bffb3d6d74798efe1199f7e86a29a14eArtem Kachitchkine * Get next property attribute from data link configuration repository.
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou * If last_attr is "", return the first property.
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou/* ARGSUSED */
62ee1d25bffb3d6d74798efe1199f7e86a29a14eArtem Kachitchkinedladm_getnext_conf_linkprop(dladm_handle_t handle, dladm_conf_t conf,
62ee1d25bffb3d6d74798efe1199f7e86a29a14eArtem Kachitchkine const char *last_attr, char *attr, void *attrval, size_t attrsz,
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou if (nvl == NULL || attrval == NULL || attrsz == 0 || attr == NULL ||
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou while ((nvp = nvlist_next_nvpair(nvl, last)) != NULL) {
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou if (last != NULL && strcmp(last_attr, nvpair_name(last)) == 0)
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou if ((err = nvpair_value_byte_array(nvp, (uchar_t **)&oattrval,
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou (void) strlcpy(attr, nvpair_name(nvp), MAXLINKATTRLEN);
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Get the link ID that is associated with the given name.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_name2info(dladm_handle_t handle, const char *link, datalink_id_t *linkidp,
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey uint32_t *flagp, datalink_class_t *classp, uint32_t *mediap)
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey if ((status = dladm_door_call(handle, &getlinkid, sizeof (getlinkid),
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * An active physical link reported by the dlmgmtd daemon
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * might not be active anymore. Check and set its real status.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey status = i_dladm_phys_status(handle, linkid, &retval.lr_flags);
d62bc4badc1c1f1549c961cfb8b420e650e1272byz *flagp = retval.lr_flags & DLMGMT_ACTIVE ? DLADM_OPT_ACTIVE : 0;
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Get the link name that is associated with the given id.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_datalink_id2info(dladm_handle_t handle, datalink_id_t linkid,
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey uint32_t *flagp, datalink_class_t *classp, uint32_t *mediap, char *link,
d62bc4badc1c1f1549c961cfb8b420e650e1272byz if ((linkid == DATALINK_INVALID_LINKID) || (link != NULL && len == 0) ||
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey if ((status = dladm_door_call(handle, &getname, sizeof (getname),
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * An active physical link reported by the dlmgmtd daemon
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * might not be active anymore. Check and set its real status.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey status = i_dladm_phys_status(handle, linkid, &retval.lr_flags);
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Set the given attr with the given attrval for the given link.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_set_conf_field(dladm_handle_t handle, dladm_conf_t conf, const char *attr,
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou return (dladm_door_call(handle, &setattr, sizeof (setattr),
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Unset the given attr the given link.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_unset_conf_field(dladm_handle_t handle, dladm_conf_t conf,
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou return (dladm_door_call(handle, &unsetattr, sizeof (unsetattr),
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Remove the given link ID and its entry from the data link configuration
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * repository.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_remove_conf(dladm_handle_t handle, datalink_id_t linkid)
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskey return (dladm_door_call(handle, &removeconf, sizeof (removeconf),
d62bc4badc1c1f1549c961cfb8b420e650e1272byz * Free the contents of the link structure.
4ac67f0276a8313b5cefec38af347b94b7bfb526Anurag S. Maskeydladm_destroy_conf(dladm_handle_t handle, dladm_conf_t conf)
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou (void) dladm_door_call(handle, &dconf, sizeof (dconf),
2b24ab6b3865caeede9eeb9db6b83e1d89dcd1eaSebastien Roydladm_zone_boot(dladm_handle_t handle, zoneid_t zoneid)
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou return (dladm_door_call(handle, &zoneboot, sizeof (zoneboot),
2b24ab6b3865caeede9eeb9db6b83e1d89dcd1eaSebastien Roydladm_zone_halt(dladm_handle_t handle, zoneid_t zoneid)
327151705b7439cb7ab35c370f682cac7ef9523aCathy Zhou return (dladm_door_call(handle, &zonehalt, sizeof (zonehalt),