fuse-utils/tzxlist.c

/* tzxlist.c: Produce a listing of the blocks in a .tzx file
   Copyright (c) 2001-2016 Philip Kendall, Darren Salt, Fredrick Meunier
   Copyright (c) 2015 Sergio Baldovi
   Copyright (c) 2016 Gergely Szasz
   Copyright (c) 2017 Chris Born

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License along
   with this program; if not, write to the Free Software Foundation, Inc.,
   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

   Author contact information:

   E-mail: philip-fuse@shadowmagic.org.uk

*/

#include "config.h"

#include <errno.h>
#include <fcntl.h>
#include <getopt.h>
#ifdef HAVE_ICONV
#include <iconv.h>
#endif /* #ifdef HAVE_ICONV */
#ifdef HAVE_LOCALE_H
#include <locale.h>
#endif /* #ifdef HAVE_LOCALE_H */
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/stat.h>
#include <unistd.h>

#include "libspectrum.h"

#include "utils.h"

#define PROGRAM_NAME "tzxlist"
#define DESCRIPTION_LENGTH 80

const char *progname;

static int dump_block = -9999;
static int block_num = 0;

#ifdef HAVE_ICONV
static iconv_t conversion_descriptor;
#endif /* #ifdef HAVE_ICONV */

static void
dump_symbol_table( libspectrum_tape_generalised_data_symbol_table *table )
{
  size_t i, j;

  libspectrum_byte pulses = 
    libspectrum_tape_generalised_data_symbol_table_max_pulses( table );
  libspectrum_word symbols =
    libspectrum_tape_generalised_data_symbol_table_symbols_in_table( table );

  printf("    Symbols in block: %lu\n", (unsigned long)libspectrum_tape_generalised_data_symbol_table_symbols_in_block( table ) );
  printf("    Max pulses: %d\n", pulses );
  printf("    Symbols in table: %d\n", symbols );

  for( i = 0; i < symbols; i++ ) {

    libspectrum_tape_generalised_data_symbol *symbol =
      libspectrum_tape_generalised_data_symbol_table_symbol( table, i );

    printf("      Symbol %lu: type %d; pulse lengths: ", (unsigned long)i, libspectrum_tape_generalised_data_symbol_type( symbol ) );

    for( j = 0; j < pulses; j++ )
      printf( "%d ", libspectrum_tape_generalised_data_symbol_pulse( symbol, j ) );

    printf( "\n" );

  }
    
}

static void
dump_pilot_repeats( libspectrum_tape_block *block )
{
  size_t i;

  libspectrum_tape_generalised_data_symbol_table *pilot =
    libspectrum_tape_block_pilot_table( block );

  for( i = 0; i < libspectrum_tape_generalised_data_symbol_table_symbols_in_block( pilot ); i++ ) {
    printf( "    Repeat %2lu: symbol %d repeated %d times\n", (unsigned long)i,
	    libspectrum_tape_block_pilot_symbols( block, i ),
	    libspectrum_tape_block_pilot_repeats( block, i ) );
  }
}

static const char*
hardware_desc( int type, int id )
{
  switch( type ) {
  case 0:
    switch( id ) {
    case 0: return "16K Spectrum";
    case 1: return "48K Spectrum/Spectrum +";
    case 2: return "48K Spectrum (Issue 1)";
    case 3: return "128K Spectrum";
    case 4: return "Spectrum +2";
    case 5: return "Spectrum +2A/+3";
    default: return "Unknown machine";
    }
  case 3:
    switch( id ) {
    case 0: return "AY-3-8192";
    default: return "Unknown sound device";
    }
  case 4:
    switch( id ) {
    case 0: return "Kempston joystick";
    case 1: return "Cursor/Protek/AGF joystick";
    case 2: return "Sinclair joystick (Left)";
    case 3: return "Sinclair joystick (Right)";
    case 4: return "Fuller joystick";
    default: return "Unknown joystick";
    }
  default: return "Unknown type";
  }
}

/* A simple routine to convert the input text to another character encoding.
   We really are only thinking about simple conversions of accented characters,
   the pound and Euro signs so just reserve 3x the input buffer size to give
   "plenty" of space for the most common encondings and let any failure in
   conversion fall back to just returning the source string unmodified */
