00000000000000000000000000000000000000000000000000000000000000000000000000000080
                              Chameleon Bootloader
                                 boot time help

The boot prompt waits for you to type advanced startup options. If you don't
type anything, the computer continues starting up normally. It will use the
kernel and configuration files on the selected/default device, which it also
uses as the root device.
Use the following syntax, when typing advanced startup options:

  [device]<kernel> [arguments]

Arguments consist of either just a name, e.g. -v or a key=value pair,
e.g. rd=disk0s2. The latest are commonly referred to as "keys" and the first
as "flags". ????????????????? bs...
Use the following syntax when typing arguments (recommended):

  [flags] [Wait=y key] [any other key]

WARNINGS (OUTDATED*****): (feedback is welcome)
- At least Wait=y is breaking other keys/flags?, when typed after them. This
  is the main reason for the "argument" syntax above. If you have any problem
  of this nature please try the recommended syntax or play with it.
- Arguments with spaces on their name (marked with (*)) are failing when
  wrapped in quotation marks.

  Syntax examples:

    backup_kernel -legacy -v DSDT=/extra/test.aml Wait=y  <-- :( DSDT= failed
    backup_kernel -legacy -v Wait=y DSDT=/extra/test.aml  <-- :)

    rd(0,0)/test_kernel -v debug=0x144
    -v Wait=y UseMemDetect=n SMBIOSDefaults=n SMBIOS=/path/to/smbios.plist

Argument's names are case sensitive, values are not. Thus:
    /Extra/DSDT.aml = /extra/dsdt.aml, etc...

                                  Thanks ?????
 ============================================================================79

Special booter hotkeys:

  F5            Rescans optical drive.
  F10           Scans and displays all BIOS accessible drives.

Special booter commands:

  ?            Displays this file.
  ?memory      Displays information about the computer's memory.
  ?video       Displays VESA video modes supported by the computer's BIOS.
  ?norescan    Leaves optical drive rescan mode.
  ?lspci       Displays information about PCI buses and devices in the system.
  ?more        Displays the text on an extra txt file (needs to be supplied).
    Ex: ?more /extra/MoreInfo.txt

 ==============================================================================

Most used "flags" include: ?????????????

  rd=<BSD device name>  or  rd=*<IODeviceTree path>                     flag
    Used to specify the root device (selected volume), from were the booter
    will load start the System. ....when using Apple software RAID helper
    partitions (apple boot).?????????
      Ex: rd=disk0s2  or  rd=uuid (used in conjunction with boot-uuid=<UUID>)??
      Ex: rd=*/PCI0@0/CHN0@0/@0:1

  <kernel name>
    Specify a different kernel (name) to be loaded. Kernel must be in the
    "/" (root) of the selected/default volume.
      Ex: my_kernel ??

curruption on Chamatic theme, due to too many spaces; the size of the spaces
is "wrong"...???***
  boot-uuid=<UUID>                     flag
    Specify the UUID of the boot volume.
      Ex: boot-uuid=12345678-1234-1234-1234-123456789012

  -v
    Verbose boot: see what booter and kernel are doing on your back :)

  -s
    Single User Mode: Boot into CLI to perform tasks.

  -x
    Safe Mode: ignore System caches and disable most devices.

  -f
    Ignore caches: ignore System caches and boot normally.

  -F
    Ignore "Kernel Flags" specified in boot configuration file. ??

  64 BIT SPECIFIC STUFF... ??
  arch=i386/x86_64
    Specify kernel architecture to be loaded

  -legacy
    Legacy Mode: disable handling 64 bit apps on i386... ??
    Note: on Snow needs arch=i386 to work on 64 bit cpu's.. ??

  config=<path to file> ???? it's not working :-/
    Use an alternate/backup "override" Boot.plist file.
      Ex: config=/extra/testBoot.plist

  blacklist=0 Kernel flag used on Voodoo kernel and others based...???????

  kernel debug flags:  e.g. debug=0x144
  IOkit debug flags:   e.g. io=0xffffffff (defined in IOKit/IOKitDebug.h) ???

 ==============================================================================

