<!DOCTYPE html><htmllang="en"><head><metacharset="utf-8"><metaname="viewport"content="width=device-width, initial-scale=1.0"><metaname="generator"content="rustdoc"><metaname="description"content="Task management implementation"><metaname="keywords"content="rust, rustlang, rust-lang, task"><title>os::task - Rust</title><linkrel="preload"as="font"type="font/woff2"crossoriginhref="../../SourceSerif4-Regular.ttf.woff2"><linkrel="preload"as="font"type="font/woff2"crossoriginhref="../../FiraSans-Regular.woff2"><linkrel="preload"as="font"type="font/woff2"crossoriginhref="../../FiraSans-Medium.woff2"><linkrel="preload"as="font"type="font/woff2"crossoriginhref="../../SourceCodePro-Regular.ttf.woff2"><linkrel="preload"as="font"type="font/woff2"crossoriginhref="../../SourceSerif4-Bold.ttf.woff2"><linkrel="preload"as="font"type="font/woff2"crossoriginhref="../../SourceCodePro-Semibold.ttf.woff2"><linkrel="stylesheet"type="text/css"href="../../normalize.css"><linkrel="stylesheet"type="text/css"href="../../rustdoc.css"id="mainThemeStyle"><linkrel="stylesheet"type="text/css"href="../../ayu.css"disabled><linkrel="stylesheet"type="text/css"href="../../dark.css"disabled><linkrel="stylesheet"type="text/css"href="../../light.css"id="themeStyle"><scriptid="default-settings"></script><scriptsrc="../../storage.js"></script><scriptdefersrc="../../main.js"></script><noscript><linkrel="stylesheet"href="../../noscript.css"></noscript><linkrel="alternate icon"type="image/png"href="../../favicon-16x16.png"><linkrel="alternate icon"type="image/png"href="../../favicon-32x32.png"><linkrel="icon"type="image/svg+xml"href="../../favicon.svg"></head><bodyclass="rustdoc mod"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><navclass="mobile-topbar"><buttonclass="sidebar-menu-toggle">☰</button><aclass="sidebar-logo"href="../../os/index.html"><divclass="logo-container"><imgclass="rust-logo"src="../../rust-logo.svg"alt="logo"></div></a><h2class="location"></h2></nav><navclass="sidebar"><aclass="sidebar-logo"href="../../os/index.html"><divclass="logo-container"><imgclass="rust-logo"src="../../rust-logo.svg"alt="logo"></div></a><h2class="location"><ahref="#">Module task</a></h2><divclass="sidebar-elems"><section><divclass="block"><ul><li><ahref="#modules">Modules</a></li><li><ahref="#structs">Structs</a></li><li><ahref="#functions">Functions</a></li></ul></div></section></div></nav><main><divclass="width-limiter"><divclass="sub-container"><aclass="sub-logo-container"href="../../os/index.html"><imgclass="rust-logo"src="../../rust-logo.svg"alt="logo"></a><navclass="sub"><formclass="search-form"><divclass="search-container"><span></span><inputclass="search-input"name="search"autocomplete="off"spellcheck="false"placeholder="Click or press ‘S’ to search, ‘?’ for more options…"type="search"><divid="help-button"title="help"tabindex="-1"><buttontype="button">?</button></div><divid="settings-menu"tabindex="-1"><ahref="../../settings.html"title="settings"><imgwidth="22"height="22"alt="Change settings"src="../../wheel.svg"></a></div></div></form></nav></div><sectionid="main-content"class="content"><divclass="main-heading"><h1class="fqn"><spanclass="in-band">Module <ahref="../index.html">os</a>::<wbr><aclass="mod"href="#">task</a><buttonid="copy-path"onclick="copy_path(this)"title="Copy item path to clipboard"><imgsrc="../../clipboard.svg"width="19"height="18"alt="Copy item path"></button></span></h1><spanclass="out-of-band"><aclass="srclink"href="../../src/os/task/mod.rs.html#1-206">source</a> · <aid="toggle-all-docs"href="javascript:void(0)"title="collapse all docs">[<spanclass="inner">−</span>]</a></span></div><detailsclass="rustdoc-toggle top-doc"open><summaryclass="hideme"><span>Expand description</span></summary><divclass="docblock"><p>Task management implementation</p>
<p>Everything about task management, like starting and switching tasks is
implemented here.</p>
<p>A single global instance of <ahref="struct.TaskManager.html"title="TaskManager"><code>TaskManager</code></a> called <code>TASK_MANAGER</code> controls
all the tasks in the operating system.</p>
<p>Be careful when you see <code>__switch</code> ASM function in <code>switch.S</code>. Control flow around this function
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="mod"href="switch/index.html"title="os::task::switch mod">switch</a><spantitle="Restricted Visibility"> 🔒</span></div><divclass="item-right docblock-short"><p>Rust wrapper around <code>__switch</code>.</p>
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="mod"href="task/index.html"title="os::task::task mod">task</a><spantitle="Restricted Visibility"> 🔒</span></div><divclass="item-right docblock-short"><p>Types related to task management</p>
</div></div></div><h2id="structs"class="small-section-header"><ahref="#structs">Structs</a></h2><divclass="item-table"><divclass="item-row"><divclass="item-left module-item"><aclass="struct"href="struct.TASK_MANAGER.html"title="os::task::TASK_MANAGER struct">TASK_MANAGER</a></div><divclass="item-right docblock-short"><p>a <code>TaskManager</code> global instance through lazy_static!</p>
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="struct"href="struct.TaskContext.html"title="os::task::TaskContext struct">TaskContext</a></div><divclass="item-right docblock-short"><p>task context structure containing some registers</p>
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="struct"href="struct.TaskManager.html"title="os::task::TaskManager struct">TaskManager</a></div><divclass="item-right docblock-short"><p>The task manager, where all the tasks are managed.</p>
</div></div></div><h2id="functions"class="small-section-header"><ahref="#functions">Functions</a></h2><divclass="item-table"><divclass="item-row"><divclass="item-left module-item"><aclass="fn"href="fn.change_program_brk.html"title="os::task::change_program_brk fn">change_program_brk</a></div><divclass="item-right docblock-short"><p>Change the current ‘Running’ task’s program break</p>
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="fn"href="fn.current_trap_cx.html"title="os::task::current_trap_cx fn">current_trap_cx</a></div><divclass="item-right docblock-short"><p>Get the current ‘Running’ task’s trap contexts.</p>
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="fn"href="fn.current_user_token.html"title="os::task::current_user_token fn">current_user_token</a></div><divclass="item-right docblock-short"><p>Get the current ‘Running’ task’s token.</p>
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="fn"href="fn.exit_current_and_run_next.html"title="os::task::exit_current_and_run_next fn">exit_current_and_run_next</a></div><divclass="item-right docblock-short"><p>Exit the current ‘Running’ task and run the next task in task list.</p>
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="fn"href="fn.mark_current_exited.html"title="os::task::mark_current_exited fn">mark_current_exited</a><spantitle="Restricted Visibility"> 🔒</span></div><divclass="item-right docblock-short"><p>Change the status of current <code>Running</code> task into <code>Exited</code>.</p>
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="fn"href="fn.mark_current_suspended.html"title="os::task::mark_current_suspended fn">mark_current_suspended</a><spantitle="Restricted Visibility"> 🔒</span></div><divclass="item-right docblock-short"><p>Change the status of current <code>Running</code> task into <code>Ready</code>.</p>
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="fn"href="fn.run_first_task.html"title="os::task::run_first_task fn">run_first_task</a></div><divclass="item-right docblock-short"><p>Run the first task in task list.</p>
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="fn"href="fn.run_next_task.html"title="os::task::run_next_task fn">run_next_task</a><spantitle="Restricted Visibility"> 🔒</span></div><divclass="item-right docblock-short"><p>Switch current <code>Running</code> task to the task we have found,
or there is no <code>Ready</code> task and we can exit with all applications completed</p>
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="fn"href="fn.suspend_current_and_run_next.html"title="os::task::suspend_current_and_run_next fn">suspend_current_and_run_next</a></div><divclass="item-right docblock-short"><p>Suspend the current ‘Running’ task and run the next task in task list.</p>
