home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 1 / FishNMoreVol1.bin / more / programming / arpprog / newdocs / newpro.arc / CheckSumPrg < prev    next >
Text File  |  1988-02-22  |  1KB  |  67 lines
  1.  
  2.  
  3.  
  4.      CheckSumPrg(33.4)      ARP Programmers Manual     CheckSumPrg(33.4)
  5.  
  6.  
  7.  
  8.      NAME
  9.       CheckSumPrg -- Calculate the checksum    on a resident program.
  10.  
  11.      SYNOPSIS
  12.       checksum = CheckSumPrg(node)
  13.           d0          d1
  14.  
  15.      FUNCTION
  16.       All programs on the resident list are    checksummed when they
  17.       are added to the list.  On rare occasions, it    might be
  18.       necessary to recompute this checksum.     This function
  19.       computes the checksum    on a resident program given its    node.
  20.       It does not change, compare or otherwise alter the node.  It
  21.       is also the only function which does not use the semaphore.
  22.       Therefore, the correct method    of using this function is:
  23.           Node = ObtainResidentProgram("name");
  24.           checksum = CheckSumPrg(Node);
  25.           ReleaseResidentPrg(Node->rpn_Segment);
  26.  
  27.       For a    general    discussion on ARP's resident list, see the
  28.       manual page for AddResidentPrg().
  29.  
  30.      INPUTS
  31.       node - Pointer to a resident program node.
  32.  
  33.      RESULT
  34.       checksum - A newly calculated    checksum.
  35.  
  36.      BUGS
  37.       The checksum is not perfect, but it should catch most
  38.       problems.  A tradeoff    was made with respect to the time it
  39.       takes    to do more complex checksums.
  40.  
  41.      SEE ALSO
  42.       ObtainResidentPrg(), AddResidentPrg(),LoadPrg(),UnLoadPrg(),
  43.       RemResidentPrg(), ReleaseResidentPrg(), BaseName().
  44.  
  45.      AUTHOR
  46.       SDB
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 2/22/88)
  64.  
  65.  
  66.  
  67.