


FVCBM(1)                                                 FVCBM(1)


NNAAMMEE
       fvcbm  -  list  directories of Commodore 64/128 compatible
       archive files

SSYYNNOOPPSSIISS
       ffvvccbbmm [ --hh ] [ --dd ] ffiilleennaammee11 [ _f_i_l_e_n_a_m_e_2, _._._._f_i_l_e_n_a_m_e_N ]

DDEESSCCRRIIPPTTIIOONN
       ffvvccbbmm displays the directories of  Commodore  64  and  128
       archive  and self-dissolving archive files. It can be used
       to determine what is contained in an archive and how  much
       disk  space  it  will take when uncompressed.  It is espe-
       cially useful for previewing files on a  network-connected
       machine used for downloading Commodore software.

       If  a  given file cannot be found, the extension `.sda' is
       appended and another attempt to open the file is made.  If
       a  file named `-' is given, ffvvccbbmm will attempt to read the
       standard input for an archive's contents.

       The default (wide) directory display contains a  line  for
       each  file  in  the archive. Each entry's display includes
       the file name, file type, uncompressed  length  in  bytes,
       uncompressed  length  in  Commodore  254 byte disk blocks,
       compression method used, compression savings factor (as  a
       percentage reduction of the uncompressed file), and check-
       sum.

       Most columns are totalled in the last line.   Values  dis-
       played  are the number of files in the archive, total num-
       ber of data bytes in the archive, number  of  disk  blocks
       required to hold all the files in the archive, the archive
       type and version number, overall compression savings  fac-
       tor  (not  including  the  extraction  program  for  self-
       extracting files), and the number of disk blocks  of  com-
       pressed   data   in   the  archive.   For  self-extracting
       archives, a `+' and the number of disk blocks taken up  by
       the  extraction program are displayed following the number
       of blocks of data.  Adding the numbers  before  and  after
       the plus should equal the size of the archive file on disk
       (because of padding and rounding, the actual size on  disk
       may be slightly different).

       The --dd option selects a style of directory output which is
       similar to that produced by Commodore  disk  drives.  Only
       the  file  name, size in blocks and type are displayed for
       each entry in the archive. The  summary  line  totals  the
       number of blocks used by the entries.

       ffvvccbbmm  supports the following archive types: ARC230 (ARC),
       self-extracting ARC230 (SDA), Lynx,  CS-DOS  (LZH),  self-
       extracting  CS-DOS (SFX), PC64 emulator files (R/S/U/P00),
       emulator tape images (T64), and emulator disk images  (D64
       and X64).



fvcbm Version 2.0        20 January 1995                        1





FVCBM(1)                                                 FVCBM(1)


OOPPTTIIOONNSS
       --hh     Print a help message.

       --dd     Display  directory in Commodore disk directory for-
              mat.

EEXXIITT SSTTAATTUUSS
       ffvvccbbmm returns the following exit status:

       00      if no errors were encountered

       11      if ffvvccbbmm displayed the help message and exited

       22      if a file could not  be  found,  or  a  read  error
              occurred

       33      if the file type was not supported

       If more than one filename caused an error, the status will
       reflect the last error encountered.

AAUUTTHHOORR
       Daniel Fandrich <dan@fch.wimsey.bc.ca>

       ffvvccbbmm was inspired by Vernon D.  Buerg's  program  _f_v  for
       displaying directories of MS-DOS archives.

       Thanks to Guntram Blohm, Kevin Brisley, Teemu Rantanen and
       Haruyasu Yoshizaki for their reference source code  and/or
       documentation for various archive formats.

BBUUGGSS
       Reading  an  archive from the standard input does not work
       for some archive types in some environments; when it  does
       work,  the file lengths can be incorrect for Lynx and PC64
       files.  Newer versions of some archivers may create  files
       which  are not recognized by ffvvccbbmm.  Archive volume labels
       and `locked' file status for D64 and X64 archive types are
       not displayed.  More suffixes should be attempted before a
       file is deemed not found.

       Older versions of Lynx (at least versions IX and below) do
       not  explicitly  store the length of the final file in the
       archive.  This  last  file  can  therefore  be  improperly
       lengthened if it is transferred using a file transfer pro-
       tocol like XMODEM which adds extraneous characters to  the
       end  of transferred files.  ffvvccbbmm (and Lynx itself) has no
       way of determining if this has happened, and will  display
       the incorrect file length if this is the case.  This limi-
       tation can also affect PC64 files.

CCOOPPYYRRIIGGHHTT
       ffvvccbbmm is placed into the public domain by the  author.  It
       is  provided  "as  is",  without  any  express  or implied



fvcbm Version 2.0        20 January 1995                        2





FVCBM(1)                                                 FVCBM(1)


       warranties.

       The words _C_o_m_m_o_d_o_r_e, _C_o_m_m_o_d_o_r_e _6_4 and _C_B_M  are  registered
       trademarks of Commodore Business Machines, Inc.  Commodore
       Business Machines was not involved in  any  way  with  the
       writing of ffvvccbbmm.

SSEEEE AALLSSOO
       llhhaarrcc(1), xx6644(1)
















































fvcbm Version 2.0        20 January 1995                        3