Module gruu

Code for Globally Routable User Agent (UA) URIs (GRUU), based on draft-ietf-sip-gruu-06 and then updated with regards to the changes in draft-ietf-sip-gruu-07.

Introduced in: 3 Mar 2006 by Fredrik Thulin <ft@it.su.se>

Authors: Fredrik Thulin (ft@it.su.se).

Description

Code for Globally Routable User Agent (UA) URIs (GRUU), based on draft-ietf-sip-gruu-06 and then updated with regards to the changes in draft-ietf-sip-gruu-07.

Function Index

create_if_not_exists/2 Update last registration time on an existing User+Instance combination, or create a new GRUU for the User+Instance combination if it hasn't been registered before.
extract/2 Extract data from our private gruu_dbe record.
generate_gruu/2 Generate a new GRUU.
get_contact_for_gruu/1 Fetch the contact for a GRUU from the location database.
is_gruu_url/1 Check if a URL could be a GRUU we have generated.
make_url/4 Make a SIP/SIPS URL out of a GRUU.
prepare_contact/2 Copy any 'grid' parameter from Request-URI to contact URI.

Function Details

create_if_not_exists/2

create_if_not_exists(SipUser, InstanceId) -> {ok, GRUU}

Update last registration time on an existing User+Instance combination, or create a new GRUU for the User+Instance combination if it hasn't been registered before.

extract/2

extract(X1::Field, E::GRUU_DBE) -> term()

Extract data from our private gruu_dbe record.

generate_gruu/2

generate_gruu(SipUser, InstanceId) -> GRUU

Generate a new GRUU.

get_contact_for_gruu/1

get_contact_for_gruu(GRUUstr) -> nomatch | {ok, User, none} | {ok, User, SingleContact}

Fetch the contact for a GRUU from the location database

is_gruu_url/1

is_gruu_url(URL) -> {true, GRUU} | false

Check if a URL could be a GRUU we have generated. Does NOT check in the database to see if there is such a GRUU. NOTE : Only call this on a URL matching 'homedomain'.

make_url/4

make_url(SipUser, InstanceId, GRUU, ToHeader) -> URL

Make a SIP/SIPS URL out of a GRUU.

prepare_contact/2

prepare_contact(Contact, URI) -> NewURI

Copy any 'grid' parameter from Request-URI to contact URI


Generated by EDoc, Oct 17 2007, 16:48:25.