Troubleshooting

Overview

This section provides solutions to common problems encountered when using Cabriolet.

Quick Diagnosis

Problem Likely Cause Solution

"Invalid CAB signature"

Corrupted or wrong file type

Common Errors

Slow extraction

Large LZX window or system resources

Performance Issues

Encoding errors

Character encoding mismatch

Encoding Issues

Memory errors

Insufficient RAM for algorithm

Performance Issues

Platform-specific failures

OS compatibility issues

Platform-Specific

Available Guides

Common Errors and Solutions

Solutions for frequently encountered errors:

  • Invalid file format errors

  • Checksum failures

  • Decompression errors

  • File not found issues

Platform-Specific Issues

Operating system-specific problems:

  • Windows path handling

  • macOS file system issues

  • Linux permission problems

  • Character encoding differences

Performance and Memory Problems

Resolving speed and resource issues:

  • Slow compression/decompression

  • High memory usage

  • Memory allocation failures

  • Optimization strategies

Handling Corrupted Archives

Dealing with damaged archives:

  • Detecting corruption

  • Using salvage mode

  • Partial recovery

  • Prevention strategies

Character Encoding Problems

Resolving text encoding issues:

  • Filename encoding

  • Content encoding

  • Cross-platform compatibility

  • UTF-8 vs. other encodings

Getting help

If you can’t find a solution here:

  1. Check the Error Classes Reference

  2. Review Examples for correct usage

  3. Search existing issues

  4. Create a new issue with details

Reporting Bugs

When reporting issues, include:

  • Cabriolet version (Cabriolet::VERSION)

  • Ruby version (ruby -v)

  • Operating system and version

  • Minimal reproducible example

  • Error messages and stack traces

  • Sample files (if possible)

See also

Table of contents