summaryrefslogtreecommitdiffstats
path: root/raddb/mods-available/always
blob: b77d00c55d46741a3ca1cfc135dee4615466e912 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
# -*- text -*-
#
#  $Id$

#
#  The "always" module is here for debugging purposes, or
#  for use in complex policies.
#  Instance simply returns the same result, always, without
#  doing anything.
#
#  rcode may be one of the following values:
#  - reject   - Reject the user.
#  - fail     - Simulate or indicate a failure.
#  - ok       - Simulate or indicate a success.
#  - handled  - Indicate that the request has been handled,
#               stop processing, and send response if set.
#  - invalid  - Indicate that the request is invalid.
#  - userlock - Indicate that the user account has been
#               locked out.
#  - notfound - Indicate that a user account can't be found.
#  - noop     - Simulate a no-op.
#  - updated  - Indicate that the request has been updated.
#
#  If an instance is listed in a session {}  section, 
#  this simulates a user having <integer> sessions.
#  
#  simulcount = <integer>
#
#  If an instance is listed in a session {}  section, 
#  this simulates the user having multilink
#  sessions.
#
#  mpp = <integer>
#
#  An xlat based on the instance name can be called to change the status
#  returned by the instance, in this example "always db_status { ... }"
#
#  Force the module status to be alive or dead:
#
#  %{db_status:alive}
#  %{db_status:dead}
#
#  Update the rcode returned by an alive module (a dead module returns fail):
#
#  %{db_status:ok}
#  %{db_status:fail}
#  %{db_status:notfound}
#  ...
#
#  The above xlats expand to the current status of the module. To fetch the
#  current status without affecting it call the xlat with an empty argument:
#
#  %{db_status:}
#
always reject {
	rcode = reject
}
always fail {
	rcode = fail
}
always ok {
	rcode = ok
}
always handled {
	rcode = handled
}
always invalid {
	rcode = invalid
}
always userlock {
	rcode = userlock
}
always notfound {
	rcode = notfound
}
always noop {
	rcode = noop
}
always updated {
	rcode = updated
}