apps/doc/kinfocenter/samba/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 <title>Samba Status Information</title>
  10 <articleinfo>
  11 <authorgroup>
  12 <author>&Alexander.Neundorf;</author>
  13 <!-- TRANS:ROLES_OF_TRANSLATORS -->
  14 </authorgroup>
  15
  16 <date>2002-02-12</date>
  17 <releaseinfo>3.00.00</releaseinfo>
  18
  19 <keywordset>
  20 <keyword>KDE</keyword>
  21 <keyword>KControl</keyword>
  22 <keyword>Samba</keyword>
  23 <keyword>system information</keyword>
  24 </keywordset>
  25 </articleinfo>
  26
  27 <sect1 id="sambastatus">
  28
  29
  30 <title>Samba Status Information</title>
  31
  32 <para>The Samba and <acronym>NFS</acronym> Status Monitor is a front end
  33 to the programs <command>smbstatus</command> and
  34 <command>showmount</command>.  Smbstatus reports on current Samba
  35 connections, and is part of the suite of Samba tools, which implements
  36 the <acronym>SMB</acronym> (Session Message Block) protocol, also called
  37 the NetBIOS or LanManager protocol.</para>
  38
  39 <para>This protocol can be used to provide printer sharing or drive
  40 sharing services on a network including machines running the various
  41 flavors of &Microsoft; &Windows;.</para>
  42
  43 <para><command>showmount</command> is part of the <acronym>NFS</acronym>
  44 software package. <acronym>NFS</acronym> stands for Network File System
  45 and is the traditional &UNIX; way to share folders over the
  46 network. In this case the output of <command>showmount</command>
  47 <option>-a localhost</option> is parsed. On some systems showmount is in
  48 <filename class="directory">/usr/sbin</filename>, check if you have
  49 showmount in your <envar>PATH</envar>.</para>
  50
  51 <sect2 id="smb-exports">
  52 <title>Exports</title>
  53
  54 <para>On this page you can see a big list which shows the currently
  55 active connections to Samba shares and <acronym>NFS</acronym> exports of
  56 your machine.  The first column shows you whether the resource is a Samba
  57 (<acronym>SMB</acronym>) share or a <acronym>NFS</acronym> export. The
  58 second column contains the name of the share, the third the name of the
  59 remote host, which accesses this share. The remaining columns have only
  60 a meaning for Samba-shares.</para>
  61
  62 <para>The fourth column contains the User <abbrev>ID</abbrev> of the
  63 user, who accesses this share. Note that this does not have to be equal
  64 to the &UNIX; user <abbrev>ID</abbrev> of this user. The same applies
  65 for the next column, which displays the group <abbrev>ID</abbrev> of the
  66 user.</para>
  67
  68 <para>Each connection to one of your shares is handled by a single
  69 process (<command>smbd</command>), the next column shows the process
  70 <abbrev>ID</abbrev> (<acronym>pid</acronym>) of this
  71 <command>smbd</command>. If you kill this process the connected user
  72 will be disconnected. If the remote user works from &Windows;, as soon
  73 as this process is killed a new one will be created, so he will almost
  74 not notice it.</para>
  75
  76 <para>The last column shows how many files this user has currently open.
  77 Here you see only, how many files he has <emphasis>open</emphasis> just
  78 now, you don't see how many he copied or formerly opened &etc;</para>
  79
  80 </sect2>
  81
  82 <sect2 id="smb-imports">
  83 <title>Imports</title>
  84
  85 <para> Here you see which Samba- and <acronym>NFS</acronym>-shares from
  86 other hosts are mounted on your local system. The first column shows
  87 wether it is a Samba- or <acronym>NFS</acronym>-share, the second column
  88 displays the name of the share, and the third shows where it is
  89 mounted.</para>
  90
  91 <para>The mounted <acronym>NFS</acronym>-shares you should see on
  92 &Linux; (this has been tested), and it should also work on &Solaris;
  93 (this has not been tested).</para>
  94
  95 </sect2>
  96
  97 <sect2 id="smb-log">
  98 <title>Log</title>
  99
 100 <para>This page presents the contents of your local samba log file in a
 101 nice way. If you open this page, the list will be empty.  You have to
 102 press the <guibutton>Update</guibutton> button, then the samba log file
 103 will be read and the results displayed. Check whether the samba log file
 104 on your system is really at the location as specified in the input
 105 line. If it is somewhere else or if it has another name, correct
 106 it. After changing the file name you have to press
 107 <guibutton>Update</guibutton> again.</para>
 108
 109 <para>Samba logs its actions according to the log level (see
 110 <filename>smb.conf</filename>).  If loglevel = 1, samba logs only when
 111 somebody connects to your machine and when this connection is closed
 112 again. If log level = 2, it logs also if somebody opens a file and if he
 113 closes the file again.  If the log level is higher than 2, yet more
 114 stuff is logged.</para>
 115
 116 <para>If you are interested in who accesses your machine, and which
 117 files are accessed, you should set the log level to 2 and regularly
 118 create a new samba log file (&eg; set up a <command>cron</command> task
 119 which once a week moves your current samba log file into another
 120 folder or something like that). Otherwise your samba log file may
 121 become very big.</para>
 122
 123 <para>With the four checkboxes below the big list you can decide, which
 124 events are displayed in the list. You have to press
 125 <guibutton>Update</guibutton> to see the results.  If the log level of
 126 your samba is too low, you won't see everything.</para>
 127
 128 <para>By clicking on the header of one column you can sort the list by
 129 this column.</para>
 130
 131 </sect2>
 132
 133
 134 <sect2 id="smb-statistics">
 135 <title>Statistics</title>
 136
 137 <para>On this page you can filter the contents of the third page for
 138 certain contents.</para>
 139
 140 <para>Let's say the <guilabel>Event</guilabel> field (not the one in the
 141 list) is set to <userinput>Connection</userinput>,
 142 <guilabel>Service/File</guilabel> is set to <userinput>*</userinput>,
 143 <guilabel>Host/User</guilabel> is set to <userinput>*</userinput>,
 144 <guilabel>Show expanded service info</guilabel> is disabled and
 145 <guilabel>Show expanded host info</guilabel> is disabled.</para>
 146
 147 <para>If you press <guibutton>Update</guibutton> now, you will see how
 148 often a connection was opened to share <literal>*</literal> (&ie; to any
 149 share) from host <literal>*</literal> (&ie; from any host).  Now enable
 150 <guilabel>Show expanded host info</guilabel> and press
 151 <guibutton>Update</guibutton> again.  Now you will see for every host
 152 which matches the wildcard <literal>*</literal>, how many connections
 153 were opened by him.</para>
 154
 155 <para>Now press <guibutton>clear</guibutton>.</para>
 156
 157 <para>Now set the <guilabel>Event</guilabel> field to File Access and
 158 enable <guilabel>Show expanded service info</guilabel> and press
 159 <guibutton>Update</guibutton> again.</para>
 160
 161 <para>Now you will see how often every single file was accessed. If you
 162 enable <guilabel>Show expanded host info</guilabel> too, you will see
 163 how often every single user opened each file.</para>
 164
 165 <para>In the input lines <guilabel>Service/File</guilabel> and
 166 <guilabel>Host/User</guilabel> you can use the wildcards
 167 <literal>*</literal> and <literal>?</literal> in the same way you use
 168 them at the command line.  Regular expressions are not
 169 recognized.</para>
 170
 171 <para>By clicking on the header of a column you can sort the list by
 172 this column.  This way you can check out which file was opened most
 173 often, or which user opened the most files or whatever.</para>
 174
 175 </sect2>
 176
 177
 178 <sect2 id="smb-stat-author">
 179 <title>Section Author</title>
 180
 181 <para>Module copyright 2000: Michael Glauche and &Alexander.Neundorf; &Alexander.Neundorf.mail;</para>
 182
 183 <para>Originally written by: Michael Glauche</para>
 184
 185 <para>Currently maintained by: &Alexander.Neundorf; &Alexander.Neundorf.mail;</para>
 186
 187 <itemizedlist>
 188 <title>Contributors</title>
 189 <listitem><para>Conversion to kcontrol applet:</para>
 190 <para>&Matthias.Hoelzer-Kluepfel; &Matthias.Hoelzer-Kluepfel.mail;</para></listitem>
 191 <listitem><para>Use of <classname>K3Process</classname> instead of popen, and more error checking:</para>
 192 <para>&David.Faure; &David.Faure.mail;</para></listitem>
 193 <listitem><para>Conversion to kcmodule, added tab pages 2,3,4, bug
 194 fixed:</para>
 195 <para>&Alexander.Neundorf; &Alexander.Neundorf.mail;</para></listitem>
 196 </itemizedlist>
 197
 198 <para>Documentation copyright 2000 &Alexander.Neundorf; &Alexander.Neundorf.mail;</para>
 199
 200 <para>Documentation translated to docbook by &Mike.McBride; &Mike.McBride.mail;</para>
 201
 202 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
 203
 204 </sect2>
 205 </sect1>
 206
 207 </article>