home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d9xx / d919 / bbbf.lha / BBBF / FileVirLib / ForYouToRead < prev    next >
Text File  |  1993-10-04  |  3KB  |  107 lines
  1.  
  2.     Some info for programmers and ordinary users:
  3.  
  4.     *    When using the '_LVORemoveLinks' function,
  5.         you have to load the entire file,
  6.         and install the right file-size.
  7.         Or else the library will give false values.
  8.  
  9.     *    Don't crunch the library or anything like
  10.         that (ie. processing the hunks and so on)
  11.         or else the library will not be avaiable
  12.         to use, because the library checks itself on start-
  13.         up for viruses, and alterings.
  14.  
  15.     *    The functions using the FileInfection field
  16.         (ie. _LVORemoveLinks and _LVOGetFileVName)
  17.         will, if there is an infection ofcouse, 
  18.         set the FileInfection field.
  19.         The MemoryInfection field will, when put
  20.         into use, act in thesame way.
  21.  
  22.     *    When you want to write back the non-infected
  23.         file, you have to get the new start of the file
  24.         (the file will most likely not be at thesame
  25.          place in memory anymore!) through the
  26.          'RL_BufferPtr' and the new filelength through
  27.          the 'RL_BufferLen' field.
  28.  
  29.     *    The 'RL_Status' field is not put into use at time 
  30.         writing. But in the future this will give errors
  31.         and other messages.
  32.  
  33.         There are currently no checks for errors.
  34.         (Actually there are some internal ones, but
  35.          the user of the library wont be able to 
  36.          see/use them!)
  37.  
  38.         When an infected file has a bad hunk-structure or like
  39.         this file will be reported to be NON-infected.
  40.         (But this is not to bad really, because this
  41.          means the file wont be able to run, at all)
  42.  
  43.     *    When using the '_LVOGetFileVName' function you only have
  44.         to load the first dos-hunk.
  45.         The library will be able to dectect if the file is infected,
  46.         on that only).
  47.  
  48.     *    '_LVOGetFileVName' function will only find ONE link
  49.         (but then you know if the file is infected or not,
  50.          and have the name, and that is by my oppinion the most
  51.          important).
  52.          When using the '_LVORemoveLinks' this will also find 
  53.          second/third/fourth/fifth links and so on.
  54.  
  55.     *    Some information about the fields that will help
  56.         your programming:
  57.  
  58.     TRUE    =0x0000        (=NULL; 0)
  59.     FALSE    =0xffff        (= -1)
  60.  
  61. READONLY fields:
  62.     Struct    *RL_FileInfection    (Link to a fileinfection node)
  63.     Struct    *RL_MemoryInfection    (Not in use)
  64.     APTR    RL_SectorVName        (Name of virus, that infected the
  65.                      current data-sector.
  66.                      This field is NULL when processing
  67.                      sector 880)
  68.     UWORD    RL_SectorInfec        (If the current data-block is infected
  69.                      TRUE/FALSE)
  70.     
  71.     UWORD    RL_NeedsRepair        (Some viruses set this field so you 
  72.                                          will know if the current disk may be 
  73.                                          attacked and needs a repair, that 
  74.                                          can heal thedisk. SADDAM+Clone(s)
  75.                                           sets this field TRUE/FALSE).
  76.  
  77.     UWORD    RL_Status        (Not in use)
  78.  
  79.     UWORD    Res0
  80.  
  81.     UWORD    Res1
  82.  
  83.     UWORD    Res2
  84.  
  85.     UWORD    Res3
  86.     
  87. READ/WRITE fields:
  88.  
  89.     APTR    RL_BufferPtr        (Where in memory the current file/
  90.                      data-block or like is at the moment)
  91.  
  92.     ULONG    RL_BufferLen        (The length of the datablock/current
  93.                      file)
  94.  
  95.     ULONG    RL_SectorOffset        (If you are to use the
  96.                      '_LVODecodeDataBlock' function,
  97.                      you have to install this field.
  98.                      It is just the IOSTD->Offset field)
  99. READONLY fields:
  100.  
  101.     Struct    *RL_VirusList        (a list of all the viruses the
  102.                      current version of 'removelink.lib'
  103.                      can handle/remove)
  104.  
  105.     ULONG    RL_VirusesCovered    (Number of viruses covered. 
  106.                      Clone(s) counts as an own viruskind)
  107.