~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/Documentation/filesystems/smb/cifsroot.rst

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

Differences between /Documentation/filesystems/smb/cifsroot.rst (Version linux-6.12-rc7) and /Documentation/filesystems/smb/cifsroot.rst (Version linux-5.14.21)


  1 .. SPDX-License-Identifier: GPL-2.0               
  2                                                   
  3 ===========================================       
  4 Mounting root file system via SMB (cifs.ko)       
  5 ===========================================       
  6                                                   
  7 Written 2019 by Paulo Alcantara <palcantara@sus    
  8                                                   
  9 Written 2019 by Aurelien Aptel <aaptel@suse.com    
 10                                                   
 11 The CONFIG_CIFS_ROOT option enables experiment    
 12 support over the SMB protocol via cifs.ko.        
 13                                                   
 14 It introduces a new kernel command-line option    
 15 which will tell the kernel to mount the root f    
 16 network by utilizing SMB or CIFS protocol.        
 17                                                   
 18 In order to mount, the network stack will also    
 19 using 'ip=' config option. For more details, s    
 20 Documentation/admin-guide/nfs/nfsroot.rst.        
 21                                                   
 22 A CIFS root mount currently requires the use o    
 23 which is only supported by the Samba server. S    
 24 deprecated version of the protocol but it has     
 25 POSIX features (See [1]). The equivalent exten    
 26 recommended version of the protocol (SMB3) hav    
 27 implemented yet which means SMB3 doesn't suppo    
 28 file system objects (e.g. block devices, pipes    
 29                                                   
 30 As a result, a CIFS root will default to SMB1     
 31 to use can nonetheless be changed via the 'ver    
 32 default will change once the SMB3 POSIX extens    
 33 implemented.                                      
 34                                                   
 35 Server configuration                              
 36 ====================                              
 37                                                   
 38 To enable SMB1+UNIX extensions you will need t    
 39 settings in Samba smb.conf::                      
 40                                                   
 41     [global]                                      
 42     server min protocol = NT1                     
 43     unix extension = yes        # default         
 44                                                   
 45 Kernel command line                               
 46 ===================                               
 47                                                   
 48 ::                                                
 49                                                   
 50     root=/dev/cifs                                
 51                                                   
 52 This is just a virtual device that basically t    
 53 the root file system via SMB protocol.            
 54                                                   
 55 ::                                                
 56                                                   
 57     cifsroot=//<server-ip>/<share>[,options]      
 58                                                   
 59 Enables the kernel to mount the root file syst    
 60 located in the <server-ip> and <share> specifi    
 61                                                   
 62 The default mount options are set in fs/smb/cl    
 63                                                   
 64 server-ip                                         
 65         IPv4 address of the server.               
 66                                                   
 67 share                                             
 68         Path to SMB share (rootfs).               
 69                                                   
 70 options                                           
 71         Optional mount options. For more infor    
 72                                                   
 73 Examples                                          
 74 ========                                          
 75                                                   
 76 Export root file system as a Samba share in sm    
 77                                                   
 78     ...                                           
 79     [linux]                                       
 80             path = /path/to/rootfs                
 81             read only = no                        
 82             guest ok = yes                        
 83             force user = root                     
 84             force group = root                    
 85             browseable = yes                      
 86             writeable = yes                       
 87             admin users = root                    
 88             public = yes                          
 89             create mask = 0777                    
 90             directory mask = 0777                 
 91     ...                                           
 92                                                   
 93 Restart smb service::                             
 94                                                   
 95     # systemctl restart smb                       
 96                                                   
 97 Test it under QEMU on a kernel built with CONF    
 98 CONFIG_IP_PNP options enabled::                   
 99                                                   
100     # qemu-system-x86_64 -enable-kvm -cpu host    
101     -kernel /path/to/linux/arch/x86/boot/bzIma    
102     -append "root=/dev/cifs rw ip=dhcp cifsroo    
103                                                   
104                                                   
105 1: https://wiki.samba.org/index.php/UNIX_Exten    
                                                      

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php