LHA/LHarc self-extracting archive

From Just Solve the File Format Problem
(Difference between revisions)
Jump to: navigation, search
Line 13: Line 13:
 
Note that some relatives of LHA, such as [[LArc]] and [[PMA]], have self-extracting archive formats that are not covered here.
 
Note that some relatives of LHA, such as [[LArc]] and [[PMA]], have self-extracting archive formats that are not covered here.
  
== Discussion ==
 
 
The usual manner of creating a self-extracting archive is to first create a normal (.LZH/.LHA) archive, then run the software on that non-executable archive using the "<code>s</code>" function.
 
The usual manner of creating a self-extracting archive is to first create a normal (.LZH/.LHA) archive, then run the software on that non-executable archive using the "<code>s</code>" function.
  
 +
== Format details ==
 
LHarc v1.x can create archives in either [[DOS executable (.com)|COM]] or [[MS-DOS EXE|EXE]] format. LHA v2.x only supports EXE format.
 
LHarc v1.x can create archives in either [[DOS executable (.com)|COM]] or [[MS-DOS EXE|EXE]] format. LHA v2.x only supports EXE format.
  
 
Starting with v1.12, EXE files can be structured in two different ways: "Small model" (the default), or "Large model". Large model is selected by using the <code>/x</code> (v1.x) or <code>/x1</code> (v2.x) option.
 
Starting with v1.12, EXE files can be structured in two different ways: "Small model" (the default), or "Large model". Large model is selected by using the <code>/x</code> (v1.x) or <code>/x1</code> (v2.x) option.
 +
 +
=== Special filenames ===
 +
* '''!''' (versions ~1.13+)
 +
If a self-extracting file contains a member file named "!", that file will be displayed as text prior to extraction, with a prompt to continue. The documentation names this feature "telop".
 +
 +
* '''AUTOLARC.BAT''' (versions through ~1.12)
 +
If a self-extracting file contains a member file named "AUTOLARC.BAT", the BAT file will be executed after the files are extracted.
 +
 +
* '''AUTOLARC.BAT''' (1.x versions ~1.13+)
 +
A self-extracting file can optionally be created such that, if the end user supplies a customizable keyword on the command line, a member file named "AUTOLARC.BAT" will be executed after the files are extracted.
 +
 +
* '''!.BAT''' (2.x versions)
 +
If a self-extracting file contains a member file named "!.BAT", and the end user uses the special "<code>/!</code>" or "<code>-!</code>" option, the BAT file will be executed after the files are extracted. ''[Ed. note: Or so says the documentation. Confirmation needed.]''
  
 
== Identification ==
 
== Identification ==
Line 52: Line 65:
 
|DOS EXE    || 2.11-2.66 || S or L || 36  || "<code>LHA's SFX</code>"
 
|DOS EXE    || 2.11-2.66 || S or L || 36  || "<code>LHA's SFX</code>"
 
|}
 
|}
 
Additionally, DOS COM files start with byte {{magic|0xeb}}.
 
  
 
== Software ==
 
== Software ==
 
Refer to [[LHA#Software]], especially the main LHarc/LHA software.
 
Refer to [[LHA#Software]], especially the main LHarc/LHA software.

Revision as of 15:24, 26 February 2022

File Format
Name LHA/LHarc self-extracting archive
Ontology
Extension(s) special
Released ≤1989

LHA/LHarc self-extracting archive refers to the various self-extracting archive formats associated with the LHarc/LHA family of compressed archive utilities.

Refer to LHA for information about the underlying archive format.

This article primarily covers files for the DOS platform. (TODO: Other platforms.)

Note that some relatives of LHA, such as LArc and PMA, have self-extracting archive formats that are not covered here.

The usual manner of creating a self-extracting archive is to first create a normal (.LZH/.LHA) archive, then run the software on that non-executable archive using the "s" function.

Contents

Format details

LHarc v1.x can create archives in either COM or EXE format. LHA v2.x only supports EXE format.

Starting with v1.12, EXE files can be structured in two different ways: "Small model" (the default), or "Large model". Large model is selected by using the /x (v1.x) or /x1 (v2.x) option.

Special filenames

  • ! (versions ~1.13+)

If a self-extracting file contains a member file named "!", that file will be displayed as text prior to extraction, with a prompt to continue. The documentation names this feature "telop".

  • AUTOLARC.BAT (versions through ~1.12)

If a self-extracting file contains a member file named "AUTOLARC.BAT", the BAT file will be executed after the files are extracted.

  • AUTOLARC.BAT (1.x versions ~1.13+)

A self-extracting file can optionally be created such that, if the end user supplies a customizable keyword on the command line, a member file named "AUTOLARC.BAT" will be executed after the files are extracted.

  • !.BAT (2.x versions)

If a self-extracting file contains a member file named "!.BAT", and the end user uses the special "/!" or "-!" option, the BAT file will be executed after the files are extracted. [Ed. note: Or so says the documentation. Confirmation needed.]

Identification

LHarc/LHA self-extracting archives contain a text message that will be printed when the files are extracted, which could be useful for format identification. Unfortunately, the message is not consistently located or formatted.

An example of such a message is "LHarc's SFX 1.13S (c) Yoshi, 1989". It contains a version number (which may only be approximate), and usually an "S" or "L" suffix indicating Small or Large model.

The following table summarizes most of the DOS formats.

Exec. format Versions Model Offset Message begins...
DOS COM 1.00 6 "SFX of LHarc"
DOS COM 1.12-1.13 6 "LHarc's SFX"
DOS COM 1.14β 6 "LHARC SFX"
DOS EXE 1.00 38 "SFX of LHarc"
DOS EXE 1.12-1.13 S 38 "LHarc's SFX"
DOS EXE 1.14β S 38 "LHARC SFX"
DOS EXE 1.12-1.13 L 37 "LHarc's SFX"
DOS EXE 1.14β L 37 "LHARC SFX"
DOS EXE 2.05 S or L 36 "LH's SFX"
DOS EXE 2.06-2.10 S or L 36 "LHa's SFX"
DOS EXE 2.11-2.66 S or L 36 "LHA's SFX"

Software

Refer to LHA#Software, especially the main LHarc/LHA software.

Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox