runtime/doc/kcontrol/smb/index.docbook

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
   3 "dtd/kdex.dtd" [
   4 <!ENTITY % addindex "IGNORE">
   5 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
   6 ]>
   7
   8 <article lang="&language;">
   9 <articleinfo>
  10
  11 <authorgroup>
  12 <author>&Mike.McBride; &Mike.McBride.mail;</author>
  13 <author>&Jost.Schenck; &Jost.Schenck.mail;</author>
  14 <!-- TRANS:ROLES_OF_TRANSLATORS -->
  15 </authorgroup>
  16
  17 <date>2002-02-12</date>
  18 <releaseinfo>3.00.00</releaseinfo>
  19
  20 <keywordset>
  21 <keyword>KDE</keyword>
  22 <keyword>KControl</keyword>
  23 <keyword>Windows shares</keyword>
  24 </keywordset>
  25 </articleinfo>
  26 <sect1 id="windows-shares">
  27 <title>Windows Shares</title>
  28
  29 <sect2 id="windows-shares-intro">
  30 <title>Introduction</title>
  31
  32 <para>In many small local area networks, the <acronym>SMB</acronym>
  33 protocol is used to offer network services. Names like
  34 <quote>&Windows; Network</quote> or <quote>&Windows; for Workgroups
  35 Network</quote> or <quote>LanManager</quote> are often used as
  36 well. Using <acronym>SMB</acronym> you can access so-called
  37 <quote>shares</quote> (&ie; folders made available by the server)
  38 as well as printers.  </para>
  39
  40 <para>&kde; comes with built-in support for the <acronym>SMB</acronym>
  41 protocol. As &kde; is network-transparent that means you can access
  42 <acronym>SMB</acronym> shares from everywhere you can access your
  43 local files, for example in the &konqueror; file manager and in the
  44 file dialog. To make use of this you should provide &kde; with some
  45 information on your <acronym>SMB</acronym> network. But don't worry,
  46 this is normally pretty simple as, for example, all the Windows
  47 clients in your network need and have the same information.</para>
  48
  49 <!-- Don't know if the following info should go in the base
  50 documentation -->
  51
  52 <!-- this smb-ioslave doesn't support showing a list
  53 of hosts (like e.g. smb:/), for this you need the lan or rlan-ioslave,
  54 very cool thing (TM) btw. If you want to write some documentation for
  55 this one too, have a look at kdenetwork/lanbrowsing/lisa/README and
  56 contact me if you have questions. -->
  57
  58 <note><para>For the <acronym>SMB</acronym> protocol to work, it is
  59 required to have <application>Samba</application> correctly
  60 installed. If you have an NT domain controller, you will need at least
  61 <application>Samba</application> version 2.0 or higher. If you want to
  62 access &Windows; 2000 shares, you will need
  63 <application>Samba</application> version 2.0.7 or higher. Older
  64 versions may work too, but have not been tested.</para></note>
  65
  66 <!-- TODO: link to some place which explains USING SMB, i.e. konqueror
  67 or file dialog manual -->
  68
  69 </sect2>
  70
  71 <sect2 id="windows-shares-use">
  72 <title>Use</title>
  73
  74 <para>Although there are a lot of insecure <acronym>SMB</acronym>
  75 networks out there which allow access to anyone, in principle you have
  76 to authenticate yourself to access the services of an
  77 <acronym>SMB</acronym> server.  By default, &kde; will use the data
  78 entered in the <guilabel>Default user name</guilabel> and
  79 <guilabel>Default password</guilabel> fields to authenticate itself on
  80 <acronym>SMB</acronym> hosts. If you leave the field <guilabel>Default
  81 user name</guilabel> empty, &kde; will try to access
  82 <acronym>SMB</acronym> hosts without a username. If you leave the
  83 default password empty, it will try without a password. If &kde; is
  84 unsuccessful accessing the host using these settings, you will be
  85 asked for a username and a password.</para>
  86
  87 <important><para>While it makes things more comfortable if &kde;
  88 stores your <acronym>SMB</acronym> password, this may be a security
  89 problem. If you are using <acronym>SMB</acronym> in a security
  90 conscious environment, you should not store your password here but
  91 rather enter it anew every time you need to access an
  92 <acronym>SMB</acronym> host.</para></important>
  93
  94 <para>In the <guilabel>Workgroup</guilabel> field, you can enter your
  95 workgroup name.  If you don't know it, ask your system administrator
  96 or have a look at other already configured machines in your network.
  97 However, in most cases providing the workgroup name is not required,
  98 so you probably can also leave this empty.</para>
  99
 100 <para>If the option <guilabel>Show hidden shares</guilabel> is
 101 checked, shares ending with a <quote>$</quote> will be shown.</para>
 102 </sect2>
 103
 104 </sect1>
 105
 106 </article>