BtctlObex

BtctlObex

Functions

Signals

void complete Run First
void connect Run First
void disconnect Run First
void error Run First
void progress Run First
void put Run First
void request-put Run First

Types and Values

Object Hierarchy

    GObject
    ╰── BtctlObex

Description

Functions

btctl_obex_new ()

BtctlObex *
btctl_obex_new (void);

Create a new Bluetooth OBEX object. This will attempt to open an OBEX server socket. Use btctl_obex_is_initialised() to check whether this was successful.

Returns

a pointer to the controller object.


btctl_obex_is_initialised ()

gboolean
btctl_obex_is_initialised (BtctlObex *bo);

Check if OBEX was able to initialise OK. If not, we won't be able to do anything.

Parameters

bo

Bluetooth OBEX object.

 

Returns

TRUE if initialised OK.


btctl_obex_set_response ()

void
btctl_obex_set_response (BtctlObex *bo,
                         gboolean resp);

Sets TRUE or FALSE response in signal handlers that must decide whether an operation can proceed or not.

Parameters

bo

Bluetooth OBEX object.

 

resp

Boolean response.

 

btctl_obex_cancel_operation ()

void
btctl_obex_cancel_operation (BtctlObex *bo);

Requests the cancel of a currently running transfer, disconnecting the client.

Parameters

bo

Bluetooth OBEX object.

 

btctl_obex_cancel_operation_forcibly ()

void
btctl_obex_cancel_operation_forcibly (BtctlObex *bo);

Forcibly causes the closing of a client connection. Use if the client isn't responding to a cancel request, e.g. where the connection's timing out.

Parameters

bo

Bluetooth OBEX object.

 

Types and Values

struct BtctlObex

struct BtctlObex;

BTCTL_OBEX_ERR_PARSE

#define BTCTL_OBEX_ERR_PARSE    0x01

BTCTL_OBEX_ERR_LINK

#define BTCTL_OBEX_ERR_LINK     0x02

BTCTL_OBEX_ERR_ABORT

#define BTCTL_OBEX_ERR_ABORT    0x03

Signal Details

The “complete” signal

void
user_function (BtctlObex *btctlobex,
               char      *arg1,
               gpointer   user_data)

Flags: Run First


The “connect” signal

void
user_function (BtctlObex *btctlobex,
               char      *arg1,
               gpointer   user_data)

Flags: Run First


The “disconnect” signal

void
user_function (BtctlObex *btctlobex,
               char      *arg1,
               gpointer   user_data)

Flags: Run First


The “error” signal

void
user_function (BtctlObex *btctlobex,
               char      *arg1,
               guint      arg2,
               gpointer   user_data)

Flags: Run First


The “progress” signal

void
user_function (BtctlObex *btctlobex,
               char      *arg1,
               gpointer   user_data)

Flags: Run First


The “put” signal

void
user_function (BtctlObex     *btctlobex,
               char          *arg1,
               char          *arg2,
               BtctlObexData *arg3,
               guint          arg4,
               gpointer       user_data)

Flags: Run First


The “request-put” signal

void
user_function (BtctlObex *btctlobex,
               char      *arg1,
               gpointer   user_data)

Flags: Run First