static char *
convert_charset( char *input )
{
#ifdef HAVE_ICONV
  const int expansion_factor = 3;
  static char *output = NULL;
  static size_t output_size = 0;
  char* output_ptr = output;
  size_t output_left = output_size;
  ICONV_CONST char* input_ptr = input;
  size_t input_left = strlen( input ) + 1;
  size_t min_output_size = input_left * expansion_factor;
 
  if( conversion_descriptor == (iconv_t)(-1) ) return input;

  if( output_size == 0 || output_size < min_output_size ) {
    output = realloc( output, min_output_size );
    if( output == NULL ) {
      output_size = 0;
      return input;
    }
    output_ptr = output;
    output_size = input_left * expansion_factor;
    output_left = output_size;
    *output = '\0';
  } 

  if( (size_t)(-1) == iconv( conversion_descriptor, &input_ptr, &input_left,
                             &output_ptr, &output_left ) ) {
    return input;
  }

  /* Write the byte sequence to get into the initial state if required. */
  if( (size_t)(-1) == iconv( conversion_descriptor, NULL, NULL, &output_ptr,
                             &output_left ) ) {
    return input;
  }

  return output;
#else  /* #ifdef HAVE_ICONV */
  return input;
#endif /* #ifdef HAVE_ICONV */
}

static void
check_checksum(unsigned long length, libspectrum_byte * data)
{
  int retval = 0;
  libspectrum_byte checksum = 0;
  if( length ) {
    size_t i;
    for( i = 0; i < length-1; i++ ) {
      checksum ^= data[i];
    }
    retval = checksum == data[length-1];
  }

  printf( "  Checksum: 0x%02x (%s)\n", checksum, retval ? "PASS" : "FAIL" );
}

static void
fprint_block_name( FILE *f, libspectrum_byte *data )
{
  int i;
  for( i = 2; i < 12; i++) {
    char c;
    if( data[i] >= 32 && data[i] < 127 ) {
      c = data[i];
    } else {
      c = '?';
    }
    fprintf( f, "%c", c );
  }
}

static void
print_block_name( libspectrum_byte * data )
{
  fprint_block_name( stdout, data );
}

/*
The header block has the following structure:
  - leader (5 seconds)
  - sync pulse
  - flag byte: this is 0x00 for header blocks and 0xff for data blocks
  - header data
  - checksum byte, calculated such that XORing all the data bytes together
    (including the flag byte) produces 0x00

The structure of the 17 byte tape header is:

Byte    Length  Description
---------------------------
0       1       Type (0,1,2 or 3)
1       10      Filename (padded with blanks)
11      2       Length of data block
13      2       Parameter 1
15      2       Parameter 2

The type is 0,1,2 or 3 for a PROGRAM, Number array, Character array or
CODE file respectively.

The data block has the following structure:
  - leader (2 seconds)
  - sync pulse
  - flag byte: this is 0x00 for header blocks and 0xff for data blocks
  - data
  - checksum byte, calculated such that XORing all the data bytes together
    (including the flag byte) produces 0x00

More info about the standard tape header label:
  "Zakboekje voor de ZX Spectrum" by Wessel Akkermans, pages 100-102.
  http://www.worldofspectrum.org/faq/reference/48kreference.htm#TapeDataStructure
  http://faqwiki.zxnet.co.uk/wiki/Spectrum_tape_interface
*/

