summaryrefslogtreecommitdiffstats
path: root/doc/en/index.docbook
blob: 285826b57877a962caf13f60a52f885d93cfdece (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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
<?xml version="1.0" ?>

<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY knmap "<application>Knmap</application>">
  <!ENTITY kappname "&knmap;">
  <!ENTITY package "kde-module"><!-- tdebase, tdeadmin, etc -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
]>

<book lang="&language;">
<bookinfo>
	<title>The &knmap; Handbook</title>
	
	<authorgroup>
		<author>
			<firstname>Kevin</firstname>
			<othername></othername>
			<surname>Gilbert</surname>
			<affiliation>
				<address><email>kev.gilbert@cdu.edu.au</email></address>
			</affiliation>
		</author>
	</authorgroup>
	
	<copyright>
		<year>2005</year>
		<year>2006</year>
		<holder>Kevin Gilbert</holder>
	</copyright>
	
	<legalnotice>&FDLNotice;</legalnotice>
	<date>2006-01-17</date>
	<releaseinfo>2.1</releaseinfo>
	
	<abstract>
		<para>
		&knmap; is a graphical front end to the <computeroutput>nmap</computeroutput> "Network exploration tool and security scanner".
		</para>
	</abstract>
	
	<keywordset>
		<keyword>KDE</keyword>
		<keyword>Knmap</keyword>
		<keyword>nmap</keyword>
	</keywordset>
</bookinfo>

