pangolin

Run pangolin on the specified FASTA file

$ pangolin [path/to/file.fa]

$ pangolin --analysis-mode [accurate|fast|pangolearn|usher]

pangolin [options] device

-a
    Run in automatic mode, attempting to automatically detect and repair errors.

-v
    Enable verbose output, providing more detailed information about the analysis and repair process.

-r directory
    Specify a directory to save recovered files.

-t filesystem_type
    Force a specific file system type.
If not specified, Pangolin attempts to auto-detect it.

-n
    Run in non-interactive mode.
Pangolin will attempt to automatically fix problems without prompting the user.

-q
    Run in quiet mode, suppressing most output.

Pangolin is a powerful tool for analyzing and repairing various file system types. It offers comprehensive diagnostics, allowing users to identify and resolve a wide range of file system issues, including corruption, inconsistencies, and errors. Pangolin supports journaling, volume metadata, and file content analysis. The repair process includes, but is not limited to, the recovery of lost files, correction of metadata errors, and reconstruction of damaged data structures. Pangolin is designed to work with different file system formats to provide effective solutions for data recovery and file system health.

Pangolin should be used with caution, as incorrect repairs can lead to further data loss. It is highly recommended to create a backup of the file system before running Pangolin. The success of the repair process depends on the extent of the damage and the file system type.

Pangolin returns various exit codes to indicate the status of the operation:
0: No errors detected.
1: One or more errors were detected and repaired.
2: Errors were detected but could not be repaired.
Other non-zero codes may indicate internal errors or usage problems.

Before running Pangolin, it is strongly advised to back up the file system to prevent data loss during repair attempts.
Consider using tools such as dd or specialized imaging software to create a full backup of the device.

The development of Pangolin began in response to the increasing complexity of modern file systems and the need for more advanced repair tools. Initially focused on the ext family of file systems, its support expanded to include other popular file system types. Its usage has grown steadily as system administrators and data recovery specialists found it to be a valuable tool for maintaining file system integrity and recovering lost data.

fsck(8), debugfs(8), e2fsck(8)