On this page
article
MAC_PICKER
MAC_PICKER Ask the user to interactively enter a MAC address via the Pager UI
When to use it
Use MAC_PICKER any time a payload needs a MAC address, such as for
a client or BSSID configuration or a target device."
Syntax
MAC_PICKER [text prompt] [default mac]
text prompt required
Text prompt / dialog title shown to the user. Text prompts should be kept short enough to fit on the device display.
default mac required
Default MAC address when the picker launches. Must be an empty string ("") for a blank prompt.
A default MAC should typically be provided. To prompt the user with no
default, usr a blank quoted string (
"") for the MAC parameter.
Results
MAC_PICKER will wait until the user has made a selection, pausing the payload.
MAC_PICKER exits with a return code of 0 if the user continues, and non-zero if the user cancels
MAC_PICKER returns the MAC address as the output
Examples
__userip=$(MAC_PICKER "Target MAC" "00:DE:AD:BE:EF:00") || exit 0
__userip=$(MAC_PICKER "No default MAC" "") || exit 0
Remember to enclose the prompt text in quotes if it contains spaces!