/* * 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 2008 Sun Microsystems, Inc. All rights reserved. * Use is subject to license terms. */ #include #include #include #include #include "libshare_impl.h" #include #include #include #include #include #include #include #include #include #include #define MAXISALEN 257 /* based on sysinfo(2) man page */ /* * protocol plugin interface * * finds plugins and makes them accessible. This is only "used" by * libshare.so. */ struct sa_proto_plugin *sap_proto_list; static struct sa_proto_handle sa_proto_handle; void proto_plugin_fini(); /* * Returns true if name is "." or "..", otherwise returns false. */ static boolean_t proto_is_dot_or_dotdot(const char *name) { if (*name != '.') return (B_FALSE); if ((name[1] == '\0') || (name[1] == '.' && name[2] == '\0')) return (B_TRUE); return (B_FALSE); } /* * proto_plugin_init() * * Initialize the protocol specific plugin modules. * * Walk /usr/lib/fs/\* for libshare_*.so modules, for example, * /usr/lib/fs/nfs/libshare_nfs.so. A protocol specific directory * would have modules with names of the form libshare_.so. * For each protocol found, initialize it and add it to the internal * list of protocols. These are used for protocol specific operations. */ int proto_plugin_init() { struct sa_proto_plugin *proto; int num_protos = 0; struct sa_plugin_ops *plugin_ops; void *dlhandle; DIR *dir; struct dirent *dent; int ret = SA_OK; struct stat st; char isa[MAXISALEN]; #if defined(_LP64) if (sysinfo(SI_ARCHITECTURE_64, isa, MAXISALEN) == -1) isa[0] = '\0'; #else isa[0] = '\0'; #endif if ((dir = opendir(SA_LIB_DIR)) == NULL) return (SA_OK); while ((dent = readdir(dir)) != NULL) { char path[MAXPATHLEN]; if (proto_is_dot_or_dotdot(dent->d_name)) continue; (void) snprintf(path, MAXPATHLEN, "%s/%s/%s/libshare_%s.so.1", SA_LIB_DIR, dent->d_name, isa, dent->d_name); /* * If file doesn't exist, don't try to map it */ if (stat(path, &st) < 0) continue; if ((dlhandle = dlopen(path, RTLD_FIRST|RTLD_LAZY)) == NULL) { (void) fprintf(stderr, dgettext(TEXT_DOMAIN, "Error in plugin for protocol %s: %s\n"), dent->d_name, dlerror()); continue; } plugin_ops = (struct sa_plugin_ops *) dlsym(dlhandle, "sa_plugin_ops"); if (plugin_ops == NULL) { (void) fprintf(stderr, dgettext(TEXT_DOMAIN, "Error in plugin ops for protocol %s: %s\n"), dent->d_name, dlerror()); (void) dlclose(dlhandle); continue; } proto = (struct sa_proto_plugin *) calloc(1, sizeof (struct sa_proto_plugin)); if (proto == NULL) { (void) dlclose(dlhandle); ret = SA_NO_MEMORY; continue; } proto->plugin_ops = plugin_ops; proto->plugin_handle = dlhandle; num_protos++; proto->plugin_next = sap_proto_list; sap_proto_list = proto; } (void) closedir(dir); if (num_protos != 0) { sa_proto_handle.sa_proto = (char **)calloc(num_protos, sizeof (char *)); sa_proto_handle.sa_ops = (struct sa_plugin_ops **)calloc(num_protos, sizeof (struct sa_plugin_ops *)); if (sa_proto_handle.sa_proto != NULL && sa_proto_handle.sa_ops != NULL) { int i; struct sa_proto_plugin *tmp; for (i = 0, tmp = sap_proto_list; i < num_protos && tmp != NULL; tmp = tmp->plugin_next) { int err; err = SA_OK; if (tmp->plugin_ops->sa_init != NULL) err = tmp->plugin_ops->sa_init(); if (err == SA_OK) { /* * Only include if the init * succeeded or was NULL */ sa_proto_handle.sa_num_proto++; sa_proto_handle.sa_ops[i] = tmp->plugin_ops; sa_proto_handle.sa_proto[i] = tmp->plugin_ops->sa_protocol; i++; } } } else { ret = SA_NO_MEMORY; } } /* * There was an error, so cleanup prior to return of failure. */ if (ret != SA_OK) proto_plugin_fini(); return (ret); } /* * proto_plugin_fini() * * Uninitialize all the plugin modules. */ void proto_plugin_fini() { struct sa_proto_plugin *p; /* * Protocols may call this framework during _fini * (the smbfs plugin is known to do this) so do * two passes: 1st call _fini; 2nd free, dlclose. */ for (p = sap_proto_list; p != NULL; p = p->plugin_next) p->plugin_ops->sa_fini(); while ((p = sap_proto_list) != NULL) { sap_proto_list = p->plugin_next; if (p->plugin_handle != NULL) (void) dlclose(p->plugin_handle); free(p); } if (sa_proto_handle.sa_ops != NULL) { free(sa_proto_handle.sa_ops); sa_proto_handle.sa_ops = NULL; } if (sa_proto_handle.sa_proto != NULL) { free(sa_proto_handle.sa_proto); sa_proto_handle.sa_proto = NULL; } sa_proto_handle.sa_num_proto = 0; } /* * find_protocol(proto) * * Search the plugin list for the specified protocol and return the * ops vector. NULL if protocol is not defined. */ static struct sa_plugin_ops * find_protocol(char *proto) { int i; struct sa_plugin_ops *ops = NULL; extern mutex_t sa_global_lock; (void) mutex_lock(&sa_global_lock); if (proto != NULL) { for (i = 0; i < sa_proto_handle.sa_num_proto; i++) { if (strcmp(proto, sa_proto_handle.sa_proto[i]) == 0) { ops = sa_proto_handle.sa_ops[i]; break; } } } (void) mutex_unlock(&sa_global_lock); return (ops); } /* * sa_proto_share(proto, share) * * Activate a share for the specified protocol. */ int sa_proto_share(char *proto, sa_share_t share) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = SA_INVALID_PROTOCOL; if (ops != NULL && ops->sa_share != NULL) ret = ops->sa_share(share); return (ret); } /* * sa_proto_unshare(proto, share) * * Deactivate (unshare) the share for this protocol. */ int sa_proto_unshare(sa_share_t share, char *proto, char *path) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = SA_INVALID_PROTOCOL; if (ops != NULL && ops->sa_unshare != NULL) ret = ops->sa_unshare(share, path); return (ret); } /* * sa_proto_share_resource(char *proto, sa_resource_t resource) * * For protocols that actually enable at the resource level, do the * protocol specific resource enable. If it doesn't, return an error. * Note that the resource functions are optional so can return * SA_NOT_SUPPORTED. */ int sa_proto_share_resource(char *proto, sa_resource_t resource) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = SA_INVALID_PROTOCOL; if (ops != NULL) { if (ops->sa_enable_resource != NULL) ret = ops->sa_enable_resource(resource); else ret = SA_NOT_SUPPORTED; } return (ret); } /* * sa_proto_unshare_resource(char *proto, sa_resource_t resource) * * For protocols that actually disable at the resource level, do the * protocol specific resource disable. If it doesn't, return an error. */ int sa_proto_unshare_resource(char *proto, sa_resource_t resource) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = SA_INVALID_PROTOCOL; if (ops != NULL) { if (ops->sa_disable_resource != NULL) ret = ops->sa_disable_resource(resource); else ret = SA_NOT_SUPPORTED; } return (ret); } /* * sa_proto_valid_prop(handle, proto, prop, opt) * * Check to see if the specified prop is valid for this protocol. */ int sa_proto_valid_prop(sa_handle_t handle, char *proto, sa_property_t prop, sa_optionset_t opt) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = 0; if (ops != NULL && ops->sa_valid_prop != NULL) ret = ops->sa_valid_prop(handle, prop, opt); return (ret); } /* * sa_proto_valid_space(proto, space) * * Check if space is valid optionspace for proto. * Protocols that don't implement this don't support spaces. */ int sa_proto_valid_space(char *proto, char *token) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = 0; if (ops != NULL && ops->sa_valid_space != NULL) ret = ops->sa_valid_space(token); return (ret); } /* * sa_proto_space_alias(proto, space) * * If the name for space is an alias, return its proper name. This is * used to translate "default" values into proper form. */ char * sa_proto_space_alias(char *proto, char *space) { struct sa_plugin_ops *ops = find_protocol(proto); char *ret = space; if (ops != NULL && ops->sa_space_alias != NULL) ret = ops->sa_space_alias(space); return (ret); } /* * sa_proto_security_prop(proto, token) * * Check to see if the property name in token is a valid named * optionset property. */ int sa_proto_security_prop(char *proto, char *token) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = 0; if (ops != NULL && ops->sa_security_prop != NULL) ret = ops->sa_security_prop(token); return (ret); } /* * sa_proto_legacy_opts(proto, grouup, options) * * Have the protocol specific parser parse the options string and add * an appropriate optionset to group. */ int sa_proto_legacy_opts(char *proto, sa_group_t group, char *options) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = SA_INVALID_PROTOCOL; if (ops != NULL && ops->sa_legacy_opts != NULL) ret = ops->sa_legacy_opts(group, options); return (ret); } /* * sa_proto_legacy_format(proto, group, hier) * * Return a legacy format string representing either the group's * properties or the groups hierarchical properties. */ char * sa_proto_legacy_format(char *proto, sa_group_t group, int hier) { struct sa_plugin_ops *ops = find_protocol(proto); char *ret = NULL; if (ops != NULL && ops->sa_legacy_format != NULL) ret = ops->sa_legacy_format(group, hier); return (ret); } void sa_format_free(char *str) { free(str); } /* * sharectl related API functions */ /* * sa_proto_get_properties(proto) * * Return the set of properties that are specific to the * protocol. These are usually in /etc/dfs/ and related files, * but only the protocol module knows which ones for sure. */ sa_protocol_properties_t sa_proto_get_properties(char *proto) { struct sa_plugin_ops *ops = find_protocol(proto); sa_protocol_properties_t props = NULL; if (ops != NULL && ops->sa_get_proto_set != NULL) props = ops->sa_get_proto_set(); return (props); } /* * sa_proto_set_property(proto, prop) * * Update the protocol specific property. */ int sa_proto_set_property(char *proto, sa_property_t prop) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = SA_OK; if (ops != NULL && ops->sa_set_proto_prop != NULL) ret = ops->sa_set_proto_prop(prop); return (ret); } /* * sa_valid_protocol(proto) * * Check to see if the protocol specified is defined by a * plugin. Returns true (1) or false (0) */ int sa_valid_protocol(char *proto) { struct sa_plugin_ops *ops = find_protocol(proto); return (ops != NULL); } /* * Return the current operational status of the protocol */ char * sa_get_protocol_status(char *proto) { struct sa_plugin_ops *ops = find_protocol(proto); char *ret = NULL; if (ops != NULL && ops->sa_get_proto_status != NULL) ret = ops->sa_get_proto_status(proto); return (ret); } /* * sa_proto_update_legacy(proto, share) * * Update the protocol specific legacy files if necessary for the * specified share. */ int sa_proto_update_legacy(char *proto, sa_share_t share) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = SA_NOT_IMPLEMENTED; if (ops != NULL) { if (ops->sa_update_legacy != NULL) ret = ops->sa_update_legacy(share); } return (ret); } /* * sa_delete_legacy(proto, share) * * Remove the specified share from the protocol specific legacy files. */ int sa_proto_delete_legacy(char *proto, sa_share_t share) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = SA_NOT_IMPLEMENTED; if (ops != NULL) { if (ops->sa_delete_legacy != NULL) ret = ops->sa_delete_legacy(share); } else { if (proto != NULL) ret = SA_NOT_IMPLEMENTED; else ret = SA_INVALID_PROTOCOL; } return (ret); } /* * sa_proto_delete_section(proto, section) * * Remove the specified section from the protocol specific legacy files, * if supported. */ int sa_proto_delete_section(char *proto, char *section) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = SA_OK; if (ops != NULL) { if (ops->sa_delete_proto_section != NULL) ret = ops->sa_delete_proto_section(section); } else { if (proto != NULL) ret = SA_NOT_IMPLEMENTED; else ret = SA_INVALID_PROTOCOL; } return (ret); } /* * sa_proto_change_notify(share, char *protocol) * * Notify the protocol that a change has been made to the share */ int sa_proto_change_notify(sa_share_t share, char *proto) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = SA_NOT_IMPLEMENTED; if (ops != NULL) { if (ops->sa_change_notify != NULL) ret = ops->sa_change_notify(share); } else if (proto == NULL) { ret = SA_INVALID_PROTOCOL; } return (ret); } /* * sa_proto_notify_resource(resource, char *protocol) * * Notify the protocol that a change has been made to the share */ int sa_proto_notify_resource(sa_resource_t resource, char *proto) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = SA_NOT_IMPLEMENTED; if (ops != NULL) { if (ops->sa_notify_resource != NULL) ret = ops->sa_notify_resource(resource); } else if (proto == NULL) { ret = SA_INVALID_PROTOCOL; } return (ret); } /* * sa_proto_get_featureset(protocol) * * Get bitmask of defined features of the protocol. These are * primarily things like SA_FEATURE_RESOURCE (shares are by resource * name rather than path) and other operational features that affect * behavior. */ uint64_t sa_proto_get_featureset(char *proto) { struct sa_plugin_ops *ops = find_protocol(proto); uint64_t ret = 0; if (ops != NULL) { if (ops->sa_features != NULL) ret = ops->sa_features(); } /* if not implemented, zero is valid */ return (ret); } /* * sa_proto_get_transients(sa_handle_t) * * Called to get any protocol specific transient shares. NFS doesn't * use this since the info is in sharetab which is processed as a * common transient store. * * The protocol plugin should verify that the share isn't in the * repository and then add it as a transient. * * Not having an entry is not a problem. It returns 0 in that case. */ int sa_proto_get_transients(sa_handle_t handle, char *proto) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = 0; if (ops != NULL) { if (ops->sa_get_transient_shares != NULL) ret = ops->sa_get_transient_shares(handle); } return (ret); } /* * sa_proto_rename_resource(sa_handle_t, proto, sa_resource_t, newname) * * Protocols may need to know when a resource has changed names in * order to notify clients. This must be done "before" the name in the * resource has been changed. Not being implemented is not a problem. */ int sa_proto_rename_resource(sa_handle_t handle, char *proto, sa_resource_t resource, char *newname) { struct sa_plugin_ops *ops = find_protocol(proto); int ret = SA_OK; if (ops != NULL) { if (ops->sa_rename_resource != NULL) ret = ops->sa_rename_resource(handle, resource, newname); } return (ret); }