sipsak - Online nel cloud

PROGRAMMA:

NOME

sipsak - un'utilità per vari test su server SIP e agenti utente

SINOSSI

sipsak [-dFGiILnNMRSTUVvwz] [-un PASSWORD ] [-B NUMERO ] [-C SIPURI ] [-C SIPURI ] [-D
NUMERO ] [-es NUMERO ] [-E STRING ] [-F RISORSE ] [-G STRING ] [-H HOSTNAME ] [-l PORT ] [-M
NUMERO ] [-O NUMERO ] [-P HOSTNAME ] [-P NUMERO ] [-Q REGEXP ] [-R PORT ] [-T NUMERO ] [-u
STRING ] [-O NUMERO ] [-X NUMERO ] -s SIPURI

DESCRIZIONE

sipsak è un'utilità di diagnostica e stress SIP. Invia richieste SIP al server
all'interno sorseggiare ed esamina le risposte ricevute. Viene eseguito in uno dei seguenti modi:
modalità:

- modalità predefinita
Un messaggio SIP viene inviato alla destinazione in sorseggiare e viene visualizzato lo stato della risposta.
la richiesta è presa da Nome del file o generato come nuovo messaggio OPZIONI.

- modalità traceroute (-T)
Questa modalità è utile per apprendere il percorso della richiesta. Funziona in modo simile al livello IP
utilità traceroute(8).

- modalità messaggio (-M)
Invia un breve messaggio (simile agli SMS dei telefoni cellulari) a un determinato target.
Con l'opzione -B il contenuto del MESSAGGIO può essere impostato. Utile potrebbe essere il
Opzioni -c e -O in questa modalità.

- modalità usrloc (-U)
Modalità stress per il registrar SIP. sipsak continua a registrarsi su un server SIP ad alta velocità
ritmo. Inoltre il registrar può essere stressato con il -I oppure -M opzione. Se
-I e -M sono omessi sipsak può essere utilizzato per registrare qualsiasi contatto dato (con il -C
opzione) per un account presso un registrar e per interrogare i binding correnti per un
conto presso un ufficio di registrazione.

- modalità randtrash (-R)
Modalità tortura del parser. sipsak continua a inviare messaggi casualmente corrotti per torturare un
Parser del server SIP.

- modalità flood (-F)
Modalità stress per i server SIP. sipsak continua a inviare richieste a un server SIP ad alta velocità
ritmo.

