Differences

This shows you the differences between two versions of the page.

--- nas-samba [2023/04/26 17:44] – [Samba File Sharing] -Condense, formatting hogwild
+++ nas-samba [2024/11/27 17:15] (current) – [Samba File Sharing] -Formatting hogwild
@@ Line 1: / Line 1: @@
 ====== File sharing ======
-The File sharing menu allows you to enable and configure Samba filesharing. Samba is a Linux clone/replica of Microsoft's SMB (Server Message Block) filesharing protocol. Samba allows FreshTomato to "speak" the same language as Windows so files can be exchanged between Windows and Linux-based systems (such as FreshTomato). This allows you to use your FreshTomato router as a NAS drive, if you connect USB storage, such as an external hard drive or flash drive.
+In the File sharing menu you can enable and configure Samba filesharing. Samba is a Linux clone of Microsoft's SMB (Server Message Block) filesharing protocol. Samba allows FreshTomato to "speak" the same language as Windows for file sharing between Windows and Linux-based systems (such as FreshTomato). This allows you to use your FreshTomato router as a NAS drive, if you connect USB like a an external hard drive or flash drive.
+Microsoft's SMB protocol was recently upgraded to v3. FreshTomato's implementation supports only v1/v2. However, these are fine for basic operations.
-Microsoft's SMB protocol has recently been upgraded to v3. FreshTomato's implementation supports v1 and v2 only. However, these versions are more than adequate for basic filesharing operations.
 ===== Samba File Sharing =====
@@ Line 17: / Line 18: @@
   * Yes Authentication Required
-For a basic setup, select //Yes no authentication. //If additional security is needed, it's recommended you select the //Yes, Authentication required// . Doing so will display two additional fields where a single username and password can be entered.
+ \\
- \\ \\  {{:pasted:20220110-125127.png}}\\  \\
+For a basic setup, select //Yes no authentication. //If you need additional security, it's recommended you select //Yes, Authentication required//. Doing so will display additional fields to set a single username and password.
+ \\ {{:pasted:20220110-125127.png}}\\  \\
 **Samba protocol version**:
@@ Line 27: / Line 30: @@
   * SMBv1 + SMBv2
-This allows you to select the maximum SMB version that will be supported. It is good practice to enable both SMB1 and SMB2. Imposing a specific version could lead to situations in which client devices aren't running a compatible version and therefore aren't supported. This may generate unwanted log errors, such as the one seen below:
+ \\
- \\\\ {{:pasted:20220111-092133.png}}\\  \\
+This lets you select the highest SMB version supported. It's good practice to enable both SMB1 and SMB2. Imposing a specific version can cause client devices running an incompatible version to be unsupported. This may generate log errors, such as the one seen below:
-**Disable GRO**: GRO (Generic Receive Offload) essentially combines together small packets to then be sent as a single large packet. This optimizes network utilization, but involves extra (sometimes unwanted) reassembly functions. The default, (Enabled) disables this feature. This is the recommended setting unless you have other, specific requirements.
+ \\ \\ {{:pasted:20220111-092133.png}}\\  \\
-**Workgroup Name**: Here, specify the WORKGROUP name (logical grouping) of PCs for devices to be displayed/organized (for Windows peer-to-peer network browsing). Note that the Windows 10 April 2018 (ver. 1803) update eliminated the use of Windows 10 Homegroups. However, workgroups, still exist in Windows 10 and Windows 11.
+**Disable GRO:** Generic Receive Offload combines small packets to be sent as a one large one.
-**Client Codepage**: DOS and Windows clients use Code pages to determine rules for mapping lowercase letters to uppercase letters. Undefined by default can be set in scenarios where case sensitivity is an issue. To check what Codepage your systems are on (in Windows) run ''cmd.exe'' and type ''chcp'' to see the current code page.
+This optimizes network utilization, but involves extra reassembly. The default, (Enabled) disables GRO. Enabled is advised unless you have other requirements.
-**Network Interfaces**: Defines to which local interface the samba service should be bound. (Default: br0).\\
+ \\
+**Workgroup Name:** here, enter the Windows WORKGROUP name for PCs to be displayed/organized (for peer-to-peer network browsing).
+Note that the Windows 10 April 2018 (v.1803) update eliminated Windows Homegroups. However, workgroups still exist in Windows 10/11.
+ \\
+**Client Codepage:** sets the Windows code page.
+Windows clients use code pages to determine rules for mapping lowercase letters to uppercase ones. Undefined, by default, can be set in cases where case sensitivity is an issue. To check your Windows Codepage, run ''cmd.exe'' and type ''chcp'' to see the current code page.
+ \\
+**Network Interfaces:** here, define to which local interface samba will be bound. (Default: br0).\\  \\
 {{:pasted:20220110-130832.png}}
