sipsak - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

sipsak - ein Dienstprogramm für verschiedene Tests auf SIP-Servern und Benutzeragenten

ZUSAMMENFASSUNG

Schluck [-dFGhiILnNMRSTUVvwz] [-ein PASSWORD ] [-B NUMBER ] [-C SIPURI ] [-C SIPURI ] [-D
NUMBER ] [-e NUMBER ] [-E STRING ] [-F FILE ] [-G STRING ] [-H HOSTNAME ] [-l PORT ] [-M
NUMBER ] [-oder NUMBER ] [-P HOSTNAME ] [-P NUMBER ] [-Q REGEXP ] [-R PORT ] [-T NUMBER ] [-u
STRING ] [-W NUMBER ] [-X NUMBER ] -s SIPURI

BESCHREIBUNG

Schluck ist ein SIP-Stress- und Diagnosedienstprogramm. Es sendet SIP-Anfragen an den Server
innerhalb der sip-uri und prüft eingegangene Antworten. Es läuft in einem der folgenden
Modi:

- Standardmodus
Eine SIP-Nachricht wird an das Ziel gesendet in sip-uri und der Antwortstatus wird angezeigt. Die
Anfrage stammt entweder von Dateinamen oder als neue OPTIONS-Nachricht generiert.

- Traceroute-Modus (-T)
Dieser Modus ist nützlich, um den Pfad der Anfrage zu lernen. Es funktioniert ähnlich wie die IP-Schicht
Nutzen Traceroute(8).

- Nachrichtenmodus (-M)
Sendet eine kurze Nachricht (ähnlich einer SMS von Mobiltelefonen) an ein bestimmtes Ziel.
Mit der Option -B der Inhalt der NACHRICHT kann eingestellt werden. Nützlich könnte das sein
Optionen -c und -O in diesem Modus.

- usrloc-Modus (-U)
Stress-Modus für SIP-Registrar. Schluck Registriert sich ständig bei einem SIP-Server mit hoher Geschwindigkeit
Tempo. Zusätzlich kann der Registrar mit der -I oder unter der -M Möglichkeit. Wenn
-I und -M werden weggelassen Schluck kann verwendet werden, um einen beliebigen Kontakt zu registrieren (mit dem -C
Option) für ein Konto bei einem Registrar und um die aktuellen Bindungen nach einem
Konto bei einem Registrar.

- Randtrash-Modus (-R)
Parser-Foltermodus. Schluck sendet immer wieder zufällig beschädigte Nachrichten an Folter a
Parser des SIP-Servers.

- Flutmodus (-F)
Stressmodus für SIP-Server. Schluck sendet ständig Anfragen an einen SIP-Server auf hohem Niveau
Tempo.

