✎ dev:scripting:start - Etherboot/gPXE Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

This page is for brainstorming a scripting language for gPXE.

=== Commands ===
The current gPXE shell strips whitespace from a line and splits into an ''argv[]'' array:
<code>
command [arg1 [arg2 [arg3 ...]]]
</code>

=== Variables ===
Currently, settings like the IP address and boot filename are available as variables.  In the future, scripts should be able to create temporary variables as scratch space.
<code>
set net0/ip 192.168.0.1
set my_ip 10.0.0.15
show net0/netmask
clear net0/gateway
</code>

We need variable expansion:
<code>
dhcp ${my_iface}
initrd http://etherboot.org/initrds/${node_id}.bz2
</code>

"References" could work like this:
<code>
set ref_to_ip net0/ip
show ${ref_to_ip}
=> ...value of net0/ip...
</code>

=== Arithmetic ===
Standard arithmetic operators should work for integral types:
<code>
set i ${i + 1}
# same for -, *, /
</code>

Bitwise operators ''|'', ''&'', ''^'', and ''~'' may be needed? 

=== String manipulation ===
TODO

=== Control flow ===
The only control flow statement is the ''if'' statement:
<code>
if <expression> goto <label>
</code>

For example:
<code>
set i 0
loop:
    dhcp net${i}
    kernel ${kernel_url}
    boot
    set i ${i + 1}
    if ${i < $iface_count} goto loop
</code>

=== Needs discussion ===
  * We probably need an exit code built-in variable like ''$?'' in POSIX shell.
  * More use cases so we know what users need.

Trace: • staging • week4 • buildbot • socideas • week2 • sanboot • usb_todo • linux_mkbootfs • romburning • week10 • week3 • week1 • wrapup • weekb3 • win2k8_iscsi_install