summaryrefslogtreecommitdiffstats
path: root/doc/userguide/konsole-intro.docbook
blob: ec168ac22c60b542a23b9d5a23afa84834c9bae5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
<chapter id="konsole-intro">

<chapterinfo>
<authorgroup>
<author>
<firstname>Gardner</firstname>
<surname>Bell</surname>
</author>
</authorgroup>
</chapterinfo>


<title>&konsole; Introduction</title>

<para>Extremely brief intro to managing in a shell</para>

<para>Emergency procedures: killing wild apps, etc</para>

<para>SSH, sessions, envars, other fun things</para>

<para>Some tips and tricks</para>


<!-- Some Content borrowed from the konsole handbook -->

<para>&konsole; is a terminal emulator for the X Window System. It is
essentially based on the <ulink url="http://vt100.net">DEC's VT100</ulink> 
and many of its succesors.  &konsole; &ndash; also referred to as a
shell &ndash; is an
essential tool on &Linux; and &UNIX; based machines for fast and productive
work.</para>

<para>Emergency Procedures:</para>

<para>On &Linux; and &UNIX;-based systems every process runs independently in its own memory
space so it can't accidentally overwrite any other processes memory, unless
of course it has <systemitem class="username">root</systemitem> privileges. 
If a process in &kde; crashes due to a bug one should not need to worry
about it accessing any other active process.</para>

<para>To keep track of all system processes use the <command>top</command>
command or <command>ps</command> in &konsole;.  Using these utilities will
make it much easier to find and kill off rogue programs.</para>

<para>An example of using signals in &konsole;,  &konqueror; has crashed
leaving behind a running process of
<application>nspluginviewer</application> which is taking up 12% of your
memory and 10% of your cpu cycles.  In <command>top</command> use the <keycap>k</keycap>
command switch to kill the task.  You will be prompted for the PID and then
the signal to send to kill it.  For more on info on what signals you can
send to a running process see the full manual on signals (type
<command>man signal</command> in a &konsole; or go to
<userinput>#signal</userinput> in &konqueror;).</para>

<para>SSH, sessions, envars, other fun things.</para>

<para>If you are using &konsole; for remote administration consider using
&konsole;'s <quote>Session</quote> feature.  To use this click on the menu
entry
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &konsole;</guimenuitem></menuchoice>.
From here choose the <guimenuitem>Sessions</guimenuitem> tab and fill in the
name for your new session.  This will now become your default session when
you start &konsole;.</para>

<para>When &konsole; is invoked <application>bash</application> specific
commands and &kde; specific variables are read and executed from
<filename>~/.bashrc</filename> or <filename>~/.bash_profile</filename>. 
The preferred configuration file for user environments is
<filename>~/.bash_profile</filename>, the commands
<command>printenv</command> or <command>env</command> can be used to
display all currently set variables.  To set a variable in the shell use 
<command>VARNAME=<replaceable>value</replaceable></command>.  For a full
list of variables that can be set in &kde; see the <ulink
url="http://wiki.kde.org/tiki-index.php?page=Environment+Variables">wiki
</ulink>.</para>

<para>Some tips and tricks</para>

<para>To rename &konsole;'s session use <keycombo
action="simul">&Ctrl;&Alt;<keycap>S</keycap></keycombo> and enter the new
name.</para>

<para>If you find the need to run any &kde; program with <systemitem
class="username">root</systemitem> privileges,  you can use the &tdesu; command with the <option>-c</option> switch
from the command line like this: <userinput><command>tdesu</command>
<option>-c -n <replaceable>PROGRAM</replaceable></option></userinput>, using
the <option>-n</option> switch will prevent &kde; from remembering your
passwords.</para>

<!-- Add links to "further reading" here -->
<itemizedlist>
<title>Related Information</title>


<listitem><para>The &konsole;
Handbook has much more information about the features available in
&konsole;. You can read it in &khelpcenter; or by entering
<userinput>help:/konsole</userinput> in &konqueror;'s
<guilabel>Location</guilabel> bar.</para>
</listitem>

</itemizedlist>





</chapter>

<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-omittag:nil
sgml-shorttag:nil
sgml-namecase-general:nil
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:true
sgml-parent-document:("index.docbook" "book" "chapter")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->