📄 flockfile.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><!-- Copyright 1997 The Open Group, All Rights Reserved --><title>flockfile</title></head><body bgcolor=white><center><font size=2>The Single UNIX ® Specification, Version 2<br>Copyright © 1997 The Open Group</font></center><hr size=2 noshade><h4><a name = "tag_000_005_101"> </a>NAME</h4><blockquote>flockfile, ftrylockfile, funlockfile - stdio locking functions</blockquote><h4><a name = "tag_000_005_102"> </a>SYNOPSIS</h4><blockquote><pre><code>#include <<a href="stdio.h.html">stdio.h</a>>void flockfile(FILE *<i>file</i>);int ftrylockfile(FILE *<i>file</i>);void funlockfile(FILE *<i>file</i>);</code></pre></blockquote><h4><a name = "tag_000_005_103"> </a>DESCRIPTION</h4><blockquote>The<i>flockfile()</i>,<i><a href="ftrylockfile.html">ftrylockfile()</a></i>and<i><a href="funlockfile.html">funlockfile()</a></i>functions provide for explicitapplication-level locking of stdio (<b> FILE *</b>)objects.These functions can be used by a threadto delineate a sequence of I/O statements that are to be executed as a unit.<p>The<i>flockfile()</i>function is used by a thread to acquire ownership of a (<b> FILE *</b>)object.<p>The<i><a href="ftrylockfile.html">ftrylockfile()</a></i>function is used by a thread to acquire ownership of a (<b> FILE *</b>)object if the object is available;<i><a href="ftrylockfile.html">ftrylockfile()</a></i>is a non-blocking version of<i>flockfile()</i>.<p>The<i><a href="funlockfile.html">funlockfile()</a></i>function is used to relinquish the ownership granted to the thread.The behaviour is undefined if a thread other than the current owner calls the<i><a href="funlockfile.html">funlockfile()</a></i>function.<p>Logically, there is a lock count associated with each (<b> FILE *</b>)object.This count is implicitly initialised to zero when the (<b> FILE *</b>)object is created.The (<b> FILE *</b>)object is unlocked when the count is zero.When the count is positive,a single thread owns the (<b> FILE *</b>)object.When the<i>flockfile()</i>function is called, if the count is zero orif the count is positive and the caller owns the (<b> FILE *</b>)object, the count is incremented.Otherwise, the calling thread is suspended,waiting for the count to return to zero.Each call to<i><a href="funlockfile.html">funlockfile()</a></i>decrements the count.This allows matching calls to<i>flockfile()</i>(or successful calls to<i><a href="ftrylockfile.html">ftrylockfile()</a></i>)and<i><a href="funlockfile.html">funlockfile()</a></i>to be nested.<p>All functions that reference (<b> FILE *</b>)objects behave as if they use<i>flockfile()</i>and<i><a href="funlockfile.html">funlockfile()</a></i>internally to obtain ownership of these (<b> FILE *</b>)objects.</blockquote><h4><a name = "tag_000_005_104"> </a>RETURN VALUE</h4><blockquote>None for<i>flockfile()</i>and<i><a href="funlockfile.html">funlockfile()</a></i>.The function<i><a href="ftrylockfile.html">ftrylockfile()</a></i>returns zero for success and non-zero to indicatethat the lock cannot be acquired.</blockquote><h4><a name = "tag_000_005_105"> </a>ERRORS</h4><blockquote>No errors are defined. </blockquote><h4><a name = "tag_000_005_106"> </a>EXAMPLES</h4><blockquote>None.</blockquote><h4><a name = "tag_000_005_107"> </a>APPLICATION USAGE</h4><blockquote>Realtime applications may encounter priority inversion when using FILElocks.The problem occurs when a high priority thread "locks" a FILE thatis about to be "unlocked" by a low prioritythread, but the low priority thread is preempted by a medium prioritythread.This scenario leads to priority inversion; a high priority thread isblocked by lower priority threads for an unlimited period of time.During system design, realtime programmers must take into account thepossibility of this kind of priority inversion.They can deal with it in a number of ways, such as by having criticalsections that are guarded by FILE locks execute at a high priority, sothat a thread cannot be preempted while executing in its criticalsection.</blockquote><h4><a name = "tag_000_005_108"> </a>FUTURE DIRECTIONS</h4><blockquote>None.</blockquote><h4><a name = "tag_000_005_109"> </a>SEE ALSO</h4><blockquote><i><a href="getc_unlocked.html">getc_unlocked()</a></i>,<i><a href="getchar_unlocked.html">getchar_unlocked()</a></i>,<i><a href="putc_unlocked.html">putc_unlocked()</a></i>,<i><a href="putchar_unlocked.html">putchar_unlocked()</a></i>,<i><a href="stdio.h.html"><stdio.h></a></i>.</blockquote><h4>DERIVATION</h4><blockquote>Derived from the POSIX Threads Extension (1003.1c-1995)</blockquote><hr size=2 noshade><center><font size=2>UNIX ® is a registered Trademark of The Open Group.<br>Copyright © 1997 The Open Group<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]</font></center><hr size=2 noshade></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -