runtime/doc/userguide/konsole-intro.docbook

   1 <chapter id="konsole-intro">
   2
   3 <chapterinfo>
   4 <authorgroup>
   5 <author>
   6 <firstname>Gardner</firstname>
   7 <surname>Bell</surname>
   8 </author>
   9 </authorgroup>
  10 </chapterinfo>
  11
  12
  13 <title>&konsole; Introduction</title>
  14
  15 <para>Extremely brief intro to managing in a shell</para>
  16
  17 <para>Emergency procedures: killing wild apps, etc</para>
  18
  19 <para>SSH, sessions, envars, other fun things</para>
  20
  21 <para>Some tips and tricks</para>
  22
  23
  24 <!-- Some Content borrowed from the konsole handbook -->
  25
  26 <para>&konsole; is a terminal emulator for the X Window System. It is
  27 essentially based on the <ulink url="http://vt100.net">DEC's VT100</ulink>
  28 and many of its succesors.  &konsole; &ndash; also referred to as a
  29 shell &ndash; is an
  30 essential tool on &Linux; and &UNIX; based machines for fast and productive
  31 work.</para>
  32
  33 <para>Emergency Procedures:</para>
  34
  35 <para>On &Linux; and &UNIX;-based systems every process runs independently in its own memory
  36 space so it can't accidentally overwrite any other processes memory, unless
  37 of course it has <systemitem class="username">root</systemitem> privileges.
  38 If a process in &kde; crashes due to a bug one should not need to worry
  39 about it accessing any other active process.</para>
  40
  41 <para>To keep track of all system processes use the <command>top</command>
  42 command or <command>ps</command> in &konsole;.  Using these utilities will
  43 make it much easier to find and kill off rogue programs.</para>
  44
  45 <para>An example of using signals in &konsole;,  &konqueror; has crashed
  46 leaving behind a running process of
  47 <application>nspluginviewer</application> which is taking up 12% of your
  48 memory and 10% of your cpu cycles.  In <command>top</command> use the <keycap>k</keycap>
  49 command switch to kill the task.  You will be prompted for the PID and then
  50 the signal to send to kill it.  For more on info on what signals you can
  51 send to a running process see the full manual on signals (type
  52 <command>man signal</command> in a &konsole; or go to
  53 <userinput>#signal</userinput> in &konqueror;).</para>
  54
  55 <para>SSH, sessions, envars, other fun things.</para>
  56
  57 <para>If you are using &konsole; for remote administration consider using
  58 &konsole;'s <quote>Session</quote> feature.  To use this click on the menu
  59 entry
  60 <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &konsole;</guimenuitem></menuchoice>.
  61 From here choose the <guimenuitem>Sessions</guimenuitem> tab and fill in the
  62 name for your new session.  This will now become your default session when
  63 you start &konsole;.</para>
  64
  65 <para>When &konsole; is invoked <application>bash</application> specific
  66 commands and &kde; specific variables are read and executed from
  67 <filename>~/.bashrc</filename> or <filename>~/.bash_profile</filename>.
  68 The preferred configuration file for user environments is
  69 <filename>~/.bash_profile</filename>, the commands
  70 <command>printenv</command> or <command>env</command> can be used to
  71 display all currently set variables.  To set a variable in the shell use
  72 <command>VARNAME=<replaceable>value</replaceable></command>.  For a full
  73 list of variables that can be set in &kde; see the <ulink
  74 url="http://wiki.kde.org/tiki-index.php?page=Environment+Variables">wiki
  75 </ulink>.</para>
  76
  77 <para>Some tips and tricks</para>
  78
  79 <para>To rename &konsole;'s session use <keycombo
  80 action="simul">&Ctrl;&Alt;<keycap>S</keycap></keycombo> and enter the new
  81 name.</para>
  82
  83 <para>If you find the need to run any &kde; program with <systemitem
  84 class="username">root</systemitem> privileges,  you can use the &kdesu; command with the <option>-c</option> switch
  85 from the command line like this: <userinput><command>kdesu</command>
  86 <option>-c -n <replaceable>PROGRAM</replaceable></option></userinput>, using
  87 the <option>-n</option> switch will prevent &kde; from remembering your
  88 passwords.</para>
  89
  90 <!-- Add links to "further reading" here -->
  91 <itemizedlist>
  92 <title>Related Information</title>
  93
  94
  95 <listitem><para>The &konsole;
  96 Handbook has much more information about the features available in
  97 &konsole;. You can read it in &khelpcenter; or by entering
  98 <userinput>help:/konsole</userinput> in &konqueror;'s
  99 <guilabel>Location</guilabel> bar.</para>
 100 </listitem>
 101
 102 </itemizedlist>
 103
 104
 105
 106
 107
 108 </chapter>
 109
 110 <!-- Keep this comment at the end of the file
 111 Local variables:
 112 mode: xml
 113 sgml-omittag:nil
 114 sgml-shorttag:nil
 115 sgml-namecase-general:nil
 116 sgml-general-insert-case:lower
 117 sgml-minimize-attributes:nil
 118 sgml-always-quote-attributes:t
 119 sgml-indent-step:0
 120 sgml-indent-data:true
 121 sgml-parent-document:("index.docbook" "book" "chapter")
 122 sgml-exposed-tags:nil
 123 sgml-local-catalogs:nil
 124 sgml-local-ecat-files:nil
 125 End:
 126 -->