Se libruli (http://www.nongnu.org/ruli/) il supporto è compilato nel sipsak binario, quindi
prima viene effettuata una ricerca SRV per _sip._udp.hostname. E se questa ricerca fallisce, viene eseguito un normale A
viene effettuata la ricerca. Se è stata specificata una porta nell'URI di destinazione, la ricerca SRV viene omessa. Failover,
la distribuzione del carico e altri trasporti non sono ancora supportati.

VERSIONI

-a, --password PASSWORD
Con il dato PASSWORD verrà tentata un'autenticazione in caso di ricezione di '401
Non autorizzato'. L'autorizzazione verrà tentata in tempo. Se questa opzione viene omessa, un
verrà tentata l'autorizzazione con una password vuota (""). Se la password è uguale
a - la password verrà letta dall'input standard (ad esempio la tastiera). Questo
impedisce ad altri utenti sullo stesso host di vedere la password nella
lista dei processi. NOTA: la password può ancora essere letta dalla memoria se altri utenti
avervi accesso.

-A, --timing
stampa solo i valori di temporizzazione dell'esecuzione del test se la verbosità è zero perché no -v
è stato dato. Se uno o più -v se è stata data questa opzione verrà ignorata.

-b, --apendix-begin NUMERO
Il numero iniziale che viene aggiunto al nome utente nella modalità usrloc. Questo
NUMERO viene aumentato fino a raggiungere il valore dato dal -e parametro. Se
omesso il numero di partenza sarà uno.

-B, --messaggio-corpo STRINGA
Il dato STRING verrà utilizzato come corpo per le richieste MESSAGGIO in uscita.

-c, --da SIPURI
Il dato SIPURI verrà utilizzato nell'intestazione Da se sipsak viene eseguito in modalità messaggio
(iniziato con il -M opzione). Questo è utile per presentare il destinatario di un
MESSAGGIO un indirizzo significativo e utilizzabile a cui magari è possibile inviare anche delle risposte.

-C, --contatta SIPURI
Questo è il contenuto dell'intestazione del contatto in modalità usrloc. Ciò consente di inserire
inoltra come per la posta. Ad esempio, puoi inserire l'URI del tuo primo SIP
account su un secondo account, quindi tutte le chiamate al secondo account verranno inoltrate
al primo account. Poiché l'argomento di questa opzione non sarà racchiuso in
tra parentesi puoi anche fornire più contatti nel formato raw separati da virgole
elenco. Le parole speciali vuoto or nessuna non risulterà in alcuna intestazione di contatto nel
Richiesta REGISTER e quindi il server dovrebbe rispondere con i binding correnti per
il conto presso l'ufficio del registro.

-d, --ignora-redirects
Se questa opzione è impostata, tutti i reindirizzamenti verranno ignorati. Per impostazione predefinita, senza questa opzione
i reindirizzamenti ricevuti saranno rispettati. Questa opzione è attivata automaticamente nel
modalità randtrash e in modalità flood.

-D, --timeout-factor NUMERO
Il timer SIP_T1 viene moltiplicato per il NUMERO specificato. Dopo aver ricevuto un
risposta provvisoria per una richiesta INVITE, o quando un trasporto affidabile come TCP
o viene utilizzato TLS sipsak attende il tempo risultante per una risposta finale
finché non si arrende.

-e, --appendice-fine NUMERO
Il numero finale che viene aggiunto al nome utente nella modalità usrloc. Questo
il numero aumenta fino a raggiungere questa fine numero. Nella modalità flood questo è
il numero massimo di messaggi che verranno inviati. Se omesso il valore predefinito è
2^31 (2147483647) in modalità flood.

-E, --trasporto STRINGA
Il valore di STRING verrà utilizzato come trasporto IP per l'invio e la ricezione di richieste
e risposte. Questa opzione sovrascrive qualsiasi risultato dalla valutazione URI e SRV
ricerca. Attualmente solo 'udp' e 'tcp' sono accettati come valore per CORDA.

-f, --nomefile FILE
Il contenuto di RISORSE verrà letto in modalità binaria e verrà utilizzato come sostituzione
per il messaggio SIP creato in alternativa. Questo può essere utilizzato nella modalità predefinita per
effettuare richieste diverse dalle richieste OPTIONS (ad esempio INVITE). Per impostazione predefinita mancante
verranno inseriti i ritorni a capo prima degli avanzamenti di riga (utilizzare -L disattivare
questa funzione). Se il nome del file è uguale a - il file viene letto dall'input standard,
ad esempio dalla tastiera o da una pipe. Si prega di notare che le funzioni di manipolazione
(ad esempio inserendo l'intestazione Via) vengono testati solo con richieste conformi a RFC. Inoltre
le stringhe speciali all'interno del file possono essere sostituite con alcuni valori locali o dati
(Vedi -g e -G per dettagli).

-F, --modalità flood
Questa opzione attiva la modalità flood. In questa modalità OPZIONI richiede con
I numeri CSeq crescenti vengono inviati al server. Le risposte vengono ignorate -- porta sorgente
9 (scarta) di localhost è pubblicizzato nel Via più in alto.

-h, --aiuto
Stampa un semplice messaggio di aiuto all'uso. Se l'opzione lunga --Aiuto è disponibile
stamperà un messaggio di aiuto con le opzioni lunghe disponibili.

-g, --replace-string STRING
Attiva la sostituzione di $replace$ all'interno della richiesta (solitamente letta da un
file) con il CORDA. In alternativa è anche possibile specificare un elenco di attributi e
valori. Questo elenco deve iniziare e terminare con un carattere non alfanumerico. Il
lo stesso carattere deve essere utilizzato anche come separatore tra l'attributo e il valore
e tra nuove ulteriori coppie di valori di attributo. La stringa "$attribute$" sarà
sostituito con la stringa di valore nel messaggio.

-G, --sostituisci
Attiva la sostituzione automatica delle seguenti variabili nella richiesta
(di solito letto da un file): $dsthost$ verrà sostituito con l'host o
nome di dominio che è dato dal -s parametro. $srchost$ sarà sostituito da
nome host della macchina locale. $porta$ verrà sostituito dalla porta di ascolto locale
of sipsak. $utente$ verrà sostituito dal nome utente fornito dall' -s
parametro.

-H, --hostname NOME HOST
Sovrascrive il rilevamento automatico del nome host con il parametro specificato.
Attenzione: usare questa opzione con cautela (preferibilmente solo se il rilevamento automatico fallisce).

-i, --no-via
Disattiva l'inserimento della riga Via del localhost. Attenzione: questo probabilmente
disabilita la ricezione delle risposte dal server.

-Io, --modalità invito
Attiva i cicli di inviti all'interno della modalità usrloc. Dovrebbe essere combinato con -U.
In questa combinazione sipsak prima registra un utente e poi simula un
invito a questo utente. Prima viene inviato un invito, a cui si risponde con 200 OK e
infine viene inviato un ACK. Questa opzione può essere utilizzata anche senza -U , ma dovresti esserlo
assicurati di NON invitare UA reali con questa opzione. Nel caso di un mancante -U , il -l
PORT è obbligatorio perché solo se hai fatto un -U eseguito con una porta locale fissa prima,
una corsa con -I e la stessa porta locale fissa può avere successo. Attenzione: sipsak is
nessuna vera UA e gli inviti alle vere UA possono dare luogo a comportamenti inaspettati.

-j, --headers STRING
. stringa verrà aggiunto come una o più intestazioni aggiuntive alla richiesta.
la stringa "\n" (nota: due caratteri) verrà sostituita con CRLF e quindi risulterà in
due intestazioni separate. In questo modo è possibile aggiungere più di un'intestazione.

-l, --local-port PORTA
Il socket UDP ricevente utilizzerà la rete locale porta. Utile se un file è
dato da -f che contiene una linea Via corretta. Controllare il -S opzione per i dettagli su come
sipsak invia e riceve messaggi.

-L, --no-crlf
Disattiva l'inserimento dei ritorni a capo (\r) prima di tutti gli avanzamenti di riga (\n)
(che non è già preceduto da un ritorno a capo) se l'input proviene da un
il file ( -f ). Anche senza questa opzione verrà aggiunta una riga vuota alla richiesta
se necessario.

-m, --max-forward NUMERO
Imposta il valore del campo di intestazione Max-Forward. Se omesso, nessun Max-Forward
il campo verrà inserito. Se omesso nella modalità traceroute numero saranno 255.

-M, --modalità-messaggio
Questo attiva i cicli dei messaggi all'interno della modalità usrloc (nota da sipsak
versioni precedenti alla 0.8.0 all'interno del normale test usrloc). Questa opzione dovrebbe essere combinata
con -U in modo che una registrazione riuscita venga testata con un messaggio di prova al
utente e ha risposto con 200 OK. Ma questa opzione può essere utilizzata anche senza l' -U
opzione. Attenzione: usando senza -U può causare comportamenti inaspettati.

-n, --numerico
Invece del nome di dominio completo qualificato nella riga Via, l'IP dell'host locale
verrà utilizzato. Questa opzione è ora attiva per impostazione predefinita.

-N, --codice nagios
Utilizzare codici di ritorno compatibili con Nagios invece dei normali codici SIPSAK. Ciò significa
sipsak restituirà 0 se tutto è andato bene e 2 in caso di errore (locale o
remoto).

-o, --sleep NUMERO
sipsak dormirà per NUMERO ms prima di avviare il ciclo successivo in modalità usrloc.
Ciò rallenterà l'intero processo di test per renderlo più realistico. Ogni ciclo sarà
verrà comunque completato il più velocemente possibile, ma l'intero test verrà rallentato.

-O, --disposizione STRINGA
Il dato STRING verrà utilizzato come contenuto per l'intestazione Content-Disposition.
Senza questa opzione non ci sarà alcuna intestazione Content-Disposition nella richiesta.

-p, --outbound-proxy NOME HOST[:PORTA]
l'indirizzo del nome host è la destinazione a cui verrà inviata la richiesta
(proxy in uscita). Utilizzare questa opzione se l'host di destinazione è diverso dalla parte host
dell'URI della richiesta. Il nome host viene risolto tramite DNS SRV se supportato (vedere
descrizione per la risoluzione SRV) e non viene specificata alcuna porta.