@@ Line 43: / Line 60: @@
  \\
-**Samba Custom Configuration**: Here, you can pass user-defined parameters to the samba process (configured in the smb.conf file). Please consult the official samba documentation prior to entering options in this field: [[https://www.samba.org|https://www.samba.org]]/
+**Samba Custom Configuration:** here, specify user-defined settings for samba (written to "smb.conf").
-**Auto-share all USB Partitions**:
+Consult samba documentation before using this field: [[https://www.samba.org|https://www.samba.org]]/
-  * Disabled
+ \\
-  * Read Only
-  * Read-Write
-  * Hidden Read-Write.
-This allows you to configure automatic sharing. As soon as a storage medium is connected to the USB port (with a compatible filesystem) its contents will be shared.
+**Auto-share all USB Partitions: **lets you configure automatic sharing.
-  * Read only: Users can only open files and browse the storage content.
+As soon compatible USB filesystem storage is connected, its contents are shared.
-  * Read-Write: Users have full control on visible content.
-  * Hidden Read-Write: This is similar to Read-Write, but allows access to hidden content (for example, files starting with a dot (.) .
- **Options**: Instruct your Samba server on additional network roles:\\  Master Browser: If enable it participate in the Master Browser election (when WINS is not available/defined).\\  WINS Server: Perform the role of Wins Server on the network. When enable clients will receive this info via DHCP but client with static addressing can point their WINS Server settings to FreshTomato's LAN IP.\\
+  * Disabled - automatic sharing will be disabled.
+  * Read Only - users can only open files and browse \\ the storage content.
+  * Read-Write - users have full control of visible content.
+  * Hidden Read-Write - Read-Write privileges plus access to \\ hidden content (such as files starting with a period).
+ \\
+**Options:** configures Samba server to perform additional network roles:
+  * Master Browser - if enabled, participate in the Master Browser \\ election (when WINS is not available/defined).
+  * WINS Server - if enabled, act as WINS server. DHCP clients will \\ receive the data via DHCP. Static clients can be set with FreshTomato's \\ LAN address as their WINS server setting.\\
 ===== Additional Share List =====
-In this table, you can define custom network shares that map to physical filesystems. These may overlap, or possibly conflict with the //Auto-share all Partition //function described above.
+In this table, you can define custom network shares that map to physical filesystems. These may overlap, or even conflict with the //Auto-share all Partition //function described above.
-**Share name**: This is the share name which appears under the [[\\WORKGROUP\$routerhostname]].
+ \\
-**Directory**: This defines where the share maps in the real filesystem.
+**Share name:**  The share name that appears under the %%[[\\WORKGROUP\$routerhostname]]%%.
-**Description**: This is for description only, and appears when browsing the network. It has no functional role other than naming the share.
+ \\
-**Access Level**: This is the network level access rights
+**Directory:**  This defines where the share maps in the real filesystem.
+ \\
+**Description:** A descriptor only, that appears when browsing the network. It has no function except as a name.\\  \\
+**Access Level:**  Specifies the network-level access rights
   * Read Only
   * Read-Write
-Do not confuse this setting with the filesystem rights. Total security is determined by executing a logical AND operator on the Access Level rights and the filesystem rights.
+ \\
-**Hidden**: A hidden share will not be visible when browsing the network, but will still be available/usable if called directly (such as by the "net use" command in Windows.
+Don't confuse this with filesystem rights. Total security is calculated by executing a logical AND operation on the Access Level rights and filesystem rights.
+ \\
+**Hidden:**  A hidden share isn't visible when network browsing, but is available if called directly (say, by Windows'  "net use" command).
+\\
+ \\

FreshTomato Wiki

User Tools

Site Tools

Differences

Page Tools