Specifications

4-7

Linksys SPA Provisioning Guide

Version 3.01

Chapter 4 Provisioning Field Reference

Macro Expansion Variables

The following macro variables are recognized within the following provisioning parameters:

• Profile_Rule

• Profile_Rule_*

• Resync_Trigger_*

• Log_Resync_*

• Upgrade_Rule

• Log_Upgrade_*

• GPP_* (under specific conditions)

Within these parameters, syntax types, such as $NAME or $(NAME), are recognized and expanded.

Macro variable substrings can be specified with the notation $(NAME:p) and $(NAME:p:q), where p

and q are non-negative integers (available in revision 2.0.11 and above). The resulting macro expansion

is the substring starting at character offset p, with length q (or else till end-of-string if q is not specified).

For example, if GPP_A contains ABCDEF, then $(A:2) expands to CDEF, and $(A:2:3) expands to CDE.

An unrecognized name is not translated, and the $NAME or $(NAME) form remains unchanged in the

parameter value after expansion.

Table 4-4 summarizes the macro expansion variables.

Table 4-4 Macro Expansion Variables

Macro Name Macro Expansion

$ The form $$ expands to a single $ character.

A through P Replaced by the contents of the general purpose

parameters GPP_A through GPP_P.

SA through SD Replaced by the contents of the special purpose

parameters GPP_SA through GPP_SD. These

parameters are meant to hold keys or passwords

used in provisioning.

Note that $SA through $SD are only recognized

as arguments to the optional resync URL

qualifier --key, as in the following example:

[--key $SA]

http://ps.callme.com/profiles/abcdefg.cfg

These variables are not expanded outside of this

limited context.

MA MAC address using lower case hex digits, for

example, 000e08aabbcc.

MAU MAC address using upper case hex digits, for

example 000E08AABBCC.

MAC MAC address using lower case hex digits, and

colons to separate hex digit pairs, for example

00:0e:08:aa:bb:cc.

PN Product Name, for example SPA2102.