| blob | 62b798114167da9f1800e758d6e50edd76ef0fd3 |
4 <head>
9 /* Debug borders */
11 /*
12 border: 1px solid red;
13 */
14 }
16 body {
18 }
20 a {
23 }
26 }
28 em {
31 }
33 strong {
36 }
38 tt {
40 }
48 }
52 }
53 h2 {
55 }
56 h3 {
58 }
59 h3 + * {
61 }
66 }
68 hr {
70 }
72 p {
75 }
79 }
81 pre {
84 }
86 span#author {
91 }
92 span#email {
93 }
96 }
98 div#footer {
104 }
105 div#footer-text {
108 }
109 div#footer-badges {
112 }
114 div#preamble {
117 }
123 }
127 }
131 }
133 /* Block element titles. */
141 }
144 }
148 }
151 }
154 }
160 }
166 }
171 }
175 }
180 }
183 }
187 }
188 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
191 }
200 }
204 }
209 }
215 dl {
218 }
219 dt {
224 }
227 }
231 }
234 }
237 }
240 }
243 }
246 }
253 }
257 }
258 thead {
261 }
262 tfoot {
264 }
267 }
270 }
271 /* Because the table frame attribute is overriden by CSS in most browsers. */
274 }
278 }
282 }
288 }
291 }
294 }
300 }
303 }
307 }
311 }
315 }
317 div#toctitle {
324 }
329 }
333 }
337 }
341 }
342 /* Workarounds for IE6's broken and incomplete CSS2. */
348 }
355 }
361 }
366 }
370 }
374 }
379 }
381 /* IE6 sets dynamically generated links as visited. */
383 </style>
384 </head>
385 <body>
388 </div>
393 <li>
394 <p>
395 Mutual exclusion. When we write out a new index file, first
397 contents into it, and rename it to the final destination
399 file with O_EXCL so that we can notice and fail when somebody
400 else is already trying to update the index file.
401 </p>
402 </li>
403 <li>
404 <p>
405 Automatic cruft removal. After we create the "lock" file, we
407 remove the file that has not been committed to its final
408 destination. This is done by remembering the lockfiles we
409 created in a linked list and cleaning them up from an
411 when the program dies on a signal.
412 </p>
413 </li>
414 </ul></div>
415 </div>
416 </div>
421 hold_lock_file_for_update
422 </dt>
423 <dd>
424 <p>
428 destination and return the file descriptor for writing
430 a lock is already taken for the file; otherwise it
431 returns a negative integer to the caller on failure.
432 </p>
433 </dd>
435 commit_lock_file
436 </dt>
437 <dd>
438 <p>
441 close the file descriptor and rename the lockfile to its
442 final destination. Returns 0 upon success, a negative
444 </p>
445 </dd>
447 rollback_lock_file
448 </dt>
449 <dd>
450 <p>
453 close the file descriptor and remove the lockfile.
454 </p>
455 </dd>
457 close_lock_file
458 </dt>
459 <dd>
460 <p>
463 and close the file descriptor. Returns 0 upon success,
464 a negative value on failure to close(2).
465 </p>
466 </dd>
467 </dl></div>
469 storage has to stay throughout the life of the program. It
470 cannot be an auto variable allocated on the stack.</p></div>
471 <div class="paragraph"><p>Call <tt>commit_lock_file()</tt> or <tt>rollback_lock_file()</tt> when you are
472 done writing to the file descriptor. If you do not call either
474 will close and remove the lockfile.</p></div>
478 Otherwise the <tt>struct
479 lock_file</tt> structure still remembers that the file descriptor
483 descriptor for completely different purpose, and then call
485 that unrelated file descriptor.</p></div>
486 </div>
490 </div>
491 </div>
492 </body>
493 </html>