D.91. SIPPEER()

D.91. `SIPPEER()`

SIPPEER(Peername[,Feld])

Gibt Informationen über einen SIP-Peer zurück. Gültige Felder sind:

ip: (Default) Die IP-Adresse des Peers
mailbox: Die eingestellte Mailbox
context: Der eingestellte Context
expire: Die Unix-Zeit (Epoch), zu der die Verbindung das nächste Mal ausläuft
dynamic: Gibt an, ob dynamic=yes gesetzt ist (yes|no).
callerid_name: Der eingestellte Caller-ID-Name
callerid_num: Die eingestellte Caller-ID-Nummer
codecs: Die verfügbaren Codecs
status: Der Status (wenn qualify=yes gesetzt ist)
regexten: Die Registrierungs-Extension (regexten)
limit: Eine Begrenzung für die Anzahl der Anrufe
curcalls: Die Anzahl der derzeitigen Anrufe (nur, wenn ein Limit gesetzt ist)
language: Die Default-Sprache für diesen Peer
useragent: Der User-Agent des Peers
codec[x]: Der Codec Nummer x (0-basiert) in der Reihenfolge der Präferenz
accountcode: Die Abrechnungsnummer im CDR für Gespräche mit diesem Peer

; die IP-Adresse des Peers 2001:
exten => 123,1,Set(sip_ip=${SIPPEER(2001,ip)})
; der bevorzugte Codec des Peers:
exten => 123,n,Set(sip_ip=${SIPPEER(2001,codec[0])})

Asterisk-Versionen:

————————| 1.2 |————————| 1.4 |————————| 1.6 |————————

Interner Hilfetext zu dieser Funktion in Asterisk 1.4:

  -= Info about function 'SIPPEER' =-

[Syntax]
SIPPEER(<peername>[|item])

[Synopsis]
Gets SIP peer information

[Description]
Valid items are:
- ip (default)          The IP address.
- mailbox               The configured mailbox.
- context               The configured context.
- expire                The epoch time of the next expire.
- dynamic               Is it dynamic? (yes/no).
- callerid_name         The configured Caller ID name.
- callerid_num          The configured Caller ID number.
- codecs                The configured codecs.
- status                Status (if qualify=yes).
- regexten              Registration extension
- limit                 Call limit (call-limit)
- curcalls              Current amount of calls
                        Only available if call-limit is set
- language              Default language for peer
- accountcode           Account code for this peer
- useragent             Current user agent id for peer
- codec[x]              Preferred codec index number 'x' (beginning with zero).

Differenz des internen Hilfetexts von Asterisk 1.2 zu 1.4:

--- in Asterisk 1.2
+++ in Asterisk 1.4
@@ -1,7 +1,7 @@
     -= Info about function 'SIPPEER' =-

   [Syntax]
-  SIPPEER(<peername>[:item])
+  SIPPEER(<peername>[|item])

   [Synopsis]
   Gets SIP peer information

Differenz des internen Hilfetexts von Asterisk 1.4 zu 1.6:

--- in Asterisk 1.4
+++ in Asterisk 1.6
@@ -1,7 +1,7 @@
     -= Info about function 'SIPPEER' =-

   [Syntax]
-  SIPPEER(<peername>[|item])
+  SIPPEER(<peername>[,item])

   [Synopsis]
   Gets SIP peer information
@@ -9,19 +9,24 @@
   [Description]
   Valid items are:
   - ip (default)          The IP address.
+  - port                  The port number
   - mailbox               The configured mailbox.
   - context               The configured context.
   - expire                The epoch time of the next expire.
   - dynamic               Is it dynamic? (yes/no).
   - callerid_name         The configured Caller ID name.
   - callerid_num          The configured Caller ID number.
+  - callgroup             The configured Callgroup.
+  - pickupgroup           The configured Pickupgroup.
   - codecs                The configured codecs.
   - status                Status (if qualify=yes).
   - regexten              Registration extension
   - limit                 Call limit (call-limit)
+  - busylevel             Configured call level for signalling busy
   - curcalls              Current amount of calls
                           Only available if call-limit is set
   - language              Default language for peer
   - accountcode           Account code for this peer
   - useragent             Current user agent id for peer
+  - chanvar[name]         A channel variable configured with setvar for this peer.
   - codec[x]              Preferred codec index number 'x' (beginning with zero).

Siehe auch

Abschnitt D.46, „IAXPEER()“