Resources.DocsCoreFlags14 History

Hide minor edits - Show changes to markup

April 24, 2013, at 09:05 PM by 92.80.24.181 -
Changed lines 1-142 from:

Resources -> Documentation -> CookBooks -> Scripting Flags v1.4.x


(:toc-float Table of Content:)

This documentation is valid for OpenSIPS v1.4.x / devel

Types of flags

  • message flags (or transaction flags) these flags are transaction persistent. They are visible in all routes and cases where the transaction context is visible
  • branch flags are saved also in transaction, but per branch; also they will be saved in usrloc (per contact). A new set of functions were added for manipulating these flags from script. So, there flags will be registration persistent and branch persistent.
  • script flags are no-message-related flags - they are only script persistent and you can strictly use them for scripting. Once you exit a top level route, they will be lost. These flags are useful and they offer an option to de-congest the message flags - many flags have no need to be saved as they just reflect some scripting status.

Corresponding Functions

Message/transaction flags

setflag(flag_idx) resetflag(flag_idx) isflagset(flag_idx)

Branch flags

setbflag/setbranchflag(branch_idx,flag_idx) resetbflag/resetbranchflag(branch_idx,flag_idx) isbflagset/isbranchflagset(branch_idx,flag_idx)

or, the shorter format, working on the default (branch 0) flags:

setbflag(flag_idx) resetbflag(flag_idx) isbflagset(flag_idx)

Script flags

setsflag/setscriptflag(flag_idx) resetsflag/resetscriptflag(flag_idx) issflagset/isscriptflagset(flag_idx)


Flags and Pseudo Variables

Message/transaction flags

$mf - decimal value $mF - hexa value

Branch flags

$bf - decimal value $bF - hexa value

Script flags

$sf - decimal value $sF - hexa valu


Flags and routes

Message/transaction flags

These flags will show up in all routes where messages related to the initial request are processed. So, they will be visible and changeable in onbranch, failure and onreply routes; the flags will be visible in all branch routes; if you change a flag in a branch route, the next branch routes will inherit the change.

Branch flags

There flags will show up in all routes where messages related to initial branch request are processed. So, in branch route you will see different sets of flags (as they are different branches); in onreply route yo will see the branch flags corresponding to the branch the reply belongs to; in failure route, the branch flags corresponding to the branch the winning reply belongs to will be visible. In request route, you can have multiple branches (as a result of a lookup(), enum query, append_branch(), etc) - the default branch is 0 (corresponding to the RURI); In reply routes there will be only one branch , the 0 one. In branch route the default branch is the current process branch (having index 0); In failure route, initially there is only one branch (index 0), corresponding the failed branch.

Script flags

There flags are available only in script and are reset after each top level route execution (routes internally triggered by OpenSIPS). They will be persistent per main route, onreply_route, branch_route, failure_route. Note they will be inherit in routes called from other routes.


Example

Nat flag handling

 ..........
 # 3 - the nat flag
 modparam("usrloc","nat_bflag",3)
 ..........

 route {
   ..........
   if (nat detected)
      setbflag(3); # set branch flag 3 for the branch 0

   ..........
   if (is_method("REGISTER")) {
      # the branch flags (including 3) will be saved into location
      save("location");
      exit;
   } else {
      # lookup will load the branch flag from location
      if (!lookup("location")) {
         sl_send_reply("404","Not Found");
         exit;
      }
      t_on_branch("1")
      t_relay();
   }
 }

 branch_route[1] {
   xlog("-------branch=$T_branch_idx, branch flags=$bF\n");
   if (isbflagset(3)) {
      #current branch is marked as natted
      .........
   }
 }

if no parallel forking is done, you can get rid of the branch route and add instead of t_on_branch():

   ........
   if (isbflagset(3)) {
      #current branch is marked as natted
      .........
   }
   ......... 

(:commentboxchrono:)

to:

(:redirect Documentation/Script-Flags-1-4 quiet=1:)

March 02, 2013, at 12:21 PM by bogdan -
Deleted lines 140-145:

(:nl:)>>messagehead<<

Happy?01 March 2013, 15:29

HHIS I shloud have thought of that!

March 01, 2013, at 03:29 PM by Happy - Comment added
Added lines 141-146:

(:nl:)>>messagehead<<

Happy?01 March 2013, 15:29

HHIS I shloud have thought of that!

August 21, 2012, at 10:07 AM by bogdan -
Deleted lines 140-144:

(:nl:)>>messagehead<<

Taka?20 August 2012, 10:41

- Mandie, I can't explain in words, ellaciespy as fluid as you did, my experience at the workshop, but I know that it was life changing. I'm convinced that our paths crossed for a purpose greater than we see on the surface and I hope that we stay in touch and remain great friends. Perhaps we will see each other at another Scott Robert workshop maybe Paris. Your work is amazing and your personality is reflected in your work. Take care.

August 20, 2012, at 10:41 AM by Taka - Comment added
Added lines 140-145:

(:nl:)>>messagehead<<

Taka?20 August 2012, 10:41

- Mandie, I can't explain in words, ellaciespy as fluid as you did, my experience at the workshop, but I know that it was life changing. I'm convinced that our paths crossed for a purpose greater than we see on the surface and I hope that we stay in touch and remain great friends. Perhaps we will see each other at another Scott Robert workshop maybe Paris. Your work is amazing and your personality is reflected in your work. Take care.

