[network/smb4k] doc: Update handbook (sort of).
Git commit dd54dc7603c69a579b4751a63490e7cf9a9c9c16 by Alexander Reinholdt. Committed on 14/04/2024 at 08:21. Pushed by areinholdt into branch 'master'. Update handbook (sort of). M +21 -0doc/index.docbook https://invent.kde.org/network/smb4k/-/commit/dd54dc7603c69a579b4751a63490e7cf9a9c9c16 diff --git a/doc/index.docbook b/doc/index.docbook index 69f17331..b730485b 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -4216,6 +4216,27 @@ export QT_QPA_PLATFORMTHEME=qt6ct + + + +Bookmarks + +... + + + Screenshot of the "Bookmarks" configuration page + + +The "Bookmarks" configuration page + + + +... + + +
[network/smb4k] doc: Update handbook.
Git commit 03d2155390a3195a0496625d5bc95f6d80c2b520 by Alexander Reinholdt.
Committed on 04/04/2024 at 18:16.
Pushed by areinholdt into branch 'master'.
Update handbook.
M +7-13 doc/index.docbook
https://invent.kde.org/network/smb4k/-/commit/03d2155390a3195a0496625d5bc95f6d80c2b520
diff --git a/doc/index.docbook b/doc/index.docbook
index 6fafc1f5..2273a26d 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -1492,15 +1492,18 @@ polkit.addRule(function(action, subject) {
Mounting Problems Under BSD
- If mounting of password-protected shares from either a or
a server fails, this might be because mount_smbfs8
only uses NTLMv1 authentication, and the server does not support it. To fix
mounting for a server, you can add the following entry to the [global]
section of the smb.conf file of the
server:
+ If mounting of shares from either a or a server
fails, this might be because mount_smbfs8
only uses NTLMv1 authentication and requires the SMB 1.0/ protocol, and
the server does not support those. To fix mounting for a server, you
can add the following entries to the [global] section of the smb.conf5
file of the server:
[global]
...
ntlm auth = yes
+server min protocol = NT1
...
- To fix this issue for a server, please contact the
sysadmin and tell her or him that NTLMv1 authentication should be swtiched on
(if possible).
+ If you want to fix this issue for a server, please
contact the sysadmin and tell her or him that NTLMv1 authentication and the SMB
1.0/ protocol should be swtiched on (if possible).
+
+ It is not advisable to enable the SMB 1.0/ protocol on
a server, because it is considered insecure (see https://techcommunity.microsoft.com/t5/storage-at-microsoft/stop-using-smb1/ba-p/425858;>here)
and was thus disabled in newer and versions (see https://learn.microsoft.com/en-us/archive/blogs/josebda/the-deprecation-of-smb1-you-should-be-planning-to-get-rid-of-this-old-smb-dialect;>here
and https://www.samba.org/samba/history/samba-4.11.0.html;>here).
[network/smb4k] doc: Update handbook.
Git commit 4b2e5161822b8b1cdf4647f4924c895fb7e9c96c by Alexander Reinholdt. Committed on 04/04/2024 at 05:27. Pushed by areinholdt into branch 'master'. Update handbook. M +30 -4doc/index.docbook https://invent.kde.org/network/smb4k/-/commit/4b2e5161822b8b1cdf4647f4924c895fb7e9c96c diff --git a/doc/index.docbook b/doc/index.docbook index 8ef8f9a2..6fafc1f5 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -14,9 +14,9 @@ ]> +The Handbook - The Handbook Alexander @@ -30,16 +30,20 @@ + 2005-2024 Alexander Reinholdt + 2024-04-03 4.0.0 + is an advanced network neighborhood browser and share mounting utility. + KDE Smb4K @@ -121,7 +125,7 @@ -The tool bar contains some of the main actions, like Configure and Quit. It also dynamically loads the actions of the dock widget that currently has the focus. For additional information, please take a look at the sections discussing the network neighborhood browser and mounted shares view. +The tool bar contains some of the main actions, like Configure and Quit. It also dynamically loads the actions of the dock widget that currently has the focus. For additional information, please take a look at the sections discussing the network neighborhood browser and mounted shares view, respectively. The status bar provides some information about the current status of . If the application is processing a user request ( mounting a share), a descriptive message is displayed in the leftmost section and a progress bar is shown with a busy indicator. The two icons on the right side indicate whether shares are mounted (network folder icon) and the status of the authentication system (wallet or key icon). If the dock widgets are arranged as tabs, the user gets additional visual feedback. Each time a share is mounted or unmounted, the Mounted Shares tab is highlighted for a few seconds. The main window is highly configurable. You can hide or show all tabbed widgets via SettingsDock Widgets. They can also be dragged around with the mouse and docked to different areas in the main window. You can even detach them from the main window. The status bar and the tool bars can be hidden or shown by toggling the menu entry SettingsShow Statusbar and the ones under SettingsToolbars Shown, respectively. @@ -1506,8 +1510,30 @@ ntlm auth = yes Other Desktop Environments Than - When using a different desktop environment than , and applications might be missing some icons. In that case, you might want to install the application qt5ct (the source code can be obtained https://sourceforge.net/projects/qt5ct/;>here). To use qt5ct with your desktop environment, add the following line to your ~/.xinitrc or ~/.profile file: -export QT_QPA_PLATFORMTHEME=qt5ct + When using a different desktop environment than , and applications might be missing some icons. In that case, you might want to install one of these applications: + + + qt5ct (https://sourceforge.net/projects/qt5ct/;>download) for 5 and 5: To use qt5ct with your desktop environment, add the following to your ~/.xinitrc or ~/.profile file. + X11: + +export QT_QPA_PLATFORMTHEME=qt5ct + + Wayland: + +export QT_QPA_PLATFORM=wayland +export QT_QPA_PLATFORMTHEME=qt5ct + + +qt6ct (https://github.com/trialuser02/qt6ct;>download) for 6 and 6: To use qt6ct with your desktop environment, add the following to your ~/.xinitrc or ~/.profile file. +X11: + +export QT_QPA_PLATFORMTHEME=qt6ct +Wayland: + +export QT_QPA_PLATFORM=wayland +export QT_QPA_PLATFORMTHEME=qt6ct + +
[network/smb4k] doc: Update handbook.
Git commit a0e0b9ea7ef8133eb01932e3d52662630829118f by Alexander Reinholdt. Committed on 19/02/2023 at 06:09. Pushed by areinholdt into branch 'master'. Update handbook. M +1-1doc/index.docbook https://invent.kde.org/network/smb4k/commit/a0e0b9ea7ef8133eb01932e3d52662630829118f diff --git a/doc/index.docbook b/doc/index.docbook index 2cade662..a094e5f8 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -35,7 +35,7 @@ Alexander Reinholdt - 2022-02-15 + 2023-02-19 3.2.0 is an advanced network neighborhood browser and share mounting utility.
[network/smb4k] doc: Update handbook.
Git commit fc8cff13bdd5226c3104b2d5326e22f18085863b by Alexander Reinholdt. Committed on 16/02/2023 at 05:54. Pushed by areinholdt into branch 'master'. Update handbook. M +27 -15 doc/index.docbook https://invent.kde.org/network/smb4k/commit/fc8cff13bdd5226c3104b2d5326e22f18085863b diff --git a/doc/index.docbook b/doc/index.docbook index 14362ea5..2cade662 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -1296,7 +1296,7 @@ Editing Custom Settings - You can edit or reset the settings of individual network items by opening the Custom Settings editor. A complete overview of all custom settings provides the Custom Settings configuration page, where you also can edit or remove the desired settings. + You can edit or reset the settings of individual network items by opening the custom settings editor. A complete overview of all custom settings provides the Custom Settings configuration page, where you also can edit or remove the desired settings. @@ -1317,7 +1317,7 @@ Enabling and Managing Profiles The use of different profiles can be enabled in the configuration dialog. The first profile in the list, most likely the Home profile, is picked to be the active profile. You can also enable the profile migration assistant. - Two profiles are pre-defined, Home and Work, but you can define as many profiles as you want. A new profile is added by entering its name into the edit line on the Profiles configuration page and clicking Add afterwards. + Two profiles are pre-defined, Home and Work, but you can define as many profiles as you want. A new profile is added by entering its name into the input line on the Profiles configuration page and clicking Add afterwards. Screenshot of the Profiles configuration page (add profile) @@ -4399,41 +4399,41 @@ ntlm auth = yes Add a bookmark to the currently selected remote share. This action is disabled if no share is selected. Read the Adding Bookmarks section for more details. - + - O + C Network -Open Mount Dialog +Add Custom Settings - Open the dialog for mounting shares "manually". This feature may be needed if cannot find a server from which you want to mount a certain shared resource. + Open the Custom Settings editor. You can set several custom settings for the selected server or share. If a workgroup or no item is selected, this menu entry is disabled. Read the Adding Custom Settings section for more details. - T + O Network -Authentication +Open Mount Dialog - Open the authentication dialog. You can provide the login and password for the selected server or share. If a workgroup or no item is selected, this action is disabled. + Open the dialog for mounting shares "manually". This feature may be needed if cannot find a server from which you want to mount a certain shared resource. - C + T Network -Add Custom Settings +Authentication - Open the Custom Settings editor. You can set several custom settings for the selected server or share. If a workgroup or no item is selected, this menu entry is disabled. + Open the authentication dialog. You can provide the login and password for the selected server or share. If a workgroup or no item is selected, this action is disabled. @@ -4568,7 +4568,19 @@ ntlm auth = yes Add a bookmark to the currently selected mounted share. This action is disabled if no share is selected. Read the Adding Bookmarks section for more details. - + + + + + C +Network +Add Custom Settings + + + + Open the Custom Settings editor. You can set several custom settings for the selected share. Read the Adding Custom Settings section for more details. + + @@ -4643,7 +4655,7 @@ ntlm auth = yes Bookmarks -Mount All Bookmarks +Mount Bookmarks @@ -4759,7 +4771,7 @@ ntlm auth = yes Provide the version of and . Mention your operating system (, FreeBSD, ) and the distribution that is running on your computer. Include the full error message if an error dialog was displayed. -If you experienced a crash, attach a full backtrace. For this it is recommended that you (re-)compile with debugging
[network/smb4k] doc: Update handbook.
Git commit 2c176093e613b3f91c1ca3cc6377c3edc592bd40 by Alexander Reinholdt. Committed on 15/02/2023 at 05:39. Pushed by areinholdt into branch 'master'. Update handbook. M +9-14 doc/index.docbook https://invent.kde.org/network/smb4k/commit/2c176093e613b3f91c1ca3cc6377c3edc592bd40 diff --git a/doc/index.docbook b/doc/index.docbook index 5d3094e5..14362ea5 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -35,7 +35,7 @@ Alexander Reinholdt - 2022-01-05 + 2022-02-15 3.2.0 is an advanced network neighborhood browser and share mounting utility. @@ -1307,8 +1307,8 @@ Profiles - offers the option to use different profiles. They are intended to facilitate better handling of different network neighborhoods, , if you are using your laptop at home and also at work. -By default, the use of different profiles is disabled and a default profile is used: one profile for everything. Most users won't have to change this, because the default behavior satisfies their needs completely. However, for some users this feature might be very useful. + offers the option to use different profiles. They are intended to facilitate handling of different network neighborhoods, , if you are using your laptop at home and also at work. +By default, the use of profiles is disabled. Most users won't have to change this, because the default behavior satisfies their needs completely. However, for some users this feature might be useful.
[network/smb4k] doc: Update handbook.
Git commit edb33c2e56e9bd745ac37e9f61f9783bfafbb93d by Alexander Reinholdt. Committed on 12/02/2023 at 16:18. Pushed by areinholdt into branch 'master'. Update handbook. M +---doc/bookmarks_add_bookmark_dialog.png M +---doc/bookmarks_editor.png M +---doc/bookmarks_popup_menu.png R +---doc/configuration_page_custom_settings.png [from: doc/configuration_page_custom_options.png - 100% similarity] M +---doc/custom_settings_editor.png M +56 -51 doc/index.docbook D +---doc/network_neighborhood_browser_dns-sd_error.png https://invent.kde.org/network/smb4k/commit/edb33c2e56e9bd745ac37e9f61f9783bfafbb93d diff --git a/doc/bookmarks_add_bookmark_dialog.png b/doc/bookmarks_add_bookmark_dialog.png index 867feab1..d935cee7 100644 Binary files a/doc/bookmarks_add_bookmark_dialog.png and b/doc/bookmarks_add_bookmark_dialog.png differ diff --git a/doc/bookmarks_editor.png b/doc/bookmarks_editor.png index df8c7c21..b42a330d 100644 Binary files a/doc/bookmarks_editor.png and b/doc/bookmarks_editor.png differ diff --git a/doc/bookmarks_popup_menu.png b/doc/bookmarks_popup_menu.png index f05c9838..73ab5b76 100644 Binary files a/doc/bookmarks_popup_menu.png and b/doc/bookmarks_popup_menu.png differ diff --git a/doc/configuration_page_custom_options.png b/doc/configuration_page_custom_settings.png similarity index 100% rename from doc/configuration_page_custom_options.png rename to doc/configuration_page_custom_settings.png diff --git a/doc/custom_settings_editor.png b/doc/custom_settings_editor.png index bc9c42cd..c9605f59 100644 Binary files a/doc/custom_settings_editor.png and b/doc/custom_settings_editor.png differ diff --git a/doc/index.docbook b/doc/index.docbook index 2ef4b3a0..1453ddef 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -158,15 +158,7 @@ uses a traditional scan mode, where initially only workgroups and domains are looked up and scans are only made when necessary , when you execute a network item. Due to the use of DNS-SD, you will most likely find a domain called LOCAL in the network neighborhood browser. This is the default local DNS domain used by services like https://en.wikipedia.org/wiki/Avahi_(software)">Avahi and not an actual domain. Opening a domain or workgroup item shows the servers belonging to it. If you want to access the shares of one of the servers, you must open the desired server. There is also the possibility to wake up sleeping servers prior to scanning the network neighborhood (Wake-On-LAN). If this feature is enabled, sends a magic packet to each server that is to be awakened, then waits the defined time until it starts to look up the workgroups and domains. The Wake-On-LAN setting can be turned on in the configuration dialog. The servers that should be awakened must be defined in the Custom Settings editor. - If you are using DNS Service Discovery and the Zeroconf daemon (Avahi) is not running, shows an error notification: - - Error message if the Zeroconf daemon is not running - - - The error message if the Zeroconf daemon is not running - - - In this case, please start the Zeroconf daemon and restart . +If you are using DNS Service Discovery and the Zeroconf daemon (Avahi) is not running, shows an error notification. For details see the Trouble Shooting section. @@ -979,9 +971,9 @@ -By clicking an entry you either enter the level below ( clicking a workgroup or domain item will show a list of all hosts belonging to it), mount the selected share, or invoke the print dialog. To go up one level, you need to click the Up button in the tool bar. -For hosts and shares, there are some action buttons to the right of the network's name. For hosts, there is one button with which you can open the Custom Settings editor. For shares, there are additional buttons for previewing the content of the selected share and for adding the share to the bookmarks, respectively. The action buttons are transparent by default and change to opaque when you move the mouse over them. By left clicking, you initiate the chosen action. -Besides the Up button, the tool bar contains three more entries: Rescan, Abort and Mount Dialog. With these you can do a rescan, abort any running action, or open the dialog for "manual" mounts. +By clicking an entry you either enter the level below ( clicking a workgroup or domain item will show a list of all hosts belonging to it), mount the selected share, or invoke the print dialog. To go one level up, you need to click the Up button in the tool bar. +For hosts and shares, there are some action buttons to the right of the network item's name. For hosts, there is one button with which you can open the Custom Settings editor. For shares, there are additional
[network/smb4k] doc: Update handbook.
Git commit c24c547e3faf4db20bf15a8884a33fb4c2dc46a4 by Alexander Reinholdt.
Committed on 07/02/2023 at 17:40.
Pushed by areinholdt into branch 'master'.
Update handbook.
M +52 -20 doc/index.docbook
https://invent.kde.org/network/smb4k/commit/c24c547e3faf4db20bf15a8884a33fb4c2dc46a4
diff --git a/doc/index.docbook b/doc/index.docbook
index 0420ed52..2ef4b3a0 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -101,17 +101,7 @@
You can either launch from the K menu or from https://userbase.kde.org/Plasma/Krunner;> by typing
smb4k. comes with a for better desktop integration. It can be
added as a widget to the desktop or panel.
-If the system is missing some of the programs needs to
operate properly, it notifies the user:
-
-
- Screenshot of the missing program notification
-
-
-The missing program
notification
-
-
-
-In this case, please install the specified program or, if it is
already present, add its location to the PATH environment
variable in your shell's configuration file (for the bash1
shell it is the ~/.bashrc file).
+If encounters a problem on start-up or while running, the
user will be notified. For the solution of some common problems see the Trouble Shooting section.
-
-Special Remarks
+
+Trouble Shooting
+
+
+
+
+ Missing Programs
+
+ If the system is missing some of the programs needs to
operate properly, it notifies the user:
+
+
+Screenshot of the missing program notification
+
+
+ The missing program
notification
+
+
+
+ In this case, please install the specified program or, if it is
already present, add its location to the PATH environment
variable in your shell's configuration file (for the bash1
shell it is the ~/.bashrc file).
+
+
+
+
+
+ Zeroconf Daemon Not Running
+
+ uses the Zeroconf service (https://avahi.org;>Avahi) to look up servers and
shares in the network neighborhood using DNS Service Discovery (DNS-SD). For
this to work, the Avahi daemon must be enabled and running on your system. If
this is not the case, shows an error message:
+
+
+Screenshot of the Zeroconf error notification
+
+
+ The Zeroconf error
notification
+
+
+
+ In most cases, the Avahi daemon is not running when an error is
reported. Under those distributions that use
systemd you can start it by running the following or
a similar command from the terminal:
+ $ sudo
systemctl enable --now
avahi-daemon
+ With all other distributions and under BSD refer to the
specific documentation how to start the Avahi daemon.
+
-
+
Denied Privilege Escalation
In case the mount and unmount actions fail (most likely with an
AuthorizationDeniedError message), your polkit-1 setup
might need to be adjusted: Add a file, named
10-mounthelper.rules, to the $PREFIX/etc/polkit-1/rules.d/ directory with the
following content:
@@ -1450,10 +1482,10 @@ polkit.addRule(function(action, subject) {
-
+
Mounting Problems Under BSD
If mounting of password-protected shares from either a or
a server fails, this might be because mount_smbfs8
only uses NTLMv1 authentication, and the server does not support it. To fix
mounting for a server, you can add the following entry to the [global]
section of the smb.conf file of the
server:
@@ -1468,10 +1500,10 @@ ntlm auth = yes
-
+
Other Desktop Environments Than
When using a different desktop environment than , and
applications might be missing some icons. In that case, you might want to
install the application qt5ct (the source code can
be obtained https://sourceforge.net/projects/qt5ct/;>here).
To use qt5ct with your desktop environment, add the
following line to your ~/.xinitrc or
~/.profile file:
[network/smb4k] doc: Update handbook.
Git commit 3c437e5706bbf71a83e8e62ba5086523813a315f by Alexander Reinholdt. Committed on 08/01/2023 at 09:59. Pushed by areinholdt into branch 'master'. Update handbook. M +44 -27 doc/index.docbook https://invent.kde.org/network/smb4k/commit/3c437e5706bbf71a83e8e62ba5086523813a315f diff --git a/doc/index.docbook b/doc/index.docbook index 30c52553..0420ed52 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -2134,7 +2134,7 @@ ntlm auth = yes Common Mount Settings ( only) - The Common Mount Settings tab is only available under . The settings present under BSD can be found in the Mount Settings (BSD only) section. + The Common Mount Settings tab is only available under and the listed options refer to the mount.cifs8 / mount.smb38 command. The settings present under BSD can be found in the Mount Settings (BSD only) section. Common Options @@ -2152,6 +2152,7 @@ ntlm auth = yes read-write +Option: rw Mount the share read-write. @@ -2160,6 +2161,7 @@ ntlm auth = yes read-only +Option: ro Mount the share read-only. @@ -2172,14 +2174,15 @@ ntlm auth = yes Client character set - Sets the character set used by the client side ( your computer). + Option: iocharset=CHARSET + Sets the character set used by the client side ( your computer) to one of the following: default -Default character set used by the client's kernel. +Default character set used by the client's kernel. In this case the iocharset option is omitted from the command line. @@ -2359,7 +2362,7 @@ ntlm auth = yes - Default: not selected; default + Default: not selected; CHARSET: default @@ -2367,9 +2370,9 @@ ntlm auth = yes File system port - Sets the file system port number that is used by mount.cifs8 when mounting a remote share. The default port number (445) should work for all modern operating systems. If you experience problems, try setting the port number to 139. If the problems only occur with a few hosts, it is recommended to leave this option untouched and to use the Custom Settings editor to define individual port numbers for the problematic hosts. - This option is only available under . Under BSD, the port for mounting shares is set with the SMB port option. - Default: not selected; port 445 + Option: port=PORT + Sets the port number that is used by mount.cifs8 when mounting a remote share. The default port number (445) should work for all modern operating systems. If you experience problems, try setting the port number to 139. If the problems only occur with a few hosts, it is recommended to leave this option untouched and to use the Custom Settings editor to define individual port numbers for the problematic hosts. + Default: not selected; PORT: 445 @@ -2383,6 +2386,7 @@ ntlm auth = yes All or most of the servers support the Unix extensions +Option: none Most versions of support the Unix or POSIX extensions. For these servers, some options are not needed, because the right values are negotiated during the mount process. For other servers, you might want to uncheck this option, so that predefined values can be passed to the server. Please note that if your computer is located in a dominated network neighborhood with only a few servers, you can safely uncheck this option and define custom settings for the servers. In case you uncheck this option, consider to switch on permission checks under Advanced Mount Settings. Default: selected @@ -2393,9 +2397,10 @@ ntlm auth = yes User ID +Option: uid=UID Sets the owner of the files and directories on the file system. By default, your UID is used. To change the UID, press the search button and choose one from the drop down menu. In case the support for the Unix extensions is selected, this setting is disabled. -Default: selected; your UID +Default: selected; UID: your UID @@ -2403,9 +2408,10 @@ ntlm auth = yes Group ID
[network/smb4k] doc: Update handbook.
Git commit 4628226e2e64ac7d3b1f3ff257834398f0d685a6 by Alexander Reinholdt. Committed on 05/01/2023 at 18:50. Pushed by areinholdt into branch 'master'. Update handbook. M +1-1doc/index.docbook https://invent.kde.org/network/smb4k/commit/4628226e2e64ac7d3b1f3ff257834398f0d685a6 diff --git a/doc/index.docbook b/doc/index.docbook index 112e106b..30c52553 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -35,7 +35,7 @@ Alexander Reinholdt - 2022-01-03 + 2022-01-05 3.2.0 is an advanced network neighborhood browser and share mounting utility.
[network/smb4k] doc: Update handbook.
Git commit eb2eae45f29fdde18210e54f8b77f71b4df81461 by Alexander Reinholdt. Committed on 05/01/2023 at 09:43. Pushed by areinholdt into branch 'master'. Update handbook. R +---doc/custom_settings_editor.png [from: doc/network_neighborhood_browser_custom_options_dialog.png - 100% similarity] M +86 -117 doc/index.docbook https://invent.kde.org/network/smb4k/commit/eb2eae45f29fdde18210e54f8b77f71b4df81461 diff --git a/doc/network_neighborhood_browser_custom_options_dialog.png b/doc/custom_settings_editor.png similarity index 100% rename from doc/network_neighborhood_browser_custom_options_dialog.png rename to doc/custom_settings_editor.png diff --git a/doc/index.docbook b/doc/index.docbook index 60f7b437..112e106b 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -262,7 +262,7 @@ -Open the Custom Settings editor where you can set several custom settings for each selected server and share. If a workgroup or no item is selected, this menu entry is disabled. +Open the Custom Settings editor where you can set several custom settings for each selected server and share. If a workgroup or no item is selected, this menu entry is disabled. @@ -440,66 +440,15 @@ If a user name has already been provided, it will be shown in the respective field. If it is wrong, or no user name was provided, you have to enter one. The password, however, may be left blank. Clicking the OK button commits the data. Depending on your choice in the configuration dialog, the user name and password will be stored permanently in a digital wallet or not at all. In the latter case you have to provide them every time they are needed. - + Defining Custom Settings - - Use the Custom Settings editor if you want to - -define custom mount or browse settings for a single server or share that deviate from the values defined in the configuration dialog, -define a server that should be awakened prior to network scans or mount attempts (Wake-On-LAN feature, see here), -always mount a particular share on start-up or when the corresponding profile is loaded. - - The editor is opened by clicking the CAdd Custom Settings menu entry. Depending on your selection, the settings either apply to all shares of a server, or to only one. - - -Screenshot of the custom settings editor for a share - - - - - -The custom settings editor - - - - - The Default button is enabled if the entries in the dialog deviate from the settings you defined in the configuration dialog. By clicking it, you can reset the entries in the dialog to their default values. The OK button is enabled if you changed the settings in the dialog. Clicking it will save the custom settings and close the dialog. - Please note that under BSD the dialog contains fewer entries than if you run , because several of the options are not supported. - - -Common Mount Settings ( only) - -In this tab you can define common settings related to mounting. Checking the Always remount this share button for a selected share leads to it being remounted on every program start. For information about all other settings see this section. - - - -Advanced Mount Settings ( only) - -In this tab you can define advanced settings related to mounting. For information about all other settings see this section. - - -Mount Settings (BSD only) - -In this tab you can define settings related to mounting. For information about all other settings see this section. - - - -Browse Settings - -You can define the minimal and maximal SMB protocol versions as well as the SMB port to be used. In addition, you can decide if Kerberos should be used for authentication. For detailed information on these settings, please see the network configuration page. - - - -Wake-On-LAN Settings - -To make the Wake-On-LAN feature work, you must provide the MAC address of the server you selected. Currently, has no way to determine the MAC address, so you need to find it on your own. Afterwards, you can define if should send a magic Wake-On-LAN packet to the selected host before the network neighborhood is scanned and/or one of its shares is mounted. - + For individual servers or shares you can define custom settings that deviate from the global settings. To do so, you can access the custom settings editor by clicking the CAdd Custom Settings menu item. See the section Custom Settings for more details. Defining Custom Settings - For the selected shares custom settings can be
[network/smb4k] doc: Update handbook.
Git commit 1ec8361a0eeffa5dbfe1a0ed0d13801fe01bb31d by Alexander Reinholdt. Committed on 04/01/2023 at 05:43. Pushed by areinholdt into branch 'master'. Update handbook. M +18 -18 doc/index.docbook https://invent.kde.org/network/smb4k/commit/1ec8361a0eeffa5dbfe1a0ed0d13801fe01bb31d diff --git a/doc/index.docbook b/doc/index.docbook index 70b06643..030facae 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -3771,9 +3771,9 @@ ntlm auth = yes Do not transfer any file smaller than - Option: --min-size=NUM + Option: --min-size=SIZE This tells rsync1 to avoid transferring any file that is smaller than the specified SIZE, which can help in not transferring small, junk files. - Default: not selected; NUM: 0 kB + Default: not selected; SIZE: 0 kB @@ -3781,9 +3781,9 @@ ntlm auth = yes Do not transfer any file larger than - Option: --max-size=NUM + Option: --max-size=SIZE This tells rsync1 to avoid transferring any file that is larger than the specified SIZE. - Default: not selected; NUM: 0 kB + Default: not selected; SIZE: 0 kB @@ -3818,7 +3818,7 @@ ntlm auth = yes Option: --bwlimit=RATE - Set the maximum data transfer rate in kilobytes per second. + Set the maximum data transfer RATE in kilobytes per second. Default: not selected; RATE: 0 kB/s @@ -4007,19 +4007,6 @@ ntlm auth = yes Filter Rules - - - Custom filter rules - - - Option: -f/--filter=RULE - You can define one or more filter rules here. Each rule has to be prefixed with the --filter= or -f option string, because the contents of the text box will be passed to the rsync1 command AS IS. - This option allows you to add rules to selectively exclude certain files from the list of files to be transferred. This is most useful in combination with a recursive transfer. - You may use as many --filter options as you like to build up the list of files to exclude. - See the FILTER RULES section of the manual page for detailed information on this option. - Default: empty - - Use --filter='dir-merge /.rsync-filter' filter rule @@ -4042,6 +4029,19 @@ ntlm auth = yes Default: not selected + + + Custom filter rules + + + Option: -f/--filter=RULE + You can define one or more filter rules here. Each rule has to be prefixed with the --filter= or -f option string, because the contents of the text box will be passed to the rsync1 command AS IS. + This option allows you to add rules to selectively exclude certain files from the list of files to be transferred. This is most useful in combination with a recursive transfer. + You may use as many --filter options as you like to build up the list of files to exclude. + See the FILTER RULES section of the manual page for detailed information on this option. + Default: not selected; RULES: empty + +
[network/smb4k] doc: Update handbook.
Git commit 0db9dbc12121781f49dcbb68f66edd3384700445 by Alexander Reinholdt. Committed on 01/01/2023 at 17:55. Pushed by areinholdt into branch 'master'. Update handbook. M +39 -18 doc/index.docbook https://invent.kde.org/network/smb4k/commit/0db9dbc12121781f49dcbb68f66edd3384700445 diff --git a/doc/index.docbook b/doc/index.docbook index f658f4aa..766b30f9 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -251,40 +251,40 @@ -Add a bookmark to the currently selected remote share. This action is disabled if no share is selected. +Add a bookmark to the selected remote shares. This action is disabled if there are no shares selected. - O - Open Mount Dialog + C + Add Custom Options -Open the dialog for mounting shares "manually". This feature may be needed if cannot find the server from which you want to mount a certain shared resource. +Open the Custom Options dialog where you can set several custom options for each selected server and share. If a workgroup or no item is selected, this menu entry is disabled. - T - Authentication + O + Open Mount Dialog -Open the authentication dialog. You can provide the login and password for the selected server or share. If a workgroup or no item is selected, this action is disabled. +Open the dialog for mounting shares "manually". This feature may be needed if cannot find the server from which you want to mount a certain shared resource. - C - Custom Options + T + Authentication -Open the Custom Options dialog. You can set several custom options for the selected server or share. If a workgroup or no item is selected, this menu entry is disabled. +Open the authentication dialog where you can provice the user name and password for each selected server and share. If a workgroup or no item is selected, this action is disabled. @@ -295,7 +295,7 @@ -Preview the contents of the selected remote share. This action is only enabled if a share is selected. Printer shares cannot be previewed. +Preview the contents of the selected remote shares. This action is only enabled if shares are selected. Printer shares cannot be previewed. @@ -306,7 +306,7 @@ -Print a file on a remote printer. This action is only available if a printer share is selected. +Print a file on a remote printer. This action is only available if at least one printer share is selected. @@ -317,7 +317,7 @@ -Mount the selected remote share. By default, and if you selected anything different than a share with type "Disk" or "IPC", this action is disabled. For a mounted share, this action is replaced with the Unmount action. +Mount the selected remote shares. This action is visible if only shares are selected that are not already mounted. By default, and if you selected anything different than a share with type "Disk" or "IPC", this action is disabled. @@ -328,7 +328,7 @@ -Unmount the selected share. This action is invisible by default and will only be visible instead of the Mount action when the share is currently mounted. +Unmount the selected shares. This action is invisible by default and will only be visible instead of the Mount action if at least one mounted share is selected. @@ -364,14 +364,14 @@ --> - Mounting a Share + Mounting Shares There are three options available to mount a remote share: Execute the icon representing the remote share in the network neighborhood browser. (Depending on your settings, this is done by either single or double clicking the icon.) -Select the remote share and click the Mount menu entry. Alternatively, you can press the M keyboard shortcut. -If was not able to find the server where the share is located, you can press the OOpen Mount Dialog menu entry and a mount dialog will be opened: +Select the remote shares and click the Mount menu entry. Alternatively, you can press the M keyboard shortcut. +Press the OOpen Mount Dialog menu entry and a mount dialog
[network/smb4k] doc: Update handbook.
Git commit 9f9e7c564435212b036d87d55e847ed6714de303 by Alexander Reinholdt. Committed on 30/12/2022 at 08:03. Pushed by areinholdt into branch 'master'. Update handbook. M +8-9doc/index.docbook https://invent.kde.org/network/smb4k/commit/9f9e7c564435212b036d87d55e847ed6714de303 diff --git a/doc/index.docbook b/doc/index.docbook index 714e5f6a..f658f4aa 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -3321,7 +3321,7 @@ ntlm auth = yes Option: -a/--archive, same as -rlptgoD (no -A, -X, -U, -N, -H) Switch the archive mode on. This is a quick way of saying you want recursion and want to preserve almost everything. Note that -a does not preserve hardlinks (-H), access control lists (ACLs, -A), extended attributes (xattrs, -X), access (use) times (-U) nor create times (-N). You must separately specify these options. The only exception to the above equivalence is when --files-from is specified, in which case -r is not implied. - In case you do not want to run rsync in archive mode, choose the appropriate arguments in the settings yourself. + In case you do not want to run rsync1 in archive mode, choose the appropriate arguments in the settings yourself. Default: selected @@ -3400,7 +3400,7 @@ ntlm auth = yes Option: --backup-dir=DIR - In combination with the --backup option, this tells rsync to store all backups in the specified folder. This is very useful for incremental backups. You can additionally specify a backup suffix using the --suffix option (otherwise the files backed up in the specified folder will keep their original filenames). + In combination with the --backup option, this tells rsync1 to store all backups in the specified folder. This is very useful for incremental backups. You can additionally specify a backup suffix using the --suffix option (otherwise the files backed up in the specified folder will keep their original filenames). This option is only available if you ticked the Make backups option above. Default: not selected; DIR: $HOME @@ -3596,7 +3596,7 @@ ntlm auth = yes Option: -A/--acls - Preserve access control lists. This option causes rsync to update the destination ACLs to be the same as the source ACLs. The option also implies --perms. The source and destination systems must have compatible ACL entries for this option to work properly. + Preserve access control lists. This option causes rsync1 to update the destination ACLs to be the same as the source ACLs. The option also implies --perms. The source and destination systems must have compatible ACL entries for this option to work properly. Default: not selected @@ -3606,7 +3606,7 @@ ntlm auth = yes Option: -X/--xattrs - Preserve extended attributes. This option causes rsync to update the destination extended attributes to be the same as the source ones. + Preserve extended attributes. This option causes rsync1 to update the destination extended attributes to be the same as the source ones. Default: not selected @@ -3616,7 +3616,7 @@ ntlm auth = yes Option: -U/--atimes - Preserve access times. This tells rsync to set the access (use) times of the destination files to the same value as the source files. + Preserve access times. This tells rsync1 to set the access (use) times of the destination files to the same value as the source files. Default: not selected @@ -3626,7 +3626,7 @@ ntlm auth = yes Option: -N/--crtimes - Preserve create times. This tells rsync to set the create times (newness) of the destination files to the same value as the source files. + Preserve create times. This tells rsync1 to set the create times (newness) of the destination files to the same value as the source files. Default: not selected @@ -3725,7 +3725,7 @@ ntlm auth = yes Option: --skip-compress=LIST - Overwrite the list of file suffixes that will not be compressed. The LIST should be one or more file suffixes (without the dot) separated by slashes. You may specify an empty string to indicate that no file should be skipped. The default list of suffixes will be replaced by this list. For further details, see the manual page of rsync. + Overwrite the list of file suffixes that will not be compressed. The LIST should be one or more file suffixes (without the dot)
[network/smb4k] doc: Update handbook.
Git commit a093c6776fd9459e8dc42d25309db0e39985b467 by Alexander Reinholdt. Committed on 29/12/2022 at 07:08. Pushed by areinholdt into branch 'master'. Update handbook. M +35 -28 doc/index.docbook https://invent.kde.org/network/smb4k/commit/a093c6776fd9459e8dc42d25309db0e39985b467 diff --git a/doc/index.docbook b/doc/index.docbook index c84e651e..714e5f6a 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -3320,7 +3320,7 @@ ntlm auth = yes Option: -a/--archive, same as -rlptgoD (no -A, -X, -U, -N, -H) - Switch the archive mode on. This is a quick way of saying you want recursion and want to preserve almost everything. Note that -a does not preserve hardlinks (-H), access control lists (ACLs, -A), extended attributes (xattrs, -X), access (use) times (-U) nor crtimes (-N). You must separately specify these options. The only exception to the above equivalence is when --files-from is specified, in which case -r is not implied. + Switch the archive mode on. This is a quick way of saying you want recursion and want to preserve almost everything. Note that -a does not preserve hardlinks (-H), access control lists (ACLs, -A), extended attributes (xattrs, -X), access (use) times (-U) nor create times (-N). You must separately specify these options. The only exception to the above equivalence is when --files-from is specified, in which case -r is not implied. In case you do not want to run rsync in archive mode, choose the appropriate arguments in the settings yourself. Default: selected @@ -3370,8 +3370,7 @@ ntlm auth = yes -Backup - +Backups @@ -3574,10 +3573,12 @@ ntlm auth = yes + - -Permissions, - + + File Attributes Ownership + +File Attributes @@ -3631,51 +3632,57 @@ ntlm auth = yes - Preserve owner + Preserve device and special files - Option: -o/--owner - This option causes rsync1 to set the owner of the destination file to be the same as the one of the source file. By default, the preservation is done by name, but may fall back to using the ID number in some circumstances (see the --numeric-ids option for a full discussion). This option has no effect if the receiving rsync1 is not run as the super user and --super is not specified. + Option: -D/--devices --specials + This option causes rsync1 to transfer character and block device files as well as special files (such as named sockets and fifos) to the remote system. This option has no effect if the receiving side is not run as the super user and --super is not specified. Default: not selected - Preserve group + Preserve times - Option: -g/--group - This option causes rsync1 to set the group of the destination file to be the same as the on of the source file. If the receiving program is not running as the super-user (or with the --no-super option), only groups that the receiver is a member of will be preserved. + Option: -t/--times + This tells rsync1 to transfer modification times along with the files and update them on the remote system. Default: not selected - Preserve device and special files + Omit directories when preserving times - Option: -D/--devices --specials - This option causes rsync1 to transfer character and block device files as well as special files (such as named sockets and fifos) to the remote system. This option has no effect if the receiving side is not run as the super user and --super is not specified. + Option: -O/--omit-dir-times + This tells rsync1 to omit directories when it is preserving modification times (see --times). Default: not selected + + + + +Ownership + - Preserve times + Preserve owner - Option: -t/--times - This tells rsync1 to transfer modification times along with the files and update them on the remote system. + Option: -o/--owner + This option causes rsync1 to set the owner of the destination file to be the same as the one of the source file. By default, the preservation is done by name, but may fall back to using the ID number in some circumstances (see the
[network/smb4k] doc: Update handbook.
Git commit 13ae58f75ecb71351b1f8491ffd19220a81f32f7 by Alexander Reinholdt. Committed on 28/12/2022 at 06:26. Pushed by areinholdt into branch 'master'. Update handbook. M +22 -21 doc/index.docbook https://invent.kde.org/network/smb4k/commit/13ae58f75ecb71351b1f8491ffd19220a81f32f7 diff --git a/doc/index.docbook b/doc/index.docbook index 84fe4f68..17be5416 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -2106,7 +2106,7 @@ ntlm auth = yes - Default: not selected / read-write + Default: not selected; read-write @@ -2301,7 +2301,7 @@ ntlm auth = yes - Default: not selected / default + Default: not selected; default @@ -2311,7 +2311,7 @@ ntlm auth = yes Sets the file system port number that is used by mount.cifs8 when mounting a remote share. The default port number (445) should work for all modern operating systems. If you experience problems, try setting the port number to 139. If the problems only occur with a few hosts, it is recommended to leave this option untouched and to use the Custom Options dialog to define individual port numbers for the problematic hosts. This option is only available under . Under BSD, the port for mounting shares is set with the SMB port option. - Default: not selected / 445 + Default: not selected; port 445 @@ -2337,7 +2337,7 @@ ntlm auth = yes Sets the owner of the files and directories on the file system. By default, your UID is used. To change the UID, press the search button and choose one from the drop down menu. In case the support for the Unix extensions is selected, this setting is disabled. -Default: selected / your UID +Default: selected; your UID @@ -2347,7 +2347,7 @@ ntlm auth = yes Sets the group that owns the files and directories on the file system. By default, your GID is used. To change the GID, press the search button and choose one from the drop down menu. In case the support for the Unix extensions is selected, this setting is disabled. -Default: selected / your GID +Default: selected; your GID @@ -2355,9 +2355,9 @@ ntlm auth = yes File mode -Sets the permissions that are applied to files. The value is given in octal and has to have 4 digits. To learn more about the file mode (file_mode), you should read the mount8 and umask2 manual pages. +Sets the permissions that are applied to files. The value is given in octal and has to have 4 digits. To learn more about the file mode (file_mode), you should read the mount8 and umask2 manual pages. In case the support for the Unix extensions is selected, this setting is disabled. -Default: selected / 0755 +Default: selected; 0755 @@ -2365,9 +2365,9 @@ ntlm auth = yes Directory mode -Sets the permissions that are applied to directories. The value is given in octal and has to have 4 digits. To learn more about the directory mode (dir_mode), you should read the mount8 and umask2 manual pages. +Sets the permissions that are applied to directories. The value is given in octal and has to have 4 digits. To learn more about the directory mode (dir_mode), you should read the mount8 and umask2 manual pages. In case the support for the Unix extensions is selected, this setting is disabled. -Default: selected / 0755 +Default: selected; 0755 @@ -2521,7 +2521,7 @@ ntlm auth = yes -Default: not selected / default (Negotiate the highest version) +Default: not selected; default (Negotiate the highest version) @@ -2557,7 +2557,7 @@ ntlm auth = yes -Default: not selected / Follow the /SMB2 protocol strictly +Default: not selected; Follow the /SMB2 protocol strictly @@ -2641,7 +2641,7 @@ ntlm auth = yes -Default: not selected / NTLMSSP protocol +Default: not selected; NTLMSSP protocol @@ -2692,7 +2692,7 @@ ntlm auth = yes File mode - Sets the permissions that are applied to files. The value is given in octal and has to have 4 digits. To
[network/smb4k] doc: Update handbook.
Git commit 5b1ecb8fc1eb0f33620ee6a10cf1758f1e0dea08 by Alexander Reinholdt. Committed on 27/12/2022 at 16:46. Pushed by areinholdt into branch 'master'. Update handbook. M +8-8doc/index.docbook https://invent.kde.org/network/smb4k/commit/5b1ecb8fc1eb0f33620ee6a10cf1758f1e0dea08 diff --git a/doc/index.docbook b/doc/index.docbook index 53359dfb..84fe4f68 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -2467,8 +2467,8 @@ ntlm auth = yes 2.0 (Windows Vista SP1/Windows Server 2008) - The vers=2.0 command line argument is used. This causes mount.cifs8 to use the SMBv2.002 protocol. This was initially introduced in Windows Vista Service Pack 1, and Windows Server 2008. - Please note that the initial release version of Windows Vista spoke a slightly different dialect (2.000) that is not supported. + The vers=2.0 command line argument is used. This causes mount.cifs8 to use the SMBv2.002 protocol. This was initially introduced in Vista Service Pack 1 and Server 2008. + Please note that the initial release version of Vista spoke a slightly different dialect (2.000) that is not supported. @@ -2492,7 +2492,7 @@ ntlm auth = yes 3.0.2 (Windows 8.1/Windows Server 2012R2) - The vers=3.0.2 or vers=3.11 command line argument is used. This causes mount.cifs8 to use the SMBv3.1.1 protocol that was introduced in Server 2016. + The vers=3.0.2 or vers=3.02 command line argument is used. This causes mount.cifs8 to use the SMBv3.0.2 protocol that was introduced in 8.1 and Server 2012R2. @@ -2501,7 +2501,7 @@ ntlm auth = yes 3.1.1 (Windows Server 2016) - The vers=3.1.1 or vers=3.02 command line argument is used. This causes mount.cifs8 to use the SMBv3.0.2 protocol that was introduced in Microsoft Windows 8.1 and Windows Server 2012R2. + The vers=3.1.1 or vers=3.11 command line argument is used. This causes mount.cifs8 to use the SMBv3.1.1 protocol that was introduced in Server 2016. @@ -3232,7 +3232,7 @@ ntlm auth = yes Save logins in a wallet -The login names and passwords are stored in a subfolder named Smb4K of the current network wallet (default: "kdewallet"). The advantage of this method is, that the authentication data is stored permanently and encrypted on your hard drive. You only have to provide it once and the next time it is needed, will read it from the wallet. If you uncheck this option, the authentication data won't be stored at all. +The user names and passwords are stored in a subfolder named Smb4K of the current network wallet (default: "kdewallet"). The advantage of this method is, that the authentication data is stored permanently and encrypted on your hard drive. You only have to provide it once and the next time it is needed, will read it from the wallet. If you uncheck this option, the authentication data won't be stored at all. Default: selected @@ -3263,9 +3263,9 @@ ntlm auth = yes Wallet Entries - In this editor you can modify or remove existing wallet entries. Before you can edit them, they have to be loaded from the wallet by pressing the Load button. The list of entries appears then in the left list view. An entry can be edited by selecting it and clicking the Details button on the right. As alternative you can just right click the entry and choose the Edit item in the popup menu. The details are then shown and can be modified. - An entry can be removed by choosing the Remove item from the popup menu. All wallet entries may be removed at once by choosing the Clear List item. - After you finished editing, the changes can be committed to the wallet by pressing Save. + In this editor you can modify or remove existing wallet entries. Before you can edit them, they have to be loaded from the wallet by pressing the Load button. The list of entries appears then in the left list view. An entry can be edited by selecting it and clicking the Edit button on the right. As alternative you can just double click the entry. A password dialog is shown and the user name and password can be modified. + An entry can be removed by selecting it and clicking the Remove button. All wallet entries can be removed at once by clicking the Clear button. + After you finished editing, the changes can be committed to the wallet by clicking Save.
[network/smb4k] doc: Update handbook.
Git commit 609024e8ec4d64fcaa0615aa876fe81b58cbfffb by Alexander Reinholdt. Committed on 26/12/2022 at 05:16. Pushed by areinholdt into branch 'master'. Update handbook. M +10 -1doc/index.docbook https://invent.kde.org/network/smb4k/commit/609024e8ec4d64fcaa0615aa876fe81b58cbfffb diff --git a/doc/index.docbook b/doc/index.docbook index 4f186782..53359dfb 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -2487,12 +2487,21 @@ ntlm auth = yes The vers=3.0 command line argument is used. This causes mount.cifs8 to use the SMBv3.0 protocol that was introduced in 8 and Server 2012. + + + 3.0.2 (Windows 8.1/Windows Server 2012R2) + + + The vers=3.0.2 or vers=3.11 command line argument is used. This causes mount.cifs8 to use the SMBv3.1.1 protocol that was introduced in Server 2016. + + + 3.1.1 (Windows Server 2016) - The vers=3.1.1 or vers=3.11 command line argument is used. This causes mount.cifs8 to use the SMBv3.1.1 protocol that was introduced in Server 2016. + The vers=3.1.1 or vers=3.02 command line argument is used. This causes mount.cifs8 to use the SMBv3.0.2 protocol that was introduced in Microsoft Windows 8.1 and Windows Server 2012R2.
[network/smb4k] doc: Update handbook.
Git commit 1e7425408333024761b3f7e7d98ebbc596b9170b by Alexander Reinholdt. Committed on 23/12/2022 at 06:00. Pushed by areinholdt into branch 'master'. Update handbook. M +37 -20 doc/index.docbook https://invent.kde.org/network/smb4k/commit/1e7425408333024761b3f7e7d98ebbc596b9170b diff --git a/doc/index.docbook b/doc/index.docbook index b6fe590b..4f186782 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -1616,7 +1616,7 @@ ntlm auth = yes Icon size for the icon view -Set the icon size in the icon view mode of the shares view. The size can be adjusted in steps of 16 pixels from 16 x 16 pixels to 128 x 128 pixels. +Set the icon size in the icon view of the shares view. The size can be adjusted in steps of 16 pixels from 16 x 16 pixels to 128 x 128 pixels. Default: desktop icon size @@ -1625,7 +1625,7 @@ ntlm auth = yes Icon size for the list view -Set the icon size in the list view mode of the shares view. The size can be adjusted in steps of 16 pixels from 16 x 16 pixels to 128 x 128 pixels. +Set the icon size in the list view of the shares view. The size can be adjusted in steps of 16 pixels from 16 x 16 pixels to 128 x 128 pixels. Default: small icon size @@ -2005,7 +2005,6 @@ ntlm auth = yes Remount all your shares that were mounted when you exited the program or changed a profile. If the remounting of a share fails, Smb4K will retry the next time it is started. Shares that were mounted by other users are ignored. - This setting does not affect the automatic remounting of shares when your computer woke up from a sleep state. Default: not selected @@ -2107,7 +2106,7 @@ ntlm auth = yes - Default: read-write + Default: not selected / read-write @@ -2302,7 +2301,7 @@ ntlm auth = yes - Default: default + Default: not selected / default @@ -2312,7 +2311,7 @@ ntlm auth = yes Sets the file system port number that is used by mount.cifs8 when mounting a remote share. The default port number (445) should work for all modern operating systems. If you experience problems, try setting the port number to 139. If the problems only occur with a few hosts, it is recommended to leave this option untouched and to use the Custom Options dialog to define individual port numbers for the problematic hosts. This option is only available under . Under BSD, the port for mounting shares is set with the SMB port option. - Default: 445 + Default: not selected / 445 @@ -2327,7 +2326,8 @@ ntlm auth = yes Most versions of support the Unix or POSIX extensions. For these servers, some options are not needed, because the right values are negotiated during the mount process. For other servers, you might want to uncheck this option, so that predefined values can be passed to the server. Please note that if your computer is located in a dominated network neighborhood with only a few servers, you can safely uncheck this option and define custom options for the servers. -Default: not selected +In case you uncheck this option, consider to switch on permission checks under Advanced Mount Settings. +Default: selected @@ -2336,7 +2336,8 @@ ntlm auth = yes Sets the owner of the files and directories on the file system. By default, your UID is used. To change the UID, press the search button and choose one from the drop down menu. -Default: your UID +In case the support for the Unix extensions is selected, this setting is disabled. +Default: selected / your UID @@ -2345,7 +2346,8 @@ ntlm auth = yes Sets the group that owns the files and directories on the file system. By default, your GID is used. To change the GID, press the search button and choose one from the drop down menu. -Default: your GID +In case the support for the Unix extensions is selected, this setting is disabled. +Default: selected / your GID @@ -2354,7 +2356,8 @@ ntlm auth = yes Sets the permissions that are applied to files. The value is given in octal and has to have 4 digits. To learn more about the file mode (file_mode), you should read the
[network/smb4k] doc: Update handbook.
Git commit dbeb15674c7dcc8ed05f79ef9f62cb92d97d7ed8 by Alexander Reinholdt. Committed on 17/12/2022 at 16:51. Pushed by areinholdt into branch 'master'. Update handbook. M +1-1doc/index.docbook https://invent.kde.org/network/smb4k/commit/dbeb15674c7dcc8ed05f79ef9f62cb92d97d7ed8 diff --git a/doc/index.docbook b/doc/index.docbook index eae8f50e..7983cc96 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -35,7 +35,7 @@ Alexander Reinholdt - 2021-03-30 + 2022-12-17 3.2.0 is an advanced network neighborhood browser and share mounting utility.
[network/smb4k] doc: Update handbook.
Git commit 4151025dfe56230b2b1e5817859523ed26f615d3 by Alexander Reinholdt. Committed on 17/12/2022 at 16:44. Pushed by areinholdt into branch 'master'. Update handbook. M +12 -1doc/index.docbook A +---doc/network_neighborhood_browser_dns-sd_error.png https://invent.kde.org/network/smb4k/commit/4151025dfe56230b2b1e5817859523ed26f615d3 diff --git a/doc/index.docbook b/doc/index.docbook index 2281dfbf..eae8f50e 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -167,6 +167,17 @@ automatically scans the network neighborhood for active workgroups and domains on start-up, and presents them in the network neighborhood browser. For this purpose it uses 's client library, https://en.wikipedia.org/wiki/Zero-configuration_networking#DNS-SD;>DNS Service Discovery (DNS-SD) and, optionally, https://en.wikipedia.org/wiki/WS-Discovery;>Web Services Dynamic Discovery (WS-Discovery). The way browses the network neighborhood can be adjusted in the Network configuration page. uses a traditional scan mode, where initially only workgroups and domains are looked up and scans are only made when necessary , when you execute a network item. Due to the use of DNS-SD, you will most likely find a domain called LOCAL in the network neighborhood browser. This is the default local DNS domain used by services like https://en.wikipedia.org/wiki/Avahi_(software)">Avahi and not an actual domain. Opening a domain or workgroup item shows the servers belonging to it. If you want to access the shares of one of the servers, you must open the desired server. There is also the possibility to wake up sleeping servers prior to scanning the network neighborhood (Wake-On-LAN). If this feature is enabled, sends a magic packet to each server that is to be awakened, then waits the defined time until it starts to look up the workgroups and domains. The Wake-On-LAN setting can be turned on in the configuration dialog. The servers that should be awakened must be defined in the Custom Options dialog. + + If you are using DNS Service Discovery and the Zeroconf daemon (Avahi) is not running, shows an error notification: + + Error message if the Zeroconf daemon is not running + + + The error message if the Zeroconf daemon is not running + + + In this case, please start the Zeroconf daemon and restart . +
[network/smb4k] doc: Update handbook.
Git commit 1f2193b72b4884a39cd29a1a093d5c5bcaa10466 by Alexander Reinholdt. Committed on 04/12/2022 at 08:49. Pushed by areinholdt into branch 'master'. Update handbook. M +4-4doc/index.docbook M +---doc/network_neighborhood_browser.png M +---doc/network_neighborhood_browser_searching.png M +---doc/shares_view_icon_view.png M +---doc/shares_view_list_view.png https://invent.kde.org/network/smb4k/commit/1f2193b72b4884a39cd29a1a093d5c5bcaa10466 diff --git a/doc/index.docbook b/doc/index.docbook index f9166788..f1db169a 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -475,7 +475,7 @@ Mount Settings (BSD only) -In this tab you can define settings related to mounting. For information about all other settings see this page. +In this tab you can define settings related to mounting. For information about all other settings see this section. @@ -545,7 +545,7 @@ - You can switch between the two views by selecting either the appropriate entry in the View Modes submenu from the Shares View menu of the main window or in the shares view's popup menu. + You can switch between the two views by selecting the appropriate entry in the View Modes submenu of the tool bar, in the menu bar under Shares or in the shares view's popup menu. By default, only your own mounts are displayed. However, you can adjust to show all mounts with the respective settings. @@ -593,7 +593,7 @@ -Unmount one or multiple selected shares. If no share is selected in the shares view, this button is disabled. +Unmount the selected shares. If no share is selected in the shares view, this button is disabled. Read the Unmounting Shares section for more details. @@ -617,7 +617,7 @@ -Add bookmarks to the currently selected mounted shares. This action is disabled if no share is selected. +Add bookmarks to the selected shares. This action is disabled if no share is selected. Read the Adding Bookmarks section for more details. diff --git a/doc/network_neighborhood_browser.png b/doc/network_neighborhood_browser.png index 3450f385..770aa871 100644 Binary files a/doc/network_neighborhood_browser.png and b/doc/network_neighborhood_browser.png differ diff --git a/doc/network_neighborhood_browser_searching.png b/doc/network_neighborhood_browser_searching.png index a8c47ef3..35d5a169 100644 Binary files a/doc/network_neighborhood_browser_searching.png and b/doc/network_neighborhood_browser_searching.png differ diff --git a/doc/shares_view_icon_view.png b/doc/shares_view_icon_view.png index 8dea9aa2..dceab887 100644 Binary files a/doc/shares_view_icon_view.png and b/doc/shares_view_icon_view.png differ diff --git a/doc/shares_view_list_view.png b/doc/shares_view_list_view.png index 7e6d7483..40e8848a 100644 Binary files a/doc/shares_view_list_view.png and b/doc/shares_view_list_view.png differ
[network/smb4k] doc: Update handbook.
Git commit 33e9ccb842075d4baaa946cce8d08e82eb8eeab0 by Alexander Reinholdt. Committed on 21/11/2022 at 05:25. Pushed by areinholdt into branch 'master'. Update handbook. M +20 -20 doc/index.docbook https://invent.kde.org/network/smb4k/commit/33e9ccb842075d4baaa946cce8d08e82eb8eeab0 diff --git a/doc/index.docbook b/doc/index.docbook index d10627c3..51c3deb6 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -121,7 +121,7 @@ The Main Window -On the first start-up, the main window of looks similar to the one shown below. The network neighborhood browser (Network Neighborhood) and the mounted shares view (Mounted Shares) are arranged in a tab widget. Above them the menubar and toolbar are located. Below them you will see the status bar. +On the first start-up, the main window of looks similar to the one shown below. The network neighborhood browser (Network Neighborhood) and the mounted shares view (Mounted Shares) are arranged in a tab widget. Above them the menu bar and tool bar are located. Below them you will see the status bar. Screenshot of the main window @@ -131,10 +131,10 @@ -The toolbar contains some of the main actions, like Configure and Quit. It also dynamically loads the actions of the dock widget that currently has the focus. For additional information, please take a look at the sections discussing the network neighborhood browser and mounted shares view. -The status bar provides some information about the current status of . If the application is processing a user request ( mounting a share), a descriptive message is displayed in the leftmost section and a progress bar is shown with a busy indicator. The two icons on the right hand side indicate if there are shares mounted (network folder icon) and the status of the authentication system (wallet or key icon). +The tool bar contains some of the main actions, like Configure and Quit. It also dynamically loads the actions of the dock widget that currently has the focus. For additional information, please take a look at the sections discussing the network neighborhood browser and mounted shares view. +The status bar provides some information about the current status of . If the application is processing a user request ( mounting a share), a descriptive message is displayed in the leftmost section and a progress bar is shown with a busy indicator. The two icons on the right side indicate whether shares are mounted (network folder icon) and the status of the authentication system (wallet or key icon). If the dock widgets are arranged as tabs, the user gets additional visual feedback. Each time a share is mounted or unmounted, the Mounted Shares tab is highlighted for a few seconds. -The main window is highly configurable. You can hide or show all tabbed widgets (SettingsDock Widgets). They can also be dragged around with the mouse and docked to different areas in the main window. You can even detach them from the main window. The status bar and the toolbars can be hidden or shown by toggling the menu entry SettingsShow Statusbar and the ones under SettingsToolbars Shown, respectively. +The main window is highly configurable. You can hide or show all tabbed widgets via SettingsDock Widgets. They can also be dragged around with the mouse and docked to different areas in the main window. You can even detach them from the main window. The status bar and the tool bars can be hidden or shown by toggling the menu entry SettingsShow Statusbar and the ones under SettingsToolbars Shown, respectively.
[network/smb4k] doc: Update handbook.
Git commit 81d0e01edbbf34d966e7debd5bb7802af3f79aa3 by Alexander Reinholdt. Committed on 14/11/2022 at 05:56. Pushed by areinholdt into branch 'master'. Update handbook. M +5-4doc/index.docbook M +---doc/main_window.png https://invent.kde.org/network/smb4k/commit/81d0e01edbbf34d966e7debd5bb7802af3f79aa3 diff --git a/doc/index.docbook b/doc/index.docbook index 8d09d8cf..d10627c3 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -7,6 +7,7 @@ CIFS"> + SMB3"> Samba"> Solid"> KDBusAddons"> @@ -30,12 +31,12 @@ -2005-2021 +2005-2022 Alexander Reinholdt 2021-03-30 - 3.1.0 + 3.2.0 is an advanced network neighborhood browser and share mounting utility. @@ -53,12 +54,12 @@ Introduction - This handbook describes 3.1.x and to some extent earlier versions. + This handbook describes 3.2 and to some extent earlier versions. is an advanced network neighborhood browser and http://www.samba.org;>Samba share mounting utility. It provides many handy features that ease your life in a -dominated network environment: Scanning for (active) workgroups, hosts, and shares using 's client library, DNS Service Discovery (DNS-SD) and, optionally, Web Services Dynamic Discovery (WS-Discovery) -Support of the () and SMBFS (BSD) file system +Support of the and file system under as well as the SMBFS file system under BSD Mounting and unmounting of shares Access to the files of a mounted share using a file manager or terminal Auto-detection of external mounts and unmounts diff --git a/doc/main_window.png b/doc/main_window.png index 5152f29c..ef499eca 100644 Binary files a/doc/main_window.png and b/doc/main_window.png differ
