diff options
Diffstat (limited to 'upstream/opensuse-leap-15-6/man8/vfs_widelinks.8')
| -rw-r--r-- | upstream/opensuse-leap-15-6/man8/vfs_widelinks.8 | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man8/vfs_widelinks.8 b/upstream/opensuse-leap-15-6/man8/vfs_widelinks.8 new file mode 100644 index 00000000..fdf5a850 --- /dev/null +++ b/upstream/opensuse-leap-15-6/man8/vfs_widelinks.8 @@ -0,0 +1,59 @@ +'\" t +.\" Title: vfs_widelinks +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> +.\" Date: 10/23/2023 +.\" Manual: System Administration tools +.\" Source: Samba 4.19.2-git.328.e4c431e307f150600.1.23SUSE-oS15.0-x86_64 +.\" Language: English +.\" +.TH "VFS_WIDELINKS" "8" "10/23/2023" "Samba 4\&.19\&.2\-git\&.328\&." "System Administration tools" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +vfs_widelinks \- make a Samba share ignore filesystem symbolic links inside a share +.SH "SYNOPSIS" +.HP \w'\ 'u +vfs objects = widelinks +.SH "DESCRIPTION" +.PP +This VFS module is part of the +\fBsamba\fR(7) +suite\&. +.PP +The +vfs_widelinks +VFS module hides the existence of symbolic links in the filesystem inside a share\&. It is used in Samba version 4\&.13 and above to implement the +smb\&.conf"wide links = yes" functionality that used to be inside the core smbd code\&. The module should not be loaded explicitly by smb\&.conf as part of the "vfs objects =" parameter, but is loaded implicitly when "wide links = yes" is enabled\&. This is to prevent existing smb\&.conf files from having to be modified to keep the existing insecure "wide links" functionality on a share\&. +.PP +Please note that "wide links = yes" functionality is a deliberately insecure option, and should never be used in Samba installations\&. On Linux, bind mounts can be used instead to implement anything "wide links = yes" can enable\&. This module has been created to provide backwards compatibility with existing users of "wide links = yes" installations, but this use cannot be recommended and is not endorsed by the Samba developers\&. +.PP +Note that this implicit loading may become explicit in a later Samba release, and administrators wishing to keep the insecure "wide links" functionality may have to add this module into their "vfs objects =" module list\&. The Samba project release notes and this manpage will be updated to reflect this when this change is made\&. +.PP +This module is stackable\&. +.SH "EXAMPLES" +.PP +No examples listed\&. This module is implicitly loaded by smbd as needed\&. +.SH "VERSION" +.PP +This man page is part of version 4\&.19\&.2\-git\&.328\&.e4c431e307f150600\&.1\&.23SUSE\-oS15\&.0\-x86_64 of the Samba suite\&. +.SH "AUTHOR" +.PP +The original Samba software and related utilities were created by Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\&. |