-P, --processi NUMERO
Start NUMERO di processi in parallelo per eseguire il controllo di invio e risposta. Rende solo
senso se un numero più alto per -e viene fornito in modalità usrloc, messaggio o invito.

-q, --ricerca REGEXP
corrispondere alle risposte contro REGEXP e restituisce false se non si è verificata alcuna corrispondenza. Utile per
esempio per rilevare il nome del server nel campo dell'intestazione del server.

-r, --remote-port PORTA
Invece della porta SIP predefinita 5060, PORT verrà utilizzato. In alternativa, il
la porta remota può essere fornita all'interno dell'URI SIP del -s parametro.

-R, --modalità casuale
Questo attiva la modalità randtrash. In questa modalità le richieste OPTIONS verranno inviate a
server con un numero crescente di caratteri bloccati casualmente all'interno di questa richiesta.
La posizione all'interno della richiesta e il carattere sostitutivo vengono scelti casualmente.
Qualsiasi risposta diversa da Richiesta non valida (4xx) interromperà questa modalità. Anche tre
gli invii senza risposta interromperanno questa modalità. Con il -t parametro il massimo di cestinati
possono essere forniti caratteri.

-s, --sip-uri SIPURI
Questa opzione obbligatoria imposta la destinazione della richiesta. Dipende dalla modalità
se è obbligatorio solo il nome del server o anche un nome utente. Esempio per un nome completo
SIPURI : sorso:[email protected]: 123 Vedi la nota nella parte descrittiva su SRV
ricerche per dettagli su come il nome host di questo URI viene convertito in un IP e una porta.