/* decode header and save data */
static void
decode_header( libspectrum_tape_block *block )
{
  unsigned long length = libspectrum_tape_block_data_length( block );
  libspectrum_byte * data = libspectrum_tape_block_data( block );
  int is_header = length == 19 && data[0] == 0x00;
  char filename[17]; /* %8d.dsc; %8d.hdr %8d.dat */
  int save = 0, i, zxlength, parameter1, parameter2;
  static int save_data = -9999;
  FILE *f = NULL;
  int error;

  if( !is_header ) {
    printf( "  Datablock length: %lu\n", length - 2 );
    if( f ) {
      fprintf( f, "  Datablock length: %lu\n", length - 2 );
    }
  }

  if( is_header ) {
    zxlength = data[12] + data[13] * 0x100;
    parameter1 = data[14] + data[15] * 0x100;
    parameter2 = data[16] + data[17] * 0x100;

    printf( "  Block header, zxlength: %d, parameter1: %d, parameter2: %d\n",
            zxlength, parameter1, parameter2 );

    printf( "  Raw header:" );
    for( i = 1; i <= 17; i++ ) {
      printf( " %02x", data[i] );
      if( i == 1 || i == 11 || i == 13 || i == 15 ) printf( " |" );
    }
    printf( "\n" );

    if( f ) {
      fprintf( f,
               "  Block header, zxlength: %d, parameter1: %d, parameter2: %d\n",
               zxlength, parameter1, parameter2 );
      fprintf( f, "  Raw header:" );
      for( i = 1; i <= 17; i++ ) {
        fprintf( f, " %02x", data[i] );
        if( i == 1 || i == 11 || i == 13 || i == 15 ) fprintf( f, " |" );
      }
      fprintf( f, "\n" );
    }

    save = ( dump_block == -1 || dump_block == block_num ) ? 1 : 0;
    if( save ) {
      snprintf( filename, 16, "%08d.dsc", block_num );
      f = fopen( filename, "wb" );
      if( !f ) {
        fprintf( stderr, "%s: couldn't open '%s': %s\n", progname, filename,
          strerror( errno ) );
      }
    }
    switch( data[1] ) {
    case 0:
      /* If the file is a PROGRAM file, parameter 1 holds the autostart line
         number (or a number >=32768 if no LINE parameter was given) and
         parameter 2 holds the start of the variable area relative to the start
         of the program */
      printf( "  Program: \"" );
      print_block_name( data );
      printf( "\"" );
      if( parameter1 < 0x2710 ) printf( " LINE %d", parameter1 );
      printf( "\n  Length: %d, includes variable length: %d", zxlength,
              zxlength - parameter2 );
      if( f ) {
        fprintf( f, "  Program: \"" );
        fprint_block_name( f, data );
        fprintf( f, "\"" );
        if( parameter1 < 0x2710 ) fprintf( f, " LINE %d", parameter1 );
        fprintf( f, "\n  Length: %d, includes variable length: %d", zxlength,
                 zxlength - parameter2 );
      }
      break;
    case 1:
      printf( "  Number Array: \"" );
      print_block_name( data );
      /* fetch BITS 0-6 only by bitwise AND operation */
      printf( "\" DATA %c() ", (char)( data[15] & 63 ) + 64 );
      if( f ) {
        fprintf( f, "  Number Array: \"" );
        fprint_block_name( f, data );
        fprintf( f, "\" DATA %c() ", (char)( data[15] & 63 ) + 64 );
      }
      break;
    case 2:
      printf( "  Character Array: \"" );
      print_block_name( data );
      printf( "\" DATA %c$() ", (char)( data[15] & 63 ) + 64 );
      if( f ) {
        fprintf( f, "  Character Array: \"" );
        fprint_block_name( f, data );
        fprintf( f, "\" DATA %c$()", (char)( data[15] & 63 ) + 64 );
      }
      break;
    case 3:
      printf( "  Bytes: \"" );
      print_block_name( data );
      printf( "\"" );

      /* A SCREEN$ file is regarded as a CODE file with start address 16384 and
         length 6912 */
      if( parameter1 == 16384 && zxlength == 6912 ) {
        printf( " SCREEN$ " );
      } else {
        /* If it's a CODE file, parameter 1 holds the start of the code block
           when saved, and parameter 2 holds 32768 */
        printf( " CODE " );
      }
      printf( " %d, %d", parameter1, zxlength );

      if( f ) {
        fprintf( f, " Bytes: \"" );
        fprint_block_name( f, data );
        fprintf( f, "\"" );
        if( parameter1 == 16384 && zxlength == 6912 ) {
          fprintf( f, " SCREEN$ " );
        } else {
          fprintf( f, " CODE " );
        }
        fprintf( f, " %d, %d", parameter1, zxlength );
      }
      break;
    default:
      printf("  Unknown");
      if( f ) {
        fprintf( f, "Unknown" );
      }
      break;
    }
    printf("\n");
    if( f ) {
      fprintf( f, "\n" );
      if( fclose( f ) ) {
        fprintf( stderr, "%s: error closing `%s': %s\n", progname, filename,
                 strerror( errno ) );
      }
    }
  }
  check_checksum(length, data);

  /* save data block */
  if( save || save_data == block_num - 1 || dump_block == block_num ) {

    snprintf( filename, 16, "%08d.%s",
              save || dump_block == block_num ? block_num : save_data,
              save ? "hdr" : "dat" );

    error = write_file( filename, data + 1, length - 2 );
    if( !error ) {
      printf( "* Tape block dumped\n" );
    }
  }
  save_data = save ? block_num : -9999;
}