<chapter id="introduction">
	<title>Introduction</title>
	
	<para>
	This program is a complete re-write of one by the same name written by Alexandre Sagala. The last version of that program was 0.9 which was released on 2003-03-09 and targeted the KDE 2.2 and QT 2.3 environments. Unfortunately it does not compile on today's KDE / QT environments.
	</para>
	
	<para>
	Not to mention that it did not cater for the full set of <computeroutput>nmap</computeroutput> options. Or, perhaps, <computeroutput>nmap</computeroutput> progressed whilst that version of Knmap languished.
	</para>

	<para>
	The icons used in this application are from the Open Clip Art Library. I am indebted to those damn fine folk as my artistic ability is zero - which is marginally above my programming ability.  :-(
	</para>

	<para>
	Version 1.0 of &knmap; was merely a re-write of the original. Version 2.0 adds the extra functionality of multiple concurrent <computeroutput>nmap</computeroutput> scans from within the one instance of &knmap;. Version 2.1 allows a normal (non-root) user to use the privileged nmap functions via to 'tdesu' utility. (Previously, the privileged options were only available if &knmap; was run by root.)
	</para>
</chapter>

<chapter id="using-knmap">
	<title>Using &knmap;</title>
	<para>
	It is assumed that you are familiar with the operation of <computeroutput>nmap</computeroutput>.
	</para>

	<para>
	If your aren't, then please refer to <computeroutput>nmap(1)</computeroutput> or any other resource you can lay your hands on. This document is all about how to use &knmap; as a front end to <computeroutput>nmap</computeroutput>.
	</para>

	<para>
	This following screenshot shows an actual run of <computeroutput>nmap</computeroutput> under the control of &knmap;. The main &knmap; window is divided into two partitions - the Index Window on the left and (a stack of) Scan Windows on the right. Each Scan Window is composed of three partitions - from top to bottom: the Options Window, the Button Bar, and the Output Window.

	<screenshot>
		<mediaobject>
			<imageobject>
				<imagedata fileref="demo.png" format="PNG"/>
			</imageobject>
		</mediaobject>
	</screenshot>
	</para>

	<para>
	The following sections contain screenshots that describe the contents of the various components of &knmap;'s main window. In the main, the contents of the Scan Window should be self-explanatory for readers familiar with <computeroutput>nmap</computeroutput>
	</para>

	<sect1 id="index_window">
		<title>Index Window</title>
		<para>
		This window contains the names of all Scan Windows - with the current entry highlighted (in the KDE "Alternate Background in Lists" colour). When a scan is active, the entry for that scan will flash. When the scan has completed, if that scan is not the current entry, then the entry will be highlighted in the KDE "Selected Background" colour.
		</para>

		<para>
		Left clicking on an entry will display the Scan Window for that scan. The caption of the &knmap; main window will be updated to show the name of the scan and its associated profile.
		</para>

		<para>
		Entries can be manipulated via options in the "File" menu and via a RMB Context Menu. The order of the entries can be changed by dragging individual entries (multiple entries cannot be dragged concurrently).
		</para>

		<para>
		Scans for which the "Use target host name" property is active will have an asterisk displayed before their name.
		</para>
	</sect1>

	<sect1 id="output_window">
		<title>Output Window</title>
		<para>
		As its name implies, this window displays the output of an <computeroutput>nmap</computeroutput> scan. As can be seen from the previous screenshot, the text appearance varies. The following list explains how each type of output is displayed.
		</para>

		<para>
		<variablelist>
			<varlistentry>
				<term>Standard Input</term>
				<listitem>
					<para>
					No font modifiers.
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term>Standard Output</term>
				<listitem>
					<para>
					Text is displayed in bold-face font.
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term>Standard Error</term>
				<listitem>
					<para>
					Text is displayed in bold-face, italic font.
					</para>
				</listitem>
			</varlistentry>
		</variablelist>
		</para>
	</sect1>

	<sect1 id="button_bar">
		<title>Button Bar</title>
		<para>
		This row of buttons control the operation of &knmap;. The following screenshot shows the button row in its normal state.

		<screenshot>
			<mediaobject>
				<imageobject>
					<imagedata fileref="button_bar.png" format="PNG"/>
				</imageobject>
			</mediaobject>
		</screenshot>
		</para>

		<para>
		The <computeroutput>Start nmap</computeroutput> and <computeroutput>Stop nmap</computeroutput> buttons should require no explanation. (No - I wont now launch into a multi-thousand word explanation of the bloody obvious.)
		</para>

		<para>
		The <computeroutput>Clear output</computeroutput> button does just that - deletes all the text in the Output Window.
		</para>

		<para>
		The <computeroutput>Hide options</computeroutput> button can be used to enlarge the Output Window so as to reduce scrolling as shown in the following screenshot. The text of the button reflects the state of the Options Window.

		<screenshot>
			<mediaobject>
				<imageobject>
					<imagedata fileref="output_full.png" format="PNG"/>
				</imageobject>
			</mediaobject>
		</screenshot>
		</para>
	</sect1>

	<sect1 id="common_options">
		<title>Common Options</title>
		<para>
			<screenshot>
				<mediaobject>
					<imageobject>
						<imagedata fileref="common_options.png" format="PNG"/>
					</imageobject>
				</mediaobject>
			</screenshot>
	
		This screenshot shows the <computeroutput>nmap</computeroutput> options that are common to most network scans.
		</para>

		<para>
		<variablelist>
			<varlistentry>
				<term>New data range</term>
				<listitem>
					<para>
					The range of ports are entered here in the format specified in the <computeroutput>nmap</computeroutput> man page for the <computeroutput>-p</computeroutput> parametere, BUT without the protocol specifier.
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term>Protocol</term>
				<listitem>
					<para>
					Select the protocol(s) for the port list shown in the input area. Note that the list of ports can contain a combination of protocols. &knmap; will ensure that the port ranges do not overlap.
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term>Add</term>
				<listitem>
					<para>
					As soon as data has been entered in the input area, the <computeroutput>Add</computeroutput> button will be activated. Pressing this button will cause &knmap; to read the input and, if, valid, add it to the list of existing port ranges.
					</para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term>Delete</term>
				<listitem>
					<para>
					To delete a port range, double click on the entry in the list. That entry will be copied to the input area, the <computeroutput>Protocol</computeroutput> combo box updated to reflect the selected entry and the <computeroutput>Delete</computeroutput> button will be activated.
					</para>

					<para>
					If the button is then pressed, the input area will NOT be cleared and the <computeroutput>Add</computeroutput> button will be activated. The allows for the port range to be added back into the list if the deletion was performed in error.
					</para>
				</listitem>
			</varlistentry>
		</variablelist>
		</para>
	</sect1>

	<sect1 id="compound_options">
		<title>Compound Options</title>
		<para>
			<screenshot>
				<mediaobject>
					<imageobject>
						<imagedata fileref="compound_options.png" format="PNG"/>
					</imageobject>
				</mediaobject>
			</screenshot>
	
		This screenshot shows those <computeroutput>nmap</computeroutput> options that require a value. The associated input area is activated when the option is activated. Options preceded by a hash (#) require root privileges. When the "Start nmap" button is pressed, the 'tdesu' facility will be invoked to run nmap as the super user.
		</para>
	</sect1>

	<sect1 id="logging_options">
		<title>Logging Options</title>
		<para>
			<screenshot>
				<mediaobject>
					<imageobject>
						<imagedata fileref="logging_options.png" format="PNG"/>
					</imageobject>
				</mediaobject>
			</screenshot>
	
		This screenshot shows the <computeroutput>nmap</computeroutput> options that relate to logging.
		</para>

		<para>
		&knmap; considers the <computeroutput>--resume</computeroutput> option to be a logging option as its use requires that logging was enabled in the interrupted scan.
		</para>
	</sect1>

	<sect1 id="man_page">
		<title><computeroutput>man</computeroutput> Page</title>
		<para>
			<screenshot>
				<mediaobject>
					<imageobject>
						<imagedata fileref="man_page.png" format="PNG"/>
					</imageobject>
				</mediaobject>
			</screenshot>
	
		&knmap; comes packaged with the <computeroutput>man</computeroutput> page for <computeroutput>nmap</computeroutput>  version 3.93 in HTML format. See the Settings -> <computeroutput>man</computeroutput> page stylesheet... menu option for how to control the appearance of this documentation and the Settings -> Zoom in / out / custom options for controlling the size..
		</para>
	</sect1>

	<sect1 id="ping_and_scan_options">
		<title>Ping and Scan Options</title>
		<para>
			<screenshot>
				<mediaobject>
					<imageobject>
						<imagedata fileref="ping_and_scan_options.png" format="PNG"/>
					</imageobject>
				</mediaobject>
			</screenshot>
	
		This screenshot shows the <computeroutput>nmap</computeroutput> options that control the types of ping and scans that will be performed. Options preceded by a hash (#) require root privileges. When the "Start nmap" button is pressed, the 'tdesu' facility will be invoked to run nmap as the super user.
		</para>
	</sect1>

	<sect1 id="simple_options">
		<title>Simple Options</title>
		<para>
			<screenshot>
				<mediaobject>
					<imageobject>
						<imagedata fileref="simple_options.png" format="PNG"/>
					</imageobject>
				</mediaobject>
			</screenshot>
	
		This screenshot shows the boolean <computeroutput>nmap</computeroutput> options, i.e., those options that do not require a value. Options preceded by a hash (#) require root privileges. When the "Start nmap" button is pressed, the 'tdesu' facility will be invoked to run nmap as the super user.
		</para>
	</sect1>

	<sect1 id="timing_options">
		<title>Timing Options</title>
		<para>
			<screenshot>
				<mediaobject>
					<imageobject>
						<imagedata fileref="timing_options.png" format="PNG"/>
					</imageobject>
				</mediaobject>
			</screenshot>
	
		This screenshot shows the <computeroutput>nmap</computeroutput> options that control the timing of network activity. Note that the <computeroutput>Default</computeroutput> does nothing. It is provided as a means to disable the other timing options.
		</para>
	</sect1>
</chapter>

<chapter id="commands">
	<title>Command Reference</title>
	<sect1 id="knmap_menu_options">
	<title>The &knmap; Menu Options</title>
		<sect2>
			<title>The File Menu</title>
			<para>
			<variablelist>
				<varlistentry>
					<term><menuchoice>
						<shortcut>
							<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
						</shortcut>
						<guimenu>File</guimenu>
						<guimenuitem>Save</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							Saves the current content of the Output Window. Note, however, that all text formatting is lost. If you don't like this - tough. Go tell someone that gives a shit!
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<guimenu>File</guimenu>
						<guimenuitem>Save As...</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							Given the above explanation of what "File -> Save" does, this option should need no further explanation.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<shortcut>
							<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
						</shortcut>
						<guimenu>File</guimenu>
						<guimenuitem>New scan...</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							Creates a new Scan Window. The dialog box shown below will be displayed to allow the name of the scan to be entered. The "Use target host name" option allows the name of the scan to automatically track the target of the nmap scan. If that option is not selected, the name of the scan can be entered in the edit window - which is activated when the "Use target host name" option is unchecked.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<shortcut>
							<keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
						</shortcut>
						<guimenu>File</guimenu>
						<guimenuitem>Duplicate scan</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							As the name imples, the current scan is duplicated. Unusual / unfortunate and / or strange behaviour may / will result if the name of the scan is not changed but a different profile is associated with the duplicated scan (name).
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<shortcut>
							<keycombo action="simul"><keycap>F2</keycap></keycombo>
						</shortcut>
						<guimenu>File</guimenu>
						<guimenuitem>Rename scan...</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							Obvious - but it is also possible to select the "Use target host name" property via this menu item.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<shortcut>
							<keycombo action="simul"><keycap>F2</keycap></keycombo>
						</shortcut>
						<guimenu>File</guimenu>
						<guimenuitem>Use target host name</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							This is a toggle item that causes the name of the scan to automatically track the target of the nmap scan.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<shortcut>
							<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo>
						</shortcut>
						<guimenu>File</guimenu>
						<guimenuitem>Close scan</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							Obvious - but if the profile has been updated you will be asked whether it should be saved.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<shortcut>
							<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
						</shortcut>
						<guimenu>File</guimenu>
						<guimenuitem>Quit</guimenuitem>
					</menuchoice></term>
					<listitem><para><action>Quits</action> &knmap;</para></listitem>
				</varlistentry>
			</variablelist>
			</para>

			<para>
			<screenshot>
				<mediaobject>
					<imageobject>
						<imagedata fileref="new_scan.png" format="PNG"/>
					</imageobject>
				</mediaobject>
			</screenshot>
			</para>
		</sect2>

		<sect2>
			<title>The Profiles Menu</title>
			<para>
			Before launching into the explanation of the items under this menu, it is necessary to define what a "Profile" is.
			</para>

			<para>
			Quite simply, a Profile is the set of values of all the <computeroutput>nmap</computeroutput> options supported by &knmap; and some &knmap;-specific data (e.g., the order of the tabs in the Options Window and the current options tab).
			</para>

			<para>
			The status of the Hide / Show buttons is not saved. All windows are shown on &knmap; startup regrardless of their status at the time a Profile saved.
			</para>

			<para>
			Having the same profile associated with multiple scans is not recommended - unusual / unfortunate and / or strange behaviour may / will result.
			</para>

			<para>
			The following screenshot shows the dialog window that controls all options in this menu.
			<screenshot>
				<mediaobject>
					<imageobject>
						<imagedata fileref="profile_dlg.png" format="PNG"/>
					</imageobject>
				</mediaobject>
			</screenshot>
			The top window is used for the entry of new names for the copy and rename functions. The lower window lists all known profiles. (For the technically minded, the profiles are stored in the standard KDE <computeroutput>knmaprc</computeroutput> configuration file - but with the name "Knmap_&lt;profile name>".)
			</para>

			<para>
			The copy, delete and rename functions available in this menu are also available when a profile name is right-clicked in the list window.
			</para>

			<para>
			<variablelist>
				<varlistentry>
					<term><menuchoice>
						<guimenu>Profiles</guimenu>
						<guimenuitem>Load profile...</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							Equivalent to a "File -> Open" in your favourite editor. If the current profile has been modified you will be asked if you want to save it prior to loading the new profile.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<guimenu>Profiles</guimenu>
						<guimenuitem>Save profile...</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							Equivalent to a "File -> Save" in your favourite editor.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<guimenu>Profiles</guimenu>
						<guimenuitem>Save profile as...</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							Equivilent to a "File -> Save" as in your favourite editor.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<guimenu>Profiles</guimenu>
						<guimenuitem>Copy profile...</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							The selected profile is copied, the name of the new profile is entered in the upper input window.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<guimenu>Profiles</guimenu>
						<guimenuitem>Delete profile...</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							Bloody obvious.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<guimenu>Profiles</guimenu>
						<guimenuitem>Rename profile...</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							The name of the selected profile is changed to the name entered in the upper input window.
							</action>
						</para>
					</listitem>
				</varlistentry>
			</variablelist>
			</para>
		</sect2>

		<sect2>
			<title>The Settings Menu</title>
			<para>
			<variablelist>
				<varlistentry>
					<term><menuchoice>
						<guimenu>Settings</guimenu>
						<guimenuitem>Wrap text</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							Selects whether the nmap output should be word-wrapped at the windows right-border.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<guimenu>Settings</guimenu>
						<guimenuitem>'man' page stylesheet...</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							Allows for the selection of the stylesheet to be used when the nmap man page is displayed.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<guimenu>Settings</guimenu>
						<guimenuitem>Use local 'man' page</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							This is a toggle action, the text changes depending upon its state. If the &knmap; nmap man page is being displayed, this option allows for the >man page stored on the local machine to be displayed. This is useful when the local version of the nmap man page differs from the version distrubuted with &knmap;.
							</action>
						</para>

						<para>
							<action>
							When the local man page is being displayed, this option allows for the &knmap; version to be displayed.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<guimenu>Settings</guimenu>
						<guimenuitem>Zoom in</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							Increases the font size in the man page window by 25% - limits are 20% - 300%.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<guimenu>Settings</guimenu>
						<guimenuitem>Zoom out</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							Decreases the font size in the man page window by 25% - limits are 20% - 300%.
							</action>
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term><menuchoice>
						<guimenu>Settings</guimenu>
						<guimenuitem>Zoom custom</guimenuitem>
					</menuchoice></term>
					<listitem>
						<para>
							<action>
							Allows manual control of the font size - limits are 20% - 300%.
							</action>
						</para>
					</listitem>
				</varlistentry>
			</variablelist>
			</para>

			<para>
			The remaining options in this menu are standard KDE options.
			</para>
		</sect2>

		<sect2>
			<title>The Help Menu</title>
			<para>
			&help.menu.documentation;
			</para>
		</sect2>
	</sect1>
</chapter>

<chapter id="developers">
	<title>Developer's Guide to &knmap;</title>
	<para>
	The only item worthy of mention here is the file <computeroutput>nmap_manpage.html.diff</computeroutput>. This file contains a <computeroutput>diff</computeroutput> of the <computeroutput>nmap</computeroutput> version 3.93 HTML formatted <computeroutput>man</computeroutput> page and that distributed with &knmap;. You can use this to update your version of that <computeroutput>man</computeroutput> page.
	</para>
</chapter>

<chapter id="credits">
	<title>Credits and License</title>
	<para>
	&knmap;
	</para>

	<para>
	Program copyright 2005, 2006 Kevin Gilbert <email>kev.gilbert@cdu.edu.au</email>
	</para>
	
	<para>
	Documentation copyright 2005, 2006 Kevin Gilbert <email>kev.gilbert@cdu.edu.au</email>
	</para>
	
	&underFDL;
	&underGPL;
</chapter>

<appendix id="installation">
	<title>Installation</title>

	<sect1 id="getting-knmap">
	<title>How to obtain &knmap;</title>

	<para>
	Now let me see... You're reading this documentation - which come packaged with &knmap;, which means that you have &knmap; installed, which means that you have somehow obtained &knmap;, and now you want to know how to obtain &knmap;?
	</para>

	<para>
	You have _way_ too much time on your hands! ;-)
	</para>

	<para>
	Okay, Okay. Go to <ulink url="http://sourceforge.net/projects/knmap">http://sourceforge.net/projects/knmap</ulink> and follow the download links.
	</para>
	</sect1>

	<sect1 id="requirements">
		<title>Requirements</title>
		<para>
		&knmap; was developed and tested under Qt 3.3.4 / KDE 3.4 &amp; 3.5. YMMV vary if your configuration differs from this.
		</para>

		<para>
		And, of course, you will need <computeroutput>nmap</computeroutput>. Go to <ulink url="http://www.insecure.org/nmap">http://www.insecure.org/nmap</ulink> for details on how to download <computeroutput>nmap</computeroutput>.
		</para>
	</sect1>

	<sect1 id="compilation">
		<title>Compilation and Installation</title>
		&install.compile.documentation;
	</sect1>
</appendix>

	&documentation.index;
</book>