## NMSettingBluetooth

NMSettingBluetooth — Describes Bluetooth connection properties

## Synopsis

    #include <nm-setting-bluetooth.h>

    #define             NM_SETTING_BLUETOOTH_SETTING_NAME
    enum                NMSettingBluetoothError;
    #define             NM_SETTING_BLUETOOTH_ERROR
    GQuark              nm_setting_bluetooth_error_quark    (void);
    #define             NM_SETTING_BLUETOOTH_BDADDR
    #define             NM_SETTING_BLUETOOTH_TYPE
    #define             NM_SETTING_BLUETOOTH_TYPE_DUN
    #define             NM_SETTING_BLUETOOTH_TYPE_PANU
                        NMSettingBluetooth;
                        NMSettingBluetoothClass;
    NMSetting *         nm_setting_bluetooth_new            (void);
    const GByteArray *  nm_setting_bluetooth_get_bdaddr     (NMSettingBluetooth *setting);
    const char *        nm_setting_bluetooth_get_connection_type
                                                            (NMSettingBluetooth *setting);

## Object Hierarchy

      GEnum
       +----NMSettingBluetoothError

      GObject
       +----NMSetting
             +----NMSettingBluetooth

## Properties

      "bdaddr"                   GArray_guchar_*       : Read / Write
      "type"                     gchar*                : Read / Write

## Description

The NMSettingBluetooth object is a NMSetting subclass that describes properties necessary for connection to devices that provide network connections via the Bluetooth Dial-Up Networking (DUN) and Network Access Point (NAP) profiles.

## Details

### NM_SETTING_BLUETOOTH_SETTING_NAME

    #define NM_SETTING_BLUETOOTH_SETTING_NAME "bluetooth"

### enum NMSettingBluetoothError

    typedef enum {
    	NM_SETTING_BLUETOOTH_ERROR_UNKNOWN = 0,            /*< nick=UnknownError >*/
    	NM_SETTING_BLUETOOTH_ERROR_INVALID_PROPERTY,       /*< nick=InvalidProperty >*/
    	NM_SETTING_BLUETOOTH_ERROR_MISSING_PROPERTY,       /*< nick=MissingProperty >*/
    	NM_SETTING_BLUETOOTH_ERROR_TYPE_SETTING_NOT_FOUND, /*< nick=TypeSettingNotFound >*/
    } NMSettingBluetoothError;

`NM_SETTING_BLUETOOTH_ERROR_UNKNOWN` | unknown or unclassified error
`NM_SETTING_BLUETOOTH_ERROR_INVALID_PROPERTY` | the property was invalid
`NM_SETTING_BLUETOOTH_ERROR_MISSING_PROPERTY` | the property was missing and is required
`NM_SETTING_BLUETOOTH_ERROR_TYPE_SETTING_NOT_FOUND` | the connection did not contain a required type setting, ie for DUN connections the connection must also contain an NMSettingGsm or NMSettingCdma as appropriate

### NM_SETTING_BLUETOOTH_ERROR

    #define NM_SETTING_BLUETOOTH_ERROR nm_setting_bluetooth_error_quark ()

### nm_setting_bluetooth_error_quark ()

    GQuark              nm_setting_bluetooth_error_quark    (void);

Registers an error quark for NMSettingBluetooth if necessary.

Returns : | the error quark used for NMSettingBluetooth errors.

### NM_SETTING_BLUETOOTH_BDADDR

    #define NM_SETTING_BLUETOOTH_BDADDR    "bdaddr"

### NM_SETTING_BLUETOOTH_TYPE

    #define NM_SETTING_BLUETOOTH_TYPE      "type"

### NM_SETTING_BLUETOOTH_TYPE_DUN

    #define NM_SETTING_BLUETOOTH_TYPE_DUN  "dun"

Connection type describing a connection to devices that support the Bluetooth DUN profile.

### NM_SETTING_BLUETOOTH_TYPE_PANU

    #define NM_SETTING_BLUETOOTH_TYPE_PANU "panu"

Connection type describing a connection to devices that support the Bluetooth NAP (Network Access Point) protocol, which accepts connections via PANU.

### NMSettingBluetooth

    typedef struct _NMSettingBluetooth NMSettingBluetooth;

### NMSettingBluetoothClass

    typedef struct {
    	NMSettingClass parent;

    	/* Padding for future expansion */
    	void (*_reserved1) (void);
    	void (*_reserved2) (void);
    	void (*_reserved3) (void);
    	void (*_reserved4) (void);
    } NMSettingBluetoothClass;

### nm_setting_bluetooth_new ()

    NMSetting *         nm_setting_bluetooth_new            (void);

Creates a new NMSettingBluetooth object with default values.

Returns : | the new empty NMSettingBluetooth object. [transfer full]

### nm_setting_bluetooth_get_bdaddr ()

    const GByteArray *  nm_setting_bluetooth_get_bdaddr     (NMSettingBluetooth *setting);

Gets the Bluetooth address of the remote device which this setting describes a connection to.

`setting` : | the NMSettingBluetooth
Returns : | the Bluetooth address

### nm_setting_bluetooth_get_connection_type ()

    const char *        nm_setting_bluetooth_get_connection_type
                                                            (NMSettingBluetooth *setting);

Returns the connection method for communicating with the remote device (i.e. either DUN to a DUN-capable device or PANU to a NAP-capable device).

`setting` : | the NMSettingBluetooth
Returns : | the type, either `NM_SETTING_BLUETOOTH_PANU` or `NM_SETTING_BLUETOOTH_DUN`

## Property Details

### The `"bdaddr"` property

      "bdaddr"                   GArray_guchar_*       : Read / Write

The Bluetooth address of the device.

### The `"type"` property

      "type"                     gchar*                : Read / Write

Either 'dun' for Dial-Up Networking connections or 'panu' for Personal Area Networking connections to devices supporting the NAP profile.

Default value: NULL