static int
process_tape( char *filename )
{
  int error, min;
  int current_loop_count = 1;
  float sec;
  unsigned char *buffer; size_t length;
  libspectrum_tape *tape;
  libspectrum_tape_iterator iterator;
  libspectrum_tape_block *block;
  float tape_total_length = 0;
  float block_total_length = 0;
  libspectrum_id_t type;

  size_t i;

  error = read_file( filename, &buffer, &length ); if( error ) return error;

  error = libspectrum_identify_file( &type, filename, buffer, length );
  if( error != LIBSPECTRUM_ERROR_NONE ) {
    free( buffer );
    return error;
  }

#ifdef HAVE_ICONV
  /* Looks like GNU libc iconv needs to have the character type locale set
     to do the current locale target thing (but oddly GNU libiconv doesn't) */
#ifdef HAVE_SETLOCALE
  setlocale(LC_CTYPE, "");
#endif /* #ifdef HAVE_SETLOCALE */
  switch( type ) {
  case LIBSPECTRUM_ID_TAPE_TZX:
    /* Convert from Windows code page 1252 to our current locale.
       CP1252 is a valid name of the Windows-1252 charset used by WoS, Tapir and
       ZX-Blockeditor on at least Linux, MacOS X and Solaris 9. If we need to
       use another string on another OS we will need to do a little more work */
    conversion_descriptor = iconv_open("", "CP1252");
    break;
  case LIBSPECTRUM_ID_TAPE_PZX:
    conversion_descriptor = iconv_open("", "UTF-8");
    break;
  default:
    conversion_descriptor = (iconv_t)(-1);
    break;
  }
#endif /* #ifdef HAVE_ICONV */

  tape = libspectrum_tape_alloc();

  error = libspectrum_tape_read( tape, buffer, length, LIBSPECTRUM_ID_UNKNOWN,
                                 filename );
  if( error != LIBSPECTRUM_ERROR_NONE ) {
    free( buffer );
    return error;
  }

  free( buffer );

  printf( "\n\nListing of `%s':\n\n", filename );

  block = libspectrum_tape_iterator_init( &iterator, tape );

  while( block ) {
    char description[ DESCRIPTION_LENGTH ];

    error =
      libspectrum_tape_block_description( description, DESCRIPTION_LENGTH,
					  block );
    if( error ) return 1;
    printf( "--= Block #%d =--\n", block_num );
    printf( "  Block type 0x%02x (%s)\n", libspectrum_tape_block_type( block ),
	    description );
    block_total_length = (libspectrum_tape_block_length( block ) / 3500000.0);
    printf( "  Block duration: %.2f sec\n", block_total_length );
    block_total_length *= current_loop_count;
    tape_total_length += block_total_length;

    switch( libspectrum_tape_block_type( block ) ) {

    case LIBSPECTRUM_TAPE_BLOCK_ROM:
      {
        printf("  Block length: %lu bytes\n",
               (unsigned long)libspectrum_tape_block_data_length( block ) );
        decode_header( block );
        printf("  Pause length: %d ms\n",
               libspectrum_tape_block_pause( block ) );
      }
      break;

    case LIBSPECTRUM_TAPE_BLOCK_TURBO:
      printf("  %lu pilot pulses of %d tstates\n",
	     (unsigned long)libspectrum_tape_block_pilot_pulses( block ),
	     libspectrum_tape_block_pilot_length( block ) );
      printf("  Sync pulses of %d and %d tstates\n",
	     libspectrum_tape_block_sync1_length( block ),
	     libspectrum_tape_block_sync2_length( block ) );
      /* Fall through */

    case LIBSPECTRUM_TAPE_BLOCK_PURE_DATA:
      printf("  Data bits are %d (reset) and %d (set) tstates\n",
	     libspectrum_tape_block_bit0_length( block ),
	     libspectrum_tape_block_bit1_length( block ) );
      printf("  Data length: %lu bytes (%lu bits in last byte used)\n",
	     (unsigned long)libspectrum_tape_block_data_length( block ),
	     libspectrum_tape_block_bits_in_last_byte(block) ? 
               (unsigned long)libspectrum_tape_block_bits_in_last_byte(block) :
               8 );
      printf("  Pause length: %d ms\n",
	     libspectrum_tape_block_pause( block ) );
      break;

    case LIBSPECTRUM_TAPE_BLOCK_PURE_TONE:
      printf("  %lu pulses of %lu tstates\n",
	     (unsigned long)libspectrum_tape_block_count( block ),
	     (unsigned long)libspectrum_tape_block_pulse_length( block ) );
      break;

    case LIBSPECTRUM_TAPE_BLOCK_PULSES:
      for( i=0; i < libspectrum_tape_block_count( block ); i++ )
        printf("  Pulse %3lu: length %d tstates\n",
	       (unsigned long)i,
	       libspectrum_tape_block_pulse_lengths( block, i ) );
      break;

    case LIBSPECTRUM_TAPE_BLOCK_RAW_DATA:
      printf("  Length: %lu bytes\n", (unsigned long)
	     libspectrum_tape_block_data_length( block ) );
      printf("  Bits in last byte: %lu\n",
	     (unsigned long)libspectrum_tape_block_bits_in_last_byte(block) );
      printf("  Each bit is %d tstates\n",
	     libspectrum_tape_block_bit_length( block ) );
      printf("  Pause length: %d ms\n",
	     libspectrum_tape_block_pause( block ) );
      break;

    case LIBSPECTRUM_TAPE_BLOCK_GENERALISED_DATA:
      printf("  Pause length: %d ms\n", libspectrum_tape_block_pause( block ) );
      printf("  Pilot table:\n");
      dump_symbol_table( libspectrum_tape_block_pilot_table( block ) );
      dump_pilot_repeats( block );
      printf("  Data table:\n");
      dump_symbol_table( libspectrum_tape_block_data_table( block ) );
      break;

    case LIBSPECTRUM_TAPE_BLOCK_PAUSE:
      printf( "  Initial polarity: " );
      if( libspectrum_tape_block_level( block ) < 0 ) {
        printf( "none specified\n" );
      } else {
        printf( "%s\n",
                libspectrum_tape_block_level( block ) ? "high" : "low" );
      }
      printf("  Length: %d ms\n", libspectrum_tape_block_pause( block ) );
      break;

    case LIBSPECTRUM_TAPE_BLOCK_GROUP_START:
      printf("  Name: %s\n", 
                    convert_charset( libspectrum_tape_block_text( block ) ) );
      break;

    case LIBSPECTRUM_TAPE_BLOCK_GROUP_END:
    case LIBSPECTRUM_TAPE_BLOCK_STOP48:
      /* Do nothing */
      break;

    case LIBSPECTRUM_TAPE_BLOCK_LOOP_END:
      current_loop_count = 1;
      break;

    case LIBSPECTRUM_TAPE_BLOCK_SET_SIGNAL_LEVEL:
      printf( "  Polarity: %s\n",
                libspectrum_tape_block_level( block ) ? "high" : "low" );
      break;

    case LIBSPECTRUM_TAPE_BLOCK_JUMP:
      printf("  Offset: %d\n", libspectrum_tape_block_offset( block ) );
      break;

    case LIBSPECTRUM_TAPE_BLOCK_LOOP_START:
      current_loop_count = libspectrum_tape_block_count( block );
      printf( "  Count: %lu\n", (unsigned long)current_loop_count );
      break;

    case LIBSPECTRUM_TAPE_BLOCK_SELECT:
      for( i = 0; i < libspectrum_tape_block_count( block ); i++ ) {
        printf("  Choice %2lu: Offset %d: %s\n", (unsigned long)i,
	       libspectrum_tape_block_offsets( block, i ),
               convert_charset( libspectrum_tape_block_texts( block, i ) ) );
      }
      break;


    case LIBSPECTRUM_TAPE_BLOCK_MESSAGE:
      printf("  Display for %d ms\n",
	     libspectrum_tape_block_pause( block ) );
      /* Fall through */

    case LIBSPECTRUM_TAPE_BLOCK_COMMENT:
      printf("  Comment: %s\n", 
               convert_charset( libspectrum_tape_block_text( block ) ) );
      break;

    case LIBSPECTRUM_TAPE_BLOCK_ARCHIVE_INFO:
      for( i = 0; i < libspectrum_tape_block_count( block ); i++ ) {
	printf("  ");
	switch( libspectrum_tape_block_ids( block, i ) ) {
	case   0: printf("Full Title:"); break;
	case   1: printf(" Publisher:"); break;
	case   2: printf("    Author:"); break;
	case   3: printf("      Year:"); break;
	case   4: printf("  Language:"); break;
	case   5: printf("  Category:"); break;
	case   6: printf("     Price:"); break;
	case   7: printf("    Loader:"); break;
	case   8: printf("    Origin:"); break;
	case 255: printf("   Comment:"); break;
        default: printf("(Unknown string): "); break;
	}
	printf(" %s\n", 
               convert_charset( libspectrum_tape_block_texts( block, i ) ));
      }
      break;

    case LIBSPECTRUM_TAPE_BLOCK_HARDWARE:
      for( i = 0; i < libspectrum_tape_block_count( block ); i++ ) {
	printf( "  %s: ",
	        hardware_desc( libspectrum_tape_block_types( block, i ),
			       libspectrum_tape_block_ids( block, i )
			     )
	      );
	switch( libspectrum_tape_block_values( block, i ) ) {
	case 0: printf("runs"); break;
	case 1: printf("runs, using hardware"); break;
	case 2: printf("runs, does not use hardware"); break;
	case 3: printf("does not run"); break;
	}
	printf("\n");
      }
      break;

    case LIBSPECTRUM_TAPE_BLOCK_CUSTOM:
      printf( "  Description: %s\n", 
                    convert_charset( libspectrum_tape_block_text( block ) ) );
      printf( "       Length: %lu bytes\n",
	      (unsigned long)libspectrum_tape_block_data_length( block ) );
      break;

    case LIBSPECTRUM_TAPE_BLOCK_PULSE_SEQUENCE:
      printf( "  Initial polarity: low\n" );
      for( i=0; i < libspectrum_tape_block_count( block ); i++ )
        printf("  Pulse %3lu: length %4d tstates, repeated %4lu times\n",
             (unsigned long)i,
             libspectrum_tape_block_pulse_lengths( block, i ),
             (unsigned long)libspectrum_tape_block_pulse_repeats( block, i ) );
      break;

    case LIBSPECTRUM_TAPE_BLOCK_DATA_BLOCK:
      printf( "  Initial polarity: " );
      if( libspectrum_tape_block_level( block ) < 0 ) {
        printf( "none specified\n" );
      } else {
        printf( "%s\n",
                libspectrum_tape_block_level( block ) ? "high" : "low" );
      }
      printf("  Reset data bits are\n");
      for( i=0; i < libspectrum_tape_block_bit0_pulse_count( block ); i++ )
        printf("    Pulse %3lu: length %4d tstates\n",
             (unsigned long)i,
             libspectrum_tape_block_bit0_pulses( block, i ) );
      printf("  Set data bits are\n");
      for( i=0; i < libspectrum_tape_block_bit1_pulse_count( block ); i++ )
        printf("    Pulse %3lu: length %4d tstates\n",
             (unsigned long)i,
             libspectrum_tape_block_bit1_pulses( block, i ) );
      printf("  Data length: %lu bytes (%lu bits in last byte used)\n",
	     (unsigned long)libspectrum_tape_block_data_length( block ),
	     libspectrum_tape_block_bits_in_last_byte(block) ? 
               (unsigned long)libspectrum_tape_block_bits_in_last_byte(block) :
               8 );
      printf("  Tail length: %d tstates\n",
	     libspectrum_tape_block_tail_length( block ) );
      decode_header( block );
      break;

    /* Libspectrum up to 1.5.0 has no support for blocks:
       LIBSPECTRUM_TAPE_BLOCK_CSW (0x18)
       LIBSPECTRUM_TAPE_BLOCK_SEQ_CALL (0x26)
       LIBSPECTRUM_TAPE_BLOCK_SEQ_RET (0x27)
    */
    default:
      printf("  (Sorry -- %s can't handle that kind of block. Skipping it)\n",
	     progname );
      break;
    }

    block = libspectrum_tape_iterator_next( &iterator );
    printf( "\n" );
    block_num++;

  }

  min = tape_total_length / 60;
  sec = tape_total_length - min * 60;
  printf( "Total tape duration: %d min, %.2f sec\n", min, sec );

  error = libspectrum_tape_free( tape );
  if( error != LIBSPECTRUM_ERROR_NONE ) return error;

#ifdef HAVE_ICONV
  if( conversion_descriptor != (iconv_t)(-1) ) {
    error = iconv_close( conversion_descriptor ); if( error ) return error;
  }
#endif /* #ifdef HAVE_ICONV */

  return 0;
}

