✎ 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

=== Comparison and logic ===
The standard operators for integral and string types (string ordering probably isn't necessary though):
<code>
== != < > <= >=
<code>

They should either evaluate to special boolean values "true"/"false", or we need to define truth rules for all types (e.g. integral types are true if not equal to zero).

=== 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: • week10 • socideas • week7 • uhci_port_reset_issue • journal • week6 • week12 • 2009 • week5

Navigation

Search

Toolbox

QR Code