-S, --simmetrico
Con questa opzione sipsak utilizzerà una sola porta per inviare e ricevere messaggi.
Con questa opzione la porta locale per l'invio sarà il valore da -l opzione.
Nella modalità predefinita sipsak invia da una porta casuale e ascolta sulla porta indicata
dal -l opzione. Nota: Con questa opzione sipsak non sarà in grado di ricevere
risposte da server con segnalazione asimmetrica (e implementazione rport non funzionante)
come il proxy Cisco. Se esegui sipsak come root e con supporto raw socket (selezionare
l'uscita dal -V opzione) allora questa opzione non è richiesta perché in questo
Custodie sipsak utilizza già una sola porta per inviare e ricevere messaggi.

-t, --trash-chars NUMERO
Questo parametro specifica il numero massimo di caratteri eliminati nella modalità randtrash.
Se omesso NUMERO verrà impostato sulla lunghezza della richiesta.

-T, --traceroute-mode
Questo attiva la modalità traceroute. Questa modalità funziona come la ben nota
traceroute(8) il comando si aspetta che non venga conteggiato il numero di salti di rete, ma
il numero di server in viaggio verso l'utente di destinazione. Anche il tempo di andata e ritorno
di ogni richiesta viene stampato, ma a causa di una limitazione all'interno del protocollo SIP il
l'identità (IP o nome) può essere determinata e stampata solo se la risposta dal
il server contiene un campo di intestazione di avviso. In questa modalità, ad ogni richiesta in uscita,
il valore del campo di intestazione Max-Forwards viene aumentato, a partire da uno. Il massimo
dell'intestazione Max-Forwards sarà 255 se non viene fornito nessun altro valore da -m parametro.
Qualsiasi risposta diversa da 483 o 1xx viene considerata una risposta definitiva e verrà
terminare questa modalità.

-u, --auth-username STRING
Usa il dato STRING come valore del nome utente per l'autenticazione (account diverso
e nome utente di autenticazione).

