FVCBM(1) FVCBM(1) NNAAMMEE fvcbm - list directories of Commodore 64/128 compatible archive files SSYYNNOOPPSSIISS ffvvccbbmm [ --hh ] [ --dd ] ffiilleennaammee11 [ _f_i_l_e_n_a_m_e_2, _._._._f_i_l_e_n_a_m_e_N ] DDEESSCCRRIIPPTTIIOONN ffvvccbbmm displays the directories of Commodore 64 and 128 archive and self-dissolving archive files, as well as raw floppy disk images. It can be used to determine what is contained in an archive and how much disk space it will take when uncompressed. It is especially useful for pre- viewing files on a network-connected machine used for downloading Commodore software, and for viewing disk images outside a Commodore 64 emulator. If a given file cannot be found, several standard archive file extensions are appended to the name in an attempt to find the desired file. If a file named `-' is given, ffvvccbbmm will attempt to read the standard input for an archive's contents. Under Linux, ffvvccbbmm can read 1581 disks by specifying the floppy disk device (e.g. _/_d_e_v_/_f_d_0). The command sseettffddpprrmm must first be used to specify that the drive contains a 1581 disk, which requires a kernel version >= 1.3 (patches to earlier ker- nels are available). 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 (not includ- ing archive overhead), the archive type and version number (if known), overall compression savings factor (not including the extraction program for self-extracting files), and the number of disk blocks of compressed data in the archive. For self-extracting archives, a `+' and the number of disk blocks taken up by the extraction pro- gram are displayed following the number of blocks of data. Adding the numbers before and after the plus should roughly equal the size of the archive file on disk (because of padding and rounding, the actual size on disk may be slightly different). The --dd option selects a style of directory output which is similar to that produced by Commodore disk drives. Only fvcbm Version 3.0 14 September 1996 1 FVCBM(1) FVCBM(1) 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. ffvvccbbmm supports the following archive types: ARC230 (not to be confused with SEA ARC), self-extracting ARC230 (SDA), Lynx, CS-DOS (LZH), self-extracting CS-DOS (SFX), LBR (not to be confused with LBR for CP/M), 64Net files (N64), PC64 emulator files (R/S/U/P00), emulator tape images (T64) and emulator disk images (D64 and X64), including 1541 and 1581 disk types. OOPPTTIIOONNSS --hh Print a help message. --dd Display directory in Commodore disk directory for- mat. EEXXIITT SSTTAATTUUSS ffvvccbbmm returns the following exit status: 00 if no errors were encountered 11 if ffvvccbbmm displayed the help message and exited 22 if a file could not be found, or a read error occurred 33 if the file type was not supported If more than one filename caused an error, the status will reflect the last error encountered. AAUUTTHHOORR Daniel Fandrich ffvvccbbmm 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. Thanks also to Jouko Valta for beta testing. Feel free to contact the author if you have questions or suggestions for improvement of the program. BBUUGGSS 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 ffvvccbbmm (please contact the fvcbm Version 3.0 14 September 1996 2 FVCBM(1) FVCBM(1) author if you find one). Archive volume labels and `locked' file status for D64 and X64 archive types are not displayed. Occasionally, some archive types (especially D64 and ARC) are misidentified. Convert D64 archives to X64 type archives with cc11554411 (part of xx6644) to read them. 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. ffvvccbbmm (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. CCOOPPYYRRIIGGHHTT ffvvccbbmm is copyright (C) 1995-1996 by Daniel Fandrich. It is provided "as is", without any express or implied war- ranties. See the file COPYING, which should have been included with the program, for details. 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 Escom AG. SSEEEE AALLSSOO ccbbmmffss(4), llhhaa(1), llssccbbmm(1), sseettffddpprrmm(8), xx6644(1) fvcbm Version 3.0 14 September 1996 3