FREQ_REG_INFO

Section: Regulatory enforcement infrast (9)
Updated: February 2011
Index Return to Main Contents

NAME

freq_reg_info - get regulatory information for the given frequency

SYNOPSIS

int freq_reg_info(struct wiphy * wiphy, u32 center_freq, u32 desired_bw_khz, const struct ieee80211_reg_rule ** reg_rule);

ARGUMENTS

wiphy

: the wiphy for which we want to process this rule for

center_freq

: Frequency in KHz for which we want regulatory information for

desired_bw_khz

: the desired max bandwidth you want to use per channel. Note that this is still 20 MHz if you want to use HT40 as HT40 makes use of two channels for its 40 MHz width bandwidth. If set to 0 we'll assume you want the standard 20 MHz.

reg_rule

: the regulatory rule which we have for this frequency

DESCRIPTION

Use this function to get the regulatory rule for a specific frequency on a given wireless device. If the device has a specific regulatory domain it wants to follow we respect that unless a country IE has been received and processed already.

Returns 0 if it was able to find a valid regulatory rule which does apply to the given center_freq otherwise it returns non-zero. It will also return -ERANGE if we determine the given center_freq does not even have a regulatory rule for a frequency range in the center_freq's band. See freq_in_rule_band for our current definition of a band -- this is purely subjective and right now its 802.11 specific.

AUTHOR

Johannes Berg <johannes@sipsolutions.net>