$Id: debug.txt,v 1.1.1.2 2002/03/28 00:03:33 andrew_belov Exp $

ARJ DEBUGGER'S GUIDE

This file is a reference for everyone who has to deal with ARJ technical
support and debugging.

A list of debug options (-hd<opt>, followed by an optional argument):

  .     (ASR) Displays each file being added to a filelist.
  ?     With ARJ v 2.75.03+, allows use of Extended license keys in standard
        ARJ. The filelist capacity shall remain the same.
  a     Rigorous archive handling. Enables detailed information in index
        files, and forces recovery of ARJ-PROTECTed archives.
  b<u>  Sets VBUF size. VBUF is used for buffering of archive input stream.
  c     Skips CRC checking for extracted files, thereby causing CRC errors.
  d     Sets the dictionary size on compression, thus making ARJ compress
        better. The archives can still be extracted... with ARJZ only, though.
  f     Notifies about len_cnt fixes in encoding routine.
  i<ld> Defines the flist_main capacity in ARJ. Extended license is not
        required in this case.
  k     Zeroes compsize after the file has been unpacked.
  l     Displays the encryption version.
  m     (ASR, DEBUG builds only) Displays malloc()/farmalloc() arguments.
  n     Inhibits any sort of productive file activity.
  o<s>  Sets archive modification time to the desired timestamp.
  p<u>  Sets TBUF size. TBUF is used for buffering of archive output stream.
  q     Reverts to the standard filelist type for flist_main.
  s     Enables unlimited ranges for numeric switch values.
  t     Enables the poor man's profiler (displays execution ticks).
  v     Dumps the command-line tokens as they are processed, shows memory
        statistics and may have other effects as a "verbose" command.
  x     Inhibits any sort of hollow file processing.
  y     Uses a case-preserving way of filename/path storage.
  z<ld> Sets the physical filelist capacity limit.

Common examples:

* -hdaflmv is a usual bug reporter's test case.

* -hdt may be used for performance measurements.