Options useful either at the prompt or in com.apple.Boot.plist file: ?????

  "Root UUID"=<UUID> or y/n?????? (*) ...... man...... :-S                 key

  "Boot Device"=hd(x,y) ??????????                 key - corruption***

  Wait=Yes
    Pause before starting the kernel.??????

  kext=<path to folder> (ends with a / (slash))
    Use an alternate/backup folder with drivers, kext or mkext.
      Ex: kext=/extra/test/

  "MKext Cache"=<path to file>
    Use an alternate/backup "System" cache file.
      Ex: "MKext Cache"=rd(0,0)/Extensions.mkext

  Kernel=<file name>

  "Kernel Cache"=<path to file> ???? check this stuff - how does it work???
    Use an alternate/backup "Kernel" cache file.
      Ex: "Kernel Cache"=bt(0,0)/kernelcache_i386.A701C40B

  Note: damn long keys to type at the boot prompt!? :-/ UseKC would be enough!!
        Doesn't anyone use the prompt anymore? Going to keep this here just
        because i hope this file ends up on the trunk, but my Chazi will use
        UseKC :P - update above***
  UseKernelCache=Yes
    Yes will load the system prelinked kernel or the one specified by the user
    with "Kernel Cache" arg, and ignore /E/E kexts/mkext and system kext cache.

- Devices/Other:???

  UseMemDetect=No
    Disable memory modules?? info detection.
0000000000000000000000000000000000000000000000000000000000000000000000000000079

  EthernetBuiltIn=Yes
    Automatic device-properties generation, that sets "built-in" property
    for ethernet interfaces.

  USBBusFix=Yes
    Enable all USB fixes below (fixes can be used individually):
      EHCIacquire=Yes - Enable the EHCI fix.
      UHCIreset=Yes - Enable the UHCI fix.
      USBLegacyOff=Yes - Enable the USB Legacy fix.

  ForceHPET=Yes
    Force enabling HPET device on the PC's BIOS.

- Hibernation:

  Wake=No
    Disable wake up after hibernation.

  ForceWake=Yes
    Force using the sleepimage (when desired), if you get the message:
      "Hibernate image is too old by n seconds. Use ForceWake=y to override."

  WakeImage=<path to file>
    Use an alternate sleepimage file.
      Default path: /private/var/vm/sleepimage

- ACPI:

  DSDT=<path to file> or <file name>??????????????
    Override the default dsdt.aml paths/name.
    Default name: dsdt.aml
    Default paths:?????
    Ex:
0000000000000000000000000000000000000000000000000000000000000000000000000000079

  DropSSDT=Yes
    Skip the SSDT tables while relocating the ACPI tables.

  PciRoot=<value>                       <<<<<<< change "group" ??
    Use an alternate value for PciRoot UID. Can be retrieved from dsdt.aml
    by the booter, if supplied by the user and present on the ACPI table.
      Default value: 0

  RestartFix=yes
    Enable restart fix for Intel chipsets.

  GenerateCStates=Yes     Enable auto generation of Processor (C-States) and/or
  GeneratePStates=Yes       Performance (P-States) power states.

  EnableC2State=Yes       Enable specific Processor power states,
  EnableC3State=Yes         C2, C3, C4.
  EnableC4State=Yes

