proc.c File Reference

Simple cooperative multitasking scheduler. More...

#include "proc_p.h"
#include "proc.h"
#include "cfg/cfg_proc.h"
#include <cfg/log.h>
#include "cfg/cfg_arch.h"
#include "cfg/cfg_monitor.h"
#include <cfg/macros.h>
#include <cfg/module.h>
#include <cfg/depend.h>
#include <cpu/irq.h>
#include <cpu/types.h>
#include <cpu/attr.h>
#include <cpu/frame.h>
#include <string.h>

Go to the source code of this file.

Functions
void	proc_init (void)
	Initialize the process subsystem (kernel).
struct Process *	proc_new_with_name (UNUSED_ARG(const char *, name), void(*entry)(void), iptr_t data, size_t stack_size, cpu_stack_t *stack_base)
	Create a new process, starting at the provided entry point.
const char *	proc_name (struct Process *proc)
	Return the name of the specified process.
const char *	proc_currentName (void)
	Return the name of the currently running process.
void	proc_rename (struct Process *proc, const char *name)
	Rename a process.
void	proc_setPri (struct Process *proc, int pri)
	Change the scheduling priority of a process.
void	proc_exit (void)
	Terminate the current process.
iptr_t	proc_currentUserData (void)
	Get the pointer to the user data of the current process.
Variables
REGISTER List	ProcReadyList
	Track ready processes.
REGISTER Process *	CurrentProcess
	Track running processes.
struct Process	MainProcess
	The main process (the one that executes main()).

---

Detailed Description

Simple cooperative multitasking scheduler.

Version:

Id

proc.c 2953 2009-09-16 13:51:30Z lottaviano

Author:

Bernie Innocenti <bernie@codewiz.org>

Stefano Fedrigo <aleph@develer.com>

Definition in file proc.c.

---

Function Documentation

iptr_t proc_currentUserData

(

void

)

Get the pointer to the user data of the current process.

Return a pointer to the user data of the current process.

Definition at line 382 of file proc.c.

void proc_exit

(

void

)

Terminate the current process.

Terminate the execution of the current process.

Definition at line 341 of file proc.c.

void proc_init

(

void

)

Initialize the process subsystem (kernel).

It must be called before using any process related function.

Definition at line 120 of file proc.c.

const char* proc_name

(

struct Process *

proc

)

Return the name of the specified process.

NULL is a legal argument and will return the name "<NULL>".

Definition at line 275 of file proc.c.

struct Process* proc_new_with_name	(	UNUSED_ARG(const char *, name)	,
		void(*)(void)	entry,
		iptr_t	data,
		size_t	stack_size,
		cpu_stack_t *	stack_base
	)			[read]

Create a new process, starting at the provided entry point.

Note:

The function

 proc_new(entry, data, stacksize, stack)

is a more convenient way to create a process, as you don't have to specify the name.

Returns:

Process structure of new created process if successful, NULL otherwise.

Definition at line 164 of file proc.c.

void proc_setPri	(	struct Process *	proc,
		int	pri
	)

Change the scheduling priority of a process.

Process piorities are signed ints, whereas a larger integer value means higher scheduling priority. The default priority for new processes is 0. The idle process runs with the lowest possible priority: INT_MIN.

A process with a higher priority always preempts lower priority processes. Processes of equal priority share the CPU time according to a simple round-robin policy.

As a general rule to maximize responsiveness, compute-bound processes should be assigned negative priorities and tight, interactive processes should be assigned positive priorities.

To avoid interfering with system background activities such as input processing, application processes should remain within the range -10 and +10.

Definition at line 322 of file proc.c.

---

Variable Documentation

REGISTER Process* CurrentProcess

Track running processes.

Definition at line 78 of file proc.c.

struct Process MainProcess

The main process (the one that executes main()).

Definition at line 95 of file proc.c.

REGISTER List ProcReadyList

Track ready processes.

Access to this list must be performed with interrupts disabled

Definition at line 71 of file proc.c.