diff --git a/apps/app_osplookup.c b/apps/app_osplookup.c index 0ddcf1cbca..509f927fe9 100644 --- a/apps/app_osplookup.c +++ b/apps/app_osplookup.c @@ -58,15 +58,21 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$") OSP Authentication. - - - - - Authenticate a call by OSP and sets the variables: + Authenticate a call by OSP. + Input variables: + + + The last hop IP address. + + + The inbound OSP token. + + + Output variables: - The inbound call transaction handle. + The inbound call OSP transaction handle. The inbound call duration limit in seconds. @@ -75,133 +81,352 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$") This application sets the following channel variable upon completion: - The status of the OSP Auth attempt as a text string, one of + The status of OSPAuth attempt as a text string, one of + + + The name of the provider that authenticates the call. + + + Reserverd. + + + + OSPLookup + OSPNext + OSPFinish + Lookup destination by OSP. + + Looks up destination via OSP. + Input variables: + + + The last hop IP address. + + + The inbound call OSP transaction handle. + + + The inbound call duration limit in seconds. + + + The inbound source network ID. + + + The inbound routing number. + + + The inbound carrier identification code. + + + The inbound number portability database dip indicator. + + + The inbound service provider identity. + + + The inbound operator company number. + + + The inbound service provider name. + + + The inbound alternate service provider name. + + + The inbound mobile country code. + + + The inbound mobile network code. + + + The inbound To header host part. + + + The inbound Diversion header user part. + + + The inbound Diversion header host part. + + + The inbound custom information, where n is the index beginning with 1 + upto 8. + + + Output variables: + + + The outbound call OSP transaction handle. + + + The outbound channel technology for the call. + + + The outbound destination IP address. + + + The outbound calling number. + + + The outbound called number. + + + The outbound destination network ID. + + + The outbound routing number. + + + The outbound carrier identification code. + + + The outbound number portability database dip indicator. + + + The outbound service provider identity. + + + The outbound operator company number. + + + The outbound service provider name. + + + The outbound alternate service provider name. + + + The outbound mobile country code. + + + The outbound mobile network code. + + + The outbound OSP token. + + + The number of remained destinations. + + + The outbound call duration limit in seconds. + + + The outbound Call-ID types. + + + The outbound Dial command string. + + + This application sets the following channel variable upon completion: + + + The status of OSPLookup attempt as a text string, one of + + + + + + - - + + The exten of the call. + + + The name of the provider that is used to route the call. + generate H323 call id for the outbound call - generate SIP call id for the outbound call. - Have not been implemented + generate SIP call id for the outbound call. Have not been implemented - generate IAX call id for the outbound call. - Have not been implemented + generate IAX call id for the outbound call. Have not been implemented - - Looks up an extension via OSP and sets the variables, where n is the - number of the result beginning with 1: - - - The OSP Handle for anything remaining. - - - The technology to use for the call. - - - The destination to use for the call. - - - The calling number to use for the call. - - - The called number to use for the call. - - - The dial command string. - - - The actual OSP token as a string. - - - The outbound call duraction limit in seconds. - - - The outbound call id types. - - - The outbound call id. - - - The number of OSP results total remaining. - - - - - This application sets the following channel variable upon completion: - - - - - - + + OSPAuth + OSPNext + OSPFinish + Lookup next destination by OSP. - - - - - - Looks up the next OSP Destination for OSPOUTHANDLE. + Looks up the next destination via OSP. + Input variables: + + + The inbound call OSP transaction handle. + + + The outbound call OSP transaction handle. + + + The inbound call duration limit in seconds. + + + The outbound Call-ID types. + + + The number of remained destinations. + + + Output variables: + + + The outbound channel technology. + + + The destination IP address. + + + The outbound calling number. + + + The outbound called number. + + + The outbound destination network ID. + + + The outbound routing number. + + + The outbound carrier identification code. + + + The outbound number portability database dip indicator. + + + The outbound service provider identity. + + + The outbound operator company number. + + + The outbound service provider name. + + + The outbound alternate service provider name. + + + The outbound mobile country code. + + + The outbound mobile network code. + + + The outbound OSP token. + + + The number of remained destinations. + + + The outbound call duration limit in seconds. + + + The outbound Call-ID. Only for H.323. + + + The outbound Dial command string. + + This application sets the following channel variable upon completion: - The status of the OSP Next attempt as a text string, one of + The status of the OSPNext attempt as a text string, one of + + + The termaintion cause of the previous call attempt. + + + The name of the provider that is used to route the call. + + + Reserved. + + + OSPAuth OSPLookup + OSPFinish - Record OSP entry. + Report OSP entry. - - - - - Records call state for OSPINHANDLE, according to status, which should - be one of BUSY, CONGESTION, ANSWER, - NOANSWER, or CHANUNAVAIL or coincidentally, just what the - Dial application stores in its DIALSTATUS. + Report call state. + Input variables: + + + The inbound call OSP transaction handle. + + + The outbound call OSP transaction handle. + + + The OSPAuth status. + + + The OSPLookup status. + + + The OSPNext status. + + + The inbound call leg audio QoS string. + + + The outbound call leg audio QoS string. + + This application sets the following channel variable upon completion: - The status of the OSP Finish attempt as a text string, one of + The status of the OSPFinish attempt as a text string, one of + + + Hangup cause. + + + Reserved. + + + + OSPAuth + OSPLookup + OSPNext + ***/ @@ -2071,7 +2296,7 @@ static int osplookup_exec( ); if (ast_strlen_zero(data)) { - ast_log(LOG_WARNING, "OSPLookup: Arg required, OSPLookup(exten[|provider[|options]])\n"); + ast_log(LOG_WARNING, "OSPLookup: Arg required, OSPLookup(exten[,provider[,options]])\n"); return OSP_AST_ERROR; } @@ -2339,7 +2564,7 @@ static int ospnext_exec( ); if (ast_strlen_zero(data)) { - ast_log(LOG_WARNING, "OSPNext: Arg required, OSPNext(cause[|provider[|options]])\n"); + ast_log(LOG_WARNING, "OSPNext: Arg required, OSPNext(cause[,provider[,options]])\n"); return OSP_AST_ERROR; }