WebSVN – HelenOS-doc – Diff – /usrman/trunk/running/running.tex

 for applications, console 12 is reserved for kernel console. Pressing
 function keys F1-F12 switches between the consoles.
 \section{KConsole}
 KConsole is a kernel thread operating completely in priviledged mode.
-It allows user to interact directly with kernel and even start directly
+It allows user to interact directly with the kernel and even start directly
 functions inside the kernel.
 The KConsole is shown by switching to console number 12. On some platforms
 the kconsole screen is not restored to its previous contents. Press
 enter to see a KConsole prompt. The function keys for switching terminals
-do not work in KConsole, if you want to switch back to other console, use
+do not work in KConsole, to switch back to other console, use
 the {\em continue} command. After executing the command, press a function key
 to switch to other consoles.
 The basic editing facilities are very similar to {\em readline} conventions.
 The left and right arrows, backspace and delete keys allow for convenient
 using up and down arrows. KConsole supports tab completion, double tab
 shows a list of available commands.
 The first class of commands prints useful statistics from the running
 operating systems. The commands are:
+\begin{description}
-- zones - Prints a list of memory zones.
+\item[zones] --- Prints a list of memory zones.
-- zone <zone number> - Prints a detailed statistics about frame allocator.
+\item[zone $<$zone number$>$] --- Prints a detailed statistics about frame allocator.
-- slabs - Prints a details statistics about slab allocator.
+\item[slabs] --- Prints a details statistics about slab allocator.
-- scheduler - Prints scheduler queues on all cpus.
+\item[scheduler] --- Prints scheduler queues on all cpus.
-- threads - Prints list of existing threads, including information about
+\item[threads] --- Prints list of existing threads, including information about
-the thread state/
+the thread state
-- tasks - Prints list of tasks along with some basic IPC informations.
+\item[tasks] --- Prints list of tasks along with some basic IPC informations.
-- ipc_tasks - Prints detailed information about IPC queues of a particular task.
+\item[ipc\_task $<$taskid$>$] --- Prints detailed information about IPC queues of a particular task.
-- tlb - Prints contents of the Translation Lookaside Buffer on a processor (supported only on some platforms)
+\item[tlb] --- Prints contents of the Translation Lookaside Buffer on a processor (supported only on some platforms)
-- exc - Prints table of registered exception handlers
+\item[exc] --- Prints table of registered exception handlers
+\end{description}
 Kernel contains a searchable version of its symbol table. This is used
 in error processing as well as for extending functionality of KConsole.
 The following commands are supported:
+\begin{description}
-- symaddr <address> - Finds an address in symbol table and prints appropriate
+\item[symaddr $<$address$>$] --- Finds an address in symbol table and prints appropriate
 symbol name.
-- call0, call1... <function> <args...> - Calls a C function function(args...).
+\item[call0, call1... $<$function$>$ $<$args...$>$] --- Calls a C function function(args...).
 Note that the tab-completion works for the function names. Because
 of architecture calling convention, this command does not work correctly
 on the ia64 platform. The arguments can be specified
+ \begin{itemize}
-  - as a number or hexadecimal number: call1 task_kill 8
+  \item as a number or hexadecimal number: call1 task\_kill 8
-  - as a string: call1 printf "Hello world"
+  \item as a string: call1 printf "Hello world"
-  - as a hexadecimal number preceded by '*'. The argument is then read from
+  \item as a hexadecimal number preceded by '*'. The argument is then read from
 the given address: call2 printf "%X" *0x8000000
-  - as a symbol name. In such case the value located in the memory
+  \item as a symbol name. In such case the value located in the memory
     in the symbols address is used: call2 printf "%d" task_counter
-  - as a symbol name preceded by '&'. The address is used.
+  \item as a symbol name preceded by '\&'. The address is used.
-  - as a symbol name preceded by '*'. In such a case the symbol is dereferenced.
+  \item as a symbol name preceded by '*'. In such a case the symbol is dereferenced.
+ \end{itemize}
-- set4 <address|symbol name> - Saves 4-byte value on a given address.
+\item[set4 <address|symbol name>] --- Saves 4-byte value on a given address.
+\end{description}
 The mips, ia32 and amd64 platforms provide additional commands regarding
 debugging facility - set and clear hardware breakpoints and watchpoints.
 \section{Emergency Functions}
 If a kernel panic occurs, the error handling automatially switches control
 to the KConsole and allows users to inspect the failed kernel online.
 On the SMP system the other processors are halted immediately. The kernel
 contains its symbol table, so you can probably read some useful information
-about the exact place where the panic occured.
 about the exact place where the panic occured.

Subversion Repositories HelenOS-doc

(root)/usrman/trunk/running/running.tex – Rev 143 → 144