135 lines
3.2 KiB
Groff
135 lines
3.2 KiB
Groff
.TH MACONV 1 "2019-01-04" "v1.0" "maconv"
|
|
|
|
.SH NAME
|
|
maconv \- Macintosh format converter
|
|
|
|
.SH SYNOPSIS
|
|
.B "maconv c [options] input-file [output-file]"
|
|
.br
|
|
.B "maconv e [options] input-file [output-folder]"
|
|
.br
|
|
.B "maconv d [options] input-folder [output-file]"
|
|
|
|
|
|
.SH DESCRIPTION
|
|
\fBmaconv\fR(1) is a Linux software that can convert all kinds
|
|
of old Macintosh formats, including MacBinary, Stuffit archives and HFS disk
|
|
files.
|
|
|
|
|
|
.SH OPTIONS
|
|
Maconv has three sub-commands:
|
|
.BR "c" ", " "e" " and " "d" .
|
|
.br
|
|
Each sub-command can take the following flags:
|
|
|
|
.TP 4
|
|
.B "-h,--help"
|
|
Print an help message about \fBMaconv\fR and exit.
|
|
|
|
.TP 4
|
|
.B "-v,--verbose"
|
|
Enable verbose mode (i.e. log useful information when converting/extracting
|
|
files).
|
|
|
|
.RE
|
|
Some sub-commands take a format argument. This argument must be one of the
|
|
following formats:
|
|
.BR macbin ", " applesingle ", " rsrc " or " data " (saves only data fork)."
|
|
|
|
|
|
.RE
|
|
.B "FILE CONVERSION (maconv c)"
|
|
.RS 4
|
|
This sub-command converts a file from a format to another. Supported formats are
|
|
listed above. The command takes the following arguments:
|
|
|
|
.TP 4
|
|
.B "input-file"
|
|
The output format. If not provided this format is determined by the output
|
|
filename extension. If both this format and the output filename are not provided
|
|
the selected format is
|
|
.BR rsrc .
|
|
|
|
.TP 4
|
|
.B "output-file"
|
|
Name of the output file. This argument is optional. By default it's the name of
|
|
the input file with another extension for a format that generates only one file
|
|
or the "real" name of the file for other formats.
|
|
|
|
.TP 4
|
|
.BI "-f,--format" " format"
|
|
The output format. If not provided this format is determined by the output
|
|
filename extension. If both this format and the output filename are not provided
|
|
the selected format is
|
|
.BR rsrc .
|
|
|
|
|
|
.RE
|
|
.B "ARCHIVE EXTRACTION (maconv e)"
|
|
.RS 4
|
|
This sub-command extracts a Stuffit archive (version 1 or 5) or an HFS disk image.
|
|
The command takes the following arguments:
|
|
|
|
.TP 4
|
|
.B "input-file"
|
|
The input archive/disk image.
|
|
|
|
.TP 4
|
|
.B "output-folder"
|
|
The folder in which the archive/disk image will be extracted. This argument is
|
|
optional. By default the output folder is
|
|
.BR . " (current folder)."
|
|
|
|
.TP 4
|
|
.BI "-f,--format" " format"
|
|
Format with which extracted files will be saved. By default this format is
|
|
.BR rsrc .
|
|
|
|
|
|
.RE
|
|
.B "DISK CREATION (maconv d)"
|
|
.RS 4
|
|
This sub-command creates an HFS disk image from a folder (like a file archiver).
|
|
The command takes the following arguments:
|
|
|
|
.TP 4
|
|
.B "input-folder"
|
|
The input folder. Files in this folder will be added to the HFS disk image.
|
|
|
|
.TP 4
|
|
.B "output-file"
|
|
Name of the disk image to create. This argument is optional. By default the disk
|
|
image has the same name as the input folder plus
|
|
.IR .img .
|
|
|
|
.TP 4
|
|
.BI "-n,--name" " vol-name"
|
|
Name of the volume to create on the disk image. By default it's the base name of
|
|
the input folder.
|
|
|
|
|
|
.SH EXAMPLES
|
|
.TP 4
|
|
.B maconv c file-macbin.bin
|
|
Extract both data and ressource forks from
|
|
.I file-macbin.bin
|
|
(MacBinary format) and save them using
|
|
.BR rsrc " format."
|
|
|
|
.TP 4
|
|
.B maconv e -f macbin archive.sit
|
|
Extract a stuffit archive named
|
|
.IR archive.sit .
|
|
Extracted files are saved in
|
|
.B macbin
|
|
format.
|
|
|
|
|
|
.SH SEE ALSO
|
|
.BR unstuff "(1),"
|
|
.BR macunpack "(1)"
|
|
|
|
.SH AUTHOR
|
|
Guillaume Gonnet <Guillaume.Gonnet@grenoble-inp.org>
|