This commit is contained in:
Liam Waldron 2024-12-15 11:57:40 -05:00
parent f7cb8fe6cf
commit 3b1b0464be
2 changed files with 46 additions and 18 deletions

View File

@ -100,7 +100,7 @@ html {
border-radius: 2px; border-radius: 2px;
padding: 4px; padding: 4px;
width: 50%; width: 50%;
color: #2E3440; color: #D8DEE9;
} }
.news { .news {
@ -181,7 +181,7 @@ warnhead {
border-radius: 2px; border-radius: 2px;
padding: 6px; padding: 6px;
width: 50%; width: 50%;
color: #2E3440; color: #D8DEE9;
} }
newshead { newshead {
@ -395,7 +395,13 @@ body, html {
hr { hr {
color: #88c0d0; color: #88c0d0;
height: 20px; width: 50%;
width: 0px; border-width: 4px;
border-width: 0px; border-radius: 5px;
margin-left: 0;
}
.tab {
display: inline-block;
margin-left: 80px;
} }

View File

@ -59,15 +59,16 @@
<p>#include &lt;glacier_log.h&gt;</p> <p>#include &lt;glacier_log.h&gt;</p>
<p>#include &lt;glacier_pkgops.h&gt;</p> <p>#include &lt;glacier_pkgops.h&gt;</p>
<p>#include &lt;glacier_runtime.h&gt;</p> <p>#include &lt;glacier_runtime.h&gt;</p>
<p>#include &lt;glacier_security.h&gt;</p>
</div> </div>
<p></p> <p></p>
<p>To compile <cil>libglacier</cil> into your program, add the following compile flag:</p> <p>To compile <cil>libglacier</cil> into your program, add the flag <cil>-lglacier</cil> to your build process.</p>
<p><code>-lconfig</code></p> <p><code>$ gcc program.c -lglacier -o program</code></p>
<p></p> <p></p>
<h2>4 - Configuration Functions</h2> <h2>4 - Configuration Functions</h2>
<p><cil>libglacier</cil> supplies functions for parsing and getting values from libconfig-syntax configuration files. While only three are present, more are planned for the future.</p> <p><cil>libglacier</cil> supplies functions for parsing and getting values from libconfig-syntax configuration files. While only three are present, more are planned for the future.</p>
<p><strong>4.1</strong> init_config</p> <p><strong>4.1</strong> init_config</p>
<p><cil>init_config<cil> initializes the libconfig library, and allows configuration files to be parsed.</p> <p><cil>init_config</cil> initializes the libconfig library, and allows configuration files to be parsed.</p>
<p>No parameters are accepted by <cil>init_config</cil>.</p> <p>No parameters are accepted by <cil>init_config</cil>.</p>
<bigcodehead><strong>CODE:</strong> init_config used in a program</bigcodehead> <bigcodehead><strong>CODE:</strong> init_config used in a program</bigcodehead>
<div class="bigcode"> <div class="bigcode">
@ -76,11 +77,17 @@
<p>int</p> <p>int</p>
<p>main()</p> <p>main()</p>
<p>{</p> <p>{</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;init_config();</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (init_config() != 0) {</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;errlog("failed to initialize libconfig");
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return(EXIT_FAILURE);</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else {</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;successlog("Initialized libconfig");
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}
<p>}</p> <p>}</p>
</div> </div>
<p><cil>init_config</cil> returns 0 on success, and 1 on failure.</p> <p><cil>init_config</cil> returns 0 on success, and 1 on failure.</p>
<p></p> <hr>
<p><strong>4.2</strong> die_config</p> <p><strong>4.2</strong> die_config</p>
<p><cil>die_config</cil> unloads the libconfig library. You should always run this when you're finished with libconfig in order to free memory.</p> <p><cil>die_config</cil> unloads the libconfig library. You should always run this when you're finished with libconfig in order to free memory.</p>
<p>No parameters are accepted by <cil>die_config</cil>.</p> <p>No parameters are accepted by <cil>die_config</cil>.</p>
@ -140,9 +147,9 @@
<p>int</p> <p>int</p>
<p>main()</p> <p>main()</p>
<p>{</p> <p>{</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;struct node pack = create_node("pack"); <p><span class="tab"></span>struct node pack = create_node("pack");
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;struct node dep1 = create_node("dep1"); <p><span class="tab"></span>struct node dep1 = create_node("dep1");
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;add_child(pack, dep1);</p> <p><span class="tab"></span>add_child(pack, dep1);</p>
<p>}</p> <p>}</p>
</div> </div>
<p><strong>5.3</strong> print_tree</p> <p><strong>5.3</strong> print_tree</p>
@ -159,12 +166,27 @@
<p>int</p> <p>int</p>
<p>main()</p> <p>main()</p>
<p>{</p> <p>{</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;struct node pack = create_node("pack");</p> <p><span class="tab"></span>struct node pack = create_node("pack");</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;struct node dep1 = create_node("dep1");</p> <p><span class="tab"></span>struct node dep1 = create_node("dep1");</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;add_child(pack, dep1);</p> <p><span class="tab"></span>add_child(pack, dep1);</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print_tree(pack, 0);</p> <p><span class="tab"></span>print_tree(pack, 0);</p>
<p>}</p> <p>}</p>
</div> </div>
<p><strong>5.4</strong> init_queue</p>
<p><cil>init_queue</cil> initializes a queue data structure.</p>
<p><cil>init_queue</cil> accepts the following parameters:</p>
<ul>
<li><p><cil>queue *q</cil> (the name of the queue to initialize</p></li>
</ul>
<bigcodehead><strong>CODE:</strong> init_queue used in a program</bigcodehead>
<div class="bigcode">
<p>#include &lt;glacier_data.h&gt;</p>
<p>&nbsp;</p>
<p>int</p>
<p>main()</p>
<p>{</p>
<p><span class="tab"></span>hi</p>
</div>
<p></p> <p></p>
<h2>6 - Logging Functions</h2> <h2>6 - Logging Functions</h2>
<p>The logging functions <cil>libglacier</cil> provides are designed to allow a uniform style of output. </p> <p>The logging functions <cil>libglacier</cil> provides are designed to allow a uniform style of output. </p>
@ -256,7 +278,7 @@
<li><p>0 on success</p></li> <li><p>0 on success</p></li>
<li><p>1 on failure</p></li> <li><p>1 on failure</p></li>
</ul> </ul>
<bigcodehad><strong>CODE:</strong> run_make_task used in a program</bigcodehead> <bigcodehead><strong>CODE:</strong> run_make_task used in a program</bigcodehead>
<div class="bigcode"> <div class="bigcode">
<p>#include &lt;glacier_pkgops.h&gt;</p> <p>#include &lt;glacier_pkgops.h&gt;</p>
<p>&nbsp;</p> <p>&nbsp;</p>