Warning, /plasma/kinfocenter/doc/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
0003 "dtd/kdedbx45.dtd" [
0004 <!ENTITY % addindex "IGNORE">
0005 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
0006 ]>
0007 
0008 <book id="kinfocenter" lang="&language;">
0009 <title>The &infocenter;</title>
0010 
0011 <bookinfo>
0012 <authorgroup>
0013 <author>&Mike.McBride; &Mike.McBride.mail;</author>
0014 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0015 </authorgroup>
0016 
0017 <legalnotice>&FDLNotice;</legalnotice>
0018 <date>2018-03-31</date>
0019 <releaseinfo>Plasma 5.12</releaseinfo>
0020 
0021 <abstract>
0022 <para>This documentation describes &plasma;’s information center.</para>
0023 </abstract>
0024 
0025 <keywordset>
0026 <keyword>Plasma</keyword>
0027 <keyword>kinfocenter</keyword>
0028 <keyword>system</keyword>
0029 <keyword>information</keyword>
0030 <keyword>module</keyword>
0031 </keywordset>
0032 
0033 </bookinfo>
0034 
0035 <chapter id="introduction">
0036 <title>The &infocenter;</title>
0037 
0038 <para>
0039 The &infocenter; provides you with a centralized and convenient
0040 overview of your system and desktop environment.
0041 </para>
0042 
0043 <para>
0044 The information center is made up of multiple modules.  Each module is a
0045 separate application, but the information center organizes all of these
0046 programs into a convenient location.
0047 </para>
0048 
0049 <para>
0050 This next section details the use of the information center itself.  For
0051 information on individual modules, please see <link linkend="module">Default
0052 &infocenter; Modules</link>.
0053 </para>
0054 
0055 <sect1 id="information-center-starting">
0056 <title>Starting the &infocenter;</title>
0057 
0058 <para>
0059 The &infocenter; can be started in three ways:
0060 </para>
0061 
0062 <orderedlist>
0063 <listitem>
0064 <para>
0065 By selecting <menuchoice><guimenu>Applications
0066 </guimenu><guisubmenu>System</guisubmenu><guimenuitem>&infocenter;</guimenuitem>
0067 </menuchoice> from the application launcher in the panel.
0068 
0069 </para>
0070 </listitem>
0071 <listitem>
0072 <para>
0073 By pressing <keycombo
0074 action="simul">&Alt;<keycap>F2</keycap></keycombo> or <keycombo
0075 action="simul">&Alt;&Space;</keycombo>.
0076 This will bring up &krunner;.  Type
0077 <userinput><command>kinfocenter</command></userinput>, and press &Enter;.
0078 </para>
0079 </listitem>
0080 
0081 <listitem>
0082 <para>
0083 You can type <command>kinfocenter &amp;</command> at any command prompt.
0084 </para>
0085 </listitem>
0086 </orderedlist>
0087 
0088 <para>
0089 All three of these methods are equivalent, and produce the same result.
0090 </para>
0091 
0092 </sect1>
0093 
0094 <sect1 id="information-center-screen">
0095 <title>The &infocenter; Screen</title>
0096 
0097 <para>
0098 When you start the information center, you are presented with a window,
0099 which can be divided into three functional parts.
0100 </para>
0101 
0102 <screenshot>
0103   <screeninfo>The &infocenter; Screen.</screeninfo>
0104   <mediaobject>
0105   <imageobject>
0106     <imagedata fileref="kinfocenter.png" format="PNG"/>
0107   </imageobject>
0108   <textobject>
0109     <phrase>The &infocenter; Screen</phrase>
0110   </textobject>
0111   </mediaobject>
0112 </screenshot>
0113 
0114 <para>
0115 Across the top is a toolbar.  The toolbar will provide you with quick
0116 access to most of &infocenter;’s features like get help on the current
0117 module and a help menu.
0118 </para>
0119 
0120 <para>
0121 Along the left hand side, is a column with a filter field at the top.
0122 This is a where you choose which module to investigate. To navigate through the various <acronym>KCM</acronym> modules, left click on
0123 the module in the tree view. You can also use the arrow keys to scroll though the <acronym>KCM</acronym>'s and pressing &Enter; will select the module. The module will
0124 now appear of the main panel of the &infocenter; window. Some items within the tree view are categories, you can left click or again press &Enter; to expand and collapsed these items. This
0125 will show the modules under the category.
0126 You can right click on the module listing to show the following options:
0127 <itemizedlist>
0128   <listitem><para><guimenuitem>Collapse All Categories</guimenuitem>: Collapses the tree to show only top level modules and categories.</para></listitem>
0129   <listitem><para><guimenuitem>Expand All Categories</guimenuitem>: Expands the tree to show modules.</para></listitem>
0130   <listitem><para><guimenuitem>Clear Search</guimenuitem>: This will clear any filter you have applied on the module listing via the search box</para></listitem>
0131 </itemizedlist>
0132 </para>
0133 
0134 <para>
0135 The main panel shows you the system information about the selected module.
0136 </para>
0137 
0138 </sect1>
0139 
0140 <!--*****************************************************************-->
0141 
0142 
0143 <sect1 id="info-center-menus">
0144 <title>The &infocenter; Toolbar</title>
0145 
0146 <para>This next section gives you a brief description of what each toolbar item does.</para>
0147 
0148 <sect2 id="info-center-module-help">
0149 <title>
0150 Module Help button
0151 </title>
0152 <para>
0153 This button opens &khelpcenter; with the current help page for the information module.
0154 </para>
0155 </sect2>
0156 
0157 <sect2 id="info-center-menu-help">
0158 <title>Help Menu button</title>
0159 <para>
0160 &kinfocenter; has the common &kde; <guimenu>Help</guimenu>
0161 menu items, for more information read the section about the <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
0162 of the &kde; Fundamentals.
0163 </para>
0164 
0165 </sect2>
0166 
0167 </sect1>
0168 <sect1 id="info-center-exiting">
0169 <title>Exiting The Information Center</title>
0170 
0171 <para>You can exit the info center one of two ways: </para>
0172 <itemizedlist>
0173 <listitem>
0174 <para>
0175 Type <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> on the keyboard.
0176 </para>
0177 </listitem>
0178 
0179 <listitem>
0180 <para>Click on the <guiicon>Close</guiicon> button on the frame surrounding the info center.</para>
0181 </listitem>
0182 </itemizedlist>
0183 </sect1>
0184 </chapter>
0185 
0186 <!--*****************************************************************-->
0187 
0188 <chapter id="module">
0189 <title>The Default &infocenter; Modules</title>
0190 
0191 <!--****************************************-->
0192 
0193 <sect1 id="aboutsystem">
0194 <title>About System Module</title>
0195 
0196 <para>This page shows a brief summary about your system, &ie; your distribution, <guilabel>KDE Plasma Version:</guilabel>,
0197 <guilabel>KDE Frameworks Version:</guilabel>, <guilabel>Qt Version:</guilabel>, <guilabel>Kernel Version:</guilabel> and <guilabel>OS Type:</guilabel>; and in the hardware section
0198 information about <guilabel>Processors:</guilabel>, <guilabel>Memory:</guilabel> and <guilabel>Graphics Processor:</guilabel>.</para>
0199 
0200 <para>Use the information on this page if you ask for help in support channels or report a bug at 
0201 <ulink url="https://bugs.kde.org">&kde;'s bugtracker</ulink>.</para>
0202 </sect1>
0203 
0204 
0205 <!--****************************************-->
0206 
0207 <sect1 id="kcm_memory">
0208 <title>Memory Information Module</title>
0209 
0210 <para>This module displays the current memory usage.  It is updated
0211 constantly, and can be very useful for pinpointing bottlenecks when certain
0212 applications  are executed.</para>
0213 
0214 <sect2 id="memory-intro">
0215 <title>Memory Types</title>
0216 
0217 <para>The first thing you must understand, is there are two types of
0218 <quote>memory</quote>, available to the operating system and the programs
0219 that run within  it.</para>
0220 
0221 <para>The first type, is called physical memory.  This is the memory located
0222 within the memory chips, within your computer.  This is the
0223 <acronym>RAM</acronym> (for Random Access Memory) you bought when you
0224 purchased your  computer.</para>
0225 
0226 <para>The second type of memory, is called virtual or swap memory.  This
0227 block of memory, is actually space on the hard drive.  The operating
0228 system reserves a space on the hard drive for <quote>swap space</quote>.
0229 The operating system can use this virtual memory (or swap space), if it
0230 runs out of physical memory.  The reason this is called
0231 <quote>swap</quote> memory, is the operating system takes some data that
0232 it doesn't think you will want for a while, and saves that to disk in
0233 this reserved space.  The operating system then loads the new data you
0234 need right now.  It has <quote>swapped</quote> the not needed data, for
0235 the data you need right now.  Virtual or swap memory is not as fast as
0236 physical memory, so operating systems try to keep data (especially often
0237 used data), in the physical memory.</para>
0238 
0239 <para>The total memory, is the combined total of physical memory and
0240 virtual memory.</para>
0241 
0242 </sect2>
0243 
0244 <sect2 id="memory-use">
0245 <title>Memory Information Module</title>
0246 
0247 <para>This window is divided into a top and bottom section</para>
0248 
0249 <para>The top section shows you the total physical memory, total free
0250  physical memory, shared memory, and buffered memory.</para>
0251 
0252 <para>All four values are represented as the total number of bytes, and
0253  as the number of megabytes (1 megabyte = slightly more than 1,000,000
0254  bytes)</para>
0255 
0256 <para>The bottom section shows you three graphs:  </para>
0257 
0258 <itemizedlist>
0259 <listitem><para><guilabel>Total Memory</guilabel> (this is the combination of physical and  virtual memory).</para></listitem>
0260 <listitem><para><guilabel>Physical Memory</guilabel></para></listitem>
0261 <listitem><para>Virtual memory, or <guilabel>Swap Space</guilabel>.</para></listitem>
0262 </itemizedlist>
0263 
0264 <para>The grey areas are free, and the blue and green areas are used.</para>
0265 <tip><para>The exact values of each type of memory are not critical, and
0266  they change regularly.  When you evaluate this page, look at
0267  trends.</para>
0268 
0269 <para>Does your computer have plenty of free space (grey areas)?  If
0270  not, you can increase the swap size or increase the physical
0271  memory.</para>
0272 
0273 <para>Also, if your computer seems sluggish: is your physical memory
0274  full, and does the hard drive always seem to be running?  This suggests
0275  that you do not have enough physical memory, and your computer is
0276  relying on the slower virtual memory for commonly used data. Increasing
0277  your physical memory will improve the responsiveness of your
0278  computer.</para></tip>
0279 
0280 </sect2>
0281 </sect1>
0282 
0283 
0284 <!--****************************************-->
0285 
0286 <sect1 id="energieinformation">
0287 <title>Energy Information Module</title>
0288 
0289 <para>This provides information about CPU wakeups, battery percentage and consumption
0290 over a user defined history and detailed information about the battery.
0291 </para>
0292 </sect1>
0293 
0294 
0295 <!--****************************************-->
0296 
0297 <sect1 id="devinfo">
0298 <title>Device Information Module</title>
0299 
0300 <para>Device Information is a device viewer module. It shows all relevant devices that are present within your <acronym>PC</acronym>. It has three sections,
0301 a device viewer, a information panel and a <acronym>UDI</acronym> listing for the currently selected device.</para>
0302 <sect2 id="devlist">
0303 <title>Device Viewer</title>
0304 <para>The device viewer displays all the current devices detected on your <acronym>PC</acronym> in a tree. The main topics at the beginning of the tree
0305 are the device categories, left click on a collapsed category to expand it and vice versa to collapse it.
0306 To display information about a device, left click on the device in the viewer, the information will display on the right side information panel.
0307 You can right click on the device viewer to show the following options: </para>
0308 <itemizedlist>
0309 <listitem><para><guimenuitem>Collapse All</guimenuitem>: Collapses the tree to show only the main categories.</para></listitem>
0310 <listitem><para><guimenuitem>Expand All</guimenuitem>: Expands the tree to show all the children devices.</para></listitem>
0311 <listitem><para><guimenuitem>Show All Devices</guimenuitem>: Show all the categories no matter if devices are present in those categories</para></listitem>
0312 <listitem><para><guimenuitem>Show Relevant Devices</guimenuitem>: Only show categories that have devices present.</para></listitem>
0313 </itemizedlist>
0314 <para>The default display is to collapse all while showing only relevant devices. Please note that the devices shown
0315 in the device listing are not all devices within your PC, they are just devices that have been detected via the &solid;.</para>
0316 <para> The device viewer can show the following devices:</para>
0317 <itemizedlist>
0318 <listitem><para><guisubmenu>Processors:</guisubmenu> These are your computers <acronym>CPU</acronym>s ( Central Processing Units ).</para></listitem>
0319 <listitem><para><guisubmenu>Storage Drives:</guisubmenu> Devices that are used to store your <acronym>PC</acronym>s files and data.</para></listitem>
0320 <listitem><para><guisubmenu>Network Interfaces:</guisubmenu> Devices that allow you to connect to a network or to another <acronym>PC</acronym>.</para></listitem>
0321 <listitem><para><guisubmenu>Audio Interfaces:</guisubmenu> Devices that allow your <acronym>PC</acronym> to play Sound. They are split into 2 categories, <acronym>ALSA</acronym> and <acronym>OSS</acronym> sound architectures.</para></listitem>
0322 <listitem><para><guisubmenu>Video Devices:</guisubmenu> Devices that allow you to stream live video.</para></listitem>
0323 <listitem><para><guisubmenu>Serial Devices:</guisubmenu> Devices that are connected to your serial port in your PC.</para></listitem>
0324 <listitem><para><guisubmenu>Smart Card Devices:</guisubmenu> Devices that are smart card readers.</para></listitem>
0325 <listitem><para><guisubmenu>Digital Video Broadcasting Devices:</guisubmenu> Devices that use the open standards for digital television.</para></listitem>
0326 <listitem><para><guisubmenu>Device Buttons:</guisubmenu> These are buttons that are present on your <acronym>PC</acronym> or external devices.</para></listitem>
0327 <listitem><para><guisubmenu>Batteries:</guisubmenu> These are battery devices that are plugged into your laptop.</para></listitem>
0328 <listitem><para><guisubmenu>AC Adapters:</guisubmenu> These devices will be present when you plug in your <acronym>AC</acronym> Adapter.</para></listitem>
0329 <listitem><para><guisubmenu>Multimedia Players:</guisubmenu> Devices that play media files, like a music player.</para></listitem>
0330 <listitem><para><guisubmenu>Camera Devices:</guisubmenu> These are digital camera that are connected to your <acronym>PC</acronym>.</para></listitem>
0331 </itemizedlist>
0332 <note>
0333 <para>Video devices do not include your video card adapter</para>
0334 </note>
0335 
0336 <sect3 id="infopanel">
0337 <title>Information Panel</title>
0338 <para>The information panel is where device information is shown when you select a device. The first two information topics are always:</para>
0339 <itemizedlist>
0340 <listitem><para><guilabel>Product:</guilabel> The name of the device.</para></listitem>
0341 <listitem><para><guilabel>Vendor:</guilabel> The vendors name of the device.</para></listitem>
0342 </itemizedlist>
0343 <para>The following information topics are dependent on the device chosen. They are labeled with easy to understand names.
0344 The information labels have the ability to be selected and copied from.</para>
0345 <note>
0346 <para>Processor <guilabel>Max Speed:</guilabel> and <guilabel>Supported Instruction sets:</guilabel> topics are usual not set by &solid;.</para>
0347 </note>
0348 <note>
0349 <para>Top categories in the device listing do not show any information.</para>
0350 </note>
0351 </sect3>
0352 <sect3 id="udilabel">
0353 <title><acronym>UDI</acronym> Information</title>
0354 <para>The bottom information panel shows the current selected devices <acronym>UDI</acronym>. This is the unique device identifier.</para>
0355 <para>All labels have the ability to be selected and copied from.</para>
0356 </sect3>
0357 </sect2>
0358 
0359 <!--****************************************-->
0360 
0361 <sect2 id="interrupts">
0362 <title>Interrupt Request (<abbrev>IRQ</abbrev>) Information Module</title>
0363 
0364 <para>This page displays information about the Interrupt Request
0365 Lines in use, and the devices that use them.</para>
0366 
0367 <para>An <acronym>IRQ</acronym> is a hardware line used in a
0368 <acronym>PC</acronym> by (<acronym>ISA</acronym> bus) devices like
0369 keyboards, modems, sound cards, &etc;, to send interrupt signals to the
0370 processor to tell it that the device is ready to send or accept data.
0371 Unfortunately, there are  only sixteen <acronym>IRQ</acronym>'s (0-15)
0372 available in the i386 (<acronym>PC</acronym>) architecture for sharing among
0373 the various <acronym>ISA</acronym> devices.</para>
0374 
0375 <para>Many hardware problems are the result of <acronym>IRQ</acronym>
0376 conflicts, when two devices try to use the same <acronym>IRQ</acronym>, or
0377 software is misconfigured to use a different <acronym>IRQ</acronym> from the
0378 one a device is actually configured for.</para>
0379 
0380 <note><para>The exact information displayed is system-dependent.  On some
0381 systems, <acronym>IRQ</acronym> information cannot be displayed
0382  yet.</para></note>
0383 
0384 <para>On &Linux;, this information is read from
0385 <filename class="directory">/proc/interrupts</filename>, which is only
0386 available if the <filename class="directory">/proc</filename>
0387 pseudo-filesystem is compiled into the  kernel.</para>
0388 
0389 <para>The first column, is the <acronym>IRQ</acronym> number.  The second
0390 column, is the number of interrupts that have been received since the last
0391 reboot.  The third column shows the type of interrupt.  The fourth,
0392 identifies the device assigned to that interrupt.</para>
0393 
0394 <para>The user cannot modify any settings on this page.</para>
0395 </sect2>
0396 
0397 <!--****************************************-->
0398 
0399 <sect2 id="dma">
0400 <title><acronym>DMA</acronym> Channel Information Module</title>
0401 
0402 <para> This page displays information about the <acronym>DMA</acronym>
0403 (Direct Memory Access) Channels.  A <acronym>DMA</acronym> channel is a
0404 direct connection that allows devices to transfer data to and from
0405 memory without going through the processor. Typically, i386-architecture
0406 systems (<acronym>PC</acronym>'s) have eight <acronym>DMA</acronym>
0407 channels (0-7).</para>
0408 
0409 <note> <para> The exact information displayed is system-dependent.  On
0410 some systems, <acronym>DMA</acronym> Channel information cannot be
0411 displayed yet.</para> </note>
0412 
0413 <para> On &Linux;, this information is read from <filename
0414 class="devicefile">/proc/dma</filename>, which is only available if the
0415 <filename class="directory">/proc</filename> pseudo-filesystem is
0416 compiled into the kernel.</para>
0417 
0418 <para> A list of all currently-registered (<acronym>ISA</acronym> bus)
0419 <acronym>DMA</acronym> channels that are in use is shown. The first
0420 column shows the <acronym>DMA</acronym> channel, and the second column
0421 shows the device which uses that channel.</para>
0422 
0423 <para>
0424 Unused <acronym>DMA</acronym> channels are not listed.
0425 </para>
0426 
0427 <para>
0428 The user cannot modify any settings on this page.
0429 </para>
0430 </sect2>
0431 
0432 <!--****************************************-->
0433 
0434 <sect2 id="kcmusb">
0435 <title>&USB; Controller/&USB; Devices Information Module</title>
0436 
0437 <para>This module allows you to see the devices attached to your
0438 &USB; bus(es).</para>
0439 
0440 <para>This module is for information only, you cannot edit any
0441 information you see here.</para>
0442 </sect2>
0443 
0444 <!--****************************************-->
0445 
0446 <sect2 id="ioports">
0447 <title>Input/Output Port Information Module</title>
0448 
0449 <para>This page displays information about the I/O ports.</para>
0450 
0451 <para>I/O Ports are memory addresses used by the processor for direct
0452 communication with a device that has sent an
0453 interrupt signal to the processor.</para>
0454 
0455 <para>The exchange of commands or data between the processor and the device
0456 takes place through the I/O port address of the device, which is a
0457  hexadecimal
0458 number.  No two devices can share the same I/O port.  Many devices use
0459  multiple
0460 I/O port addresses, which are expressed as a range of hexadecimal
0461 numbers.</para>
0462 
0463 <note><para>The exact information displayed is system-dependent. On some
0464 systems, I/O port information can not yet be displayed.</para></note>
0465 
0466 <para>On &Linux;, this information is read from <filename
0467 class="devicefile">/proc/ioports</filename> which is only available if
0468 the <filename class="devicefile">/proc</filename> pseudo-filesystem is
0469 compiled into the kernel.  A list of all currently-registered I/O port
0470 regions that are in use is shown.</para>
0471 
0472 <para>The first column is the I/O port (or the range of I/O ports), the
0473 second column identifies the device that uses these I/O ports.</para>
0474 
0475 <para>The user cannot modify any settings on this page.</para>
0476 </sect2>
0477 
0478 <!--****************************************-->
0479 
0480 <sect2 id="kcm_pci">
0481 <title><acronym>PCI</acronym>-bus/Installed <acronym>PCI</acronym> Cards Information Module</title>
0482 
0483 <para>This page displays information about the
0484 <acronym>PCI</acronym>-bus and installed <acronym>PCI</acronym> cards,
0485 and other devices that use the Peripheral Component Interconnect
0486 (<acronym>PCI</acronym>) bus.</para>
0487 
0488 <note><para>The exact information displayed is system-dependent. On some
0489 systems, <acronym>PCI</acronym>-information can not yet be
0490 displayed.</para> </note>
0491 
0492 <para>On &Linux;, this information is read from <filename
0493 class="devicefile">/proc/pci</filename> which is only available if the
0494 <filename class="directory">/proc</filename> pseudo-filesystem is
0495 compiled into the kernel.  A listing of all <acronym>PCI</acronym>
0496 devices found during kernel initialization, and their configuration, is
0497 shown.</para>
0498 
0499 <para>Each entry begins with a bus, device and function number.</para>
0500 <para>The user cannot modify any settings on this page.</para>
0501 </sect2>
0502 
0503 </sect1>
0504 
0505 <!--****************************************-->
0506 
0507 
0508 <sect1 id="network">
0509 <title>Network Information Module</title>
0510 
0511 <sect2 id="nic">
0512 <title>Network Interfaces Information Module</title>
0513 
0514 <para>
0515 This page displays information about the network interfaces
0516 installed in your computer.
0517 </para>
0518 
0519 <note><para>The exact information displayed is system-dependent.  On
0520 some systems, this information can not yet be displayed.</para></note>
0521 
0522 <para>The user cannot modify any settings on this page.</para>
0523 </sect2>
0524 
0525 <!--****************************************-->
0526 
0527 <sect2 id="smbstatus">
0528 <title>&Samba; Status Information Module</title>
0529 
0530 <para>The &Samba; and &NFS; Status Monitor is a front end
0531 to the programs <command>smbstatus</command> and
0532 <command>showmount</command>.  Smbstatus reports on current &Samba;
0533 connections, and is part of the suite of &Samba; tools, which implements
0534 the &SMB; (Server Message Block) protocol, also called
0535 the NetBIOS or LanManager protocol.</para>
0536 
0537 <para>This protocol can be used to provide printer sharing or drive
0538 sharing services on a network including machines running the various
0539 flavors of &Microsoft; &Windows;.</para>
0540 
0541 <para><command>showmount</command> is part of the &NFS;
0542 software package. &NFS; stands for Network File System
0543 and is the traditional &UNIX; way to share folders over the
0544 network. In this case the output of <command>showmount</command>
0545 <option>-a localhost</option> is parsed. On some systems showmount is in
0546 <filename class="directory">/usr/sbin</filename>, check if you have
0547 showmount in your <envar>PATH</envar>.</para>
0548 
0549 <sect3 id="smb-exports">
0550 <title>Exports</title>
0551 
0552 <para>On this page you can see a big list which shows the currently
0553 active connections to &Samba; shares and &NFS; exports of
0554 your machine.  The first column shows you whether the resource is a &Samba;
0555 (&SMB;) share or a &NFS; export. The
0556 second column contains the name of the share, the third the name of the
0557 remote host, which accesses this share. The remaining columns have only
0558 a meaning for &Samba;-shares.</para>
0559 
0560 <para>The fourth column contains the User <abbrev>ID</abbrev> of the
0561 user, who accesses this share. Note that this does not have to be equal
0562 to the &UNIX; user <abbrev>ID</abbrev> of this user. The same applies
0563 for the next column, which displays the group <abbrev>ID</abbrev> of the
0564 user.</para>
0565 
0566 <para>Each connection to one of your shares is handled by a single
0567 process (<command>smbd</command>), the next column shows the process
0568 <abbrev>ID</abbrev> (<acronym>pid</acronym>) of this
0569 <command>smbd</command>. If you kill this process the connected user
0570 will be disconnected. If the remote user works from &Windows;, as soon
0571 as this process is killed a new one will be created, so he will almost
0572 not notice it.</para>
0573 
0574 <para>The last column shows how many files this user has currently open.
0575 Here you see only, how many files he has <emphasis>open</emphasis> just
0576 now, you don't see how many he copied or formerly opened &etc;</para>
0577 
0578 </sect3>
0579 
0580 <sect3 id="smb-imports">
0581 <title>Imports</title>
0582 
0583 <para> Here you see which &Samba;- and &NFS;-shares from
0584 other hosts are mounted on your local system. The first column shows
0585 whether it is a &Samba;- or &NFS;-share, the second column
0586 displays the name of the share, and the third shows where it is
0587 mounted.</para>
0588 
0589 <para>The mounted &NFS;-shares you should see on
0590 &Linux; (this has been tested), and it should also work on &Solaris;
0591 (this has not been tested).</para>
0592 
0593 </sect3>
0594 
0595 <sect3 id="smb-log">
0596 <title>Log</title>
0597 
0598 <para>This page presents the contents of your local &Samba; log file in a
0599 nice way. If you open this page, the list will be empty.  You have to
0600 press the <guibutton>Update</guibutton> button, then the &Samba; log file
0601 will be read and the results displayed. Check whether the &Samba; log file
0602 on your system is really at the location as specified in the input
0603 line. If it is somewhere else or if it has another name, correct
0604 it. After changing the file name you have to press
0605 <guibutton>Update</guibutton> again.</para>
0606 
0607 <para>&Samba; logs its actions according to the log level (see
0608 <filename>smb.conf</filename>).  If loglevel = 1, &Samba; logs only when
0609 somebody connects to your machine and when this connection is closed
0610 again. If log level = 2, it logs also if somebody opens a file and if he
0611 closes the file again.  If the log level is higher than 2, yet more
0612 stuff is logged.</para>
0613 
0614 <para>If you are interested in who accesses your machine, and which
0615 files are accessed, you should set the log level to 2 and regularly
0616 create a new &Samba; log file (&eg; set up a <command>cron</command> task
0617 which once a week moves your current &Samba; log file into another
0618 folder or something like that). Otherwise your &Samba; log file may
0619 become very big.</para>
0620 
0621 <para>With the four checkboxes below the big list you can decide, which
0622 events are displayed in the list. You have to press
0623 <guibutton>Update</guibutton> to see the results.  If the log level of
0624 your &Samba; is too low, you won't see everything.</para>
0625 
0626 <para>By clicking on the header of one column you can sort the list by
0627 this column.</para>
0628 
0629 </sect3>
0630 <sect3 id="smb-statistics">
0631 <title>Statistics</title>
0632 
0633 <para>On this page you can filter the contents of the third page for
0634 certain contents.</para>
0635 
0636 <para>Let's say the <guilabel>Event</guilabel> field (not the one in the
0637 list) is set to <userinput>Connection</userinput>,
0638 <guilabel>Service/File</guilabel> is set to <userinput>*</userinput>,
0639 <guilabel>Host/User</guilabel> is set to <userinput>*</userinput>,
0640 <guilabel>Show expanded service info</guilabel> is disabled and
0641 <guilabel>Show expanded host info</guilabel> is disabled.</para>
0642 
0643 <para>If you press <guibutton>Update</guibutton> now, you will see how
0644 often a connection was opened to share <literal>*</literal> (&ie; to any
0645 share) from host <literal>*</literal> (&ie; from any host).  Now enable
0646 <guilabel>Show expanded host info</guilabel> and press
0647 <guibutton>Update</guibutton> again.  Now you will see for every host
0648 which matches the wildcard <literal>*</literal>, how many connections
0649 were opened by him.</para>
0650 
0651 <para>Now press <guibutton>Clear Results</guibutton>.</para>
0652 
0653 <para>Now set the <guilabel>Event</guilabel> field to File Access and
0654 enable <guilabel>Show expanded service info</guilabel> and press
0655 <guibutton>Update</guibutton> again.</para>
0656 
0657 <para>Now you will see how often every single file was accessed. If you
0658 enable <guilabel>Show expanded host info</guilabel> too, you will see
0659 how often every single user opened each file.</para>
0660 
0661 <para>In the input lines <guilabel>Service/File</guilabel> and
0662 <guilabel>Host/User</guilabel> you can use the wildcards
0663 <literal>*</literal> and <literal>?</literal> in the same way you use
0664 them at the command line.  Regular expressions are not
0665 recognized.</para>
0666 
0667 <para>By clicking on the header of a column you can sort the list by
0668 this column.  This way you can check out which file was opened most
0669 often, or which user opened the most files or whatever.</para>
0670 
0671 </sect3>
0672 
0673 
0674 <sect3 id="smb-stat-author">
0675 <title>Section Author</title>
0676 
0677 <para>Module copyright 2000: Michael Glauche and &Alexander.Neundorf; &Alexander.Neundorf.mail;</para>
0678 
0679 <para>Originally written by: Michael Glauche</para>
0680 
0681 <para>Currently maintained by: &Alexander.Neundorf; &Alexander.Neundorf.mail;</para>
0682 
0683 <itemizedlist>
0684 <title>Contributors</title>
0685 <listitem><para>Conversion to &kcontrol; applet:</para>
0686 <para>&Matthias.Hoelzer-Kluepfel; &Matthias.Hoelzer-Kluepfel.mail;</para></listitem>
0687 <listitem><para>Use of <classname>K3Process</classname> instead of popen, and more error checking:</para>
0688 <para>&David.Faure; &David.Faure.mail;</para></listitem>
0689 <listitem><para>Conversion to kcmodule, added tab pages 2,3,4, bug
0690 fixed:</para>
0691 <para>&Alexander.Neundorf; &Alexander.Neundorf.mail;</para></listitem>
0692 </itemizedlist>
0693 
0694 <para>Documentation copyright 2000 &Alexander.Neundorf; &Alexander.Neundorf.mail;</para>
0695 
0696 <para>Documentation translated to docbook by &Mike.McBride; &Mike.McBride.mail;</para>
0697 
0698 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
0699 
0700 </sect3>
0701 </sect2>
0702 </sect1>
0703 
0704 <sect1 id="graphical">
0705 <title>Graphical Information Module</title>
0706 
0707 <para>When you open the modules in this section, you are presented with some
0708 information.  The left hand side of the window is organized into a
0709 tree. Some of the elements have a plus sign in front of the label.
0710 Clicking this sign opens a <quote>submenu</quote> related to the
0711 label.  Clicking on a minus sign in front of a label hides the
0712 submenu.</para>
0713 
0714 <para>The right hand side of the window contains the individual
0715 values for each of the parameters on the left.</para>
0716 
0717 <para>The information presented will vary depending on your
0718 setup.</para>
0719 
0720 <note><para>Some setups may not be able to determine some or all of the
0721 parameters.</para></note>
0722 
0723 <para>You can not change any values from this module.  It is for
0724 information only.</para>
0725 
0726 <!--****************************************-->
0727 
0728 <sect2 id="wayland">
0729 <title>&Wayland; Information Module</title>
0730 
0731 <para>This screen is useful for getting specific information about your
0732 <ulink url="https://en.wikipedia.org/wiki/Wayland_(display_server_protocol)">&Wayland; Compositor</ulink>.</para>
0733 
0734 </sect2>
0735 
0736 <!--****************************************-->
0737 
0738 <sect2 id="xserver">
0739 <title>X Server Information Module</title>
0740 
0741 <para>This screen is useful for getting specific information about your
0742 X Server and the current session of X.</para>
0743 
0744 </sect2>
0745 
0746 <!--****************************************-->
0747 
0748 <sect2 id="opengl">
0749 <title>OpenGL Information Module</title>
0750 
0751 <para>This page displays information about installed <acronym>OpenGL</acronym> implementation.
0752 OpenGL (for "Open Graphics Library") is a cross-platform,
0753 hardware independent interface for 3D graphics.</para>
0754 
0755 <para><acronym>GLX</acronym> is the binding for OpenGL to X Window system.</para>
0756 
0757 <para> <acronym>DRI</acronym> (Direct Rendering Infrastucture) provides hardware acceleration for OpenGL.
0758 You must have a videocard with 3D accelerator and properly installed driver for this.</para>
0759 <para> </para>
0760 
0761 <para>Read more at the official OpenGL site <ulink url="https://www.opengl.org">OpenGL</ulink> </para>
0762 </sect2>
0763 
0764 </sect1>
0765 
0766 </chapter>
0767 
0768 <chapter id="credits">
0769 <title>Credits and License</title>
0770 
0771 <para>&infocenter;</para>
0772 <para>Program copyright 1997-2001 The &infocenter; Developers</para>
0773 <para>Contributors:</para>
0774 
0775 <itemizedlist>
0776 <listitem><para>&Matthias.Hoelzer-Kluepfel;
0777 &Matthias.Hoelzer-Kluepfel.mail;</para></listitem>
0778 <listitem><para>&Matthias.Elter; &Matthias.Elter.mail;</para></listitem>
0779 </itemizedlist>
0780 
0781 <para>Documentation <trademark class="copyright">copyright 2000
0782 &Mike.McBride;</trademark> &Mike.McBride.mail;</para>
0783 
0784 <para>Contributors:</para>
0785 
0786 <itemizedlist>
0787 <listitem><para>&Paul.Campbell; &Paul.Campbell.mail;</para></listitem>
0788 <listitem><para>&Helge.Deller; &Helge.Deller.mail;</para></listitem>
0789 <listitem><para>&Mark.Donohoe;</para></listitem>
0790 <listitem><para>&Patrick.Dowler;</para></listitem>
0791 <listitem><para>&Duncan.Haldane; <email>duncan@kde.org</email></para></listitem>
0792 <listitem><para>&Steffen.Hansen; <email>stefh@mip.ou.dk</email>.</para></listitem>
0793 <listitem><para>&Matthias.Hoelzer-Kluepfel; &Matthias.Hoelzer-Kluepfel.mail;</para></listitem>
0794 <listitem><para>&Martin.R.Jones; &Martin.R.Jones.mail;</para></listitem>
0795 <listitem><para>&Jost.Schenck; &Jost.Schenck.mail;</para></listitem>
0796 <listitem><para>&Jonathan.Singer; &Jonathan.Singer.mail;</para></listitem>
0797 <listitem><para>&Thomas.Tanghus; &Thomas.Tanghus.mail;</para></listitem>
0798 <listitem><para>&Krishna.Tateneni; &Krishna.Tateneni.mail;</para></listitem>
0799 <listitem><para>Ellis Whitehead <email>ewhitehe@uni-freiburg.de</email></para></listitem>
0800 
0801 </itemizedlist>
0802 
0803 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
0804 
0805 &underFDL;
0806 &underGPL;
0807 </chapter>
0808 
0809 </book>
0810 <!--
0811 Local Variables:
0812 mode: sgml
0813 End:
0814 -->