====   ====
  	       ||    //
	       ||  //		
	       ||//	      ====	  //\\  //\\  //\\
	       ||\\ 	       ||        |    ||    ||    |
	       ||  \\	       ||	||    ||    ||    ||
	       ||    \\	       ||	||    ||    ||    ||
              ====   ====     ====     ====  ====  ====  ==== 

========== Help contents: ==========

• descriptions
• version and dependency
• command-line options
• key bar
• keys
• menu
• Data:
  • infoline
  • fields descriptions
  • system informations
• license (GNU)
• kim's home page
• bugs
• author

DESCRIPTION:

The Kim is interactive user friendly process manager for OS Linux. It reads the /proc(5) directory. The '/proc' is a pseudo-filesystem which is used as an interface to kernel data structures.

VERSION & DEPENDENCY:

The Kim is independent on other program, but all version depend on libproc. Libproc is distribution with (or in) 'procps' package.

COMMAND-LINE OPTIONS:

-a, --noline use of +, -, | for line drawing

-b, --nocolor black & white mode

-h, --help this help

-k, --force-key force key

-t, --tree display in tree mode

-v, --version program version

-y, --your display your processes only

--dir=(path) config directory (default is '$HOME/.kim/')

--from=(file) load process information from file

--out=(file) output (save) process information to file

--ascii=(file) export process information to ascii file

--helper=(path) help HTML viewer (default: lynx)

KEY BAR:

F1 Help   This help.

F2 Tree   Switch between Tree / List mode. Tree mode display tree of process (from relation: parent (PPID) --> child (PID)). If the Kim is in the tree mode, menu 'User filter' is not accessible.

F3 (^m) More   Show all accessible informations about process.

F4 Maps   Maps is the /proc/#pid#/maps viewer. A file maps containing the currently mapped memory regions and their access permissions. For more details see to the proc(5).

F5 Reload   Allow you reload all process data and redraw screen.

F6 Your   Switch between Your / All process. Your process - have your UID.

F7 ('/') Search   Search string in first column (field) and marking found process.

F8 Signal   Allow you select and send signal to (one or all selected) process. After it is automatic reload.

F9 Menu   Open the Kim menu.

F10 Quit  Quit of the Kim.

KEYS:

--> Default keys:

pattern: key - [alternative key]

		UP		- ^p
		DOWN		- ^n,
		LEFT		- ^l,
		RIGHT		- ^r,
		
		DEL		- ^d, 
		HOME		- ^h, 
		END		- ^e, 
		INSERT		- ^i, 
		PPAGE		- ^u
		NPAGE		- ^v
		
		F1		- ESC+1
		F2		- ESC+2
		F3		- ESC+3
		F4		- ESC+4
		F5		- ESC+5
		F6		- ESC+6
		F7		- ESC+7
		F8		- ESC+8
		F9		- ESC+9
		F10		- ESC+0		
	

F9 MENU:

-- First: --

Allow you to set a first column. You can choose the column from all columns in the actual profile. The first column is searchable if you press F7 (or '/'). If you want to original profile's columns, you must refresh it in the menu 'profile'.

-- Command: --

• Sort:

  Here you can change the current sort mode. Note: the naturally sort is sort accord with processes in the '/proc' directory.

• User filter:

  Allow you to select which user's process display.

• Save proc:

  Allow you to set current displayed proc information to file (in kim's format).

• Load proc from file:

  Allow you to load proc information from file (in kim's format).

• Load proc from proc:

  Load next proc information from naturally /proc directory. Previous proc information stay in buffer - switch between old and new (or other) data is in the View menu.

• Export to ASCII:

  Save processes information to ASCII (humane readalble) file.

--- Profile: ---

Allow you to switch between your saved profile. The profile with '< >' (setting key is: space) is default profile (used after start) and profile with '*' (setting key: Enter) is the current profile.

--- Options: ---

(see the menu for more details :-)))

• Profile editor
• Delete profile
• Learn key
• Delete learned key
• Configure

INFOLINE:

Infoline is between blue screen and key bar. Allow show this information:

CMDLINE - process command line.

UPTIME - actual uptime of the system.

MEMORY - actual used memory in the system.

--> In menu 'options / configure' you can choose between CMDLINE, UPTIME or MEMORY.

For more details see the SYSTEM INFORMATION part in this help.

				       
	NAME       	basename of executable file in call to exec(2)
	STAT	   	process state (S=sleepingZ=zombieR=running,D,T)
	TTY        	name of controlling tty device
	CMDLINE    	process command line
	PID        	process id
	PPID       	parent PID
	PGRP	   	process group id
	SESSION    	session id
	DEVNUM     	full device number of controlling terminal
	TPGID      	terminal process group id
	START	   	start time of process
	ETIME      	elapsed time from start to current time
	UID        	user effective ids
	USER	   	user name corresponding to effective uid
	%MEM       	%MEM usage of total system memory
	SIZE	   	kB total of memory
	RSS	   	kB/pages memory resident set size
	RSS_RLIM   	current limit in bytes on the RSS of the process
	RESIDENT   	kB/pages non-swapped menory size
	SHARE	   	kB/pages number of shared (mmap'd memory)
	DT     	   	kB/pages dirty memory
	TRS 	   	kB/pages text resident memory
	LRS 	   	kB/pages shared-lib (not usable for ELF)
	DRS 	   	kB/pages data resident memory
	SWAP       	kB/pages on swap device
	MINFLT     	number of minor page faults since process start
	MAJFLT     	number of major page faults since process start
	CMINFLT    	cumulative MIN_FLT of process and child process
	CMAJFLT    	cumulative MAX_FLT of process and child process
	%CPU       	%CPU usage
	PRIORITY   	kernel scheduling priority
	NICE	   	standard unix nice level of process
	TIMEOUT    	???
	TIME       	UTIME+STIME - compatible with TIME in ps(1)
	CTIME      	cumulative TIME
	FLAGS	   	kernel flags for the process
	START_CODE 	the address above which program text can run
	END_CODE   	the address below which program text can run
	START_STACK 	the address of the start of the stack
	KSTK_ESP    	the current ESP (32-bit stack pointer
	KSTK_EIP    	the current EIP (32-bit instruction pointer
	WCHAN	    	kernel function where the process waiting
	SIGNAL     	mask of pending signals
	BLOCKED    	mask of blocked signal
	IGNORED    	mask of ignored signal
	CATCHED    	mask of caugth signal
	ALARM      	the time before the next SIGALARM