Warning, /frameworks/kio/docs/kcontrol5/smb/index.docbook is written in an unsupported language. File is not indexed.

 <?xml version="1.0" ?>
 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
 "dtd/kdedbx45.dtd" [
 <!ENTITY % addindex "IGNORE">
 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
 ]>
 
 <article id="smb" lang="&language;">
 <articleinfo>
 <title>&Windows; Shares</title>
 <authorgroup>
 <author>&Mike.McBride; &Mike.McBride.mail;</author>
 <author>&Jost.Schenck; &Jost.Schenck.mail;</author>
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
 <date>2016-11-10</date>
 <releaseinfo>Frameworks 5.29</releaseinfo>
 
 <keywordset>
 <keyword>KDE</keyword>
 <keyword>Systemsettings</keyword>
 <keyword>Windows shares</keyword>
 </keywordset>
 </articleinfo>
 <sect1 id="windows-shares">
 <title>&Windows; Shares</title>
 
 <sect2 id="windows-shares-intro">
 <title>Introduction</title>
 
 <para>In many small local area networks, the &SMB;
 protocol is used to offer network services. Names like
 <quote>&Windows; Network</quote> or <quote>&Windows; for Workgroups
 Network</quote> or <quote>LanManager</quote> are often used as
 well. Using &SMB; you can access so-called
 <quote>shares</quote> (&ie; folders made available by the server)
 as well as printers.</para>
 
 <para>&kde; comes with built-in support for the &SMB;
 protocol. As &kde; is network-transparent that means you can access
 &SMB; shares from everywhere you can access your
 local files, for example in the &konqueror; file manager and in the
 file dialog. To make use of this you should provide &kde; with some
 information on your &SMB; network. But don't worry,
 this is normally pretty simple as, for example, all the &Windows;
 clients in your network need and have the same information.</para>
 
 <!-- Don't know if the following info should go in the base
 documentation --> 
 
 <!-- this smb KIO worker doesn't support showing a list
 of hosts (like e.g. smb:/), for this you need the lan or rlan KIO worker,
 very cool thing (TM) btw. If you want to write some documentation for
 this one too, have a look at kdenetwork/lanbrowsing/lisa/README and
 contact me if you have questions. -->
 
 <note><para>For the &SMB; protocol to work, it is
 required to have &Samba; correctly installed.</para></note>
 
 <!-- TODO: link to some place which explains USING SMB, i.e. konqueror
 or file dialog manual -->
 
 </sect2>
 
 <sect2 id="windows-shares-use">
 <title>Use</title>
 
 <para>Although there are a lot of insecure &SMB;
 networks out there which allow access to anyone, in principle you have
 to authenticate yourself to access the services of an
 &SMB; server.  By default, &kde; will use the data
 entered in the <guilabel>Default user name:</guilabel> and
 <guilabel>Default password:</guilabel> fields to authenticate itself on
 &SMB; hosts. If you leave the field <guilabel>Default
 user name:</guilabel> empty, &kde; will try to access
 &SMB; hosts without a username. If you leave the
 default password empty, it will try without a password. If &kde; is
 unsuccessful accessing the host using these settings, you will be
 asked for a username and a password.</para>
 
 <important><para>While it makes things more comfortable if &kde;
 stores your &SMB; password, this may be a security
 problem. If you are using &SMB; in a security
 conscious environment, you should not store your password here but
 rather enter it anew every time you need to access an
 &SMB; host.</para></important>
 
 </sect2>
 
 </sect1>
 
 </article>