man/man1/megatron.1

   1 .TH MEGATRON 1 "8 Jan 1992" "netatalk 1.2"
   2 .SH NAME
   3 megatron, unhex, unbin, unsingle, hqx2bin, single2bin, macbinary \- Macintosh file format transformer
   4 .SH SYNOPSIS
   5 .B megatron
   6 [
   7 .I sourcefile...
   8 ]
   9 .LP
  10 .B unbin
  11 [
  12 .I sourcefile...
  13 ]
  14 .LP
  15 .B unhex
  16 [
  17 .I sourcefile...
  18 ]
  19 .LP
  20 .B unsingle
  21 [
  22 .I sourcefile...
  23 ]
  24 .LP
  25 .B hqx2bin
  26 [
  27 .I sourcefile...
  28 ]
  29 .LP
  30 .B single2bin
  31 [
  32 .I sourcefile...
  33 ]
  34 .LP
  35 .B macbinary
  36 [
  37 .I sourcefile...
  38 ]
  39 .SH DESCRIPTION
  40 .B megatron
  41 is used to transform files from BinHex, MacBinary, AppleSingle, or
  42 .B netatalk
  43 style AppleDouble formats into MacBinary or
  44 .B netatalk
  45 style AppleDouble formats.  The
  46 .B netatalk
  47 style AppleDouble format is the file format used by
  48 .B afpd,
  49 the
  50 .B netatalk
  51 Apple Filing Protocol (AppleShare) server.  BinHex, MacBinary, and
  52 AppleSingle are commonly used formats for transferring Macintosh files
  53 between machines via email or file transfer protocols.
  54 .B megatron
  55 uses its name to determine what type of tranformation is being asked of
  56 it.
  57 .LP
  58 If
  59 .B megatron
  60 is called as
  61 .B unhex, unbin,
  62 or
  63 .B unsingle,
  64 it tries to convert file(s) from BinHex, MacBinary, or AppleSingle into
  65 AppleDouble format.  BinHex is the format most often used to send
  66 Macintosh files by e-mail.  Usually these files have an extension of
  67 ".hqx".  MacBinary is the format most often used by terminal emulators
  68 "on the fly" when transferring Macintosh files in binary mode.
  69 MacBinary files often have an extension of ".bin".  Some Macintosh
  70 LAN-based email packages use uuencoded AppleSingle format to "attach"
  71 or "enclose" files in email.  AppleSingle files don't have a standard
  72 filename extension.
  73 .LP
  74 If
  75 .B megatron
  76 is called as
  77 .B hqx2bin, single2bin,
  78 or
  79 .B macbinary,
  80 it will try to convert the file(s) from BinHex, AppleSingle, or
  81 AppleDouble into MacBinary.  This last translation may be useful in
  82 moving Macintosh files from your
  83 .B afpd
  84 server to some other machine when you can't copy them from the server
  85 using a Macintosh for some reason.
  86 .LP
  87 If
  88 .B megatron
  89 is called with any other name, it uses the default translation, namely
  90 .B unhex.
  91 .LP
  92 If no source file is given, or if
  93 .I sourcefile
  94 is
  95 .RB ` - ',
  96 and if the conversion is from a BinHex or MacBinary file,
  97 .B megatron
  98 will read from standard input.
  99 .LP
 100 The filename used to store any output file is the filename that is
 101 encoded in the source file.  MacBinary files are created with a ".bin"
 102 extension.  In the case of conflicts, the old file is overwritten!
 103 .SH SEE ALSO
 104 .BR afpd (8)