1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
|
/*
* 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.
* Copyright (c) 2016 by Delphix. All rights reserved.
*/
/*
* basic declarations for implementation of the share management
* libraries.
*/
#ifndef _LIBSHARE_IMPL_H
#define _LIBSHARE_IMPL_H
#include <libshare.h>
#include <libscf.h>
#include <scfutil.h>
#include <libzfs.h>
#include <sharefs/share.h>
#include <sharefs/sharetab.h>
#ifdef __cplusplus
extern "C" {
#endif
/* directory to find plugin modules in */
#define SA_LIB_DIR "/usr/lib/fs"
/* default group name for dfstab file */
#define SA_DEFAULT_FILE_GRP "sys"
typedef void *sa_phandle_t;
#define SA_PLUGIN_VERSION 1
struct sa_plugin_ops {
int sa_version; /* version number */
char *sa_protocol; /* protocol name */
int (*sa_init)();
void (*sa_fini)();
int (*sa_share)(sa_share_t); /* start sharing */
int (*sa_unshare)(sa_share_t, char *); /* stop sharing */
int (*sa_valid_prop)(sa_handle_t, sa_property_t,
sa_optionset_t); /* validate */
int (*sa_valid_space)(char *); /* is name valid optionspace? */
int (*sa_security_prop)(char *); /* property is security */
int (*sa_legacy_opts)(sa_group_t, char *); /* parse legacy opts */
char *(*sa_legacy_format)(sa_group_t, int);
int (*sa_set_proto_prop)(sa_property_t); /* set a property */
sa_protocol_properties_t (*sa_get_proto_set)(); /* get properties */
char *(*sa_get_proto_status)();
char *(*sa_space_alias)(char *);
int (*sa_update_legacy)(sa_share_t);
int (*sa_delete_legacy)(sa_share_t);
int (*sa_change_notify)(sa_share_t);
int (*sa_enable_resource)(sa_resource_t);
int (*sa_disable_resource)(sa_resource_t);
uint64_t (*sa_features)(void);
int (*sa_get_transient_shares)(sa_handle_t); /* add transients */
int (*sa_notify_resource)(sa_resource_t);
int (*sa_rename_resource)(sa_handle_t, sa_resource_t, char *);
int (*sa_run_command)(int, int, char **); /* proto specific */
int (*sa_command_help)();
int (*sa_delete_proto_section)(char *);
};
struct sa_proto_handle {
int sa_num_proto;
char **sa_proto;
struct sa_plugin_ops **sa_ops;
};
typedef struct propertylist {
struct propertylist *pl_next;
int pl_type;
union propval {
sa_optionset_t pl_optionset;
sa_security_t pl_security;
void *pl_void;
} pl_value;
} property_list_t;
/* internal version of sa_handle_t */
typedef struct sa_handle_impl {
uint64_t flags;
scfutilhandle_t *scfhandle;
libzfs_handle_t *zfs_libhandle;
zfs_handle_t **zfs_list;
size_t zfs_list_count;
xmlNodePtr tree;
xmlDocPtr doc;
uint64_t tssharetab;
uint64_t tstrans;
int sa_service;
} *sa_handle_impl_t;
extern int sa_proto_share(char *, sa_share_t);
extern int sa_proto_unshare(sa_share_t, char *, char *);
extern int sa_proto_valid_prop(sa_handle_t, char *, sa_property_t,
sa_optionset_t);
extern int sa_proto_security_prop(char *, char *);
extern int sa_proto_legacy_opts(char *, sa_group_t, char *);
extern int sa_proto_share_resource(char *, sa_resource_t);
extern int sa_proto_unshare_resource(char *, sa_resource_t);
/* internal utility functions */
extern sa_optionset_t sa_get_derived_optionset(sa_group_t, char *, int);
extern void sa_free_derived_optionset(sa_optionset_t);
extern sa_optionset_t sa_get_all_security_types(void *, char *, int);
extern sa_security_t sa_get_derived_security(void *, char *, char *, int);
extern void sa_free_derived_security(sa_security_t);
extern sa_protocol_properties_t sa_create_protocol_properties(char *);
extern int sa_start_transaction(scfutilhandle_t *, char *);
extern int sa_end_transaction(scfutilhandle_t *, sa_handle_impl_t);
extern void sa_abort_transaction(scfutilhandle_t *);
extern int sa_commit_share(scfutilhandle_t *, sa_group_t, sa_share_t);
extern int sa_set_property(scfutilhandle_t *, char *, char *);
extern void sa_free_fstype(char *fstyp);
extern int sa_delete_share(scfutilhandle_t *, sa_group_t, sa_share_t);
extern int sa_delete_instance(scfutilhandle_t *, char *);
extern int sa_create_pgroup(scfutilhandle_t *, char *);
extern int sa_delete_pgroup(scfutilhandle_t *, char *);
extern void sa_fillshare(sa_share_t share, char *proto, struct share *sh);
extern void sa_emptyshare(struct share *sh);
/* ZFS functions */
extern int sa_get_one_zfs_share(sa_handle_t, char *, sa_init_selective_arg_t *,
char ***, size_t *);
extern int sa_get_zfs_shares(sa_handle_t, char *);
extern int sa_get_zfs_share_for_name(sa_handle_t, char *, const char *, char *);
extern int sa_zfs_update(sa_share_t);
extern int sa_share_zfs(sa_share_t, sa_resource_t, char *, share_t *,
void *, zfs_share_op_t);
extern int sa_sharetab_fill_zfs(sa_share_t share, struct share *sh,
char *proto);
/* plugin specific functions */
extern int proto_plugin_init();
extern void proto_plugin_fini();
extern int sa_proto_set_property(char *, sa_property_t);
extern int sa_proto_delete_legacy(char *, sa_share_t);
extern int sa_proto_update_legacy(char *, sa_share_t);
extern int sa_proto_rename_resource(sa_handle_t, char *,
sa_resource_t, char *);
#define PL_TYPE_PROPERTY 0
#define PL_TYPE_SECURITY 1
/* values only used by the internal dfstab/sharetab parser */
#define SA_SHARE_PARSER 0x1000
/* plugin handler only */
struct sa_proto_plugin {
struct sa_proto_plugin *plugin_next;
struct sa_plugin_ops *plugin_ops;
void *plugin_handle;
};
#define TSTAMP(tm) (uint64_t)(((uint64_t)tm.tv_sec << 32) | \
(tm.tv_nsec & 0xffffffff))
#ifdef __cplusplus
}
#endif
#endif /* _LIBSHARE_IMPL_H */
|
