<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
<html lang="en" style='--code-editor-font: var(--default-mono-font, "GitLab Mono"), JetBrains Mono, Menlo, DejaVu Sans Mono, Liberation Mono, Consolas, Ubuntu Mono, Courier New, andale mono, lucida console, monospace;'>
<head>
<meta content="text/html; charset=US-ASCII" http-equiv="Content-Type">
<title>
GitLab
</title>
<style data-premailer="ignore" type="text/css">
a { color: #1068bf; }
</style>
<style>img {
max-width: 100%; height: auto;
}
body {
font-size: .875rem;
}
body {
-webkit-text-shadow: rgba(255,255,255,.01) 0 0 1px;
}
body {
font-family: var(--default-regular-font, "GitLab Sans"),-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Noto Sans",Ubuntu,Cantarell,"Helvetica Neue",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji"; font-size: inherit;
}
</style>
</head>
<body style='font-size: inherit; -webkit-text-shadow: rgba(255,255,255,.01) 0 0 1px; font-family: var(--default-regular-font, "GitLab Sans"),-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Noto Sans",Ubuntu,Cantarell,"Helvetica Neue",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";'>
<div class="content">
<p class="details" style="font-style: italic; color: #737278;">
<a href="https://gitlab.rtems.org/sebhub">Sebastian Huber</a> created an issue: <a href="https://gitlab.rtems.org/rtems/rtos/rtems/-/issues/5067">#5067</a>
</p>
<p>
Assignee: Sebastian Huber
</p>
<div class="md" style="color: #333238; word-wrap: break-word;">
<h2 dir="auto" style="font-size: 1.5em; font-weight: 600; padding-bottom: .3em; border-bottom-width: 1px; border-bottom-color: #bfbfc3; border-bottom-style: solid; color: #333238; margin: 0 0 16px;" align="initial">
<a href="#summary" aria-hidden="true" class="anchor" id="user-content-summary" style="margin-top: 0; float: left; margin-left: -20px; text-decoration: none; outline: none;"></a>Summary</h2>
<p dir="auto" style="color: #333238; margin: 0 0 16px;" align="initial">The system termination procedure is implemented like this:</p>
<div class="gl-relative markdown-code-block js-markdown-code">
<pre data-canonical-lang="c" class="code highlight js-syntax-highlight language-c" v-pre="true" style='display: block; font-size: 14px; color: #333238; line-height: 1.6em; overflow-x: auto; border-radius: .25rem; position: relative; font-family: var(--default-mono-font, "GitLab Mono"),"JetBrains Mono","Menlo","DejaVu Sans Mono","Liberation Mono","Consolas","Ubuntu Mono","Courier New","andale mono","lucida console",monospace; word-break: break-all; word-wrap: break-word; background-color: #fbfafd; margin: 0 0 16px; padding: 12px; border: 1px solid #dcdcde;'><code style='font-size: inherit; color: inherit; word-wrap: normal; word-break: keep-all; background-color: inherit; border-radius: .25rem; white-space: pre; margin-top: 0; font-family: var(--default-mono-font, "GitLab Mono"),"JetBrains Mono","Menlo","DejaVu Sans Mono","Liberation Mono","Consolas","Ubuntu Mono","Courier New","andale mono","lucida console",monospace; vertical-align: bottom; overflow-wrap: normal; padding: unset;'><span id="LC1" class="line" lang="c" style="margin-top: 0;"><span class="kt" style="margin-top: 0;">void</span> <span class="nf">_Terminate</span><span class="p">(</span></span>
<span id="LC2" class="line" lang="c"> <span class="n" style="margin-top: 0;">Internal_errors_Source</span> <span class="n">the_source</span><span class="p">,</span></span>
<span id="LC3" class="line" lang="c"> <span class="n" style="margin-top: 0;">Internal_errors_t</span> <span class="n">the_error</span></span>
<span id="LC4" class="line" lang="c"><span class="p" style="margin-top: 0;">)</span></span>
<span id="LC5" class="line" lang="c"><span class="p" style="margin-top: 0;">{</span></span>
<span id="LC6" class="line" lang="c"> <span class="n" style="margin-top: 0;">_User_extensions_Fatal</span><span class="p">(</span> <span class="n">the_source</span><span class="p">,</span> <span class="n">the_error</span> <span class="p">);</span></span>
<span id="LC7" class="line" lang="c"> <span class="n" style="margin-top: 0;">_System_state_Set</span><span class="p">(</span> <span class="n">SYSTEM_STATE_TERMINATED</span> <span class="p">);</span></span>
<span id="LC8" class="line" lang="c"> <span class="n" style="margin-top: 0;">_SMP_Request_shutdown</span><span class="p">();</span></span>
<span id="LC9" class="line" lang="c"> <span class="n" style="margin-top: 0;">_CPU_Fatal_halt</span><span class="p">(</span> <span class="n">the_source</span><span class="p">,</span> <span class="n">the_error</span> <span class="p">);</span></span>
<span id="LC10" class="line" lang="c"><span class="p" style="margin-top: 0;">}</span></span></code></pre>
<copy-code></copy-code>
</div>
<p dir="auto" style="color: #333238; margin: 0 0 16px;" align="initial">However, the <code style='font-size: 90%; color: #1f1e24; word-wrap: break-word; background-color: #ececef; border-radius: .25rem; margin-top: 0; font-weight: inherit; font-family: var(--default-mono-font, "GitLab Mono"),"JetBrains Mono","Menlo","DejaVu Sans Mono","Liberation Mono","Consolas","Ubuntu Mono","Courier New","andale mono","lucida console",monospace; vertical-align: bottom; white-space: pre-wrap; overflow-wrap: break-word; word-break: keep-all; padding: 2px 4px;'>_User_extensions_Fatal()</code> should not return for properly configured applications. The <code style='font-size: 90%; color: #1f1e24; word-wrap: break-word; background-color: #ececef; border-radius: .25rem; font-weight: inherit; font-family: var(--default-mono-font, "GitLab Mono"),"JetBrains Mono","Menlo","DejaVu Sans Mono","Liberation Mono","Consolas","Ubuntu Mono","Courier New","andale mono","lucida console",monospace; vertical-align: bottom; white-space: pre-wrap; overflow-wrap: break-word; word-break: keep-all; padding: 2px 4px;'>_Terminate()</code> implementation should be simplified to ease testing and code coverage.</p>
<div class="gl-relative markdown-code-block js-markdown-code" style="margin-bottom: 0;">
<pre data-canonical-lang="c" class="code highlight js-syntax-highlight language-c" v-pre="true" style='display: block; font-size: 14px; color: #333238; line-height: 1.6em; overflow-x: auto; border-radius: .25rem; position: relative; font-family: var(--default-mono-font, "GitLab Mono"),"JetBrains Mono","Menlo","DejaVu Sans Mono","Liberation Mono","Consolas","Ubuntu Mono","Courier New","andale mono","lucida console",monospace; word-break: break-all; word-wrap: break-word; background-color: #fbfafd; margin: 0 0 16px; padding: 12px; border: 1px solid #dcdcde;'><code style='font-size: inherit; color: inherit; word-wrap: normal; word-break: keep-all; background-color: inherit; border-radius: .25rem; white-space: pre; margin-top: 0; font-family: var(--default-mono-font, "GitLab Mono"),"JetBrains Mono","Menlo","DejaVu Sans Mono","Liberation Mono","Consolas","Ubuntu Mono","Courier New","andale mono","lucida console",monospace; vertical-align: bottom; overflow-wrap: normal; padding: unset;'><span id="LC1" class="line" lang="c" style="margin-top: 0;"><span class="kt" style="margin-top: 0;">void</span> <span class="nf">_Terminate</span><span class="p">(</span></span>
<span id="LC2" class="line" lang="c"> <span class="n" style="margin-top: 0;">Internal_errors_Source</span> <span class="n">the_source</span><span class="p">,</span></span>
<span id="LC3" class="line" lang="c"> <span class="n" style="margin-top: 0;">Internal_errors_t</span> <span class="n">the_error</span></span>
<span id="LC4" class="line" lang="c"><span class="p" style="margin-top: 0;">)</span></span>
<span id="LC5" class="line" lang="c"><span class="p" style="margin-top: 0;">{</span></span>
<span id="LC6" class="line" lang="c"> <span class="n" style="margin-top: 0;">_User_extensions_Fatal</span><span class="p">(</span> <span class="n">the_source</span><span class="p">,</span> <span class="n">the_error</span> <span class="p">);</span></span>
<span id="LC7" class="line" lang="c"></span>
<span id="LC8" class="line" lang="c"> <span class="cm" style="margin-top: 0;">/*</span></span>
<span id="LC9" class="line" lang="c"><span class="cm" style="margin-top: 0;"> * Everything after invoking the fatal extensions is essentially dead code.</span></span>
<span id="LC10" class="line" lang="c"><span class="cm" style="margin-top: 0;"> * At least one fatal extension of the initial extension sets should not</span></span>
<span id="LC11" class="line" lang="c"><span class="cm" style="margin-top: 0;"> * return and for example reset the system. See section "System Termination</span></span>
<span id="LC12" class="line" lang="c"><span class="cm" style="margin-top: 0;"> * Procedure" in the RTEMS Classic API Guide.</span></span>
<span id="LC13" class="line" lang="c"><span class="cm" style="margin-top: 0;"> *</span></span>
<span id="LC14" class="line" lang="c"><span class="cm" style="margin-top: 0;"> * The following code is only executed in badly applications.</span></span>
<span id="LC15" class="line" lang="c"><span class="cm" style="margin-top: 0;"> */</span></span>
<span id="LC16" class="line" lang="c"> <span class="n" style="margin-top: 0;">_CPU_Thread_Idle_body</span><span class="p">(</span> <span class="mi">0</span> <span class="p">);</span></span>
<span id="LC17" class="line" lang="c"><span class="p" style="margin-top: 0;">}</span></span></code></pre>
<copy-code></copy-code>
</div>
</div>
</div>
<div class="footer" style="margin-top: 10px;">
<p style="font-size: small; color: #737278;">
—
<br>
<a href="https://gitlab.rtems.org/rtems/rtos/rtems/-/issues/5067">View it on GitLab</a>.
<br>
You're receiving this email because of your account on <a target="_blank" rel="noopener noreferrer" href="https://gitlab.rtems.org">gitlab.rtems.org</a>. <a href="https://gitlab.rtems.org/-/sent_notifications/fbc9fff9e1fe8cebe53d26bf42ec22cb/unsubscribe" target="_blank" rel="noopener noreferrer">Unsubscribe</a> from this thread · <a href="https://gitlab.rtems.org/-/profile/notifications" target="_blank" rel="noopener noreferrer" class="mng-notif-link">Manage all notifications</a> · <a href="https://gitlab.rtems.org/help" target="_blank" rel="noopener noreferrer" class="help-link">Help</a>
<script type="application/ld+json">{"@context":"http://schema.org","@type":"EmailMessage","action":{"@type":"ViewAction","name":"View Issue","url":"https://gitlab.rtems.org/rtems/rtos/rtems/-/issues/5067"}}</script>
</p>
</div>
</body>
</html>