/* * 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 * or http://www.opensolaris.org/os/licensing. * 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 #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include /* * Table of data type sizes indexed by dladm_datatype_t. */ static size_t dladm_datatype_size[] = { 0, /* DLADM_TYPE_STR, use strnlen() */ sizeof (boolean_t), /* DLADM_TYPE_BOOLEAN */ sizeof (uint64_t) /* DLADM_TYPE_UINT64 */ }; static dladm_status_t dladm_door_call(dladm_handle_t handle, void *arg, size_t asize, void *rbuf, size_t rsize) { door_arg_t darg; int door_fd; dladm_status_t status = DLADM_STATUS_OK; darg.data_ptr = arg; darg.data_size = asize; darg.desc_ptr = NULL; darg.desc_num = 0; darg.rbuf = rbuf; darg.rsize = rsize; /* The door descriptor is opened if it isn't already */ if ((status = dladm_door_fd(handle, &door_fd)) != DLADM_STATUS_OK) return (status); if (door_call(door_fd, &darg) == -1) status = dladm_errno2status(errno); if (status != DLADM_STATUS_OK) return (status); if (darg.rbuf != rbuf) { /* * The size of the input rbuf is not big enough so that * the door allocate the rbuf itself. In this case, simply * think something wrong with the door call. */ (void) munmap(darg.rbuf, darg.rsize); return (DLADM_STATUS_TOOSMALL); } if (darg.rsize != rsize) return (DLADM_STATUS_FAILED); return (dladm_errno2status(((dlmgmt_retval_t *)rbuf)->lr_err)); } /* * Allocate a new linkid with the given name. Return the new linkid. */ dladm_status_t dladm_create_datalink_id(dladm_handle_t handle, const char *link, datalink_class_t class, uint32_t media, uint32_t flags, datalink_id_t *linkidp) { dlmgmt_door_createid_t createid; dlmgmt_createid_retval_t retval; uint32_t dlmgmt_flags; dladm_status_t status; if (link == NULL || class == DATALINK_CLASS_ALL || !(flags & (DLADM_OPT_ACTIVE | DLADM_OPT_PERSIST)) || linkidp == NULL) { return (DLADM_STATUS_BADARG); } dlmgmt_flags = (flags & DLADM_OPT_ACTIVE) ? DLMGMT_ACTIVE : 0; dlmgmt_flags |= (flags & DLADM_OPT_PERSIST) ? DLMGMT_PERSIST : 0; (void) strlcpy(createid.ld_link, link, MAXLINKNAMELEN); createid.ld_class = class; createid.ld_media = media; createid.ld_flags = dlmgmt_flags; createid.ld_cmd = DLMGMT_CMD_CREATE_LINKID; createid.ld_prefix = (flags & DLADM_OPT_PREFIX); if ((status = dladm_door_call(handle, &createid, sizeof (createid), &retval, sizeof (retval))) == DLADM_STATUS_OK) { *linkidp = retval.lr_linkid; } return (status); } /* * Destroy the given link ID. */ dladm_status_t dladm_destroy_datalink_id(dladm_handle_t handle, datalink_id_t linkid, uint32_t flags) { dlmgmt_door_destroyid_t destroyid; dlmgmt_destroyid_retval_t retval; uint32_t dlmgmt_flags; dlmgmt_flags = (flags & DLADM_OPT_ACTIVE) ? DLMGMT_ACTIVE : 0; dlmgmt_flags |= ((flags & DLADM_OPT_PERSIST) ? DLMGMT_PERSIST : 0); destroyid.ld_cmd = DLMGMT_CMD_DESTROY_LINKID; destroyid.ld_linkid = linkid; destroyid.ld_flags = dlmgmt_flags; return (dladm_door_call(handle, &destroyid, sizeof (destroyid), &retval, sizeof (retval))); } /* * Remap a given link ID to a new name. */ dladm_status_t dladm_remap_datalink_id(dladm_handle_t handle, datalink_id_t linkid, const char *link) { dlmgmt_door_remapid_t remapid; dlmgmt_remapid_retval_t retval; remapid.ld_cmd = DLMGMT_CMD_REMAP_LINKID; remapid.ld_linkid = linkid; (void) strlcpy(remapid.ld_link, link, MAXLINKNAMELEN); return (dladm_door_call(handle, &remapid, sizeof (remapid), &retval, sizeof (retval))); } /* * Make a given link ID active. */ dladm_status_t dladm_up_datalink_id(dladm_handle_t handle, datalink_id_t linkid) { dlmgmt_door_upid_t upid; dlmgmt_upid_retval_t retval; upid.ld_cmd = DLMGMT_CMD_UP_LINKID; upid.ld_linkid = linkid; return (dladm_door_call(handle, &upid, sizeof (upid), &retval, sizeof (retval))); } /* * Create a new link with the given name. Return the new link's handle */ dladm_status_t dladm_create_conf(dladm_handle_t handle, const char *link, datalink_id_t linkid, datalink_class_t class, uint32_t media, dladm_conf_t *confp) { dlmgmt_door_createconf_t createconf; dlmgmt_createconf_retval_t retval; dladm_status_t status; if (link == NULL || confp == NULL) return (DLADM_STATUS_BADARG); (void) strlcpy(createconf.ld_link, link, MAXLINKNAMELEN); createconf.ld_class = class; createconf.ld_media = media; createconf.ld_linkid = linkid; createconf.ld_cmd = DLMGMT_CMD_CREATECONF; if ((status = dladm_door_call(handle, &createconf, sizeof (createconf), &retval, sizeof (retval))) == DLADM_STATUS_OK) { *confp = retval.lr_conf; } return (status); } /* * An active physical link reported by the dlmgmtd daemon might not be active * anymore as this link might be removed during system shutdown. Check its * real status by calling dladm_phys_info(). */ dladm_status_t i_dladm_phys_status(dladm_handle_t handle, datalink_id_t linkid, uint32_t *flagsp) { dladm_phys_attr_t dpa; dladm_status_t status; assert((*flagsp) & DLMGMT_ACTIVE); status = dladm_phys_info(handle, linkid, &dpa, DLADM_OPT_ACTIVE); if (status == DLADM_STATUS_NOTFOUND) { /* * No active status, this link was removed. Update its status * in the daemon and delete all active linkprops. * * Note that the operation could fail. If it does, return * failure now since otherwise dladm_set_linkprop() might * call back to i_dladm_phys_status() recursively. */ if ((status = dladm_destroy_datalink_id(handle, linkid, DLADM_OPT_ACTIVE)) != DLADM_STATUS_OK) return (status); (void) dladm_set_linkprop(handle, linkid, NULL, NULL, 0, DLADM_OPT_ACTIVE); (*flagsp) &= ~DLMGMT_ACTIVE; status = DLADM_STATUS_OK; } return (status); } /* * Walk each entry in the data link configuration repository and * call fn on the linkid and arg. */ dladm_status_t dladm_walk_datalink_id(int (*fn)(dladm_handle_t, datalink_id_t, void *), dladm_handle_t handle, void *argp, datalink_class_t class, datalink_media_t dmedia, uint32_t flags) { dlmgmt_door_getnext_t getnext; dlmgmt_getnext_retval_t retval; uint32_t dlmgmt_flags; datalink_id_t linkid = DATALINK_INVALID_LINKID; dladm_status_t status = DLADM_STATUS_OK; if (fn == NULL) return (DLADM_STATUS_BADARG); dlmgmt_flags = (flags & DLADM_OPT_ACTIVE) ? DLMGMT_ACTIVE : 0; dlmgmt_flags |= ((flags & DLADM_OPT_PERSIST) ? DLMGMT_PERSIST : 0); getnext.ld_cmd = DLMGMT_CMD_GETNEXT; getnext.ld_class = class; getnext.ld_dmedia = dmedia; getnext.ld_flags = dlmgmt_flags; do { getnext.ld_linkid = linkid; if ((status = dladm_door_call(handle, &getnext, sizeof (getnext), &retval, sizeof (retval))) != DLADM_STATUS_OK) { /* * Done with walking. If no next datalink is found, * return success. */ if (status == DLADM_STATUS_NOTFOUND) status = DLADM_STATUS_OK; break; } linkid = retval.lr_linkid; if ((retval.lr_class == DATALINK_CLASS_PHYS) && (retval.lr_flags & DLMGMT_ACTIVE)) { /* * An active physical link reported by the dlmgmtd * daemon might not be active anymore. Check its * real status. */ if (i_dladm_phys_status(handle, linkid, &retval.lr_flags) != DLADM_STATUS_OK) { continue; } if (!(dlmgmt_flags & retval.lr_flags)) continue; } if (fn(handle, linkid, argp) == DLADM_WALK_TERMINATE) break; } while (linkid != DATALINK_INVALID_LINKID); return (status); } /* * Get the link properties structure for the given link. */ dladm_status_t dladm_read_conf(dladm_handle_t handle, datalink_id_t linkid, dladm_conf_t *confp) { dlmgmt_door_readconf_t readconf; dlmgmt_readconf_retval_t retval; dladm_status_t status; if (linkid == DATALINK_INVALID_LINKID || confp == NULL) return (DLADM_STATUS_BADARG); readconf.ld_linkid = linkid; readconf.ld_cmd = DLMGMT_CMD_READCONF; if ((status = dladm_door_call(handle, &readconf, sizeof (readconf), &retval, sizeof (retval))) == DLADM_STATUS_OK) { *confp = retval.lr_conf; } return (status); } /* * Commit the given link to the data link configuration repository so * that it will persist across reboots. */ dladm_status_t dladm_write_conf(dladm_handle_t handle, dladm_conf_t conf) { dlmgmt_door_writeconf_t writeconf; dlmgmt_writeconf_retval_t retval; if (conf == DLADM_INVALID_CONF) return (DLADM_STATUS_BADARG); writeconf.ld_cmd = DLMGMT_CMD_WRITECONF; writeconf.ld_conf = conf; return (dladm_door_call(handle, &writeconf, sizeof (writeconf), &retval, sizeof (retval))); } /* * Given a link ID and a key, get the matching information from * data link configuration repository. */ dladm_status_t dladm_get_conf_field(dladm_handle_t handle, dladm_conf_t conf, const char *attr, void *attrval, size_t attrsz) { dlmgmt_door_getattr_t getattr; dlmgmt_getattr_retval_t retval; dladm_status_t status; if (conf == DLADM_INVALID_CONF || attrval == NULL || attrsz == 0 || attr == NULL) { return (DLADM_STATUS_BADARG); } getattr.ld_cmd = DLMGMT_CMD_GETATTR; getattr.ld_conf = conf; (void) strlcpy(getattr.ld_attr, attr, MAXLINKATTRLEN); if ((status = dladm_door_call(handle, &getattr, sizeof (getattr), &retval, sizeof (retval))) != DLADM_STATUS_OK) { return (status); } if (retval.lr_attrsz > attrsz) return (DLADM_STATUS_TOOSMALL); bcopy(retval.lr_attrval, attrval, retval.lr_attrsz); return (DLADM_STATUS_OK); } /* * Get next property attribute from data link configuration repository. */ dladm_status_t dladm_getnext_conf_linkprop(dladm_handle_t handle, dladm_conf_t conf, const char *last_attr, char *attr, void *attrval, size_t attrsz, size_t *attrszp) { dlmgmt_door_linkprop_getnext_t getnext; dlmgmt_linkprop_getnext_retval_t retval; dladm_status_t status; if (conf == DLADM_INVALID_CONF || attrval == NULL || attrsz == 0 || attr == NULL) { return (DLADM_STATUS_BADARG); } getnext.ld_cmd = DLMGMT_CMD_LINKPROP_GETNEXT; getnext.ld_conf = conf; (void) strlcpy(getnext.ld_last_attr, last_attr, MAXLINKATTRLEN); if ((status = dladm_door_call(handle, &getnext, sizeof (getnext), &retval, sizeof (retval))) != DLADM_STATUS_OK) { return (status); } *attrszp = retval.lr_attrsz; if (retval.lr_attrsz > attrsz) { return (DLADM_STATUS_TOOSMALL); } (void) strlcpy(attr, retval.lr_attr, MAXLINKATTRLEN); bcopy(retval.lr_attrval, attrval, retval.lr_attrsz); return (DLADM_STATUS_OK); } /* * Get the link ID that is associated with the given name. */ dladm_status_t dladm_name2info(dladm_handle_t handle, const char *link, datalink_id_t *linkidp, uint32_t *flagp, datalink_class_t *classp, uint32_t *mediap) { dlmgmt_door_getlinkid_t getlinkid; dlmgmt_getlinkid_retval_t retval; datalink_id_t linkid; dladm_status_t status; getlinkid.ld_cmd = DLMGMT_CMD_GETLINKID; (void) strlcpy(getlinkid.ld_link, link, MAXLINKNAMELEN); if ((status = dladm_door_call(handle, &getlinkid, sizeof (getlinkid), &retval, sizeof (retval))) != DLADM_STATUS_OK) { return (status); } linkid = retval.lr_linkid; if (retval.lr_class == DATALINK_CLASS_PHYS && retval.lr_flags & DLMGMT_ACTIVE) { /* * An active physical link reported by the dlmgmtd daemon * might not be active anymore. Check and set its real status. */ status = i_dladm_phys_status(handle, linkid, &retval.lr_flags); if (status != DLADM_STATUS_OK) return (status); } if (linkidp != NULL) *linkidp = linkid; if (flagp != NULL) { *flagp = retval.lr_flags & DLMGMT_ACTIVE ? DLADM_OPT_ACTIVE : 0; *flagp |= (retval.lr_flags & DLMGMT_PERSIST) ? DLADM_OPT_PERSIST : 0; } if (classp != NULL) *classp = retval.lr_class; if (mediap != NULL) *mediap = retval.lr_media; return (DLADM_STATUS_OK); } /* * Get the link name that is associated with the given id. */ dladm_status_t dladm_datalink_id2info(dladm_handle_t handle, datalink_id_t linkid, uint32_t *flagp, datalink_class_t *classp, uint32_t *mediap, char *link, size_t len) { dlmgmt_door_getname_t getname; dlmgmt_getname_retval_t retval; dladm_status_t status; if ((linkid == DATALINK_INVALID_LINKID) || (link != NULL && len == 0) || (link == NULL && len != 0)) { return (DLADM_STATUS_BADARG); } getname.ld_cmd = DLMGMT_CMD_GETNAME; getname.ld_linkid = linkid; if ((status = dladm_door_call(handle, &getname, sizeof (getname), &retval, sizeof (retval))) != DLADM_STATUS_OK) { return (status); } if (len != 0 && (strlen(retval.lr_link) + 1 > len)) return (DLADM_STATUS_TOOSMALL); if (retval.lr_class == DATALINK_CLASS_PHYS && retval.lr_flags & DLMGMT_ACTIVE) { /* * An active physical link reported by the dlmgmtd daemon * might not be active anymore. Check and set its real status. */ status = i_dladm_phys_status(handle, linkid, &retval.lr_flags); if (status != DLADM_STATUS_OK) return (status); } if (link != NULL) (void) strlcpy(link, retval.lr_link, len); if (classp != NULL) *classp = retval.lr_class; if (mediap != NULL) *mediap = retval.lr_media; if (flagp != NULL) { *flagp = retval.lr_flags & DLMGMT_ACTIVE ? DLADM_OPT_ACTIVE : 0; *flagp |= (retval.lr_flags & DLMGMT_PERSIST) ? DLADM_OPT_PERSIST : 0; } return (DLADM_STATUS_OK); } /* * Set the given attr with the given attrval for the given link. */ dladm_status_t dladm_set_conf_field(dladm_handle_t handle, dladm_conf_t conf, const char *attr, dladm_datatype_t type, const void *attrval) { dlmgmt_door_setattr_t setattr; dlmgmt_setattr_retval_t retval; size_t attrsz; if (attr == NULL || attrval == NULL) return (DLADM_STATUS_BADARG); if (type == DLADM_TYPE_STR) attrsz = strlen(attrval) + 1; else attrsz = dladm_datatype_size[type]; if (attrsz > MAXLINKATTRVALLEN) return (DLADM_STATUS_TOOSMALL); setattr.ld_cmd = DLMGMT_CMD_SETATTR; setattr.ld_conf = conf; (void) strlcpy(setattr.ld_attr, attr, MAXLINKATTRLEN); setattr.ld_attrsz = attrsz; setattr.ld_type = type; bcopy(attrval, &setattr.ld_attrval, attrsz); return (dladm_door_call(handle, &setattr, sizeof (setattr), &retval, sizeof (retval))); } /* * Unset the given attr the given link. */ dladm_status_t dladm_unset_conf_field(dladm_handle_t handle, dladm_conf_t conf, const char *attr) { dlmgmt_door_unsetattr_t unsetattr; dlmgmt_unsetattr_retval_t retval; if (attr == NULL) return (DLADM_STATUS_BADARG); unsetattr.ld_cmd = DLMGMT_CMD_UNSETATTR; unsetattr.ld_conf = conf; (void) strlcpy(unsetattr.ld_attr, attr, MAXLINKATTRLEN); return (dladm_door_call(handle, &unsetattr, sizeof (unsetattr), &retval, sizeof (retval))); } /* * Remove the given link ID and its entry from the data link configuration * repository. */ dladm_status_t dladm_remove_conf(dladm_handle_t handle, datalink_id_t linkid) { dlmgmt_door_removeconf_t removeconf; dlmgmt_removeconf_retval_t retval; removeconf.ld_cmd = DLMGMT_CMD_REMOVECONF; removeconf.ld_linkid = linkid; return (dladm_door_call(handle, &removeconf, sizeof (removeconf), &retval, sizeof (retval))); } /* * Free the contents of the link structure. */ void dladm_destroy_conf(dladm_handle_t handle, dladm_conf_t conf) { dlmgmt_door_destroyconf_t destroyconf; dlmgmt_destroyconf_retval_t retval; if (conf == DLADM_INVALID_CONF) return; destroyconf.ld_cmd = DLMGMT_CMD_DESTROYCONF; destroyconf.ld_conf = conf; (void) dladm_door_call(handle, &destroyconf, sizeof (destroyconf), &retval, sizeof (retval)); } dladm_status_t dladm_zone_boot(dladm_handle_t handle, zoneid_t zoneid) { dlmgmt_door_zoneboot_t zoneboot; dlmgmt_zoneboot_retval_t retval; zoneboot.ld_cmd = DLMGMT_CMD_ZONEBOOT; zoneboot.ld_zoneid = zoneid; return (dladm_door_call(handle, &zoneboot, sizeof (zoneboot), &retval, sizeof (retval))); } dladm_status_t dladm_zone_halt(dladm_handle_t handle, zoneid_t zoneid) { dlmgmt_door_zonehalt_t zonehalt; dlmgmt_zonehalt_retval_t retval; zonehalt.ld_cmd = DLMGMT_CMD_ZONEHALT; zonehalt.ld_zoneid = zoneid; return (dladm_door_call(handle, &zonehalt, sizeof (zonehalt), &retval, sizeof (retval))); }