MORPHMINI(1)

Brendan Sleight <morphix@barwap.spam_removed.com>

NAME

morphmini - Creates a morphix mini module, using a template file.

SYNOPSIS

morphmini input.xml output.mod

DESCRIPTION

Morphmini creates a Morphix mini module output.mod, using xml template file input.xml. A really lazy way to build parts of a LiveCD. Its is mmaker little brother.

EXAMPLE TEMPLATE

This is an example template to show how morphmini works, listing all the possible options.

<comps>
 <group>
  <minimod>
   <version>0.0.1</version>
   <description>MorphMini Example</description>
   <minitag>Example</minitag>
   <maintag>ALL</maintag>
   <bootoption>ALL</bootoption> <!-- Only run the minimodule when this bootoption is used. Special case run ALL the time-->
   <filelist> <!-- files to be added to minimod available as $1/morphix/files/ -->
    <local>
     <file>/home/morph/test.jpg</file>
     <file>/home/morph/test2.jpg</file>
    </local>
    <remote>
     <file>http://www.barwap.com/morphix/mmorphix/morphixsound2.wav</file>
    </remote>
   </filelist>
   <root> <!-- Files or Packages to be overlaid on the rootfile system - good for saving ramspace -->
    <files>
     <local>
      <from>/home/morph/test.jpg</from>
      <to>/usr/share/misc/</to>
     </local>
     <local>
      <from>/home/morph/test2.jpg</from>
      <to>/usr/share/misc/</to>
     </local>
     <remote>
      <from>http://www.barwap.com/morphix/mmorphix/morphixsound2.wav</from>
      <to>/usr/share/misc/</to>
     </remote>
    </files>
    <packages>
     <local>
      <targz>/home/morph/example.tar.gz</targz>
     </local>
     <remote>
      <targz>http://www.barwap.com/morphix/rebrand/morphix-rebrand.tar.gz</targz>
     </remote>
    </packages>
   </root>
   <commandlist> <!-- Commands to be started from minimodule -->
    <preX>       <!-- Commands to run before X windows start -->
     <command>echo "Hello"</command>
     <command>echo "Hello 2"</command>
    </preX>
    <X>         <!-- Commands to run in X windows -->
     <command>xmessage --timeout 8 --center "Hello 3"</command>
     <command>display $1/morphix/test.jpg</command>
    </X>
    <postX>     <!-- Commands to run after X windows shutdown -->
     <command>echo "Hello 5"</command>
     <command>echo "Hello 6"</command>
    </postX>
   </commandlist>
   <other> <!-- used to make a minimodule in another way - command will be passed $1 for minimodule filesystem -->
    <buildcommand>echo "Hello World" &gt; $1/morphix/hello.txt</buildcommand>
   </other>
  </minimod>
 </group>
</comps>

Most templates are much shorter. Sections version, bootoption, filelist, local, remote, commandlist, preX, X, postX are optional.

<comps>
 <group>
  <minimod>
   <description>MorphMini launch firefox</description>
   <minitag>MorphixMini-Firefox</minitag>
   <maintag>ALL</maintag>
   <commandlist>
    <X>
     <command>firefox http://www.morphix.org &amp; </command> <!-- &amp; is xml format for & -->
    </X>
   </commandlist>
  </minimod>
 </group>
</comps>

EXAMPLES

Build a Morphix mini module
morphmini example.xml output.mod

SECURITY

Needs to be run as root or via sudo. So has security implications.

NOTES

Morphix is a modular-based liveCD, designed to be easy to modify. The package morphing-tools and morphix-mmaker contains tools to help modify and build morphix-based LiveCDs.

BUGS

Dont panic. If you find one, report it to us, but please make sure you have read all of the documentation first. We have assumed that you have cloop device and have installed the packages morphing-tools and morphix-mmaker.

AUTHORS

Written by Alex de Landgraaf and other Morphix developers. Morphix web site. Browse cvs repository[http://sourceforge.net/projects/morphix] and cvs mailing lists for full list of developers and patches submitted.

This man page was written by Brendan Sleight using asciidoc

SEE ALSO

addtoiso, install2mainmod, isomaker, isomorph, make-iso, make-mini, minimod-gen, mmaker, module-builder, module-extractor, morphmini