1sip-dig(1)                         sofia-sip                        sip-dig(1)
2
3
4

NAME

6       sip-dig - Resolve SIP URIs.
7

Synopsis

9       sip-dig [OPTIONS] uri...
10

Description

12       The sip-dig utility resolves SIP URIs as described in RFC 3263. It
13       queries NAPTR, SRV and A/AAAA records and prints out the resulting
14       transport addresses.
15
16       The default transports are: UDP, TCP, SCTP, TLS and TLS-SCTP. The SIPS
17       URIs are resolved using only TLS transports, TLS and TLS-SCTP. If not
18       otherwise indicated by NAPTR or SRV records, the sip-dig uses UDP and
19       TCP as transports for SIP and TLS for SIPS URIs.
20
21       The results are printed intended, with a preference followed by weight,
22       then protocol name, port number and IP address in numeric format.
23

Command Line Options

25       The sip-dig utility accepts following command line options:
26
27       -p protoname
28           Use named transport protocol. The protoname can be either well-
29           known, e.g., 'udp', or it can specify NAPTR service and SRV
30           identifier, e.g., 'tls-udp/SIPS+D2U/_sips._udp.'.
31
32       --udp
33           Use UDP transport protocol.
34
35       --tcp
36           Use TCP transport protocol.
37
38       --tls
39           Use TLS over TCP transport protocol.
40
41       --sctp
42           Use SCTP transport protocol.
43
44       --tls-sctp
45           Use TLS over SCTP transport protocol.
46
47       --no-sctp
48           Ignore SCTP or TLS-SCTP records in the list of default transports.
49           This option has no effect if transport protocols has been
50           explicitly listed.
51
52       -4  Query IP4 addresses (A records)
53
54       -6  Query IP6 addresses (AAAA records).
55
56       -v  Be verbatim.
57
58
59

Return Codes

61       0when successful (a 2XX-series response is received) 1when unsuccessful
62       (a 3XX..6XX-series response is received) 2initialization failure
63

Examples

65       Resolve sip:openlaboratory.net, prefer TLS over TCP, TCP over UDP:
66
67        $ sip-dig --tls --tcp --udp sip:openlaboratory.net
68               1 0.333 tls 5061 212.213.221.127
69               2 0.333 tcp 5060 212.213.221.127
70               3 0.333 udp 5060 212.213.221.127
71
72
73       Resolve sips:example.net with TLS over SCTP (TLS-SCTP) and TLS:
74
75        $ sip-dig -p tls-sctp --tls sips:example.net
76               1 0.500 tls-udp 5061 172.21.55.26
77               2 0.500 tls 5061 172.21.55.26
78
79

Environment

81       SRESOLV_DEBUG, SRESOLV_CONF
82

Reporting Bugs

84       Report bugs to <sofia-sip-devel@lists.sourceforge.net>.
85

Author

87       Written by Pekka Pessi <pekka -dot pessi -at- nokia -dot- com>
88

90       Copyright (C) 2006 Nokia Corporation.
91
92       This program is free software; see the source for copying conditions.
93       There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
94       PARTICULAR PURPOSE.
95
96
97
98Version 1.12.6                    31 Jul 2007                       sip-dig(1)
Impressum