home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / CPROG / CBASE101.ZIP / BLKIO112.ZIP / BFLUSH.C < prev    next >
Text File  |  1990-06-20  |  2KB  |  88 lines
  1. /*    Copyright (c) 1989 Citadel    */
  2. /*       All Rights Reserved        */
  3.  
  4. /* #ident    "@(#)bflush.c    1.4 - 90/06/20" */
  5.  
  6. /* ansi headers */
  7. #include <errno.h>
  8.  
  9. /* local headers */
  10. #include "blkio_.h"
  11.  
  12. /*man---------------------------------------------------------------------------
  13. NAME
  14.      bflush - flush a block file
  15.  
  16. SYNOPSIS
  17.      #include <blkio.h>
  18.  
  19.      int bflush(bp)
  20.      BLKFILE *bp;
  21.  
  22. DESCRIPTION
  23.      The bflush function causes any buffered data for the block file
  24.      associated with BLKFILE pointer bp to be written to the file and
  25.      the buffers to be emptied.  The header, if it has been modified,
  26.      is written out last.  The block file remains open.  If  bp is
  27.      open read-only or is not buffered, there will be no data to flush
  28.      and bflush will return a value of zero immediately.
  29.  
  30.      bflush should be called immediately before a block file is
  31.      unlocked.  lockb does this automatically.
  32.  
  33.      bflush will fail if one or more of the following is true:
  34.  
  35.      [EINVAL]       bp is not a valid BLKFILE pointer.
  36.      [BENOPEN]      bp is not open.
  37.  
  38. SEE ALSO
  39.      bexit, bputb, bsync.
  40.  
  41. DIAGNOSTICS
  42.      Upon successful completion, a value of 0 is returned.  Otherwise,
  43.      a value of -1 is returned, and errno set to indicate the error.
  44.  
  45. ------------------------------------------------------------------------------*/
  46. int bflush(bp)
  47. BLKFILE *bp;
  48. {
  49.     /* validate arguments */
  50.     if (!b_valid(bp)) {
  51.         errno = EINVAL;
  52.         return -1;
  53.     }
  54.  
  55.     /* check if not open */
  56.     if (!(bp->flags & BIOOPEN)) {
  57.         errno = BENOPEN;
  58.         return -1;
  59.     }
  60.  
  61.     /* check if not open for writing */
  62.     if (!(bp->flags & BIOWRITE)) {
  63.         errno = 0;
  64.         return 0;
  65.     }
  66.  
  67.     /* check if not buffered */
  68.     if (bp->bufcnt == 0) {
  69.         errno = 0;
  70.         return 0;
  71.     }
  72.  
  73.     /* synchronize file with buffers */
  74.     if (bsync(bp) == -1) {
  75.         BEPRINT;
  76.         return -1;
  77.     }
  78.  
  79.     /* empty the buffers */
  80.     if (b_initlist(bp) == -1) {
  81.         BEPRINT;
  82.         return -1;
  83.     }
  84.  
  85.     errno = 0;
  86.     return 0;
  87. }
  88.