- Bios/smbios:???

  SMBIOS=<path to file> or <file name?????>
    Override the default smbios.plist paths/name.
      Default name: smbios.plist
      Default paths:?????
      Ex:

  SMBIOSdefaults=No
    Disable the use of Default values for SMBIOS overriding, when smbios.plist
    is not used.

  SystemType=<value>
    Set the system type where n is between 0..6 (default value =1 (Desktop).
0000000000000000000000000000000000000000000000000000000000000000000000000000079

According to CHANGES file, this should be SystemID, not SystemId! ????????
  SystemId=<UUID>
    Manually set the system UUID. (also known as Platform or Hardware UUID)
    SMUUID (reserved field) in smbios.plist config is deprecated.
      Ex: SystemId=12345678-1234-1234-1234-123456789012

- CD-ROM: (dvd??)

  "Rescan Prompt"=Yes (*)
    Prompts for enable CD-ROM rescan mode.

  Rescan=Yes
    Enable CD-ROM rescan mode.

  "Scan Single Drive"=Yes (*)
    Scan "only" the drive where the booter got loaded from.
    Fixes rescan pbs when using a DVD reader in AHCI mode, on some PC's.
- Ramdisk:

  *****add ramdisk stuff: ?rd, ?rd [m, u, e, d, i]

  md0=<path to file>
    Override the default "name"??? of raw img file, to be loaded into memory
    for use as the kernel's md0 ramdisk.
      Default name: Postboot.img
      Default paths:?????
      Ex:

- Gui/Graphics:

0000000000000000000000000000000000000000000000000000000000000000000000000000079
  "Legacy Logo"=Yes (*)     <-- seems to need quotes
    Use the legacy grey apple logo on the boot screen.

  GraphicsEnabler=Yes
    Automatic device-properties generation for gfx cards.
      Note: it doesn't work for all cards and you may have to perform
            additional patching to get advantage of
            the automatic dev-prop generation. (Leo??)

  UseAtiROM=Yes
    Use an alternate Ati ROM image 
      Default path: /Extra/<vendorid>_<devid>.rom
      Ex: /Extra/1002_1234.rom

  UseNvidiaROM=Yes
    Use an alternate Nvidia ROM image.
      Default path: /Extra/<vendorid>_<devid>.rom)
      Ex: /Extra/10DE_1234.rom

  VBIOS=Yes                (nVidia only)
    Inject VBIOS to device-properties.

  NVCAP_<devid>=<value>    (nVidia only)
    Specify NVCAP value. This value is a 20 bytes long hex string.
      Ex: NVCAP_05e2=0000000000000000000000000000000000000000

  AutoResolution=Yes
    Enable native resolution setting for booter Gui and System, even when
    graphics acceleration (qe/ci) is not available.

  Graphics Mode=WIDTHxHEIGHTxDEPTH + F2 (*) (AutoResolution only)
    Change or set current resolution while at boot prompt.
    Only works if AutoResolution is already enabled (AutoResolution=Yes).
      Ex: "Graphics Mode"=1024x768x32 + press F2 key     <-- needs quotes

- Modules:

  PatchKernel=Yes
    Enable on the fly kernel patching.

==============================================================================

  F8
  Tab

  "Text Mode"=<does this stuff work at all??>
    VGA Text Mode Dimensions

  device-properties ???????

  "Quiet Boot"=Yes (*)
    Use quiet boot mode (no messages or prompt).

  Timeout=<n>
    Number of seconds to pause at the boot: prompt.
    There are diff timeouts for hd boot and cdrom boot (8 sec).

  "Instant Menu"=Yes
    Force displaying the partition selection menu.

  "Default Partition"=hd(x,y)|UUID|"Label" (*)
    Sets the default boot partition, specified as a disk/partition pair,
    an UUID, or a label enclosed in quotes.

0000000000000000000000000000000000000000000000000000000000000000000000000000079
  "Hide Partition"=partition [;partition2 ...] (*)
    Remove unwanted partition(s) from the boot menu. Specified, possibly
    multiple times, as hd(x,y), an UUID or label enclosed in quotes.
    Only works for foreign partitions!! ?????

  "Rename Partition"=partition <alias> [;partition2 <alias2>...] (*)
    Rename partition(s) for the boot menu. Where partition is hd(x,y), UUID or
    label enclosed in quotes. Alias should be quoted when containing any space.

  GUI=No
    Disable the GUI.

  "Boot Banner"=No (*)
    Disable boot banner in GUI mode.

  Theme=<theme name>
    Specify the theme to use in GUI mode. Default theme's name is Default :P
      Ex: <key>Theme</key>
          <string>Embed</string>

  DebugInfo=Yes
    Enable display of some debug info (bla bla...) on GUI mode.