June 28, 2011, at 10:34 AM by bogdan -
Deleted lines 139-144:

(:nl:)>>messagehead<<

Trevion?27 June 2011, 20:43

That’s not just logic. That’s raelly sensible.

June 27, 2011, at 08:43 PM by Trevion - Comment added
Added lines 140-145:

(:nl:)>>messagehead<<

Trevion?27 June 2011, 20:43

That’s not just logic. That’s raelly sensible.

June 27, 2011, at 05:05 PM by 109.99.2.142 -
Deleted lines 139-144:

(:nl:)>>messagehead<<

Arry?27 June 2011, 02:08

Cool! That's a clever way of loionkg at it!

June 27, 2011, at 02:08 AM by Arry - Comment added
Added lines 140-145:

(:nl:)>>messagehead<<

Arry?27 June 2011, 02:08

Cool! That's a clever way of loionkg at it!

May 12, 2011, at 11:30 AM by bogdan - Comments Cleanup
Deleted lines 139-144:

(:nl:)>>messagehead<<

Jailyn?11 May 2011, 12:59

Thkans for sharing. What a pleasure to read!

May 11, 2011, at 12:59 PM by Jailyn - Comment added
Added lines 140-145:

(:nl:)>>messagehead<<

Jailyn?11 May 2011, 12:59

Thkans for sharing. What a pleasure to read!

April 23, 2009, at 10:33 AM by bogdan -
Added lines 1-141:

Resources -> Documentation -> CookBooks -> Scripting Flags v1.4.x


(:toc-float Table of Content:)

This documentation is valid for OpenSIPS v1.4.x / devel

Types of flags

  • message flags (or transaction flags) these flags are transaction persistent. They are visible in all routes and cases where the transaction context is visible
  • branch flags are saved also in transaction, but per branch; also they will be saved in usrloc (per contact). A new set of functions were added for manipulating these flags from script. So, there flags will be registration persistent and branch persistent.
  • script flags are no-message-related flags - they are only script persistent and you can strictly use them for scripting. Once you exit a top level route, they will be lost. These flags are useful and they offer an option to de-congest the message flags - many flags have no need to be saved as they just reflect some scripting status.

Corresponding Functions

Message/transaction flags

setflag(flag_idx) resetflag(flag_idx) isflagset(flag_idx)

Branch flags

setbflag/setbranchflag(branch_idx,flag_idx) resetbflag/resetbranchflag(branch_idx,flag_idx) isbflagset/isbranchflagset(branch_idx,flag_idx)

or, the shorter format, working on the default (branch 0) flags:

setbflag(flag_idx) resetbflag(flag_idx) isbflagset(flag_idx)

Script flags

setsflag/setscriptflag(flag_idx) resetsflag/resetscriptflag(flag_idx) issflagset/isscriptflagset(flag_idx)


Flags and Pseudo Variables

Message/transaction flags

$mf - decimal value $mF - hexa value

Branch flags

$bf - decimal value $bF - hexa value

Script flags

$sf - decimal value $sF - hexa valu


Flags and routes

Message/transaction flags

These flags will show up in all routes where messages related to the initial request are processed. So, they will be visible and changeable in onbranch, failure and onreply routes; the flags will be visible in all branch routes; if you change a flag in a branch route, the next branch routes will inherit the change.

Branch flags

There flags will show up in all routes where messages related to initial branch request are processed. So, in branch route you will see different sets of flags (as they are different branches); in onreply route yo will see the branch flags corresponding to the branch the reply belongs to; in failure route, the branch flags corresponding to the branch the winning reply belongs to will be visible. In request route, you can have multiple branches (as a result of a lookup(), enum query, append_branch(), etc) - the default branch is 0 (corresponding to the RURI); In reply routes there will be only one branch , the 0 one. In branch route the default branch is the current process branch (having index 0); In failure route, initially there is only one branch (index 0), corresponding the failed branch.

Script flags

There flags are available only in script and are reset after each top level route execution (routes internally triggered by OpenSIPS). They will be persistent per main route, onreply_route, branch_route, failure_route. Note they will be inherit in routes called from other routes.


Example

Nat flag handling

 ..........
 # 3 - the nat flag
 modparam("usrloc","nat_bflag",3)
 ..........

 route {
   ..........
   if (nat detected)
      setbflag(3); # set branch flag 3 for the branch 0

   ..........
   if (is_method("REGISTER")) {
      # the branch flags (including 3) will be saved into location
      save("location");
      exit;
   } else {
      # lookup will load the branch flag from location
      if (!lookup("location")) {
         sl_send_reply("404","Not Found");
         exit;
      }
      t_on_branch("1")
      t_relay();
   }
 }

 branch_route[1] {
   xlog("-------branch=$T_branch_idx, branch flags=$bF\n");
   if (isbflagset(3)) {
      #current branch is marked as natted
      .........
   }
 }

if no parallel forking is done, you can get rid of the branch route and add instead of t_on_branch():

   ........
   if (isbflagset(3)) {
      #current branch is marked as natted
      .........
   }
   ......... 

(:commentboxchrono:)


Page last modified on April 24, 2013, at 09:05 PM