xenial (1) rsrce.1.gz

Provided by: rsrce_0.2.2_amd64 bug

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>

SEE ALSO

       hfsutils(1), macutil(1)