4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
23 * Copyright (c) 2002, 2010, Oracle and/or its affiliates. All rights reserved.
24 * Copyright (c) 2011,2012 Turbo Fredriksson <turbo@bayour.com>, based on nfs.c
27 * This is an addition to the zfs device driver to add, modify and remove SMB
28 * shares using the 'net share' command that comes with Samba.
31 * Make sure that samba listens to 'localhost' (127.0.0.1) and that the options
32 * 'usershare max shares' and 'usershare owner only' have been rewied/set
33 * accordingly (see zfs(8) for information).
35 * Once configuration in samba have been done, test that this
36 * works with the following three commands (in this case, my ZFS
37 * filesystem is called 'share/Test1'):
39 * (root)# net -U root -S 127.0.0.1 usershare add Test1 /share/Test1 \
40 * "Comment: /share/Test1" "Everyone:F"
41 * (root)# net usershare list | grep -i test
42 * (root)# net -U root -S 127.0.0.1 usershare delete Test1
44 * The first command will create a user share that gives everyone full access.
45 * To limit the access below that, use normal UNIX commands (chmod, chown etc).
57 #include <sys/types.h>
61 #include "libshare_impl.h"
64 static boolean_t
smb_available(void);
66 static sa_fstype_t
*smb_fstype
;
69 * Retrieve the list of SMB shares.
72 smb_retrieve_shares(void)
75 char file_path
[PATH_MAX
], line
[512], *token
, *key
, *value
;
76 char *dup_value
= NULL
, *path
= NULL
, *comment
= NULL
, *name
= NULL
;
77 char *guest_ok
= NULL
;
79 FILE *share_file_fp
= NULL
;
80 struct dirent
*directory
;
82 smb_share_t
*shares
, *new_shares
= NULL
;
84 /* opendir(), stat() */
85 shares_dir
= opendir(SHARE_DIR
);
86 if (shares_dir
== NULL
)
87 return (SA_SYSTEM_ERR
);
89 /* Go through the directory, looking for shares */
90 while ((directory
= readdir(shares_dir
))) {
91 if (directory
->d_name
[0] == '.')
94 snprintf(file_path
, sizeof (file_path
),
95 "%s/%s", SHARE_DIR
, directory
->d_name
);
97 if (stat(file_path
, &eStat
) == -1) {
102 if (!S_ISREG(eStat
.st_mode
))
105 if ((share_file_fp
= fopen(file_path
, "r")) == NULL
) {
110 name
= strdup(directory
->d_name
);
116 while (fgets(line
, sizeof (line
), share_file_fp
)) {
120 /* Trim trailing new-line character(s). */
121 while (line
[strlen(line
) - 1] == '\r' ||
122 line
[strlen(line
) - 1] == '\n')
123 line
[strlen(line
) - 1] = '\0';
125 /* Split the line in two, separated by '=' */
126 token
= strchr(line
, '=');
134 dup_value
= strdup(value
);
135 if (dup_value
== NULL
) {
140 if (strcmp(key
, "path") == 0) {
143 } else if (strcmp(key
, "comment") == 0) {
146 } else if (strcmp(key
, "guest_ok") == 0) {
148 guest_ok
= dup_value
;
154 if (path
== NULL
|| comment
== NULL
|| guest_ok
== NULL
)
155 continue; /* Incomplete share definition */
157 shares
= (smb_share_t
*)
158 malloc(sizeof (smb_share_t
));
159 if (shares
== NULL
) {
164 (void) strlcpy(shares
->name
, name
,
165 sizeof (shares
->name
));
167 (void) strlcpy(shares
->path
, path
,
168 sizeof (shares
->path
));
170 (void) strlcpy(shares
->comment
, comment
,
171 sizeof (shares
->comment
));
173 shares
->guest_ok
= atoi(guest_ok
);
175 shares
->next
= new_shares
;
189 if (share_file_fp
!= NULL
) {
190 fclose(share_file_fp
);
191 share_file_fp
= NULL
;
204 closedir(shares_dir
);
206 smb_shares
= new_shares
;
212 * Used internally by smb_enable_share to enable sharing for a single host.
215 smb_enable_share_one(const char *sharename
, const char *sharepath
)
217 char *argv
[10], *pos
;
218 char name
[SMB_NAME_MAX
], comment
[SMB_COMMENT_MAX
];
221 /* Support ZFS share name regexp '[[:alnum:]_-.: ]' */
222 strlcpy(name
, sharename
, sizeof (name
));
223 name
[sizeof (name
)-1] = '\0';
226 while (*pos
!= '\0') {
239 * CMD: net -S NET_CMD_ARG_HOST usershare add Test1 /share/Test1 \
240 * "Comment" "Everyone:F"
242 snprintf(comment
, sizeof (comment
), "Comment: %s", sharepath
);
244 argv
[0] = NET_CMD_PATH
;
245 argv
[1] = (char *)"-S";
246 argv
[2] = NET_CMD_ARG_HOST
;
247 argv
[3] = (char *)"usershare";
248 argv
[4] = (char *)"add";
249 argv
[5] = (char *)name
;
250 argv
[6] = (char *)sharepath
;
251 argv
[7] = (char *)comment
;
252 argv
[8] = "Everyone:F";
255 rc
= libzfs_run_process(argv
[0], argv
, 0);
257 return (SA_SYSTEM_ERR
);
259 /* Reload the share file */
260 (void) smb_retrieve_shares();
266 * Enables SMB sharing for the specified share.
269 smb_enable_share(sa_share_impl_t impl_share
)
273 if (!smb_available())
274 return (SA_SYSTEM_ERR
);
276 shareopts
= FSINFO(impl_share
, smb_fstype
)->shareopts
;
277 if (shareopts
== NULL
) /* on/off */
278 return (SA_SYSTEM_ERR
);
280 if (strcmp(shareopts
, "off") == 0)
283 /* Magic: Enable (i.e., 'create new') share */
284 return (smb_enable_share_one(impl_share
->dataset
,
285 impl_share
->sharepath
));
289 * Used internally by smb_disable_share to disable sharing for a single host.
292 smb_disable_share_one(const char *sharename
)
297 /* CMD: net -S NET_CMD_ARG_HOST usershare delete Test1 */
298 argv
[0] = NET_CMD_PATH
;
299 argv
[1] = (char *)"-S";
300 argv
[2] = NET_CMD_ARG_HOST
;
301 argv
[3] = (char *)"usershare";
302 argv
[4] = (char *)"delete";
303 argv
[5] = strdup(sharename
);
306 rc
= libzfs_run_process(argv
[0], argv
, 0);
308 return (SA_SYSTEM_ERR
);
314 * Disables SMB sharing for the specified share.
317 smb_disable_share(sa_share_impl_t impl_share
)
319 smb_share_t
*shares
= smb_shares
;
321 if (!smb_available()) {
323 * The share can't possibly be active, so nothing
324 * needs to be done to disable it.
329 while (shares
!= NULL
) {
330 if (strcmp(impl_share
->sharepath
, shares
->path
) == 0)
331 return (smb_disable_share_one(shares
->name
));
333 shares
= shares
->next
;
340 * Checks whether the specified SMB share options are syntactically correct.
343 smb_validate_shareopts(const char *shareopts
)
345 /* TODO: Accept 'name' and sec/acl (?) */
346 if ((strcmp(shareopts
, "off") == 0) || (strcmp(shareopts
, "on") == 0))
349 return (SA_SYNTAX_ERR
);
353 * Checks whether a share is currently active.
356 smb_is_share_active(sa_share_impl_t impl_share
)
358 smb_share_t
*iter
= smb_shares
;
360 if (!smb_available())
363 /* Retrieve the list of (possible) active shares */
364 smb_retrieve_shares();
366 while (iter
!= NULL
) {
367 if (strcmp(impl_share
->sharepath
, iter
->path
) == 0)
377 * Called to update a share's options. A share's options might be out of
378 * date if the share was loaded from disk and the "sharesmb" dataset
379 * property has changed in the meantime. This function also takes care
380 * of re-enabling the share if necessary.
383 smb_update_shareopts(sa_share_impl_t impl_share
, const char *resource
,
384 const char *shareopts
)
387 boolean_t needs_reshare
= B_FALSE
;
391 return (SA_SYSTEM_ERR
);
393 FSINFO(impl_share
, smb_fstype
)->active
=
394 smb_is_share_active(impl_share
);
396 old_shareopts
= FSINFO(impl_share
, smb_fstype
)->shareopts
;
398 if (FSINFO(impl_share
, smb_fstype
)->active
&& old_shareopts
!= NULL
&&
399 strcmp(old_shareopts
, shareopts
) != 0) {
400 needs_reshare
= B_TRUE
;
401 smb_disable_share(impl_share
);
404 shareopts_dup
= strdup(shareopts
);
406 if (shareopts_dup
== NULL
)
407 return (SA_NO_MEMORY
);
409 if (old_shareopts
!= NULL
)
412 FSINFO(impl_share
, smb_fstype
)->shareopts
= shareopts_dup
;
415 smb_enable_share(impl_share
);
421 * Clears a share's SMB options. Used by libshare to
422 * clean up shares that are about to be free()'d.
425 smb_clear_shareopts(sa_share_impl_t impl_share
)
427 free(FSINFO(impl_share
, smb_fstype
)->shareopts
);
428 FSINFO(impl_share
, smb_fstype
)->shareopts
= NULL
;
431 static const sa_share_ops_t smb_shareops
= {
432 .enable_share
= smb_enable_share
,
433 .disable_share
= smb_disable_share
,
435 .validate_shareopts
= smb_validate_shareopts
,
436 .update_shareopts
= smb_update_shareopts
,
437 .clear_shareopts
= smb_clear_shareopts
,
441 * Provides a convenient wrapper for determining SMB availability
448 if (lstat(SHARE_DIR
, &statbuf
) != 0 ||
449 !S_ISDIR(statbuf
.st_mode
))
452 if (access(NET_CMD_PATH
, F_OK
) != 0)
459 * Initializes the SMB functionality of libshare.
462 libshare_smb_init(void)
464 smb_fstype
= register_fstype("smb", &smb_shareops
);