1VFS_WIDELINKS(8)          System Administration tools         VFS_WIDELINKS(8)
2
3
4

NAME

6       vfs_widelinks - make a Samba share ignore filesystem symbolic links
7       inside a share
8

SYNOPSIS

10       vfs objects = widelinks
11

DESCRIPTION

13       This VFS module is part of the samba(7) suite.
14
15       The vfs_widelinks VFS module hides the existence of symbolic links in
16       the filesystem inside a share. It is used in Samba version 4.13 and
17       above to implement the smb.conf"wide links = yes" functionality that
18       used to be inside the core smbd code. The module should not be loaded
19       explicitly by smb.conf as part of the "vfs objects =" parameter, but is
20       loaded implicitly when "wide links = yes" is enabled. This is to
21       prevent existing smb.conf files from having to be modified to keep the
22       existing insecure "wide links" functionality on a share.
23
24       Please note that "wide links = yes" functionality is a deliberately
25       insecure option, and should never be used in Samba installations. On
26       Linux, bind mounts can be used instead to implement anything "wide
27       links = yes" can enable. This module has been created to provide
28       backwards compatibility with existing users of "wide links = yes"
29       installations, but this use cannot be recommended and is not endorsed
30       by the Samba developers.
31
32       Note that this implicit loading may become explicit in a later Samba
33       release, and administrators wishing to keep the insecure "wide links"
34       functionality may have to add this module into their "vfs objects ="
35       module list. The Samba project release notes and this manpage will be
36       updated to reflect this when this change is made.
37
38       This module is stackable.
39

EXAMPLES

41       No examples listed. This module is implicitly loaded by smbd as needed.
42

VERSION

44       This man page is part of version 4.18.9 of the Samba suite.
45

AUTHOR

47       The original Samba software and related utilities were created by
48       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
49       Source project similar to the way the Linux kernel is developed.
50
51
52
53Samba 4.18.9                      11/30/2023                  VFS_WIDELINKS(8)
Impressum