![]() |
![]() |
![]() |
libnm-util Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#define NM_SETTING_GSM_SETTING_NAME enum NMSettingGsmError; #define NM_TYPE_SETTING_GSM_ERROR #define NM_SETTING_GSM_ERROR GQuark nm_setting_gsm_error_quark (void
); #define NM_SETTING_GSM_NUMBER #define NM_SETTING_GSM_USERNAME #define NM_SETTING_GSM_PASSWORD #define NM_SETTING_GSM_APN #define NM_SETTING_GSM_NETWORK_ID #define NM_SETTING_GSM_NETWORK_TYPE #define NM_SETTING_GSM_ALLOWED_BANDS #define NM_SETTING_GSM_PIN #define NM_SETTING_GSM_HOME_ONLY #define NM_SETTING_GSM_PUK #define NM_SETTING_GSM_BAND #define NM_GSM_NETWORK_ANY #define NM_GSM_NETWORK_UMTS_HSPA #define NM_GSM_NETWORK_GPRS_EDGE #define NM_GSM_NETWORK_PREFER_UMTS_HSPA #define NM_GSM_NETWORK_PREFER_GPRS_EDGE enum NMSettingGsmNetworkType; enum NMSettingGsmNetworkBand; NMSettingGsm; NMSettingGsmClass; GType nm_setting_gsm_get_type (void
); NMSetting * nm_setting_gsm_new (void
); const char * nm_setting_gsm_get_number (NMSettingGsm *setting
); const char * nm_setting_gsm_get_username (NMSettingGsm *setting
); const char * nm_setting_gsm_get_password (NMSettingGsm *setting
); const char * nm_setting_gsm_get_apn (NMSettingGsm *setting
); const char * nm_setting_gsm_get_network_id (NMSettingGsm *setting
); int nm_setting_gsm_get_network_type (NMSettingGsm *setting
); guint32 nm_setting_gsm_get_allowed_bands (NMSettingGsm *setting
); const char * nm_setting_gsm_get_pin (NMSettingGsm *setting
); gboolean nm_setting_gsm_get_home_only (NMSettingGsm *setting
); const char * nm_setting_gsm_get_puk (NMSettingGsm *setting
); int nm_setting_gsm_get_band (NMSettingGsm *setting
);
"allowed-bands" guint : Read / Write / Construct "apn" gchar* : Read / Write "band" gint : Read / Write / Construct "home-only" gboolean : Read / Write "network-id" gchar* : Read / Write "network-type" gint : Read / Write / Construct "number" gchar* : Read / Write "password" gchar* : Read / Write "pin" gchar* : Read / Write "puk" gchar* : Read / Write "username" gchar* : Read / Write
typedef enum { NM_SETTING_GSM_ERROR_UNKNOWN = 0, NM_SETTING_GSM_ERROR_INVALID_PROPERTY, NM_SETTING_GSM_ERROR_MISSING_PROPERTY, NM_SETTING_GSM_ERROR_MISSING_SERIAL_SETTING } NMSettingGsmError;
#define NM_GSM_NETWORK_PREFER_UMTS_HSPA NM_SETTING_GSM_NETWORK_TYPE_PREFER_UMTS_HSPA
#define NM_GSM_NETWORK_PREFER_GPRS_EDGE NM_SETTING_GSM_NETWORK_TYPE_PREFER_GPRS_EDGE
typedef enum { NM_SETTING_GSM_NETWORK_TYPE_ANY = -1, NM_SETTING_GSM_NETWORK_TYPE_UMTS_HSPA = 0, NM_SETTING_GSM_NETWORK_TYPE_GPRS_EDGE = 1, NM_SETTING_GSM_NETWORK_TYPE_PREFER_UMTS_HSPA = 2, NM_SETTING_GSM_NETWORK_TYPE_PREFER_GPRS_EDGE = 3 } NMSettingGsmNetworkType;
typedef enum { NM_SETTING_GSM_BAND_UNKNOWN = 0x00000000, NM_SETTING_GSM_BAND_ANY = 0x00000001, NM_SETTING_GSM_BAND_EGSM = 0x00000002, /* 900 MHz */ NM_SETTING_GSM_BAND_DCS = 0x00000004, /* 1800 MHz */ NM_SETTING_GSM_BAND_PCS = 0x00000008, /* 1900 MHz */ NM_SETTING_GSM_BAND_G850 = 0x00000010, /* 850 MHz */ NM_SETTING_GSM_BAND_U2100 = 0x00000020, /* WCDMA 3GPP UMTS 2100 MHz (Class I) */ NM_SETTING_GSM_BAND_U1800 = 0x00000040, /* WCDMA 3GPP UMTS 1800 MHz (Class III) */ NM_SETTING_GSM_BAND_U17IV = 0x00000080, /* WCDMA 3GPP AWS 1700/2100 MHz (Class IV) */ NM_SETTING_GSM_BAND_U800 = 0x00000100, /* WCDMA 3GPP UMTS 800 MHz (Class VI) */ NM_SETTING_GSM_BAND_U850 = 0x00000200, /* WCDMA 3GPP UMTS 850 MHz (Class V) */ NM_SETTING_GSM_BAND_U900 = 0x00000400, /* WCDMA 3GPP UMTS 900 MHz (Class VIII) */ NM_SETTING_GSM_BAND_U17IX = 0x00000800, /* WCDMA 3GPP UMTS 1700 MHz (Class IX) */ NM_SETTING_GSM_BAND_U1900 = 0x00001000, /* WCDMA 3GPP UMTS 1900 MHz (Class II) */ } NMSettingGsmNetworkBand;
typedef struct { NMSettingClass parent; /* Padding for future expansion */ void (*_reserved1) (void); void (*_reserved2) (void); void (*_reserved3) (void); void (*_reserved4) (void); } NMSettingGsmClass;
const char * nm_setting_gsm_get_number (NMSettingGsm *setting
);
|
|
Returns : |
const char * nm_setting_gsm_get_username (NMSettingGsm *setting
);
|
|
Returns : |
const char * nm_setting_gsm_get_password (NMSettingGsm *setting
);
|
|
Returns : |
const char * nm_setting_gsm_get_apn (NMSettingGsm *setting
);
|
|
Returns : |
const char * nm_setting_gsm_get_network_id (NMSettingGsm *setting
);
|
|
Returns : |
int nm_setting_gsm_get_network_type (NMSettingGsm *setting
);
|
|
Returns : |
guint32 nm_setting_gsm_get_allowed_bands (NMSettingGsm *setting
);
|
|
Returns : |
const char * nm_setting_gsm_get_pin (NMSettingGsm *setting
);
|
|
Returns : |
gboolean nm_setting_gsm_get_home_only (NMSettingGsm *setting
);
|
|
Returns : |
const char * nm_setting_gsm_get_puk (NMSettingGsm *setting
);
|
|
Returns : |
"allowed-bands"
property"allowed-bands" guint : Read / Write / Construct
Bitfield of allowed frequency bands. Note that not all devices allow frequency band control.
Allowed values: <= 1
Default value: 1
"apn"
property"apn" gchar* : Read / Write
The GPRS Access Point Name specifying the APN used when establishing a data session with the GSM-based network. The APN often determines how the user will be billed for their network usage and whether the user has access to the Internet or just a provider-specific walled-garden, so it is important to use the correct APN for the user's mobile broadband plan.
Default value: NULL
"band"
property"band" gint : Read / Write / Construct
DEPRECATED
Allowed values: [G_MAXULONG,5]
Default value: -1
"home-only"
property"home-only" gboolean : Read / Write
When TRUE, only connections to the home network will be allowed. Connections to roaming networks will not be made.
Default value: FALSE
"network-id"
property"network-id" gchar* : Read / Write
The Network ID (GSM LAI format, ie MCC-MNC) to force specific network registration. If the Network ID is specified, NetworkManager will attempt to force the device to register only on the specified network. This can be used to ensure that the device does not roam when direct roaming control of the device is not otherwise possible.
Default value: NULL
"network-type"
property"network-type" gint : Read / Write / Construct
Network preference to force the device to only use specific network technologies. The permitted values are: -1: any, 0: 3G only, 1: GPRS/EDGE only, 2: prefer 3G, and 3: prefer 2G. Note that not all devices allow network preference control.
Allowed values: [G_MAXULONG,3]
Default value: -1
"number"
property"number" gchar* : Read / Write
Number to dial when establishing a PPP data session with the GSM-based mobile broadband network. In most cases, leave the number blank and a number selecting the APN specified in the 'apn' property will be used automatically when required.
Default value: NULL
"password"
property"password" gchar* : Read / Write
The password used to authenticate with the network, if required. Many providers do not require a password, or accept any password. But if a password is required, it is specified here.
Default value: NULL
"pin"
property"pin" gchar* : Read / Write
If the SIM is locked with a PIN it must be unlocked before any other operations are requested. Specify the PIN here to allow operation of the device.
Default value: NULL
"username"
property"username" gchar* : Read / Write
The username used to authenticate with the network, if required. Many providers do not require a username, or accept any username. But if a username is required, it is specified here.
Default value: NULL