Macro Expansion Variables - Linksys SPA2102-AU Provisioning Manual

Chapter 4 Provisioning Field Reference

Macro Expansion Variables

The following macro variables are recognized within the following provisioning parameters:
•
•
•
•
•
•
•
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
Macro Name
$
A through P
SA through SD
MA
MAU
MAC
PN
Version 3.0
Profile_Rule
Profile_Rule_*
Resync_Trigger_*
Log_Resync_*
Upgrade_Rule
Log_Upgrade_*
GPP_* (under specific conditions)
Macro Expansion Variables
Table 4-4 summarizes the macro expansion variables.
Macro Expansion
The form $$ expands to a single $ character.
Replaced by the contents of the general purpose
parameters GPP_A through GPP_P.
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.
MAC address using lower case hex digits, for
example, 000e08aabbcc.
MAC address using upper case hex digits, for
example 000E08AABBCC.
MAC address using lower case hex digits, and
colons to separate hex digit pairs, for example
00:0e:08:aa:bb:cc.
Product Name, for example SPA2102.
Macro Expansion Variables
Linksys SPA Provisioning Guide
4-7