← Volver al índice de módulos

presence_xml

The module does specific handling for notify-subscribe events using xml bodies. It is used with the general event handling module, presence.
💬 Presencia y Mensajería Kamailio 6.1 30 parámetros 4 funciones

Descripción general

The module does specific handling for notify-subscribe events using xml bodies. It is used with the general event handling module, presence. It constructs and adds 3 events to it: * presence - SIMPLE status presence: RFC 3856 * presence.winfo - SIMPLE watcher info: RFC 3857 * dialog;sla (or dialog;ma) - Bridged Line Appearances (BLA) (or Multiple Line Appearances (MLA)): draft-anil-sipping-bla You can control which events are enabled via module parameters. This module takes the XCAP permission rule documents from xcap_table. The presence permission rules are interpreted according to the specifications in RFC 4745 and RFC 5025.

Documentación oficial: https://www.kamailio.org/docs/modules/stable/modules/presence_xml.html
Código fuente: https://github.com/kamailio/kamailio/tree/master/src/modules/presence_xml

Parámetros de configuración

ParámetroTipoDescripción
db_url str 3.2. xcap_table(str) 3.3. disable_presence(int) 3.4. disable_winfo(int) 3.5. disable_bla(int) 3.6. disable_xcapdiff(int) 3.7. force_active (int) 3.8. integrated_xcap_server (int) 3.9. xcap_server (str
xcap_table str 3.3. disable_presence(int) 3.4. disable_winfo(int) 3.5. disable_bla(int) 3.6. disable_xcapdiff(int) 3.7. force_active (int) 3.8. integrated_xcap_server (int) 3.9. xcap_server (str) 3.10. passive_mode(
disable_presence int 3.4. disable_winfo(int) 3.5. disable_bla(int) 3.6. disable_xcapdiff(int) 3.7. force_active (int) 3.8. integrated_xcap_server (int) 3.9. xcap_server (str) 3.10. passive_mode(int) 3.11. xcapauth_userdel
disable_winfo int 3.5. disable_bla(int) 3.6. disable_xcapdiff(int) 3.7. force_active (int) 3.8. integrated_xcap_server (int) 3.9. xcap_server (str) 3.10. passive_mode(int) 3.11. xcapauth_userdel_reason(str) 3.12. force
disable_bla int 3.6. disable_xcapdiff(int) 3.7. force_active (int) 3.8. integrated_xcap_server (int) 3.9. xcap_server (str) 3.10. passive_mode(int) 3.11. xcapauth_userdel_reason(str) 3.12. force_dummy_presence(int) 3
disable_xcapdiff int 3.7. force_active (int) 3.8. integrated_xcap_server (int) 3.9. xcap_server (str) 3.10. passive_mode(int) 3.11. xcapauth_userdel_reason(str) 3.12. force_dummy_presence(int) 3.13. force_presence_single_
force_active int 3.8. integrated_xcap_server (int) 3.9. xcap_server (str) 3.10. passive_mode(int) 3.11. xcapauth_userdel_reason(str) 3.12. force_dummy_presence(int) 3.13. force_presence_single_body(int) 3.14. presence
integrated_xcap_server int 3.9. xcap_server (str) 3.10. passive_mode(int) 3.11. xcapauth_userdel_reason(str) 3.12. force_dummy_presence(int) 3.13. force_presence_single_body(int) 3.14. presence_single_body_priorities(str) 3.15.
xcap_server str 3.10. passive_mode(int) 3.11. xcapauth_userdel_reason(str) 3.12. force_dummy_presence(int) 3.13. force_presence_single_body(int) 3.14. presence_single_body_priorities(str) 3.15. presence_single_body_l
passive_mode int 3.11. xcapauth_userdel_reason(str) 3.12. force_dummy_presence(int) 3.13. force_presence_single_body(int) 3.14. presence_single_body_priorities(str) 3.15. presence_single_body_lookup_element(str) 3.16.
xcapauth_userdel_reason str 3.12. force_dummy_presence(int) 3.13. force_presence_single_body(int) 3.14. presence_single_body_priorities(str) 3.15. presence_single_body_lookup_element(str) 3.16. default_expires (int)
force_dummy_presence int 3.13. force_presence_single_body(int) 3.14. presence_single_body_priorities(str) 3.15. presence_single_body_lookup_element(str) 3.16. default_expires (int)
force_presence_single_body int 3.14. presence_single_body_priorities(str) 3.15. presence_single_body_lookup_element(str) 3.16. default_expires (int)
presence_single_body_priorities str 3.15. presence_single_body_lookup_element(str) 3.16. default_expires (int)
presence_single_body_lookup_element str 3.16. default_expires (int)
default_expires int 3.1. db_url(str)
db_url str The database URL.
xcap_table str The name of the database table where XCAP documents are stored.
disable_presence int Set this parameter to disable the handling of the "presence" event.
disable_winfo int Set this parameter to disable the handling of the "presence.winfo" event.
disable_bla int Set this parameter to disable the handling of the "dialog;sla" event.
disable_xcapdiff int Set this parameter to disable the handling of the "xcap-diff" event.
force_active int This parameter is used for permissions when handling Subscribe messages. If set to 1, subscription state is considered active and the presentity is not queried for permissions (should be set to 1 if n
integrated_xcap_server int This parameter is a flag for the type of XCAP servers used. If the XCAP server is integrated with Kamailio presence_xml module and access the same database tables directly, like the embedded XCAP serv
xcap_server str The address of the xcap servers used for storage. This parameter is compulsory if the integrated_xcap_server parameter is not set. It can be set more than once, to construct an address list of trusted
passive_mode int If set to 1, module acts in passive mode - no bind to presence module, no connection to database. Useful when needing only to use $xml(...) pseudo-variable.
xcapauth_userdel_reason str This parameter represents the reason that will be included in the Subscription-State header of the Notify when a rule is no longer found in the XCAP pres-auth document for a user that was previously a
force_dummy_presence int Set this parameter to enable simple body notify with status 'open' when presentity info is not available.
force_presence_single_body int Set this parameter to enable single body notify. One presentity can have multiple dialogs and will by default notify all the dialogs and this can be a problem when dealing with large ring-groups or at
presence_single_body_priorities str Change this parameter to set the priorities when choosing the dialog that will be the final.

Funciones exportadas

pres_check_basic(presentity_uri, status)

4.2. pres_check_activities(presentity_uri, activity)

pres_check_activities(presentity_uri, activity)

4.1. pres_check_basic(presentity_uri, status)

pres_check_basic(presentity_uri, status)

Checks the /presence/tuple/status/basic nodes in the presentity for presentity_uri against the value in status.

pres_check_activities(presentity_uri, activity)

Checks whether a /presence/person/activities/activity node exists in the presentity for presentity_uri.

Autores y contribuidores

Anca-Maria VamanuVoice Sistem SRL

Copyright © 2007 Voice Sistem SRL

Módulos relacionados

dialog msilo presence presence_dialoginfo presence_mwi presence_profile presence_reginfo pua