OsGetAgentIP

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (Change See Also)
 
(8 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{| width="100%" style="border: thin solid black"
+
{{osslfunc
| colspan="2" align="center" style=background:orange | '''{{SUBPAGENAME}}'''
+
|threat_level=Severe
|- valign="top"
+
|permissions=true
|'''Threat Level''' || High
+
|delay=0
 
+
|function_syntax=string osGetAgentIP(key uuid);
|- valign="top"
+
|description=Requires: ''key uuid'' of agent to get IP address for.
|'''Function Syntax''' || <source lang="lsl">
+
Returns: string representing the IP address returned.<br>
string OsGetAgentIP(key uuid);
+
Possible Exceptions thrown:
</source>
+
System.Exception: OSSL Runtime Error: osGetAgentIP permission denied.  Allowed threat level is VeryLow but function threat level is High.
|- valign="top"
+
Notes:
|'''Example(s)||<source lang="lsl">
+
Unknown if this function requires a valid ''Detect'' event such as touch or collision.<br>
 +
Unknown what is returned for IPv6.<br>
 +
'''osGetAgentIP''' is always restricted to Administrators
 +
|ossl_example=<source lang="lsl">
 
//
 
//
// Example of osGetAgentIP
+
// osGetAgentIP Script Example
 
//
 
//
 +
 
default
 
default
 
{
 
{
  state_entry()
+
    state_entry()
  {
+
    {
    // Demo-Script
+
        llSay(PUBLIC_CHANNEL, "Touch to see osGetAgentIP usage.");
  }
+
    }
  touch_start(integer total_number)
+
 
  {
+
    touch_start(integer number)  
    llSay (0, "Your IP is : "+ osGetAgentIP(llDetectedKey(0)));
+
    {
  }
+
        llSay(PUBLIC_CHANNEL, "Your IP is : " + osGetAgentIP(llDetectedKey(0)));
 +
    }
 
}
 
}
 
</source>
 
</source>
 
+
|additional_info=
|}
+
}}
Requires: key <uuid> of agent to get IP address for.
+
== See Also ==
 
+
* [[osGetAgentIP]]
Returns: string representing the IP address returned.
+
* [[osGetAgentCountry]]
 
+
* [[osDetectedCountry]]
Possible Exceptions thrown:
+
System.Exception: OSSL Runtime Error: osGetAgentIP permission denied.  Allowed threat level is VeryLow but function threat level is High.
+
 
+
Notes:
+
Unknown if this function requires a valid *Detect* event such as touch or collision.
+
 
+
Unknown what is returned for IPv6.
+
 
+
 
+
[[Category:OSSL Functions]]
+
[[Category:OSSL]]
+

Latest revision as of 18:46, 5 December 2020

string osGetAgentIP(key uuid);
Requires: key uuid of agent to get IP address for.

Returns: string representing the IP address returned.
Possible Exceptions thrown:

System.Exception: OSSL Runtime Error: osGetAgentIP permission denied.  Allowed threat level is VeryLow but function threat level is High.

Notes: Unknown if this function requires a valid Detect event such as touch or collision.
Unknown what is returned for IPv6.
osGetAgentIP is always restricted to Administrators

Threat Level Severe
Permissions Use of this function is always allowed by default
Extra Delay 0 seconds
Example(s)
//
// osGetAgentIP Script Example
//
 
default
{
    state_entry()
    {
        llSay(PUBLIC_CHANNEL, "Touch to see osGetAgentIP usage.");
    }
 
    touch_start(integer number) 
    {
        llSay(PUBLIC_CHANNEL, "Your IP is : " + osGetAgentIP(llDetectedKey(0)));
    }
}


[edit] See Also

Personal tools
General
About This Wiki