kernel.h File Reference

The base include file for the XINU kernel. More...

#include <conf.h>
#include <stddef.h>

Include dependency graph for kernel.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
int	nulluser (void)
	Intializes the system and becomes the null thread.
syscall	kprintf (char *fmt,...)
	kprintf - kernel printf: formatted, unbuffered output to CONSOLE
syscall	kputc (device *, uchar)
	kputc - perform a synchronous kernel write to the console tty
syscall	kgetc (device *)
	kgetc - perform a synchronous kernel read from the console tty

---

Detailed Description

The base include file for the XINU kernel.

Defines symbolic constants, universal return constants, intialization constants, machine size definitions, inline utility functions, and include types

Id

kernel.h 1447 2008-08-12 19:23:34Z mschul

Definition in file kernel.h.

---

Function Documentation

syscall kgetc

(

device *

pdev

)

kgetc - perform a synchronous kernel read from the console tty

Parameters:

	*pdev	pointer to device on which to write character
	c	character to write

Returns:

c on success, SYSERR on failure

Definition at line 56 of file kprintf.c.

References uart_csreg::ier, uart_csreg::lsr, NULL, SYSERR, and UART_LSR_DR.

syscall kprintf	(	char *	fmt,
			...
	)

kprintf - kernel printf: formatted, unbuffered output to CONSOLE

Parameters:

*fmt

pointer to string being printed

Returns:

OK on success

Definition at line 86 of file kprintf.c.

References _doprnt(), kputc(), and OK.

Referenced by allocRxBuffer(), backplaneInit(), dispatch(), etherControl(), etherInit(), exception(), libq_printqueue(), nulluser(), waitOnBit(), and xdone().

Here is the call graph for this function:

Here is the caller graph for this function:

syscall kputc	(	device *	pdev,
		unsigned char	c
	)

kputc - perform a synchronous kernel write to the console tty

Parameters:

	*pdev	pointer to device on which to write character
	c	character to write

Returns:

c on success, SYSERR on failure

Definition at line 21 of file kprintf.c.

References uart_csreg::ier, uart_csreg::lsr, NULL, SYSERR, and UART_LSR_TEMT.

Referenced by kprintf().

Here is the caller graph for this function:

int nulluser

(

void

)

Intializes the system and becomes the null thread.

This is where the system begins after the C environment has been established. Interrupts are initially DISABLED, and must eventually be enabled explicitly. This routine turns itself into the null thread after initialization. Because the null thread must always remain ready to run, it cannot execute code that might cause it to be suspended, wait for a semaphore, or put to sleep, or exit. In particular, it must not do I/O unless it uses kprintf for synchronous output.

Definition at line 65 of file initialize.c.

References _end, _start, backplaneInit(), create(), enable, INITPRIO, INITSTK, kprintf(), KSEG0_BASE, memheap, NULL, open(), pause(), platforminit(), ready(), RESCHED_YES, sysinit(), and TRUE.

Here is the call graph for this function: