Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

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\&.