static void
show_version( void )
{
  printf(
    PROGRAM_NAME " (" PACKAGE ") " PACKAGE_VERSION "\n"
    "Copyright (c) 2001-2011 Philip Kendall, Darren Salt, Fredrick Meunier\n"
    "License GPLv2+: GNU GPL version 2 or later "
    "<http://gnu.org/licenses/gpl.html>\n"
    "This is free software: you are free to change and redistribute it.\n"
    "There is NO WARRANTY, to the extent permitted by law.\n" );
}

static void
show_help( void )
{
  printf(
    "Usage: %s [OPTION] <tapefile>...\n"
    "Outputs a description of the contents of TZX, TAP, PZX and Warajevo tape files.\n"
    "\n"
    "Options:\n"
    "  -d <num>       Dump standard block (header and data) number <num>.\n"
    "                   Use -1 to dump all blocks.\n"
    "  -h, --help     Display this help and exit.\n"
    "  -V, --version  Output version information and exit.\n"
    "\n"
    "Report %s bugs to <%s>\n"
    "%s home page: <%s>\n"
    "For complete documentation, see the manual page of %s.\n",
    progname,
    PROGRAM_NAME, PACKAGE_BUGREPORT, PACKAGE_NAME, PACKAGE_URL, PROGRAM_NAME
  );
}

