RmProfile

RmProfile — Profile handling functions

Functions

Types and Values

Description

Profiles are used to distinguish between several routers. This is useful for mobile devices using private and business environements.

The strategy should always be:

  • Return set device

  • If it is not present, use first available plugin and set it as default

  • Only if no alternative is found, return NULL

Functions

rm_profile_init ()

gboolean
rm_profile_init (void);

Initialize profiles (load profiles).

Returns

TRUE


rm_profile_shutdown ()

void
rm_profile_shutdown (void);

Shutdown profile (free profile list, free settings).


rm_profile_get_list ()

GList *
rm_profile_get_list (void);

Get profile list

Returns

profile list


rm_profile_add ()

RmProfile *
rm_profile_add (const gchar *name);

Create and add a new profile structure.

Parameters

name

profile name

 

Returns

new RmProfile


rm_profile_remove ()

void
rm_profile_remove (RmProfile *profile);

Remove profile from list.

Parameters

profile

a RmProfile

 

rm_profile_get_active ()

RmProfile *
rm_profile_get_active (void);

Get active profile.

Returns

active RmProfile


rm_profile_set_active ()

void
rm_profile_set_active (RmProfile *profile);

Set active profile in detail:

  • Set internal active profile

  • Connect user plugin bindings

  • Initialize audio

  • Load and initialize action

  • Load journal

Parameters

profile

a RmProfile

 

rm_profile_detect ()

RmProfile *
rm_profile_detect (void);

Detect profile (scan available routers).

Returns

RmProfile or NULL if none found


rm_profile_get_name ()

const gchar *
rm_profile_get_name (RmProfile *profile);

Get profiles name of profile .

Parameters

profile

a RmProfile

 

Returns

profile name


rm_profile_set_host ()

void
rm_profile_set_host (RmProfile *profile,
                     const gchar *host);

Set host name used in profile.

Parameters

profile

a RmProfile

 

host

new host name for profile

 

rm_profile_set_login_user ()

void
rm_profile_set_login_user (RmProfile *profile,
                           const gchar *user);

Set login user used in profile.

Parameters

profile

a RmProfile

 

user

new user name for profile

 

rm_profile_set_login_password ()

void
rm_profile_set_login_password (RmProfile *profile,
                               const gchar *password);

Set login password used in profile.

Parameters

profile

a RmProfile

 

password

new password for profile

 

rm_profile_get_addressbook ()

RmAddressBook *
rm_profile_get_addressbook (RmProfile *profile);

Get address book for selected profile.

Parameters

profile

a RmProfile

 

Returns

a RmAddressBook


rm_profile_set_addressbook ()

void
rm_profile_set_addressbook (RmProfile *profile,
                            RmAddressBook *book);

Sets preferred addressbook within profile.

Parameters

profile

a RmProfile

 

book

a RmAddressBook

 

rm_profile_get_audio ()

RmAudio *
rm_profile_get_audio (RmProfile *profile);

Get audio for selected profile.

Parameters

profile

a RmProfile

 

rm_profile_get_audio_ringtone ()

gchar *
rm_profile_get_audio_ringtone (RmProfile *profile);

Get ringtone audio device for selected profile.

Parameters

profile

a RmProfile

 

Returns

Audio ringtone device


rm_profile_get_notification ()

RmNotification *
rm_profile_get_notification (RmProfile *profile);

Get notification for selected profile.

Parameters

profile

a RmProfile

 

Returns

a RmNotification


rm_profile_get_notification_incoming_numbers ()

gchar **
rm_profile_get_notification_incoming_numbers
                               (RmProfile *profile);

Get notification incoming numbers for selected profile.

Parameters

profile

a RmProfile

 

rm_profile_get_notification_outgoing_numbers ()

gchar **
rm_profile_get_notification_outgoing_numbers
                               (RmProfile *profile);

Get notification outgoing numbers for selected profile.

Parameters

profile

a RmProfile

 

rm_profile_set_notification_incoming_numbers ()

void
rm_profile_set_notification_incoming_numbers
                               (RmProfile *profile,
                                const gchar * const*numbers);

Set notification incoming numbers for selected profile.

Parameters

profile

a RmProfile

 

numbers

numbers to set

 

rm_profile_set_notification_outgoing_numbers ()

void
rm_profile_set_notification_outgoing_numbers
                               (RmProfile *profile,
                                const gchar * const*numbers);

Set notification outgoing numbers for selected profile.

Parameters

profile

a RmProfile

 

numbers

numbers to set

 

rm_profile_get_notification_ringtone ()

gboolean
rm_profile_get_notification_ringtone (RmProfile *profile);

Get notification ringtone setting for selected profile.

Parameters

profile

a RmProfile

 

rm_profile_get_phone ()

RmPhone *
rm_profile_get_phone (RmProfile *profile);

Get phone for selected profile.

Parameters

profile

a RmProfile

 

rm_profile_set_phone ()

void
rm_profile_set_phone (RmProfile *profile,
                      RmPhone *phone);

Set preferred phone within profile.

Parameters

profile

a RmProfile

 

phone

a RmPhone

 

rm_profile_get_fax ()

RmFax *
rm_profile_get_fax (RmProfile *profile);

Get fax for selected profile.

Parameters

profile

a RmProfile

 

rm_profile_set_fax ()

void
rm_profile_set_fax (RmProfile *profile,
                    gchar *name);

Set preferred phone name within profile.

Parameters

profile

a RmProfile

 

name

fax name

 

rm_profile_update_numbers ()

void
rm_profile_update_numbers (RmProfile *profile);

Updates numbers for each RmDevice (currently only CAPI and Dialer) This one is hard-coded as we are currently supporting CAPI and Call Monitor only, once SIP is implemented we need to break this one up

Parameters

profile

a RmProfile

 

Types and Values

RmProfile

typedef struct {
} RmProfile;

The RmProfile contains only private fileds and should not be directly accessed.