haiku-website/static/legacy-docs/bebook/TheStorageKit_Functions_Ove...

28 lines
5.5 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>The Be Book - System Overview - The Storage Kit</title><link rel="stylesheet" href="be_book.css" type="text/css" media="all" /><link rel="shortcut icon" type="image/vnd.microsoft.icon" href="./images/favicon.ico" /><!--[if IE]>
<link rel="stylesheet" type="text/css" href="be_book_ie.css" />
<![endif]--><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><meta name="keywords" content="Access, BeOS, BeBook, API" /><link rel="start" href="index.html" title="The Be Book" /><link rel="up" href="TheStorageKit_Overview.html" title="The Storage Kit" /><link rel="prev" href="BVolumeRoster_Overview.html" title="BVolumeRoster" /><link rel="next" href="AttributeFunctions_Overview.html" title="Attribute Functions" /></head><body><div id="header"><div id="headerT"><div id="headerTL"><a accesskey="p" href="BVolumeRoster_Overview.html" title="BVolumeRoster"><img src="./images/navigation/prev.png" alt="Prev" /></a> <a accesskey="u" href="TheStorageKit_Overview.html" title="The Storage Kit"><img src="./images/navigation/up.png" alt="Up" /></a> <a accesskey="n" href="AttributeFunctions_Overview.html" title="Attribute Functions"><img src="./images/navigation/next.png" alt="Next" /></a></div><div id="headerTR"><div id="navigpeople"><a href="http://www.haiku-os.org"><img src="./images/People_24.png" alt="haiku-os.org" title="Visit The Haiku Website" /></a></div><div class="navighome" title="Home"><a accesskey="h" href="index.html"><img src="./images/navigation/home.png" alt="Home" /></a></div><div class="navigboxed" id="navigindex"><a accesskey="i" href="ClassIndex.html" title="Index">I</a></div><div class="navigboxed" id="naviglang" title="English">en</div></div><div id="headerTC">The Be Book - System Overview - The Storage Kit</div></div><div id="headerB">Prev: <a href="BVolumeRoster_Overview.html">BVolumeRoster</a>  Up: <a href="TheStorageKit_Overview.html">The Storage Kit</a>  Next: <a href="AttributeFunctions_Overview.html">Attribute Functions</a></div><hr /></div><div class="section"><div xmlns="" xmlns:d="http://docbook.org/ns/docbook" class="titlepage"><div><div xmlns:d="http://docbook.org/ns/docbook"><h2 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="TheStorageKit_Functions_Overview"></a>Functions</h2></div></div></div><p>
The next four sections document the straight C interface to attributes,
indices, queries, and file system information. Technically, these
functions are part of the Kernel Kit—their definitions live in
header files in be/kernel, and their code is in
<code class="filename">libroot.so</code>.
</p><p>
These functions use a global error variable (an integer), called <code class="varname">errno</code>,
to register errors. You can look at the <code class="varname">errno</code> value directly in your code
after a file system function fails. Alternatively, you can use the
<code class="function">errno()</code> function which prints, to standard error, its argument followed
by a system-generated string that describes the current state of <code class="varname">errno</code>.
</p><ul class="itemizedlist"><li><p>
Each thread maintains its own <code class="varname">errno</code> variable.
</p></li><li><p>
<code class="varname">errno</code> is only set if there's an error—it never indicates
success.
</p></li><li><p>
<code class="varname">errno</code> is never cleared. If call A fails and then you call B, C, and
D, <code class="varname">errno</code> will still record the error from A.
</p></li></ul></div><div id="footer"><hr /><div id="footerT">Prev: <a href="BVolumeRoster_Overview.html">BVolumeRoster</a>  Up: <a href="TheStorageKit_Overview.html">The Storage Kit</a>  Next: <a href="AttributeFunctions_Overview.html">Attribute Functions</a> </div><div id="footerB"><div id="footerBL"><a href="BVolumeRoster_Overview.html" title="BVolumeRoster"><img src="./images/navigation/prev.png" alt="Prev" /></a> <a href="TheStorageKit_Overview.html" title="The Storage Kit"><img src="./images/navigation/up.png" alt="Up" /></a> <a href="AttributeFunctions_Overview.html" title="Attribute Functions"><img src="./images/navigation/next.png" alt="Next" /></a></div><div id="footerBR"><div><a href="http://www.haiku-os.org"><img src="./images/People_24.png" alt="haiku-os.org" title="Visit The Haiku Website" /></a></div><div class="navighome" title="Home"><a accesskey="h" href="index.html"><img src="./images/navigation/home.png" alt="Home" /></a></div></div><div id="footerBC"><a href="http://www.access-company.com/home.html" title="ACCESS Co."><img alt="Access Company" src="./images/access_logo.png" /></a></div></div></div><div id="licenseFooter"><div id="licenseFooterBL"><a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/3.0/" title="Creative Commons License"><img alt="Creative Commons License" style="border-width:0" src="https://licensebuttons.net/l/by-nc-nd/3.0/88x31.png" /></a></div><div id="licenseFooterBR"><a href="./LegalNotice.html">Legal Notice</a></div><div id="licenseFooterBC"><span id="licenseText">This work is licensed under a
<a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/3.0/">Creative
Commons Attribution-Non commercial-No Derivative Works 3.0 License</a>.</span></div></div></body></html>