int
main( int argc, char **argv )
{
  int ret = 0;
  int i;
  int c, error = 0;

  struct option long_options[] = {
    { "help", 0, NULL, 'h' },
    { "version", 0, NULL, 'V' },
    { 0, 0, 0, 0 }
  };

  progname = argv[0];

  while( ( c = getopt_long( argc, argv, "d:hV", long_options, NULL ) ) != -1 ) {

    switch( c ) {

    case 'd':
      dump_block = atoi( optarg );
      break;

    case 'h':
      show_help();
      return 0;

    case 'V':
      show_version();
      return 0;

    case '?':
      /* getopt prints an error message to stderr */
      error = 1;
      break;

    default:
      error = 1;
      fprintf( stderr, "%s: unknown option `%c'\n", progname, (char) c );
      break;

    }
  }

  argc -= optind;
  argv += optind;

  if( error ) {
    fprintf( stderr, "Try `%s --help' for more information.\n", progname );
    return error;
  }

  if( argc < 1 ) {
    fprintf( stderr, "%s: usage: %s [OPTION] <tape files>...\n", progname,
             progname );
    fprintf( stderr, "Try `%s --help' for more information.\n", progname );
    return 1;
  }

  error = init_libspectrum(); if( error ) return error;


  for( i = 0; i < argc; i++ ) {
    ret |= process_tape( argv[i] );
  }

  return ret;
}