Wenn Bücher (http://www.nongnu.org/ruli/) Unterstützung ist in die kompiliert Schluck binär, dann
zuerst wird eine SRV-Suche nach _sip._udp.hostname durchgeführt. Und wenn diese Suche fehlschlägt ein normales A
nachschauen gemacht wird. Wenn in der Ziel-URI ein Port angegeben wurde, entfällt die SRV-Suche. Ausfallsicherung,
Lastverteilung und andere Transporte werden noch nicht unterstützt.

OPTIONAL

-a, --password PASSWORT
Mit dem gegebenen PASSWORD bei empfangener '401 . wird eine Authentifizierung versucht
Unbefugt'. Die Autorisierung wird rechtzeitig versucht. Wenn diese Option weggelassen wird und
Autorisierung mit leerem Passwort ("") wird versucht. Wenn das Passwort gleich ist
zu - das Passwort wird aus der Standardeingabe (zB der Tastatur) gelesen. Dies
verhindert, dass andere Benutzer auf demselben Host das Passwort sehen das Passwort im
Prozessliste bzw. Anmerkungen: das Passwort kann weiterhin aus dem Speicher gelesen werden, wenn andere Benutzer
Zugriff darauf haben.

-A, --Timing
druckt nur die Zeitwerte des Testlaufs, wenn die Ausführlichkeit null ist, weil nein -v
wurde gegeben. Wenn einer oder mehrere -v gegeben wurden, wird diese Option ignoriert.

-b, --apendix-begin NUMMER
Die Startnummer, die im usrloc-Modus an den Benutzernamen angehängt wird. Dies
NUMBER wird erhöht, bis der Wert erreicht wird, der durch die -e Parameter. Wenn
weggelassen wird die Startnummer eins.

-B, --message-body STRING
Das Gegebene STRING wird als Hauptteil für ausgehende MESSAGE-Anfragen verwendet.

-c, --von SIPURI
Das Gegebene SIPURI wird im From-Header verwendet, wenn Schluck läuft im Nachrichtenmodus
(eingeleitet mit dem -M Möglichkeit). Dies ist hilfreich, um den Empfänger von a . zu präsentieren
NACHRICHT eine aussagekräftige und brauchbare Adresse, an die vielleicht sogar Antworten gesendet werden können.

-C, --kontaktiere SIPURI
Dies ist der Inhalt des Contact-Headers im usrloc-Modus. Dies ermöglicht das Einfügen
leitet wie für Post weiter. Sie können zum Beispiel die uri Ihres ersten SIP . eingeben
Konto auf einem zweiten Konto, dadurch werden alle Anrufe auf das zweite Konto umgeleitet
auf das erste Konto. Da das Argument für diese Option nicht eingeschlossen ist in
Klammern können Sie auch mehrere Kontakte im Rohformat durch Kommas getrennt angeben
aufführen. Die besonderen Worte leer or keine führt zu keiner Kontaktkopfzeile im
REGISTER-Anfrage und somit sollte der Server mit den aktuellen Bindings antworten für
das Konto beim Registrar.

-d, --ignore-redirects
Wenn diese Option gesetzt ist, werden alle Weiterleitungen ignoriert. Standardmäßig ohne diese Option
erhaltene Weiterleitungen werden respektiert. Diese Option wird automatisch im
Randtrash-Modus und im Flood-Modus.

-D, --timeout-factor ZAHL
Der SIP_T1-Timer wird mit der angegebenen NUMMER multipliziert. Nach Erhalt von a
vorläufige Antwort auf eine INVITE-Anfrage oder wenn ein zuverlässiger Transport wie TCP
oder TLS verwendet wird Schluck wartet die resultierende Zeit auf eine endgültige Antwort
bis es aufgibt.

-e, --appendix-end NUMMER
Die Endnummer, die im usrloc-Modus an den Benutzernamen angehängt wird. Dies
Nummer wird erhöht, bis diese Endung erreicht ist Anzahl. Im Flutmodus ist dies
die maximale Anzahl von Nachrichten, die gesendet werden. Wenn es weggelassen wird, ist der Standardwert
2^31 (2147483647) im Flutmodus.

-E, --transport STRING
Der Wert der STRING wird als IP-Transport zum Senden und Empfangen von Anfragen verwendet
und Antworten. Diese Option überschreibt alle Ergebnisse aus der URI-Auswertung und SRV
Schau hoch. Derzeit werden nur 'udp' und 'tcp' als Wert akzeptiert für STRING.

-f, --filename DATEI
Der Inhalt von FILE wird im Binärmodus eingelesen und als Ersatz verwendet
für die alternativ erstellte SIP-Nachricht. Dies kann im Standardmodus verwendet werden, um
andere Anfragen als OPTIONS-Anfragen stellen (zB INVITE). Standardmäßig fehlt
Wagenrückläufe vor Zeilenumbrüchen werden eingefügt (verwenden Sie -L deaktivieren
diese Funktion). Wenn der Dateiname gleich ist - die Datei wird von der Standardeingabe gelesen,
zB von der Tastatur oder einer Pfeife. Bitte beachten Sie, dass die Manipulationsfunktionen
(zB Einfügen von Via-Headern) werden nur mit RFC-konformen Anfragen getestet. Zusätzlich
spezielle Strings innerhalb der Datei können durch einige lokale oder vorgegebene Werte ersetzt werden
(sehen -g und -G für Details).

-F, --flood-mode
Diese Option aktiviert den Flutmodus. In diesem Modus OPTIONS-Anfragen mit
steigende CSeq-Nummern werden an den Server gesendet. Antworten werden ignoriert -- Quellport
9 (discard) von localhost wird in der obersten Via beworben.

-h, --Hilfe
Druckt eine einfache Gebrauchshilfenachricht aus. Wenn die lange Option --help ist es verfügbar
druckt eine Hilfenachricht mit den verfügbaren langen Optionen aus.

-g, --replace-string ZEICHENFOLGE
Aktiviert das Ersetzen von $replace$ innerhalb der Anfrage (normalerweise eingelesen von a
Datei) mit dem STRING. Alternativ können Sie auch eine Liste von Attributen und
Werte. Diese Liste muss mit einem nicht alphanumerischen Zeichen beginnen und enden. Die
das gleiche Zeichen muss auch als Trennzeichen zwischen dem Attribut und dem Wert verwendet werden
und zwischen neuen weiteren Attribut-Werte-Paaren. Die Zeichenfolge "$attribute$" ist
durch die Wertzeichenfolge in der Nachricht ersetzt.

-G, --ersetzen
Aktiviert das automatische Ersetzen der folgenden Variablen in der Anfrage
(normalerweise aus einer Datei einlesen): $dsthost$ wird ersetzt durch durch den Host oder
Domainname, der von der . gegeben wird -s Parameters. $srchost$ wird ersetzt durch die
Hostname des lokalen Rechners. $port$ wird durch den lokalen Listening-Port ersetzt
of Schluck. $Benutzer$ wird durch den Benutzernamen ersetzt, der vom -s
Parameters.

-H, --hostname HOSTNAME
Überschreibt die automatische Erkennung des Hostnamens mit dem angegebenen Parameter.
Warnung: Verwenden Sie dies mit Vorsicht (vorzugsweise nur, wenn die automatische Erkennung fehlschlägt).

-i, --no-via
Deaktiviert das Einfügen der Via-Zeile des localhost. Warnung: das wahrscheinlich
deaktiviert den Empfang der Antworten vom Server.

-I, --invite-mode
Aktiviert die Invites-Zyklen im usrloc-Modus. Es sollte kombiniert werden mit -IN.
In dieser Kombination Schluck registriert zuerst einen Benutzer und simuliert dann einen
Einladung an diesen Benutzer. Zuerst wird eine Einladung verschickt, diese wird mit 200 OK beantwortet und
schließlich wird eine ACK gesendet. Diese Option kann auch ohne verwendet werden -U , aber das solltest du sein
Stellen Sie sicher, dass Sie mit dieser Option KEINE echten UAs einladen. Bei fehlendem -U -l
PORT ist erforderlich, denn nur wenn Sie a gemacht haben -U vorher mit einem festen lokalen Port laufen,
ein Lauf mit -I und der gleiche feste lokale Port kann erfolgreich sein. Warnung: Schluck is
keine echte UA und Einladungen zu echten UAs können zu unerwartetem Verhalten führen.

-j, --headers STRING
Das Schnur werden der Anfrage als ein oder mehrere zusätzliche Header hinzugefügt. Die
String "\n" (Anmerkung: zwei Zeichen) wird durch CRLF ersetzt und ergibt somit
zwei separate Header. Auf diese Weise kann mehr als ein Header hinzugefügt werden.

-l, --local-port PORT
Der empfangende UDP-Socket verwendet das lokale Netzwerk Hafen. Nützlich, wenn eine Datei
gegeben durch -f die eine korrekte Via-Zeile enthält. Überprüf den -S Option für Details wie
sipsak sendet und empfängt Nachrichten.

-L, --no-crlf
Deaktiviert das Einfügen von Carriage Returns (\r) vor allen Zeilenumbrüchen (\n)
(was nicht bereits durch carraige Return erfolgt) wenn die Eingabe von a . kommt
Datei ( -f ). Ohne diese Option wird auch eine Leerzeile an die Anfrage angehängt
Falls erforderlich.

-m, --max-forwards NUMMER
Dadurch wird der Wert des Max-Forward-Header-Felds festgelegt. Wenn weggelassen, kein Max-Forward
Feld eingefügt wird. Wenn im Traceroute-Modus weggelassen Anzahl wird 255 sein.

-M, --Nachrichtenmodus
Dies aktiviert die Messages-Zyklen innerhalb des usrloc-Modus (bekannt aus Schluck
Versionen vor 0.8.0 innerhalb des normalen usrloc-Tests). Diese Option sollte kombiniert werden
mit -U damit eine erfolgreiche Anmeldung mit einer Testnachricht an die
Benutzer und antwortete mit 200 OK. Diese Option kann aber auch ohne die -U
. Warnung: ohne verwenden -U kann zu unerwartetem Verhalten führen.

-n, --numerisch
Anstelle des vollqualifizierten Domainnamens in der Via-Zeile die IP des lokalen Hosts
verwendet werden. Diese Option ist jetzt standardmäßig aktiviert.

-N, --nagios-code
Verwenden Sie Nagios-konforme Returncodes anstelle der normalen sipsak-Returncodes. Das heisst
Schluck gibt 0 zurück, wenn alles in Ordnung war und 2 im Falle eines Fehlers (lokal oder
Fernbedienung).

-o, --sleep NUMMER
Schluck werde schlafen für NUMBER ms, bevor der nächste Zyklus im usrloc-Modus gestartet wird.
Dies wird den gesamten Testprozess verlangsamen, um realistischer zu sein. Jeder Zyklus wird
noch so schnell wie möglich abgeschlossen, aber der gesamte Test wird verlangsamt.

-O, --disposition STRING
Das Gegebene STRING wird als Inhalt für den Content-Disposition-Header verwendet.
Ohne diese Option gibt es keinen Content-Disposition-Header in der Anfrage.

-p, --outbound-proxy HOSTNAME[:PORT]
die Adresse des Hostnamens ist das Ziel, an das die Anfrage gesendet wird
(ausgehender Proxy). Verwenden Sie dies, wenn sich der Zielhost vom Hostteil unterscheidet
der Anfrage-URI. Der Hostname wird über DNS SRV aufgelöst, falls unterstützt (siehe
Beschreibung für die SRV-Auflösung) und es wird kein Port angegeben.

-P, --Prozesse NUMMER
Beginne NUMBER von Prozessen parallel, um die Sende- und Antwortprüfung durchzuführen. Macht nur
Sinn, wenn eine höhere Zahl für -e wird im usrloc-, Nachrichten- oder Einladungsmodus angegeben.

-q, --search REGEXP
Spielantworten gegen REGEXP und geben false zurück, wenn keine Übereinstimmung aufgetreten ist. Nützlich zum
Beispiel, um den Servernamen im Server-Header-Feld zu erkennen.

-r, --remote-port PORT
Anstelle des standardmäßigen SIP-Ports 5060 wird der PORT verwendet werden. Alternativ die
Remote-Port kann in der SIP-URI des -s Parameters.

-R, --random-mode
Dies aktiviert den Randtrash-Modus. In diesem Modus werden OPTIONS-Anfragen gesendet an
Server mit zunehmender Anzahl zufällig abgestürzter Charaktere in dieser Anfrage.
Die Position innerhalb der Anfrage und das ersetzende Zeichen werden zufällig gewählt.
Jede andere Antwort als Bad request (4xx) beendet diesen Modus. Auch drei
unbeantwortete Sends beenden diesen Modus. Mit dem -t Parameter das Maximum von Papierkorb
Zeichen gegeben werden können.

-s, --sip-uri SIPURI
Diese obligatorische Option legt das Ziel der Anforderung fest. Es kommt auf den Modus an
wenn nur der Servername oder auch ein Benutzername zwingend erforderlich ist. Beispiel für eine volle
SIPURI : Schluck:test@foo.bar: 123 Siehe den Hinweis im Beschreibungsteil zu SRV
sucht nach Details, wie der Hostname dieser URI in eine IP und einen Port umgewandelt wird.

-S, --symmetrisch
Mit dieser Option Schluck verwendet nur einen Port zum Senden und Empfangen von Nachrichten.
Bei dieser Option ist der lokale Port zum Senden der Wert aus dem -l .
Im Standardmodus Schluck sendet von einem zufälligen Port und lauscht auf dem angegebenen Port
von dem -l . Hinweis: Mit dieser Option Schluck wird nicht empfangen können
Antworten von Servern mit asymmetrischer Signalisierung (und fehlerhafter rport-Implementierung)
wie der Cisco-Proxy. Wenn du läufst Schluck als root und mit Raw-Socket-Unterstützung (check
die Ausgabe von der -V Option) dann ist diese Option nicht erforderlich, weil in diesem
Häuser Schluck verwendet bereits nur einen Port zum Senden und Empfangen von Nachrichten.

-t, --trash-chars NUMMER
Dieser Parameter gibt die maximale Anzahl von Zeichen im Papierkorb im Randtrash-Modus an.
Wenn weggelassen NUMBER wird auf die Länge der Anfrage gesetzt.

-T, --traceroute-Modus
Dies aktiviert den Traceroute-Modus. Dieser Modus funktioniert wie der bekannte
Traceroute(8) Befehl erwarten, dass nicht die Anzahl der Netzwerk-Hops gezählt wird, sondern
die Nummer des Servers auf dem Weg zum Zielbenutzer. Auch die Rundfahrtzeit
jeder Anfrage wird ausgedruckt, aber aufgrund einer Einschränkung innerhalb des SIP-Protokolls
Identität (IP oder Name) kann nur ermittelt und ausgedruckt werden, wenn die Antwort vom
server enthält ein Warnungs-Header-Feld. In diesem Modus wird bei jeder ausgehenden Anfrage die
Wert des Max-Forwards-Header-Felds wird erhöht, beginnend mit eins. Das Maximum
des Max-Forwards-Headers beträgt 255, wenn kein anderer Wert von der -m Parameters.
Jede andere Antwort als 483 oder 1xx wird als endgültige Antwort behandelt und wird
beenden Sie diesen Modus.

-u, --auth-Benutzername STRING
Benutze das Gegebene STRING als Benutzername für die Authentifizierung (anderer Account
und Authentifizierungs-Benutzername).

-U, --usrloc-Modus
Dies aktiviert den usrloc-Modus. Ohne das -I oder unter der -M Option, nur diese
registriert Benutzer bei einem Registrar. Mit einer der oben genannten Optionen die vorherige
registrierte Benutzer werden auch mit einem simulierten Anrufverlauf (einladen, 200,
ack) oder mit einer Sofortnachricht (Nachricht, 200). Ein Passwort für alle Benutzerkonten
innerhalb des usrloc-Tests kann mit dem angegeben werden -a Möglichkeit. Ein Benutzername ist obligatorisch
für diesen Modus im -s Parameter. Die Zahl beginnend mit dem -b Parameter auf die
-e Parameter wird der Benutzername angehängt. Wenn die -b und den -e Parameter weggelassen werden,
nur einer läuft mit dem angegebenen Benutzernamen, aber ohne Nummer an den Benutzernamen anzuhängen
erledigt.

-v, --verbose
Dieser Parameter erhöht die Ausführlichkeit der Ausgabe. Nein -v bedeutet fast keine Ausgabe außer
in Traceroute und Fehlermeldungen. Das Maximum von drei Vs druckt den Inhalt aus
aller empfangenen und gesendeten Pakete.

-V, --Version
Druckt den Namen und die Versionsnummer von Schluck und die Optionen, die waren
in die Binärdatei kompiliert.

-w, --extract-ip
Aktiviert die Extraktion der IP oder des Hostnamens aus dem Header-Feld Warnung.

-W, --nagios-warn NUMMER
Geben Sie den Nagios-Warn-Exit-Code (1) zurück, wenn die Anzahl der erneuten Übertragungen vor dem Erfolg
war über der angegebenen Zahl.

-x, --expires ZAHL
Setzt den Wert des Expires-Headers auf die angegebene Zahl.

-z, --Remove-Bindungen
Aktiviert das zufällige Entfernen alter Bindings im usrloc-Modus. Wie viele pro
Cent der Bindungen entfernt werden, wird durch die USRLOC_REMOVE_PERCENT bestimmt
im Code definieren (vor der Kompilierung setzen). Mehrfaches Entfernen von Bindungen
ist möglich und kann nicht verhindert werden.

RÜCKKEHR WERTE

Der Rückgabewert 0 bedeutet, dass eine 200 empfangen wurde. 1 bedeutet etwas anderes als 1xx oder 2xx
wurde erhalten. 2 wird bei lokalen Fehlern wie nicht auflösbaren Namen oder falschen zurückgegeben
Optionen Kombination. 3 wird bei entfernten Fehlern wie Socket-Fehlern zurückgegeben (z. B. icmp
error), Weiterleitungen ohne Kontaktkopfzeile oder einfach keine Antwort (Timeout).

Besitzt das -N Option gegeben wurde, ist der Rückgabecode 2 im Falle einer (lokal oder entfernt)
Error. 1 falls es erneute Übertragungen von gegeben hat Schluck zum Server. Und 0 wenn da
war überhaupt kein fehler.

VORSICHT

Wasser Schluck verantwortungsbewusst. Es in einem der Stressmodi zu betreiben, belastet den
Netzwerk und Server im Test.

Beispiele:

sipsak -vv -s SIP:niemand@foo.bar
zeigt empfangene Antworten an.

sipsak -T -s Schluck:niemand@foo.bar
verfolgt SIP-Pfad zu niemandem.

sipsak -U -C sip:me@home -x 3600 -a Passwort -s sip:myself@company
fügt die Weiterleitung von der Arbeit nach Hause für eine Stunde ein.

sipsak -f bye.sip -g '!FTAG!345.af23!TTAG!1208.12!' -s sip:myproxy
liest die Datei bye.sip, ersetzt $FTAG$ durch 345.af23 und $TTAG$ durch 1208.12 und
Sende diese Nachricht endlich an myproxy

EINSCHRÄNKUNGEN / NICHT UMSETZT

Viele Server entscheiden sich möglicherweise dafür, SIP-Header-Felder "Warnung" NICHT einzuschließen. Leider ist das
macht die Anzeige von IP-Adressen von SIP-Servern im Traceroute-Modus unmöglich.

IPv6 wird nicht unterstützt.

Fehlende Unterstützung für den Record-Route- und Route-Header.

Verwenden Sie sipsak online mit den onworks.net-Diensten