6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * CDDL HEADER START
6185db853e024a486ff8837e6784dd290d866112dougm *
6185db853e024a486ff8837e6784dd290d866112dougm * The contents of this file are subject to the terms of the
6185db853e024a486ff8837e6784dd290d866112dougm * Common Development and Distribution License (the "License").
6185db853e024a486ff8837e6784dd290d866112dougm * You may not use this file except in compliance with the License.
6185db853e024a486ff8837e6784dd290d866112dougm *
6185db853e024a486ff8837e6784dd290d866112dougm * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
6185db853e024a486ff8837e6784dd290d866112dougm * or http://www.opensolaris.org/os/licensing.
6185db853e024a486ff8837e6784dd290d866112dougm * See the License for the specific language governing permissions
6185db853e024a486ff8837e6784dd290d866112dougm * and limitations under the License.
6185db853e024a486ff8837e6784dd290d866112dougm *
6185db853e024a486ff8837e6784dd290d866112dougm * When distributing Covered Code, include this CDDL HEADER in each
6185db853e024a486ff8837e6784dd290d866112dougm * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
6185db853e024a486ff8837e6784dd290d866112dougm * If applicable, add the following below this CDDL HEADER, with the
6185db853e024a486ff8837e6784dd290d866112dougm * fields enclosed by brackets "[]" replaced with your own identifying
6185db853e024a486ff8837e6784dd290d866112dougm * information: Portions Copyright [yyyy] [name of copyright owner]
6185db853e024a486ff8837e6784dd290d866112dougm *
6185db853e024a486ff8837e6784dd290d866112dougm * CDDL HEADER END
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
4bff34e37def8a90f9194d81bc345c52ba20086athurlow * Copyright 2008 Sun Microsystems, Inc. All rights reserved.
6185db853e024a486ff8837e6784dd290d866112dougm * Use is subject to license terms.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm#include <stdio.h>
6185db853e024a486ff8837e6784dd290d866112dougm#include <stdlib.h>
6185db853e024a486ff8837e6784dd290d866112dougm#include <string.h>
6185db853e024a486ff8837e6784dd290d866112dougm#include <libshare.h>
6185db853e024a486ff8837e6784dd290d866112dougm#include "libshare_impl.h"
6185db853e024a486ff8837e6784dd290d866112dougm#include <dlfcn.h>
6185db853e024a486ff8837e6784dd290d866112dougm#include <link.h>
6185db853e024a486ff8837e6784dd290d866112dougm#include <sys/types.h>
6185db853e024a486ff8837e6784dd290d866112dougm#include <sys/param.h>
6185db853e024a486ff8837e6784dd290d866112dougm#include <sys/stat.h>
6185db853e024a486ff8837e6784dd290d866112dougm#include <dirent.h>
6185db853e024a486ff8837e6784dd290d866112dougm#include <libintl.h>
549ec3fff108310966327d1dc9004551b63210b7dougm#include <sys/systeminfo.h>
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm#include <thread.h>
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm#include <synch.h>
549ec3fff108310966327d1dc9004551b63210b7dougm
549ec3fff108310966327d1dc9004551b63210b7dougm#define MAXISALEN 257 /* based on sysinfo(2) man page */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * protocol plugin interface
6185db853e024a486ff8837e6784dd290d866112dougm *
6185db853e024a486ff8837e6784dd290d866112dougm * finds plugins and makes them accessible. This is only "used" by
6185db853e024a486ff8837e6784dd290d866112dougm * libshare.so.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmstruct sa_proto_plugin *sap_proto_list;
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmstatic struct sa_proto_handle sa_proto_handle;
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmvoid proto_plugin_fini();
6185db853e024a486ff8837e6784dd290d866112dougm
8d7e41661dc4633488e93b13363137523ce59977jose borrego/*
8d7e41661dc4633488e93b13363137523ce59977jose borrego * Returns true if name is "." or "..", otherwise returns false.
8d7e41661dc4633488e93b13363137523ce59977jose borrego */
8d7e41661dc4633488e93b13363137523ce59977jose borregostatic boolean_t
8d7e41661dc4633488e93b13363137523ce59977jose borregoproto_is_dot_or_dotdot(const char *name)
8d7e41661dc4633488e93b13363137523ce59977jose borrego{
8d7e41661dc4633488e93b13363137523ce59977jose borrego if (*name != '.')
8d7e41661dc4633488e93b13363137523ce59977jose borrego return (B_FALSE);
8d7e41661dc4633488e93b13363137523ce59977jose borrego
8d7e41661dc4633488e93b13363137523ce59977jose borrego if ((name[1] == '\0') || (name[1] == '.' && name[2] == '\0'))
8d7e41661dc4633488e93b13363137523ce59977jose borrego return (B_TRUE);
8d7e41661dc4633488e93b13363137523ce59977jose borrego
8d7e41661dc4633488e93b13363137523ce59977jose borrego return (B_FALSE);
8d7e41661dc4633488e93b13363137523ce59977jose borrego}
8d7e41661dc4633488e93b13363137523ce59977jose borrego
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * proto_plugin_init()
6185db853e024a486ff8837e6784dd290d866112dougm *
6185db853e024a486ff8837e6784dd290d866112dougm * Initialize the protocol specific plugin modules.
6185db853e024a486ff8837e6784dd290d866112dougm *
8d7e41661dc4633488e93b13363137523ce59977jose borrego * Walk /usr/lib/fs/\* for libshare_*.so modules, for example,
8d7e41661dc4633488e93b13363137523ce59977jose borrego * /usr/lib/fs/nfs/libshare_nfs.so. A protocol specific directory
8d7e41661dc4633488e93b13363137523ce59977jose borrego * would have modules with names of the form libshare_<proto>.so.
8d7e41661dc4633488e93b13363137523ce59977jose borrego * For each protocol found, initialize it and add it to the internal
8d7e41661dc4633488e93b13363137523ce59977jose borrego * list of protocols. These are used for protocol specific operations.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmint
6185db853e024a486ff8837e6784dd290d866112dougmproto_plugin_init()
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_proto_plugin *proto;
6185db853e024a486ff8837e6784dd290d866112dougm int num_protos = 0;
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *plugin_ops;
6185db853e024a486ff8837e6784dd290d866112dougm void *dlhandle;
6185db853e024a486ff8837e6784dd290d866112dougm DIR *dir;
6185db853e024a486ff8837e6784dd290d866112dougm struct dirent *dent;
6185db853e024a486ff8837e6784dd290d866112dougm int ret = SA_OK;
6185db853e024a486ff8837e6784dd290d866112dougm struct stat st;
8d7e41661dc4633488e93b13363137523ce59977jose borrego char isa[MAXISALEN];
549ec3fff108310966327d1dc9004551b63210b7dougm
549ec3fff108310966327d1dc9004551b63210b7dougm#if defined(_LP64)
8d7e41661dc4633488e93b13363137523ce59977jose borrego if (sysinfo(SI_ARCHITECTURE_64, isa, MAXISALEN) == -1)
8d7e41661dc4633488e93b13363137523ce59977jose borrego isa[0] = '\0';
549ec3fff108310966327d1dc9004551b63210b7dougm#else
8d7e41661dc4633488e93b13363137523ce59977jose borrego isa[0] = '\0';
549ec3fff108310966327d1dc9004551b63210b7dougm#endif
8d7e41661dc4633488e93b13363137523ce59977jose borrego
8d7e41661dc4633488e93b13363137523ce59977jose borrego if ((dir = opendir(SA_LIB_DIR)) == NULL)
8d7e41661dc4633488e93b13363137523ce59977jose borrego return (SA_OK);
8d7e41661dc4633488e93b13363137523ce59977jose borrego
8d7e41661dc4633488e93b13363137523ce59977jose borrego while ((dent = readdir(dir)) != NULL) {
8d7e41661dc4633488e93b13363137523ce59977jose borrego char path[MAXPATHLEN];
8d7e41661dc4633488e93b13363137523ce59977jose borrego
8d7e41661dc4633488e93b13363137523ce59977jose borrego if (proto_is_dot_or_dotdot(dent->d_name))
8d7e41661dc4633488e93b13363137523ce59977jose borrego continue;
8d7e41661dc4633488e93b13363137523ce59977jose borrego
8d7e41661dc4633488e93b13363137523ce59977jose borrego (void) snprintf(path, MAXPATHLEN,
8d7e41661dc4633488e93b13363137523ce59977jose borrego "%s/%s/%s/libshare_%s.so.1", SA_LIB_DIR,
8d7e41661dc4633488e93b13363137523ce59977jose borrego dent->d_name, isa, dent->d_name);
8d7e41661dc4633488e93b13363137523ce59977jose borrego
8d7e41661dc4633488e93b13363137523ce59977jose borrego /*
8d7e41661dc4633488e93b13363137523ce59977jose borrego * If file doesn't exist, don't try to map it
8d7e41661dc4633488e93b13363137523ce59977jose borrego */
8d7e41661dc4633488e93b13363137523ce59977jose borrego if (stat(path, &st) < 0)
8d7e41661dc4633488e93b13363137523ce59977jose borrego continue;
8d7e41661dc4633488e93b13363137523ce59977jose borrego
8d7e41661dc4633488e93b13363137523ce59977jose borrego if ((dlhandle = dlopen(path, RTLD_FIRST|RTLD_LAZY)) == NULL) {
8d7e41661dc4633488e93b13363137523ce59977jose borrego (void) fprintf(stderr, dgettext(TEXT_DOMAIN,
8d7e41661dc4633488e93b13363137523ce59977jose borrego "Error in plugin for protocol %s: %s\n"),
8d7e41661dc4633488e93b13363137523ce59977jose borrego dent->d_name, dlerror());
8d7e41661dc4633488e93b13363137523ce59977jose borrego continue;
8d7e41661dc4633488e93b13363137523ce59977jose borrego }
8d7e41661dc4633488e93b13363137523ce59977jose borrego
8d7e41661dc4633488e93b13363137523ce59977jose borrego plugin_ops = (struct sa_plugin_ops *)
8d7e41661dc4633488e93b13363137523ce59977jose borrego dlsym(dlhandle, "sa_plugin_ops");
8d7e41661dc4633488e93b13363137523ce59977jose borrego if (plugin_ops == NULL) {
8d7e41661dc4633488e93b13363137523ce59977jose borrego (void) fprintf(stderr, dgettext(TEXT_DOMAIN,
8d7e41661dc4633488e93b13363137523ce59977jose borrego "Error in plugin ops for protocol %s: %s\n"),
8d7e41661dc4633488e93b13363137523ce59977jose borrego dent->d_name, dlerror());
8d7e41661dc4633488e93b13363137523ce59977jose borrego (void) dlclose(dlhandle);
8d7e41661dc4633488e93b13363137523ce59977jose borrego continue;
6185db853e024a486ff8837e6784dd290d866112dougm }
8d7e41661dc4633488e93b13363137523ce59977jose borrego
8d7e41661dc4633488e93b13363137523ce59977jose borrego proto = (struct sa_proto_plugin *)
8d7e41661dc4633488e93b13363137523ce59977jose borrego calloc(1, sizeof (struct sa_proto_plugin));
8d7e41661dc4633488e93b13363137523ce59977jose borrego if (proto == NULL) {
8d7e41661dc4633488e93b13363137523ce59977jose borrego (void) dlclose(dlhandle);
8d7e41661dc4633488e93b13363137523ce59977jose borrego ret = SA_NO_MEMORY;
8d7e41661dc4633488e93b13363137523ce59977jose borrego continue;
8d7e41661dc4633488e93b13363137523ce59977jose borrego }
8d7e41661dc4633488e93b13363137523ce59977jose borrego
8d7e41661dc4633488e93b13363137523ce59977jose borrego proto->plugin_ops = plugin_ops;
8d7e41661dc4633488e93b13363137523ce59977jose borrego proto->plugin_handle = dlhandle;
8d7e41661dc4633488e93b13363137523ce59977jose borrego num_protos++;
8d7e41661dc4633488e93b13363137523ce59977jose borrego proto->plugin_next = sap_proto_list;
8d7e41661dc4633488e93b13363137523ce59977jose borrego sap_proto_list = proto;
6185db853e024a486ff8837e6784dd290d866112dougm }
8d7e41661dc4633488e93b13363137523ce59977jose borrego
8d7e41661dc4633488e93b13363137523ce59977jose borrego (void) closedir(dir);
8d7e41661dc4633488e93b13363137523ce59977jose borrego
8d7e41661dc4633488e93b13363137523ce59977jose borrego if (num_protos != 0) {
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm sa_proto_handle.sa_proto =
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm (char **)calloc(num_protos, sizeof (char *));
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm sa_proto_handle.sa_ops =
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm (struct sa_plugin_ops **)calloc(num_protos,
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm sizeof (struct sa_plugin_ops *));
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm if (sa_proto_handle.sa_proto != NULL &&
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm sa_proto_handle.sa_ops != NULL) {
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm int i;
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm struct sa_proto_plugin *tmp;
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm for (i = 0, tmp = sap_proto_list;
917c27c8913183a8fd19de808ddac321484cba3adougm i < num_protos && tmp != NULL;
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm tmp = tmp->plugin_next) {
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm int err;
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm err = SA_OK;
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm if (tmp->plugin_ops->sa_init != NULL)
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm err = tmp->plugin_ops->sa_init();
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm if (err == SA_OK) {
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm /*
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm * Only include if the init
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm * succeeded or was NULL
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm */
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm sa_proto_handle.sa_num_proto++;
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm sa_proto_handle.sa_ops[i] =
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm tmp->plugin_ops;
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm sa_proto_handle.sa_proto[i] =
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm tmp->plugin_ops->sa_protocol;
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm i++;
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm }
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm }
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm } else {
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm ret = SA_NO_MEMORY;
6185db853e024a486ff8837e6784dd290d866112dougm }
6185db853e024a486ff8837e6784dd290d866112dougm }
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm /*
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm * There was an error, so cleanup prior to return of failure.
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm */
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm if (ret != SA_OK)
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm proto_plugin_fini();
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm
6185db853e024a486ff8837e6784dd290d866112dougm return (ret);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * proto_plugin_fini()
6185db853e024a486ff8837e6784dd290d866112dougm *
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm * Uninitialize all the plugin modules.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmvoid
6185db853e024a486ff8837e6784dd290d866112dougmproto_plugin_fini()
6185db853e024a486ff8837e6784dd290d866112dougm{
0fd7766084e66e6e9fda9eb800b67bbf965d4bffgwr struct sa_proto_plugin *p;
0fd7766084e66e6e9fda9eb800b67bbf965d4bffgwr
6185db853e024a486ff8837e6784dd290d866112dougm /*
0fd7766084e66e6e9fda9eb800b67bbf965d4bffgwr * Protocols may call this framework during _fini
0fd7766084e66e6e9fda9eb800b67bbf965d4bffgwr * (the smbfs plugin is known to do this) so do
0fd7766084e66e6e9fda9eb800b67bbf965d4bffgwr * two passes: 1st call _fini; 2nd free, dlclose.
6185db853e024a486ff8837e6784dd290d866112dougm */
0fd7766084e66e6e9fda9eb800b67bbf965d4bffgwr for (p = sap_proto_list; p != NULL; p = p->plugin_next)
0fd7766084e66e6e9fda9eb800b67bbf965d4bffgwr p->plugin_ops->sa_fini();
0fd7766084e66e6e9fda9eb800b67bbf965d4bffgwr
0fd7766084e66e6e9fda9eb800b67bbf965d4bffgwr while ((p = sap_proto_list) != NULL) {
0fd7766084e66e6e9fda9eb800b67bbf965d4bffgwr sap_proto_list = p->plugin_next;
0fd7766084e66e6e9fda9eb800b67bbf965d4bffgwr
0fd7766084e66e6e9fda9eb800b67bbf965d4bffgwr if (p->plugin_handle != NULL)
0fd7766084e66e6e9fda9eb800b67bbf965d4bffgwr (void) dlclose(p->plugin_handle);
0fd7766084e66e6e9fda9eb800b67bbf965d4bffgwr free(p);
6185db853e024a486ff8837e6784dd290d866112dougm }
6185db853e024a486ff8837e6784dd290d866112dougm if (sa_proto_handle.sa_ops != NULL) {
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm free(sa_proto_handle.sa_ops);
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm sa_proto_handle.sa_ops = NULL;
6185db853e024a486ff8837e6784dd290d866112dougm }
6185db853e024a486ff8837e6784dd290d866112dougm if (sa_proto_handle.sa_proto != NULL) {
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm free(sa_proto_handle.sa_proto);
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm sa_proto_handle.sa_proto = NULL;
6185db853e024a486ff8837e6784dd290d866112dougm }
6185db853e024a486ff8837e6784dd290d866112dougm sa_proto_handle.sa_num_proto = 0;
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * find_protocol(proto)
6185db853e024a486ff8837e6784dd290d866112dougm *
6185db853e024a486ff8837e6784dd290d866112dougm * Search the plugin list for the specified protocol and return the
6185db853e024a486ff8837e6784dd290d866112dougm * ops vector. NULL if protocol is not defined.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmstatic struct sa_plugin_ops *
6185db853e024a486ff8837e6784dd290d866112dougmfind_protocol(char *proto)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm int i;
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm struct sa_plugin_ops *ops = NULL;
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm extern mutex_t sa_global_lock;
6185db853e024a486ff8837e6784dd290d866112dougm
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm (void) mutex_lock(&sa_global_lock);
6185db853e024a486ff8837e6784dd290d866112dougm if (proto != NULL) {
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm for (i = 0; i < sa_proto_handle.sa_num_proto; i++) {
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm if (strcmp(proto, sa_proto_handle.sa_proto[i]) == 0) {
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm ops = sa_proto_handle.sa_ops[i];
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm break;
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm }
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm }
6185db853e024a486ff8837e6784dd290d866112dougm }
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm (void) mutex_unlock(&sa_global_lock);
c5f58477f1b190d049c5f4fedeed36e5cc22a1c7dougm return (ops);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * sa_proto_share(proto, share)
6185db853e024a486ff8837e6784dd290d866112dougm *
6185db853e024a486ff8837e6784dd290d866112dougm * Activate a share for the specified protocol.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmint
6185db853e024a486ff8837e6784dd290d866112dougmsa_proto_share(char *proto, sa_share_t share)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *ops = find_protocol(proto);
6185db853e024a486ff8837e6784dd290d866112dougm int ret = SA_INVALID_PROTOCOL;
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm if (ops != NULL && ops->sa_share != NULL)
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm ret = ops->sa_share(share);
6185db853e024a486ff8837e6784dd290d866112dougm return (ret);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * sa_proto_unshare(proto, share)
6185db853e024a486ff8837e6784dd290d866112dougm *
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * Deactivate (unshare) the share for this protocol.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmint
ecd6cf800b63704be73fb264c3f5b6e0dafc068dmarkssa_proto_unshare(sa_share_t share, char *proto, char *path)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *ops = find_protocol(proto);
6185db853e024a486ff8837e6784dd290d866112dougm int ret = SA_INVALID_PROTOCOL;
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm if (ops != NULL && ops->sa_unshare != NULL)
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm ret = ops->sa_unshare(share, path);
6185db853e024a486ff8837e6784dd290d866112dougm return (ret);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw/*
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * sa_proto_share_resource(char *proto, sa_resource_t resource)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw *
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * For protocols that actually enable at the resource level, do the
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * protocol specific resource enable. If it doesn't, return an error.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * Note that the resource functions are optional so can return
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * SA_NOT_SUPPORTED.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw */
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwint
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwsa_proto_share_resource(char *proto, sa_resource_t resource)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw{
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw struct sa_plugin_ops *ops = find_protocol(proto);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw int ret = SA_INVALID_PROTOCOL;
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (ops != NULL) {
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (ops->sa_enable_resource != NULL)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw ret = ops->sa_enable_resource(resource);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw else
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw ret = SA_NOT_SUPPORTED;
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw }
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw return (ret);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw}
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw/*
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * sa_proto_unshare_resource(char *proto, sa_resource_t resource)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw *
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * For protocols that actually disable at the resource level, do the
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * protocol specific resource disable. If it doesn't, return an error.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw */
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwint
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwsa_proto_unshare_resource(char *proto, sa_resource_t resource)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw{
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw struct sa_plugin_ops *ops = find_protocol(proto);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw int ret = SA_INVALID_PROTOCOL;
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (ops != NULL) {
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (ops->sa_disable_resource != NULL)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw ret = ops->sa_disable_resource(resource);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw else
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw ret = SA_NOT_SUPPORTED;
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw }
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw return (ret);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw}
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
6185db853e024a486ff8837e6784dd290d866112dougm/*
687915e946710e354e302fa654bf53bf38b57cc6dougm * sa_proto_valid_prop(handle, proto, prop, opt)
6185db853e024a486ff8837e6784dd290d866112dougm *
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm * Check to see if the specified prop is valid for this protocol.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmint
687915e946710e354e302fa654bf53bf38b57cc6dougmsa_proto_valid_prop(sa_handle_t handle, char *proto, sa_property_t prop,
687915e946710e354e302fa654bf53bf38b57cc6dougm sa_optionset_t opt)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *ops = find_protocol(proto);
6185db853e024a486ff8837e6784dd290d866112dougm int ret = 0;
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm if (ops != NULL && ops->sa_valid_prop != NULL)
687915e946710e354e302fa654bf53bf38b57cc6dougm ret = ops->sa_valid_prop(handle, prop, opt);
6185db853e024a486ff8837e6784dd290d866112dougm return (ret);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * sa_proto_valid_space(proto, space)
6185db853e024a486ff8837e6784dd290d866112dougm *
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm * Check if space is valid optionspace for proto.
6185db853e024a486ff8837e6784dd290d866112dougm * Protocols that don't implement this don't support spaces.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougmint
6185db853e024a486ff8837e6784dd290d866112dougmsa_proto_valid_space(char *proto, char *token)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *ops = find_protocol(proto);
6185db853e024a486ff8837e6784dd290d866112dougm int ret = 0;
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm if (ops != NULL && ops->sa_valid_space != NULL)
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm ret = ops->sa_valid_space(token);
6185db853e024a486ff8837e6784dd290d866112dougm return (ret);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * sa_proto_space_alias(proto, space)
6185db853e024a486ff8837e6784dd290d866112dougm *
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm * If the name for space is an alias, return its proper name. This is
6185db853e024a486ff8837e6784dd290d866112dougm * used to translate "default" values into proper form.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougmchar *
6185db853e024a486ff8837e6784dd290d866112dougmsa_proto_space_alias(char *proto, char *space)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *ops = find_protocol(proto);
6185db853e024a486ff8837e6784dd290d866112dougm char *ret = space;
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm if (ops != NULL && ops->sa_space_alias != NULL)
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm ret = ops->sa_space_alias(space);
6185db853e024a486ff8837e6784dd290d866112dougm return (ret);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * sa_proto_security_prop(proto, token)
6185db853e024a486ff8837e6784dd290d866112dougm *
6185db853e024a486ff8837e6784dd290d866112dougm * Check to see if the property name in token is a valid named
6185db853e024a486ff8837e6784dd290d866112dougm * optionset property.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmint
6185db853e024a486ff8837e6784dd290d866112dougmsa_proto_security_prop(char *proto, char *token)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *ops = find_protocol(proto);
6185db853e024a486ff8837e6784dd290d866112dougm int ret = 0;
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm if (ops != NULL && ops->sa_security_prop != NULL)
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm ret = ops->sa_security_prop(token);
6185db853e024a486ff8837e6784dd290d866112dougm return (ret);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * sa_proto_legacy_opts(proto, grouup, options)
6185db853e024a486ff8837e6784dd290d866112dougm *
6185db853e024a486ff8837e6784dd290d866112dougm * Have the protocol specific parser parse the options string and add
6185db853e024a486ff8837e6784dd290d866112dougm * an appropriate optionset to group.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmint
6185db853e024a486ff8837e6784dd290d866112dougmsa_proto_legacy_opts(char *proto, sa_group_t group, char *options)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *ops = find_protocol(proto);
6185db853e024a486ff8837e6784dd290d866112dougm int ret = SA_INVALID_PROTOCOL;
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm if (ops != NULL && ops->sa_legacy_opts != NULL)
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm ret = ops->sa_legacy_opts(group, options);
6185db853e024a486ff8837e6784dd290d866112dougm return (ret);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * sa_proto_legacy_format(proto, group, hier)
6185db853e024a486ff8837e6784dd290d866112dougm *
6185db853e024a486ff8837e6784dd290d866112dougm * Return a legacy format string representing either the group's
6185db853e024a486ff8837e6784dd290d866112dougm * properties or the groups hierarchical properties.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmchar *
6185db853e024a486ff8837e6784dd290d866112dougmsa_proto_legacy_format(char *proto, sa_group_t group, int hier)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *ops = find_protocol(proto);
6185db853e024a486ff8837e6784dd290d866112dougm char *ret = NULL;
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm if (ops != NULL && ops->sa_legacy_format != NULL)
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm ret = ops->sa_legacy_format(group, hier);
6185db853e024a486ff8837e6784dd290d866112dougm return (ret);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmvoid
6185db853e024a486ff8837e6784dd290d866112dougmsa_format_free(char *str)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm free(str);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * sharectl related API functions
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * sa_proto_get_properties(proto)
6185db853e024a486ff8837e6784dd290d866112dougm *
6185db853e024a486ff8837e6784dd290d866112dougm * Return the set of properties that are specific to the
6185db853e024a486ff8837e6784dd290d866112dougm * protocol. These are usually in /etc/dfs/<proto> and related files,
6185db853e024a486ff8837e6784dd290d866112dougm * but only the protocol module knows which ones for sure.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmsa_protocol_properties_t
6185db853e024a486ff8837e6784dd290d866112dougmsa_proto_get_properties(char *proto)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *ops = find_protocol(proto);
6185db853e024a486ff8837e6784dd290d866112dougm sa_protocol_properties_t props = NULL;
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm if (ops != NULL && ops->sa_get_proto_set != NULL)
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm props = ops->sa_get_proto_set();
6185db853e024a486ff8837e6784dd290d866112dougm return (props);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * sa_proto_set_property(proto, prop)
6185db853e024a486ff8837e6784dd290d866112dougm *
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * Update the protocol specific property.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmint
6185db853e024a486ff8837e6784dd290d866112dougmsa_proto_set_property(char *proto, sa_property_t prop)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *ops = find_protocol(proto);
6185db853e024a486ff8837e6784dd290d866112dougm int ret = SA_OK;
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm
6185db853e024a486ff8837e6784dd290d866112dougm if (ops != NULL && ops->sa_set_proto_prop != NULL)
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm ret = ops->sa_set_proto_prop(prop);
6185db853e024a486ff8837e6784dd290d866112dougm return (ret);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * sa_valid_protocol(proto)
6185db853e024a486ff8837e6784dd290d866112dougm *
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm * Check to see if the protocol specified is defined by a
6185db853e024a486ff8837e6784dd290d866112dougm * plugin. Returns true (1) or false (0)
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmint
6185db853e024a486ff8837e6784dd290d866112dougmsa_valid_protocol(char *proto)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *ops = find_protocol(proto);
6185db853e024a486ff8837e6784dd290d866112dougm return (ops != NULL);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * Return the current operational status of the protocol
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmchar *
6185db853e024a486ff8837e6784dd290d866112dougmsa_get_protocol_status(char *proto)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *ops = find_protocol(proto);
6185db853e024a486ff8837e6784dd290d866112dougm char *ret = NULL;
6185db853e024a486ff8837e6784dd290d866112dougm if (ops != NULL && ops->sa_get_proto_status != NULL)
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm ret = ops->sa_get_proto_status(proto);
6185db853e024a486ff8837e6784dd290d866112dougm return (ret);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * sa_proto_update_legacy(proto, share)
6185db853e024a486ff8837e6784dd290d866112dougm *
6185db853e024a486ff8837e6784dd290d866112dougm * Update the protocol specific legacy files if necessary for the
6185db853e024a486ff8837e6784dd290d866112dougm * specified share.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmint
6185db853e024a486ff8837e6784dd290d866112dougmsa_proto_update_legacy(char *proto, sa_share_t share)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *ops = find_protocol(proto);
6185db853e024a486ff8837e6784dd290d866112dougm int ret = SA_NOT_IMPLEMENTED;
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm if (ops != NULL) {
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm if (ops->sa_update_legacy != NULL)
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm ret = ops->sa_update_legacy(share);
6185db853e024a486ff8837e6784dd290d866112dougm }
6185db853e024a486ff8837e6784dd290d866112dougm return (ret);
6185db853e024a486ff8837e6784dd290d866112dougm}
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm/*
6185db853e024a486ff8837e6784dd290d866112dougm * sa_delete_legacy(proto, share)
6185db853e024a486ff8837e6784dd290d866112dougm *
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm * Remove the specified share from the protocol specific legacy files.
6185db853e024a486ff8837e6784dd290d866112dougm */
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougmint
6185db853e024a486ff8837e6784dd290d866112dougmsa_proto_delete_legacy(char *proto, sa_share_t share)
6185db853e024a486ff8837e6784dd290d866112dougm{
6185db853e024a486ff8837e6784dd290d866112dougm struct sa_plugin_ops *ops = find_protocol(proto);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw int ret = SA_NOT_IMPLEMENTED;
6185db853e024a486ff8837e6784dd290d866112dougm
6185db853e024a486ff8837e6784dd290d866112dougm if (ops != NULL) {
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm if (ops->sa_delete_legacy != NULL)
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm ret = ops->sa_delete_legacy(share);
4bff34e37def8a90f9194d81bc345c52ba20086athurlow } else {
4bff34e37def8a90f9194d81bc345c52ba20086athurlow if (proto != NULL)
4bff34e37def8a90f9194d81bc345c52ba20086athurlow ret = SA_NOT_IMPLEMENTED;
4bff34e37def8a90f9194d81bc345c52ba20086athurlow else
4bff34e37def8a90f9194d81bc345c52ba20086athurlow ret = SA_INVALID_PROTOCOL;
4bff34e37def8a90f9194d81bc345c52ba20086athurlow }
4bff34e37def8a90f9194d81bc345c52ba20086athurlow return (ret);
4bff34e37def8a90f9194d81bc345c52ba20086athurlow}
4bff34e37def8a90f9194d81bc345c52ba20086athurlow
4bff34e37def8a90f9194d81bc345c52ba20086athurlow/*
4bff34e37def8a90f9194d81bc345c52ba20086athurlow * sa_proto_delete_section(proto, section)
4bff34e37def8a90f9194d81bc345c52ba20086athurlow *
4bff34e37def8a90f9194d81bc345c52ba20086athurlow * Remove the specified section from the protocol specific legacy files,
4bff34e37def8a90f9194d81bc345c52ba20086athurlow * if supported.
4bff34e37def8a90f9194d81bc345c52ba20086athurlow */
4bff34e37def8a90f9194d81bc345c52ba20086athurlow
4bff34e37def8a90f9194d81bc345c52ba20086athurlowint
4bff34e37def8a90f9194d81bc345c52ba20086athurlowsa_proto_delete_section(char *proto, char *section)
4bff34e37def8a90f9194d81bc345c52ba20086athurlow{
4bff34e37def8a90f9194d81bc345c52ba20086athurlow struct sa_plugin_ops *ops = find_protocol(proto);
4bff34e37def8a90f9194d81bc345c52ba20086athurlow int ret = SA_OK;
4bff34e37def8a90f9194d81bc345c52ba20086athurlow
4bff34e37def8a90f9194d81bc345c52ba20086athurlow if (ops != NULL) {
4bff34e37def8a90f9194d81bc345c52ba20086athurlow if (ops->sa_delete_proto_section != NULL)
4bff34e37def8a90f9194d81bc345c52ba20086athurlow ret = ops->sa_delete_proto_section(section);
4bff34e37def8a90f9194d81bc345c52ba20086athurlow } else {
4bff34e37def8a90f9194d81bc345c52ba20086athurlow if (proto != NULL)
4bff34e37def8a90f9194d81bc345c52ba20086athurlow ret = SA_NOT_IMPLEMENTED;
4bff34e37def8a90f9194d81bc345c52ba20086athurlow else
4bff34e37def8a90f9194d81bc345c52ba20086athurlow ret = SA_INVALID_PROTOCOL;
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw }
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw return (ret);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw}
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw/*
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * sa_proto_change_notify(share, char *protocol)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw *
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * Notify the protocol that a change has been made to the share
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw */
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwint
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwsa_proto_change_notify(sa_share_t share, char *proto)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw{
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw struct sa_plugin_ops *ops = find_protocol(proto);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw int ret = SA_NOT_IMPLEMENTED;
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (ops != NULL) {
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (ops->sa_change_notify != NULL)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw ret = ops->sa_change_notify(share);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw } else if (proto == NULL) {
4bff34e37def8a90f9194d81bc345c52ba20086athurlow
25a68471b9ababbc21cfdbbb2866014f34f419ecdougm ret = SA_INVALID_PROTOCOL;
6185db853e024a486ff8837e6784dd290d866112dougm }
6185db853e024a486ff8837e6784dd290d866112dougm return (ret);
6185db853e024a486ff8837e6784dd290d866112dougm}
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw/*
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * sa_proto_notify_resource(resource, char *protocol)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw *
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * Notify the protocol that a change has been made to the share
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw */
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwint
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwsa_proto_notify_resource(sa_resource_t resource, char *proto)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw{
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw struct sa_plugin_ops *ops = find_protocol(proto);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw int ret = SA_NOT_IMPLEMENTED;
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (ops != NULL) {
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (ops->sa_notify_resource != NULL)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw ret = ops->sa_notify_resource(resource);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw } else if (proto == NULL) {
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw ret = SA_INVALID_PROTOCOL;
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw }
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw return (ret);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw}
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw/*
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * sa_proto_get_featureset(protocol)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw *
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * Get bitmask of defined features of the protocol. These are
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * primarily things like SA_FEATURE_RESOURCE (shares are by resource
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * name rather than path) and other operational features that affect
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * behavior.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw */
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwuint64_t
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwsa_proto_get_featureset(char *proto)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw{
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw struct sa_plugin_ops *ops = find_protocol(proto);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw uint64_t ret = 0;
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (ops != NULL) {
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (ops->sa_features != NULL)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw ret = ops->sa_features();
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw }
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw /* if not implemented, zero is valid */
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw return (ret);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw}
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw/*
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * sa_proto_get_transients(sa_handle_t)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw *
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * Called to get any protocol specific transient shares. NFS doesn't
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * use this since the info is in sharetab which is processed as a
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * common transient store.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw *
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * The protocol plugin should verify that the share isn't in the
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * repository and then add it as a transient.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw *
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * Not having an entry is not a problem. It returns 0 in that case.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw */
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwint
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwsa_proto_get_transients(sa_handle_t handle, char *proto)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw{
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw struct sa_plugin_ops *ops = find_protocol(proto);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw int ret = 0;
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (ops != NULL) {
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (ops->sa_get_transient_shares != NULL)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw ret = ops->sa_get_transient_shares(handle);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw }
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw return (ret);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw}
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw/*
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * sa_proto_rename_resource(sa_handle_t, proto, sa_resource_t, newname)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw *
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * Protocols may need to know when a resource has changed names in
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * order to notify clients. This must be done "before" the name in the
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw * resource has been changed. Not being implemented is not a problem.
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw */
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwint
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amwsa_proto_rename_resource(sa_handle_t handle, char *proto,
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw sa_resource_t resource, char *newname)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw{
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw struct sa_plugin_ops *ops = find_protocol(proto);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw int ret = SA_OK;
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (ops != NULL) {
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw if (ops->sa_rename_resource != NULL)
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw ret = ops->sa_rename_resource(handle, resource,
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw newname);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw }
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw return (ret);
da6c28aaf62fa55f0fdb8004aa40f88f23bf53f0amw}