xref: /freebsd/share/man/man4/smbfs.4 (revision 066ef2aec187ae93a9df01d25fa8e47d67ff972b)
1bd2d71b1SAlexander Ziaee.\"-
2bd2d71b1SAlexander Ziaee.\" SPDX-License-Identifier: BSD-2-Clause
3bd2d71b1SAlexander Ziaee.\"
41687d771SAlexander Ziaee.\" Copyright (c) 2020 Gordon Bergling
51687d771SAlexander Ziaee.\"
61687d771SAlexander Ziaee.\" Redistribution and use in source and binary forms, with or without
71687d771SAlexander Ziaee.\" modification, are permitted provided that the following conditions
81687d771SAlexander Ziaee.\" are met:
91687d771SAlexander Ziaee.\" 1. Redistributions of source code must retain the above copyright
101687d771SAlexander Ziaee.\"    notice, this list of conditions and the following disclaimer.
111687d771SAlexander Ziaee.\" 2. Redistributions in binary form must reproduce the above copyright
121687d771SAlexander Ziaee.\"    notice, this list of conditions and the following disclaimer in the
131687d771SAlexander Ziaee.\"    documentation and/or other materials provided with the distribution.
141687d771SAlexander Ziaee.\"
151687d771SAlexander Ziaee.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
161687d771SAlexander Ziaee.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
171687d771SAlexander Ziaee.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
181687d771SAlexander Ziaee.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
191687d771SAlexander Ziaee.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
201687d771SAlexander Ziaee.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
211687d771SAlexander Ziaee.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
221687d771SAlexander Ziaee.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
231687d771SAlexander Ziaee.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
241687d771SAlexander Ziaee.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
251687d771SAlexander Ziaee.\" SUCH DAMAGE.
261687d771SAlexander Ziaee.\"
271687d771SAlexander Ziaee.Dd April 6, 2022
281687d771SAlexander Ziaee.Dt SMBFS 4
291687d771SAlexander Ziaee.Os
301687d771SAlexander Ziaee.Sh NAME
311687d771SAlexander Ziaee.Nm smbfs
32bd2d71b1SAlexander Ziaee.Nd server message block (SMB1/CIFS) file system
331687d771SAlexander Ziaee.Sh SYNOPSIS
341687d771SAlexander ZiaeeTo compile this driver into the kernel,
351687d771SAlexander Ziaeeplace the following lines in your
361687d771SAlexander Ziaeekernel configuration file:
371687d771SAlexander Ziaee.Bd -ragged -offset indent
381687d771SAlexander Ziaee.Cd "option NETSMB"
391687d771SAlexander Ziaee.Ed
401687d771SAlexander Ziaee.Pp
411687d771SAlexander ZiaeeAlternatively, to load the driver as a
421687d771SAlexander Ziaeemodule at boot time, place the following line in
431687d771SAlexander Ziaee.Xr loader.conf 5 :
441687d771SAlexander Ziaee.Bd -literal -offset indent
451687d771SAlexander Ziaeesmbfs_load="YES"
461687d771SAlexander Ziaee.Ed
471687d771SAlexander Ziaee.Sh DESCRIPTION
481687d771SAlexander ZiaeeThe SMB driver is an implementation of the CIFS (Common Internet Filesystem)
491687d771SAlexander Ziaeenetwork protocol.
501687d771SAlexander Ziaee.Pp
511687d771SAlexander Ziaee.Bf -symbolic
521687d771SAlexander ZiaeeThe
531687d771SAlexander Ziaee.Nm
541687d771SAlexander Ziaeefilesystem driver supports only the obsolete SMBv1 protocol.
551687d771SAlexander Ziaee.Nm
561687d771SAlexander Ziaeehas known bugs and likely has security vulnerabilities.
571687d771SAlexander Ziaee.Nm
581687d771SAlexander Ziaeeand userspace counterparts
591687d771SAlexander Ziaee.Xr smbutil 1
601687d771SAlexander Ziaeeand
611687d771SAlexander Ziaee.Xr mount_smbfs 8
621687d771SAlexander Ziaeemay be removed from a future version of
631687d771SAlexander Ziaee.Fx .
641687d771SAlexander ZiaeeUsers are advised to evaluate the
65*066ef2aeSAlexander Ziaee.Pa filesystems/smbnetfs
661687d771SAlexander Ziaeeport instead.
671687d771SAlexander Ziaee.Ef
681687d771SAlexander Ziaee.Sh SEE ALSO
691687d771SAlexander Ziaee.Xr smbutil 1 ,
701687d771SAlexander Ziaee.Xr mount_smbfs 8
711687d771SAlexander Ziaee.Sh STANDARDS
721687d771SAlexander Ziaee.Rs
731687d771SAlexander Ziaee.%U https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-cifs/
741687d771SAlexander Ziaee.%T Common Internet File System (CIFS) Protocol
751687d771SAlexander Ziaee.%R MS-CIFS
761687d771SAlexander Ziaee.%D December 2018
771687d771SAlexander Ziaee.Re
781687d771SAlexander Ziaee.Pp
791687d771SAlexander Ziaee.Rs
801687d771SAlexander Ziaee.%U https://tools.ietf.org/html/draft-heizer-cifs-v1-spec-00
811687d771SAlexander Ziaee.%T Common Internet File System Protocol (CIFS/1.0)
821687d771SAlexander Ziaee.%D June 13, 1996
831687d771SAlexander Ziaee.%A I. Heizer
841687d771SAlexander Ziaee.%A P. Leach
851687d771SAlexander Ziaee.%A D. Perry
861687d771SAlexander Ziaee.Re
871687d771SAlexander Ziaee.Sh HISTORY
881687d771SAlexander ZiaeeThe
891687d771SAlexander Ziaee.Nm
901687d771SAlexander Ziaeedevice driver first appeared in
911687d771SAlexander Ziaee.Fx 4.4 .
921687d771SAlexander Ziaee.Sh AUTHORS
931687d771SAlexander Ziaee.An -nosplit
941687d771SAlexander ZiaeeThe
951687d771SAlexander Ziaee.Nm
961687d771SAlexander Ziaeedevice driver was written by
971687d771SAlexander Ziaee.An Boris Popov Aq Mt bp@FreeBSD.org .
981687d771SAlexander ZiaeeThe manual page was contributed by
991687d771SAlexander Ziaee.An Gordon Bergling Aq Mt gbe@FreeBSD.org .
100