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.

The MAC picker dialog
The MAC picker dialog
The MAC picker editor
The MAC picker editor

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