]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - share/man/man5/smbfs.5
Add 'contrib/spleen/' from commit '5eab6333fa27e2b6954c6927859d462a004e57bb'
[FreeBSD/FreeBSD.git] / share / man / man5 / smbfs.5
1 .\" Copyright (c) 2020 Gordon Bergling
2 .\"
3 .\" Redistribution and use in source and binary forms, with or without
4 .\" modification, are permitted provided that the following conditions
5 .\" are met:
6 .\" 1. Redistributions of source code must retain the above copyright
7 .\"    notice, this list of conditions and the following disclaimer.
8 .\" 2. Redistributions in binary form must reproduce the above copyright
9 .\"    notice, this list of conditions and the following disclaimer in the
10 .\"    documentation and/or other materials provided with the distribution.
11 .\"
12 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
13 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
14 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
15 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
16 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
17 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
18 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
19 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
20 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
21 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
22 .\" SUCH DAMAGE.
23 .\"
24 .\" $FreeBSD$
25 .\"
26 .Dd April 6, 2022
27 .Dt SMBFS 5
28 .Os
29 .Sh NAME
30 .Nm smbfs
31 .Nd "SMB FS"
32 .Sh SYNOPSIS
33 To compile this driver into the kernel,
34 place the following lines in your
35 kernel configuration file:
36 .Bd -ragged -offset indent
37 .Cd "option NETSMB"
38 .Ed
39 .Pp
40 Alternatively, to load the driver as a
41 module at boot time, place the following line in
42 .Xr loader.conf 5 :
43 .Bd -literal -offset indent
44 smbfs_load="YES"
45 .Ed
46 .Sh DESCRIPTION
47 The SMB driver is an implementation of the CIFS (Common Internet Filesystem)
48 network protocol.
49 .Pp
50 .Bf -symbolic
51 The
52 .Nm
53 filesystem driver supports only the obsolete SMBv1 protocol.
54 .Nm
55 has known bugs and likely has security vulnerabilities.
56 .Nm
57 and userspace counterparts
58 .Xr smbutil 1
59 and
60 .Xr mount_smbfs 8
61 may be removed from a future version of
62 .Fx .
63 Users are advised to evaluate the
64 .Pa sysutils/fusefs-smbnetfs
65 port instead.
66 .Ef
67 .Sh SEE ALSO
68 .Xr smbutil 1 ,
69 .Xr mount_smbfs 8
70 .Sh STANDARDS
71 .Rs
72 .%U https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-cifs/
73 .%T Common Internet File System (CIFS) Protocol
74 .%R MS-CIFS
75 .%D December 2018
76 .Re
77 .Pp
78 .Rs
79 .%U https://tools.ietf.org/html/draft-heizer-cifs-v1-spec-00
80 .%T Common Internet File System Protocol (CIFS/1.0)
81 .%D June 13, 1996
82 .%A I. Heizer
83 .%A P. Leach
84 .%A D. Perry
85 .Re
86 .Sh HISTORY
87 The
88 .Nm
89 device driver first appeared in
90 .Fx 4.4 .
91 .Sh AUTHORS
92 .An -nosplit
93 The
94 .Nm
95 device driver was written by
96 .An Boris Popov Aq Mt bp@FreeBSD.org .
97 The manual page was contributed by
98 .An Gordon Bergling Aq Mt gbe@FreeBSD.org .