Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Enumerations
wimax.h File Reference
#include <linux/types.h>

Go to the source code of this file.

Enumerations

enum  { WIMAX_GNL_VERSION = 01, WIMAX_GNL_ATTR_INVALID = 0x00, WIMAX_GNL_ATTR_MAX = 10 }
 
enum  {
  WIMAX_GNL_OP_MSG_FROM_USER, WIMAX_GNL_OP_MSG_TO_USER, WIMAX_GNL_OP_RFKILL, WIMAX_GNL_OP_RESET,
  WIMAX_GNL_RE_STATE_CHANGE, WIMAX_GNL_OP_STATE_GET
}
 
enum  { WIMAX_GNL_MSG_IFIDX = 1, WIMAX_GNL_MSG_PIPE_NAME, WIMAX_GNL_MSG_DATA }
 
enum  wimax_rf_state { WIMAX_RF_OFF = 0, WIMAX_RF_ON = 1, WIMAX_RF_QUERY = 2 }
 
enum  { WIMAX_GNL_RFKILL_IFIDX = 1, WIMAX_GNL_RFKILL_STATE }
 
enum  { WIMAX_GNL_RESET_IFIDX = 1 }
 
enum  { WIMAX_GNL_STGET_IFIDX = 1 }
 
enum  { WIMAX_GNL_STCH_IFIDX = 1, WIMAX_GNL_STCH_STATE_OLD, WIMAX_GNL_STCH_STATE_NEW }
 
enum  wimax_st {
  __WIMAX_ST_NULL = 0, WIMAX_ST_DOWN, __WIMAX_ST_QUIESCING, WIMAX_ST_UNINITIALIZED,
  WIMAX_ST_RADIO_OFF, WIMAX_ST_READY, WIMAX_ST_SCANNING, WIMAX_ST_CONNECTING,
  WIMAX_ST_CONNECTED, __WIMAX_ST_INVALID
}
 

Enumeration Type Documentation

anonymous enum
Enumerator:
WIMAX_GNL_VERSION 

Version of the interface (unsigned decimal, MMm, max 25.5) M - Major: change if removing or modifying an existing call. m - minor: change when adding a new call

WIMAX_GNL_ATTR_INVALID 
WIMAX_GNL_ATTR_MAX 

Definition at line 56 of file wimax.h.

anonymous enum
Enumerator:
WIMAX_GNL_OP_MSG_FROM_USER 
WIMAX_GNL_OP_MSG_TO_USER 
WIMAX_GNL_OP_RFKILL 
WIMAX_GNL_OP_RESET 
WIMAX_GNL_RE_STATE_CHANGE 
WIMAX_GNL_OP_STATE_GET 

Definition at line 75 of file wimax.h.

anonymous enum
Enumerator:
WIMAX_GNL_MSG_IFIDX 
WIMAX_GNL_MSG_PIPE_NAME 
WIMAX_GNL_MSG_DATA 

Definition at line 86 of file wimax.h.

anonymous enum
Enumerator:
WIMAX_GNL_RFKILL_IFIDX 
WIMAX_GNL_RFKILL_STATE 

Definition at line 106 of file wimax.h.

anonymous enum
Enumerator:
WIMAX_GNL_RESET_IFIDX 

Definition at line 113 of file wimax.h.

anonymous enum
Enumerator:
WIMAX_GNL_STGET_IFIDX 

Definition at line 118 of file wimax.h.

anonymous enum
Enumerator:
WIMAX_GNL_STCH_IFIDX 
WIMAX_GNL_STCH_STATE_OLD 
WIMAX_GNL_STCH_STATE_NEW 

Definition at line 128 of file wimax.h.

Enumerator:
WIMAX_RF_OFF 
WIMAX_RF_ON 
WIMAX_RF_QUERY 

Definition at line 99 of file wimax.h.

enum wimax_st

enum wimax_st - The different states of a WiMAX device : The device structure has been allocated and zeroed, but still wimax_dev_add() hasn't been called. There is no state.

: The device has been registered with the WiMAX and networking stacks, but it is not initialized (normally that is done with 'ifconfig DEV up' [or equivalent], which can upload firmware and enable communications with the device). In this state, the device is powered down and using as less power as possible. This state is the default after a call to wimax_dev_add(). It is ok to have drivers move directly to WIMAX_ST_UNINITIALIZED or WIMAX_ST_RADIO_OFF in _probe() after the call to wimax_dev_add(). It is recommended that the driver leaves this state when calling 'ifconfig DEV up' and enters it back on 'ifconfig DEV down'.

: The device is being torn down, so no API operations are allowed to proceed except the ones needed to complete the device clean up process.

: [optional] Communication with the device is setup, but the device still requires some configuration before being operational. Some WiMAX API calls might work.

: The device is fully up; radio is off (wether by hardware or software switches). It is recommended to always leave the device in this state after initialization.

: The device is fully up and radio is on.

: [optional] The device has been instructed to scan. In this state, the device cannot be actively connected to a network.

: The device is connecting to a network. This state exists because in some devices, the connect process can include a number of negotiations between user space, kernel space and the device. User space needs to know what the device is doing. If the connect sequence in a device is atomic and fast, the device can transition directly to CONNECTED

: The device is connected to a network.

: This is an invalid state used to mark the maximum numeric value of states.

Description:

Transitions from one state to another one are atomic and can only be caused in kernel space with wimax_state_change(). To read the state, use wimax_state_get().

States starting with __ are internal and shall not be used or referred to by drivers or userspace. They look ugly, but that's the point – if any use is made non-internal to the stack, it is easier to catch on review.

All API operations [with well defined exceptions] will take the device mutex before starting and then check the state. If the state is __WIMAX_ST_NULL, WIMAX_ST_DOWN, WIMAX_ST_UNINITIALIZED or __WIMAX_ST_QUIESCING, it will drop the lock and quit with -EINVAL, -ENOMEDIUM, -ENOTCONN or -ESHUTDOWN.

The order of the definitions is important, so we can do numerical comparisons (eg: < WIMAX_ST_RADIO_OFF means the device is not ready to operate).

Enumerator:
__WIMAX_ST_NULL 
WIMAX_ST_DOWN 
__WIMAX_ST_QUIESCING 
WIMAX_ST_UNINITIALIZED 
WIMAX_ST_RADIO_OFF 
WIMAX_ST_READY 
WIMAX_ST_SCANNING 
WIMAX_ST_CONNECTING 
WIMAX_ST_CONNECTED 
__WIMAX_ST_INVALID 

Definition at line 225 of file wimax.h.