
mi_fifo Module

Bogdan-Andrei Iancu

   voice-system.ro

Edited by

Bogdan-Andrei Iancu

   Copyright © 2006 voice-system.ro
     _________________________________________________________

   Table of Contents
   1. User's Guide

        1.1. Overview
        1.2. FIFO command syntax
        1.3. Dependencies

              1.3.1. OpenSER Modules
              1.3.2. External Libraries or Applications

        1.4. Exported Parameters

              1.4.1. fifo_name (string)
              1.4.2. fifo_mode (integer)
              1.4.3. fifo_group (integer) fifo_group (string)
              1.4.4. fifo_user (integer) fifo_group (string)
              1.4.5. reply_dir (string)
              1.4.6. reply_indent (string)

        1.5. Exported Functions
        1.6. Example

   2. Developer's Guide
   3. Frequently Asked Questions

   List of Examples
   1-1. Set fifo_name parameter
   1-2. Set fifo_mode parameter
   1-3. Set fifo_group parameter
   1-4. Set fifo_user parameter
   1-5. Set reply_dir parameter
   1-6. Set reply_indent parameter
   1-7. FIFO request
     _________________________________________________________

Chapter 1. User's Guide

1.1. Overview

   This is a module which provides a FIFO transport layer
   implementation for Management Interface.
     _________________________________________________________

1.2. FIFO command syntax

   The external commands issued via FIFO interface must follow
   the following syntax:

     * request = first_line argument* 
     * first_line = ':'command_name':'reply_fifo'\n' 
     * argument = (arg_name '::' (arg_value)? ) | (arg_value) 
     * arg_name = not-quoted_string 
     * arg_value = not-quoted_string | '"' string '"' 
     * not-quoted_string = string - {',",\n,\r} 
     _________________________________________________________

1.3. Dependencies

1.3.1. OpenSER Modules

   The following modules must be loaded before this module:

     * No dependencies on other OpenSER modules.
     _________________________________________________________

1.3.2. External Libraries or Applications

   The following libraries or applications must be installed
   before running OpenSER with this module loaded:

     * none
     _________________________________________________________

1.4. Exported Parameters

1.4.1. fifo_name (string)

   The name of the FIFO file to be created for listening and
   reading external commands.

   Default value is NONE. 

   Example 1-1. Set fifo_name parameter
...
modparam("mi_fifo", "fifo_name", "/tmp/openser_fifo")
...
     _________________________________________________________

1.4.2. fifo_mode (integer)

   Permission to be used for creating the listening FIFO file. It
   follows the UNIX conventions.

   Default value is 0660 (rw-rw----). 

   Example 1-2. Set fifo_mode parameter
...
modparam("mi_fifo", "fifo_mode", 0600)
...
     _________________________________________________________

1.4.3. fifo_group (integer) fifo_group (string)

   Group to be used for creating the listening FIFO file.

   Default value is the inherited one. 

   Example 1-3. Set fifo_group parameter
...
modparam("mi_fifo", "fifo_group", 0)
modparam("mi_fifo", "fifo_group", "root")
...
     _________________________________________________________

1.4.4. fifo_user (integer) fifo_group (string)

   User to be used for creating the listening FIFO file.

   Default value is the inherited one. 

   Example 1-4. Set fifo_user parameter
...
modparam("mi_fifo", "fifo_user", 0)
modparam("mi_fifo", "fifo_user", "root")
...
     _________________________________________________________

1.4.5. reply_dir (string)

   Directory to be used for creating the reply FIFO files.

   Default value is "/tmp/" 

   Example 1-5. Set reply_dir parameter
...
modparam("mi_fifo", "reply_dir", "/home/openser/tmp/")
...
     _________________________________________________________

1.4.6. reply_indent (string)

   Strings to be used for line indentation. As the MI data
   structure is tree oriendeted, the depth level will printed as
   indentation.

   Default value is ""\t" (TAB)". 

   Example 1-6. Set reply_indent parameter
...
modparam("mi_fifo", "reply_indent", "    ")
...
     _________________________________________________________

1.5. Exported Functions

   No function exported to be used from configuration file.
     _________________________________________________________

1.6. Example

   This is an example showing the FIFO format for the
   "get_statistics dialog: tm:" MI commad: response.

   Example 1-7. FIFO request
get_statistics:/tmp/reply_fifo\n
dialog:\n
tm:\n
\n
     _________________________________________________________

Chapter 2. Developer's Guide

   The module does not provide any API to use in other OpenSER
   modules.
     _________________________________________________________

Chapter 3. Frequently Asked Questions

   3.1. Where can I find more about OpenSER?
   3.2. Where can I post a question about this module?
   3.3. How can I report a bug?

   3.1. Where can I find more about OpenSER?

   Take a look at http://openser.org/.

   3.2. Where can I post a question about this module?

   First at all check if your question was already answered on
   one of our mailing lists:

     * User Mailing List -
       http://openser.org/cgi-bin/mailman/listinfo/users
     * Developer Mailing List -
       http://openser.org/cgi-bin/mailman/listinfo/devel

   E-mails regarding any stable OpenSER release should be sent to
   <users@openser.org> and e-mails regarding development versions
   should be sent to <devel@openser.org>.

   If you want to keep the mail private, send it to
   <team@openser.org>.

   3.3. How can I report a bug?

   Please follow the guidelines provided at:
   http://sourceforge.net/tracker/?group_id=139143.
