<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % British-English "INCLUDE" 
> <!-- change language only here -->
]>

<article lang="&language;">
<articleinfo>

<authorgroup>
<author
> <firstname
>Mike</firstname
> <surname
>McBride</surname
> </author>
<author
> <firstname
>Jost</firstname
> <surname
>Schenck</surname
> </author>
<othercredit role="translator"
><firstname
>Malcolm</firstname
><surname
>Hunter</surname
><affiliation
><address
><email
>malcolm.hunter@gmx.co.uk</email
></address
></affiliation
><contrib
>KDE British Conversion</contrib
></othercredit>
</authorgroup>

<date
>2002-02-12</date>
<releaseinfo
>3.00.00</releaseinfo>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KControl</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 <acronym
>SMB</acronym
> 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 <acronym
>SMB</acronym
> you can access so-called <quote
>shares</quote
> (&ie; directories made available by the server) as well as printers. </para>

<para
>&kde; comes with builtin support for the <acronym
>SMB</acronym
> protocol. As &kde; is network-transparent that means you can access <acronym
>SMB</acronym
> shares from everywhere you can access your local files, for example in the &konqueror; file manager and in the file dialogue. To make use of this you should provide &kde; with some information on your <acronym
>SMB</acronym
> 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-ioslave doesn't support showing a list
of hosts (like e.g. smb:/), for this you need the lan or rlan-ioslave,
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 <acronym
>SMB</acronym
> protocol to work it is required to have <application
>Samba</application
> correctly installed. If you have an NT domain controller, you will need at least <application
>Samba</application
> version 2.0 or higher. If you want to access &Windows; 2000 shares, you will need <application
>Samba</application
> version 2.0.7 or higher. Older versions may work too, but have not been tested.</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 alot of insecure <acronym
>SMB</acronym
> networks out there which allow access to anyone, in principle you have to authenticate yourself to access the services of an <acronym
>SMB</acronym
> 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 <acronym
>SMB</acronym
> hosts. If you leave the field <guilabel
>Default user name</guilabel
> empty, &kde; will try to access <acronym
>SMB</acronym
> 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 <acronym
>SMB</acronym
> password, this may be a security problem. If you are using <acronym
>SMB</acronym
> in a security conscious environment, you should not store your password here but rather enter it anew every time you need to access an <acronym
>SMB</acronym
> host.</para
></important>

<para
>In the <guilabel
>Workgroup</guilabel
> field, you can enter your workgroup name. If you don't know it, ask your system administrator or have a look at other already configured machines in your network. However, in most cases providing the workgroup name is not required, so you probably can also leave this empty.</para>

<para
>If the option <guilabel
>Show hidden shares</guilabel
> is checked, shares ending with a <quote
>$</quote
> will be shown.</para>
</sect2>

<sect2 id="windows-shares-author">
<title
>Section Author</title>
<para
>This section written by: Jost Schenck <email
>jost@schenck.de</email
></para>


</sect2>
</sect1>

</article>