docs/mkbiarch.8

   1 .\" PROCESS THIS FILE WITH
   2 .\" groff -man -Tascii mkbiarch.8
   3 .\"
   4 .TH mkbiarch 8 "2010-8-24" "LiveCD Tools" "User Manuals"
   5
   6 .SH NAME
   7 mkbiarch.py - make a multiple architecture Live boot disk image
   8 for USB, CF SSD or any disk from 2 architecturally different
   9 LiveCD ISO9660 image files.
  10
  11 .SH SYNOPSIS
  12 mkbiarch <LiveCDx86ISO>  <LiveCDx64ISO>  <MultipleArch Disk IMG File>
  13
  14 .SH DESCRIPTION
  15 .B mkbiarch(8)
  16 create a multiple architecture, bootable Live Disk image file (IMG)
  17 for use on USB or any disk (CF, SSD)
  18 from 2 LiveCD ISO9660 files of different architecture (ISO).
  19 .BR
  20
  21 .SH USAGE
  22 .B mkbiarch.py
  23 Fedora-13-i686-Live.iso
  24 Fedora-13-x86_64-Live.iso
  25 Fedora-13-MultiArch.img
  26
  27 Then to write it
  28 /bin/dd if=Fedora-13-MultiArch.img of=/dev/sdb bs=4M
  29
  30 In the above example, mkbiarch.py
  31 creates Fedora-Multi-arch.img
  32 from the two existing ISO9660 LiveCD image files.
  33 The resulting image file,
  34 is written to a raw disk device using
  35 .B dd(1)
  36 .BR
  37
  38
  39 .SH UNDER THE HOOD
  40 .B mkbiarch.py(8)
  41 first checks that the two ISO9660 image files exist. It will create a blank
  42 file using dd(1) writing data from /dev/zero, the size of the two ISO9660 images files combined.
  43 The blank file is then bound via loopback using
  44 .B losetup(8)
  45 partitioned, and bound at an offset via loopback
  46 of 512 bytes, this second loopback device is formatted type ext3 using
  47 .B mke2fs(8)
  48 This filesystem is mounted using
  49 .B mount(8)
  50 on a temporary directory. The two ISO9660 files are then mounted via loopback,
  51 files are copied using shutil module in Python, from them to the newly formatted
  52 filesystem in the image file. Data is gathered from the ISO9660 image files from it's isolinux.cfg,
  53 after the files are copied the loopbacked ISO9660 image files are released.
  54 .B extlinux(1)
  55 is installed to the loopback mounted filesystem on the target image file and an extlinux.conf
  56 is written. The temporary directories are unmounted using
  57 .B umount(8)
  58 and the looback devices are released.
  59 The temporary directories are then removed, and the resulting Multiple Architecture Disk Image
  60 File is moved using shutil to the specified location on the command line, which is provided as
  61 argument 3 to mkbiarch.py
  62
  63 .SH BUGS
  64 Please report any bugs to
  65 http://bugzilla.redhat.com
  66 under component livecd-tools
  67
  68 .SH AVAILABILITY
  69 To check out the git version of this program
  70  git clone git://git.fedorahosted.org/livecd
  71
  72 .SH AUTHOR
  73 Jasper Hartline <autopsy@liveprojects.info>
  74
  75 .SH CONTRIBUTORS
  76 .B Richard Shaw <email@address.com>
  77 pyparted suggestions and feedback
  78
  79 .B Jan Kratochvil <email@address.com>
  80 for the original bash script which
  81 the python version was derived
  82
  83 .SH "SEE ALSO"
  84 .BR livecd-creator(8),
  85 .BR livecd-iso-to-disk(8),
  86 .BR mke2fs(8),
  87 .BR losetup(8),
  88 .BR dd(1),
  89 .BR exlinux(1)