Troubleshooting/Debugging Issues on Linux SMB Client
Stevens Creek
Wed Sep 18 | 2:30pm
Abstract
This presentation offers practical strategies for troubleshooting Linux SMB client issues, leveraging logs, trace points, CIFS proc file system debug files, and cifs-utils. Attendees will learn how to enable extended logs, capture and analyze trace points effectively.
We'll cover locating errors, decoding and analyzing SMB3 Wireshark traces, and using other SMB diagnostics tools to capture diagnostics from the system. Additionally, common SMB errors such as mount failures, open handles, and connectivity issues will be addressed, incorporating insights from traces, logs, CIFS proc file system debug files, and cifs-utils into the troubleshooting process.
Lastly, we will talk about an upcoming eBPF based diagnostics tools project we are working on to capture diagnostics and debug issues in SMB client. Attendees will leave equipped with actionable skills to resolve Linux SMB client issues confidently.
Learning Objectives
Upon completion, participants will be able to capture extended SMB client debug logs, trace points and interpret diagnostic data, including SMB Wireshark traces and CIFS proc file system debug files, to diagnose and address Linux SMB client problems.
Upon completion, participants will be able to identify and resolve common SMB errors such as mount failures, open handles, and connectivity issues using insights from logs, traces, and diagnostic tools.
Upon completion, participants will get an understanding of available diagnostics tools and methods for debugging Linux SMB client.
Related Sessions
File Systems & Protocols
USMB2: An SMB2/3 Client for Extremely Constrained Targets
USMB2 is a userspace SMB2/3 client for extremely constrained platforms, such as Z80 class machines.
It supports NTLMv2 authentication, mapping shares, opening/reading/writing files with full unicode for share and file names.
This presentation will go through how to design and implement a SMB2/3 client for extremely CPU and RAM constrained systems. What featureset is feasible for 8-bit machines, how and what tweaks are required to make it all work.
File Systems & Protocols
The in-kernel Linux NFS server in 2026
This presentation recaps the features and capabilities added to the upstream Linux in-kernel NFS server from kernels 6.14 through 7.2, covering areas such as dynamic thread pool scaling and the use of server-side O_DIRECT. It will also highlight upcoming additions and the directions driving active development — giving attendees a practical understanding of where the server stands today and where it is headed.
File Systems & Protocols
New Transports in Samba: QUIC and SMBDirect, with High-Speed I/O via io_uring
The Linux kernel is about to get native quic and smbdirect support. This talk covers the current status of merging these features into upstream Linux and Samba projects. By the time of the conference most things should be ready to use, so this will also outline what still could be optimized, regarding cpu usage, avoiding memory copy and latency.
File Systems & Protocols
SMB3 POSIX Extensions, from Plumbing to Flowing
SMB3 POSIX Extensions bring first-class POSIX semantics to SMB, and are now fully implemented and documented across Samba, ksmbd, and the Linux kernel client in their latest stable releases.
This session walks administrators through enabling and using these capabilities in real-world deployments. We conclude by presenting the new home of the protocol specification and outlining how to stay involved as it evolves.
File Systems & Protocols
Samba in 2026
Samba development has not stopped since SDC 2025:
* SMB over RDMA shows spectacular transfer rates
* The connection ceph and ceph/rgw has improved
* Security of Active Directory protocols has been tightened
* Samba has done development to follow Microsoft on its way to get rid of NTLM
* Entra ID authentication over SMB is an area of active development
* Samba will work better with fuse-based file systems
This talk will present the highlights of latest Samba developments in the above and possibly other areas
File Systems & Protocols
Fibre Channel Update - Security, Speed, and AI!
The Fibre Channel Channel community began the year with the introduction of 128GFC products, but that's not all! With the release the third generation Security Protocols, Fibre Channel enters a new era of secure fabric solutions. Add to that the completion of the FC-RDMA specification and Fibre Channel lays the groundwork for integration with AI solutions for Fibre Channel SANs. The Fibre Channel team is also pushing ahead on the Gen 9 Fibre Channel specification to deliver 256GFC in the near future.
Now is the time to step back a bit and view the Fibre Channel roadmap. In this session, we discuss the success of the next generation security specifications (FC-SP-3), the technical challenges associated with the creation of 256GFC products, and the impact AI will have on Fibre Channel solutions. Come explore the excitement around FC-SP-3 "Autonomous In-flight encryption" (AIE) that provide a plug-n-play solution for end-to-end security! Take a look at the expansion of Fabric Notifications to produce automated responses to disruptions in the network. Let's see where Fibre Channel is taking you!
We look forward to sharing with you the innovations in Fibre Channel!
