Ubuntu Manpage: rsrce - editor for raw MacOS resource forks

NAME

       rsrce - editor for raw MacOS resource forks

SYNOPSIS

       rsrce [-e] [-f script] [-o output-file] [input-file]

DESCRIPTION

       Rsrce  is a command driven Macintosh resource fork editor for Unix-like operating systems.
       It works with raw resource forks stored in Unix files, such as the .rsrc files produced by
       the macutil package.

       Rsrce  doesn't  allow  you  to  edit  the  resource  data  directly.   It  only  knows  to
       import/export them from/to files, performing conversion for  the  few  resource  types  it
       knows.

OPTIONS

       -e     When  this  option  is  given, the failure of an editor command will cause rsrce to
              quit immediately with a non-zero exit status. This is similar to the -e  option  to
              /bin/sh.

       -f script
              Instructs  rsrce  to  read its commands from the given script, instead of using the
              standard input.

       -o output-file
              Specifies a default output file for the writecommand.  Useful  when  calling  rsrce
              scripts which save their changes with a write command without a filename.

       If  an  input-file is specified, it is loaded before rsrce starts reading commands, and is
       used as the default output file if the -o option has not been given.

USAGE

Rsrce reads commands from the standard input. Unquoted whitespace is ignored, except for
the purpose of separating arguments. Empty lines are ignored, and a # at a position where
an argument would have started indicates a comment which extends to the end of the line.
Text within single quotes is used as-is. An unquoted backslash can be used the way it
works in C strings, or to force literal interpretation of the following character.

Resources are referred to by specifing their type and id, separated by a colon. I mean,
something like "STR#:128". If the given type has less than 4 letters, spaces are added to
complete it.

The following commands are available:

read [file]
read the resources from file

write [file]
write the resources to file

create resource
create a new, empty resource with the given type and id

delete resource
remove the specified resource

rename resource new-name
change the name associated with resource to new-name

chattr resource attr-spec
change the attributes of resource according to attr-spec

ls list each resource's type, id, attributes, data lenght, and name

hexdump resource
show an hexdump of resource's data

import|export resource file [ext]
import/export resource's data from/to file. The conversion which is performed
depends on the extension of the given filename. This extenstion may be overriden
by providing the extargument.

edit resource[ext]
invoke an external editor to change resource's data

help list available commands

exit terminate rsrce (without saving, use write before exit if you wish to save your
changes)

CONVERSION OF RESOURCE DATA

       When  rsrce  imports  or exports resource data, a conversion can be performed depending on
       the resource type and the extension of the provided filename.

       The following extensions are known to rsrce:

       bin    causes no conversion, the raw resource data is  used  regardless  of  the  resource
              type;

       txt    causes  the resource data to be converted to plain text.  This is possible for STR,
              STR#andCMDLresources.

BUGS

       Rsrce has only been originally created to change the configuration  of  the  miBoot  Linux
       bootloader  for  OldWorld  PowerMac computers.  Since I do not use MacOS, I haven't tested
       any other usage of this program.  You should therefore be very careful when using  it,  as
       it could very well produce unusable output.

       Another  consequence  of  this is wildly missing functionnality.  I'm not going to work on
       it, since I couldn't test anything in a real  situation.   Patches  and/or  usage  reports
       would be very welcome.

AUTHOR

       Jeremie Koenig <sprite@sprite.fr.eu.org>