-U, --usrloc-mode
Questo attiva la modalità usrloc. Senza il -I oppure -M opzione, solo questa
registra gli utenti presso un registrar. Con una delle opzioni sopra indicate, il precedente
l'utente registrato verrà inoltre sondato con un flusso di chiamate simulato (invito, 200,
ack) o con un messaggio istantaneo (messaggio, 200). Una password per tutti gli account utente
all'interno del test usrloc può essere fornito con il -a opzione. Un nome utente è obbligatorio
per questa modalità nel -s parametro. Il numero a partire dal -b parametro per il
-e parametro viene aggiunto il nome utente. Se il -b e la -e i parametri vengono omessi,
solo uno viene eseguito con il nome utente specificato, ma senza aggiungere un numero ai nomi utente
è fatta.

-v, --verboso
Questo parametro aumenta la verbosità dell'output. No -v significa quasi nessuna produzione tranne
nei messaggi traceroute e di errore. Il massimo di tre v stampa il contenuto
di tutti i pacchetti ricevuti e inviati.

-V, --versione
Stampa il nome e il numero di versione di sipsak e le opzioni che erano
compilato nel binario.

-w, --estrai-ip
Attiva l'estrazione dell'IP o del nome host dal campo dell'intestazione Avviso.

-W, --nagios-warn NUMERO
Restituisce il codice di uscita di avviso Nagios (1) se il numero di ritrasmissioni prima del successo
era superiore al numero dato.

-x, --scadenza NUMERO
Imposta il valore dell'intestazione Expires sul numero specificato.

-z, --rimuovi-associazioni
Attiva la rimozione casuale dei vecchi binding nella modalità usrloc. Quanti per
la percentuale di binding che verrà rimossa è determinata da USRLOC_REMOVE_PERCENT
definire all'interno del codice (impostarlo prima della compilazione). Rimozione multipla di associazioni
è possibile e non può essere impedito.

RITORNO VALORI

Il valore di ritorno 0 significa che è stato ricevuto un 200. 1 significa qualcosa di diverso da 1xx o 2xx
è stato ricevuto. 2 verrà restituito su errori locali come nomi non risolvibili o errati
combinazione di opzioni. 3 verrà restituito in caso di errori remoti come errori socket (ad esempio icmp
errore), reindirizza senza un'intestazione di contatto o semplicemente senza risposta (timeout).

Se l' -N è stata data l'opzione il codice di ritorno sarà 2 in caso di qualsiasi (locale o remoto)
errore. 1 nel caso in cui ci siano state ritrasmissioni da sipsak al server. E 0 se c'è
non c'era alcun errore.

AVVERTENZE

Usa il sipsak responsabilmente. Eseguirlo in una qualsiasi delle modalità di stress comporta un carico sostanziale
rete e server in fase di test.

ESEMPI

sipsak -vv -s sip:[email protected]
visualizza le risposte ricevute.

sipsak -T -s sorseggiare:[email protected]
non traccia il percorso SIP verso nessuno.

sipsak -U -C sip:me@home -x 3600 -a password -s sip:myself@company
inserisce l'inoltro dal lavoro a casa per un'ora.

sipsak -f bye.sip -g '!FTAG!345.af23!TTAG!1208.12!' -s sip:myproxy
legge il file bye.sip, sostituisce $FTAG$ con 345.af23 e $TTAG$ con 1208.12 e
finalmente invia questo messaggio a myproxy

LIMITAZIONI / NON IMPLEMENTATO

Molti server potrebbero decidere di NON includere i campi di intestazione "Avviso" SIP. Sfortunatamente, questo
rende impossibile la visualizzazione degli indirizzi IP dei server SIP in modalità traceroute.

IPv6 non è supportato.

Manca il supporto per Record-Route e Route header.

Utilizzare sipsak online utilizzando i servizi onworks.net