iPXE
Macros
Bits for the 802.11 association state field

Macros

#define NET80211_STATUS_MASK   0x7F
 An error code indicating the failure mode, or 0 if successful. More...
 
#define NET80211_IS_REASON   0x80
 Whether the error code provided is a "reason" code, not a "status" code. More...
 
#define NET80211_PROBED   (1 << 8)
 Whether we have found the network we will be associating with. More...
 
#define NET80211_AUTHENTICATED   (1 << 9)
 Whether we have successfully authenticated with the network. More...
 
#define NET80211_ASSOCIATED   (1 << 10)
 Whether we have successfully associated with the network. More...
 
#define NET80211_CRYPTO_SYNCED   (1 << 11)
 Whether we have completed security handshaking with the network. More...
 
#define NET80211_WORKING   (1 << 12)
 Whether the auto-association task is running. More...
 
#define NET80211_WAITING   (1 << 13)
 Whether the auto-association task is waiting for a reply from the AP. More...
 
#define NET80211_NO_ASSOC   (1 << 14)
 Whether the auto-association task should be suppressed. More...
 
#define NET80211_AUTO_SSID   (1 << 15)
 Whether this association was performed using a broadcast SSID. More...
 

Detailed Description

Macro Definition Documentation

◆ NET80211_STATUS_MASK

#define NET80211_STATUS_MASK   0x7F

An error code indicating the failure mode, or 0 if successful.

Definition at line 185 of file net80211.h.

◆ NET80211_IS_REASON

#define NET80211_IS_REASON   0x80

Whether the error code provided is a "reason" code, not a "status" code.

Definition at line 188 of file net80211.h.

◆ NET80211_PROBED

#define NET80211_PROBED   (1 << 8)

Whether we have found the network we will be associating with.

Definition at line 191 of file net80211.h.

◆ NET80211_AUTHENTICATED

#define NET80211_AUTHENTICATED   (1 << 9)

Whether we have successfully authenticated with the network.

This usually has nothing to do with actual security; it is a holdover from older 802.11 implementation ideas.

Definition at line 198 of file net80211.h.

◆ NET80211_ASSOCIATED

#define NET80211_ASSOCIATED   (1 << 10)

Whether we have successfully associated with the network.

Definition at line 201 of file net80211.h.

◆ NET80211_CRYPTO_SYNCED

#define NET80211_CRYPTO_SYNCED   (1 << 11)

Whether we have completed security handshaking with the network.

Once this is set, we can send data packets. For that reason this bit is set even in cases where no security handshaking is required.

Definition at line 209 of file net80211.h.

◆ NET80211_WORKING

#define NET80211_WORKING   (1 << 12)

Whether the auto-association task is running.

Definition at line 212 of file net80211.h.

◆ NET80211_WAITING

#define NET80211_WAITING   (1 << 13)

Whether the auto-association task is waiting for a reply from the AP.

Definition at line 215 of file net80211.h.

◆ NET80211_NO_ASSOC

#define NET80211_NO_ASSOC   (1 << 14)

Whether the auto-association task should be suppressed.

This is set by the ‘iwlist’ command so that it can open the device without starting another probe process that will interfere with its own.

Definition at line 223 of file net80211.h.

◆ NET80211_AUTO_SSID

#define NET80211_AUTO_SSID   (1 << 15)

Whether this association was performed using a broadcast SSID.

If the user opened this device without netX/ssid set, the device's SSID will be set to that of the network it chooses to associate with, but the netX/ssid setting will remain blank. If we don't remember that we started from no specified SSID, it will appear every time settings are updated (e.g. after DHCP) that we need to reassociate due to the difference between the set SSID and our own.

Definition at line 234 of file net80211.h.